Creates a service rollout.
Operation description
Usage notes
Mutually exclusive strategies: You can use either the
Partitionor theBatchstrategy, but not both.Request rate limit: Up to 100 requests per second.
Authorization: This operation requires the
eas:CreateServiceRolloutpermission.ARN:
acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}.Pause a rollout: To pause the service rollout, set the
Pausedparameter totrue. You can then resume or cancel the rollout by calling theUpdateServiceRolloutoperation.Monitoring and rollback: Monitor service metrics during the service rollout to promptly identify and resolve issues. To perform a rollback, you can adjust the
Partitionvalue or delete the rollout strategy.
Try it now
Test
RAM authorization
Request syntax
POST /api/v2/services/{ClusterId}/{ServiceName}/rollout HTTP/1.1Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ClusterId |
string |
Yes |
The region ID where the service is deployed. Call the |
cn-shanghai |
| ServiceName |
string |
Yes |
The name of the service to update. The name must be unique within the region. Call the |
my-service |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| Partition |
object |
No |
The configuration for the Partition strategy. |
|
| Partition |
string |
No |
The number of instances to update to the new version. |
1 |
| Batch |
object |
No |
The configuration for the Batch strategy. |
|
| BatchSize |
string |
No |
The number of instances to update in each batch. |
1 |
| Interval |
string |
No |
The wait interval after each batch completes. |
5m |
| Paused |
boolean |
No |
Specifies whether to pause the rollout. |
False |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response body. |
||
| RequestId |
string |
The unique request ID. Use this ID for troubleshooting and traceability. |
40325405-579C-4D82**** |
| Message |
string |
A message that indicates the result of the operation. |
Rollout created successfully |
Examples
Success response
JSON format
{
"RequestId": "40325405-579C-4D82****\n",
"Message": "Rollout created successfully"
}Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.