Domain name for API request: cvm.tencentcloudapi.com.
This API is used to create a spread placement group. After you create one, you can specify it for an instance when you create the instance,
A maximum of 10 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: CreateDisasterRecoverGroup. |
Version | Yes | String | Common Params. The value used for this API: 2017-03-12. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
Name | Yes | String | Name of the spread placement group. The name must be 1-60 characters long and can contain both Chinese characters and English letters. |
Type | Yes | String | Type of a spread placement group. Valid values: |
ClientToken | No | String | A string used to ensure the idempotency of the request, which is generated by the user and must be unique to each request. The maximum length is 64 ASCII characters. If this parameter is not specified, the idempotency of the request cannot be guaranteed. For more information, see 'How to ensure idempotency'. |
Parameter Name | Type | Description |
---|---|---|
DisasterRecoverGroupId | String | List of spread placement group IDs. |
Type | String | Type of a spread placement group. Valid values: |
Name | String | Name of the spread placement group. The name must be 1-60 characters long and can contain both Chinese characters and English letters. |
CvmQuotaTotal | Integer | The maximum number of CVMs in a placement group. |
CurrentNum | Integer | The current number of CVMs in a placement group. |
CreateTime | Timestamp | Creation time of the placement group. |
RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to create a spread placement group.
GET https://cvm.tencentcloudapi.com/?Action=CreateDisasterRecoverGroup
&Name=Physical machine spread placement group
&Type=HOST
&<Common request parameters>
{
"Response": {
"Type": "HOST",
"DisasterRecoverGroupId": "ps-qajfd25h",
"Name": "Physical machine spread placement group",
"CvmQuotaTotal": 50,
"CurrentNum": 0,
"CreateTime": "2020-09-22 00:00:00",
"RequestId": "21387009-9b9c-4b57-8fa2-8228f702ff6c"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
InvalidParameterValue.InvalidAppIdFormat | Invalid AppID |
InvalidParameterValue.Range | Invalid parameter value: invalid parameter value range. |
InvalidParameterValue.TooLong | Invalid parameter value: parameter value is too long. |
ResourceInsufficient.InsufficientGroupQuota |
Was this page helpful?