NUnullplatform
Deployment group

Update deployment group

Changed on

Updates a deployment group's status or strategy data.

patch/deployment_group/{id}

Request

  • Base URL
    https://api.nullplatform.com
  • URL
    https://api.nullplatform.com/deployment_group/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the deployment group to update.

Request body

statusstring

Status of the deployment group.

Note: See Deployments for more information.

Example request

{
  "status": "running",
  "strategy_data": {
    "switched_traffic": 30,
    "desired_switched_traffic": 50,
    "amount_instances_to_wait": 5,
    "healthy_instances": 3,
    "launched_instances": 5,
    "switch_traffic_step": true
  }
}

Response

The operation was successful.

idstring required

The ID of the deployment group.

status'creating_approval' | 'creating_approval_denied' | 'creating' | 'waiting_for_instances' | 'running' | 'finalizing' | 'finalized' | 'cancelling' | 'cancelled' | 'failed' | 'rolling_back' | 'rolled_back' | 'deleting' | 'deleted' required

Status of the deployment group.

Note: See Deployments for more information.

application_idstring required

The ID of the application the deployment group belongs to.

release_idstring required

The ID of the release associated with the deployment.

deployments_amountinteger required

Number of deployments in the group

created_bystring required

The user ID of the creator of the deployment group.

updated_bystring required

The user ID of the last person who updated the deployment group.

created_atstring date-time required

The ISO-8601 UTC timestamp of when the deployment group was created.

updated_atstring date-time required

The ISO-8601 UTC timestamp of when the deployment group was last updated.

Example response

{
  "id": "1",
  "status": "running",
  "deployments": [
    {
      "strategy": "blue_green",
      "strategy_data": {
        "switched_traffic": 30,
        "desired_switched_traffic": 50,
        "amount_instances_to_wait": 5,
        "healthy_instances": 3,
        "launched_instances": 5,
        "switch_traffic_step": true
      }
    }
  ],
  "scopes": [
    {
      "name": "AR - Staging"
    }
  ],
  "strategy_data": {
    "switched_traffic": 30,
    "desired_switched_traffic": 50,
    "amount_instances_to_wait": 5,
    "healthy_instances": 3,
    "launched_instances": 5,
    "switch_traffic_step": true
  },
  "application_id": "6789",
  "release_id": "5678",
  "deployments_amount": 5,
  "created_at": "2023-10-01T12:34:56Z",
  "updated_at": "2023-10-01T12:34:56Z"
}

Changes

  • 728d4df70ca1Revision changes
    • breaking

      the response property became optional for the status

    • breaking

      the response property became optional for the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      response property message deprecated

    • info

      response property message deprecated

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status