Patch v1deployments

Update deployment status

PATCH /v1/deployments/{deploymentId}

cURL

cURL

curl --request PATCH \
  --url https://api.qyl.dev/v1/deployments/{deploymentId} \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "pending",
  "healthy_replicas": 123,
  "error_message": "<string>"
}
'

200

{
  "deployment.id": "<string>",
  "service.name": "<string>",
  "service.version": "2.1.0",
  "environment": "development",
  "status": "pending",
  "strategy": "rolling",
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "duration_s": 1,
  "deployed_by": "<string>",
  "git_commit": "<string>",
  "git_branch": "<string>",
  "previous_version": "2.1.0",
  "rollback_target": "<string>",
  "replica_count": 123,
  "healthy_replicas": 123,
  "error_message": "<string>"
}

Path Parameters

deploymentId · string · required

Body

application/json

Deployment update request

status · enum<string>

New status

Available options: pending, in_progress, success, failed, rolled_back, cancelled

healthy_replicas · integer<int32>

Healthy replicas

error_message · string

Error message

Response

200

application/json

The request has succeeded.

Complete deployment record

deployment.id · string · required

Deployment ID

service.name · string · required

Service name

service.version · string · required

Service version

Example:

"2.1.0"

environment · enum<string> · required

Environment

Available options: development, testing, staging, production, preview, canary

status · enum<string> · required

Status

Available options: pending, in_progress, success, failed, rolled_back, cancelled

strategy · enum<string> · required

Strategy

Available options: rolling, blue_green, canary, recreate, ab_test, shadow, feature_flag

start_time · string<date-time> · required

Start time

end_time · string<date-time>

End time

duration_s · number<double>

Duration in seconds

Required range: x >= 0

deployed_by · string

Deployed by (user/system)

git_commit · string

Git commit SHA

git_branch · string

Git branch

previous_version · string

Previous version

Example:

"2.1.0"

rollback_target · string

Rollback target (if rolled back)

replica_count · integer<int32>

Replica count

healthy_replicas · integer<int32>

Healthy replica count

error_message · string

Error message (if failed)