Domain name for API request: postgres.intl.tencentcloudapi.com.
This API is used to create an RO group.
A maximum of 100 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: CreateReadOnlyGroup. |
| 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. |
| MasterDBInstanceId | Yes | String | Primary instance ID. obtain through the api DescribeDBInstances. |
| Name | Yes | String | Read-Only group name. only supports chinese, english, digits, "_", or "-" with length less than 60. |
| ProjectId | No | Integer | Project ID. default value is 0, means it belongs to the default project. |
| VpcId | No | String | VPC ID. note: uses classic networks by default. currently, basic networks are not supported, so this parameter is required. |
| SubnetId | No | String | Subnet ID. note: uses classic networks by default. currently, basic networks are not supported, so this parameter is required. |
| ReplayLagEliminate | No | Integer | Delay time size switch: 0 for off, 1 for on. this parameter is required. |
| ReplayLatencyEliminate | No | Integer | Delay space size switch: 0 for off, 1 for on. this parameter must match ReplayLagEliminate. |
| MaxReplayLag | No | Integer | The size threshold of the delay time, a positive integer with unit: s. this parameter is required when ReplayLagEliminate is 1 and must be set to 0 when ReplayLagEliminate is 0. |
| MaxReplayLatency | No | Integer | Delay threshold for space size, a positive integer in MB. this parameter is required when ReplayLatencyEliminate is 1 and must be set to 0 when ReplayLatencyEliminate is 0. |
| MinDelayEliminateReserve | No | Integer | Specifies the minimum number of instances to retain with delay removal. value range [0,100]. this parameter is required when ReplayLatencyEliminate is 1 and invalid when ReplayLagEliminate is 0. |
| SecurityGroupIds.N | No | Array of String | Security group ID |
| Parameter Name | Type | Description |
|---|---|---|
| ReadOnlyGroupId | String | RO group ID |
| FlowId | Integer | Process ID. FlowId is equivalent to TaskId. |
| TaskId | Integer | Task ID. |
| 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. |
POST / HTTP/1.1
Host: postgres.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateReadOnlyGroup
<Common request parameters>
{
"MaxReplayLag": 0,
"VpcId": "vpc-e0tfm161",
"Name": "name",
"ProjectId": 0,
"MasterDBInstanceId": "postgres-k95qzetn",
"MinDelayEliminateReserve": 0,
"ReplayLagEliminate": 0,
"SubnetId": "subnet-443a3lv6"
}
{
"Response": {
"RequestId": "d43b2a9f-070c-480b-a0bb-7c210428cfe8",
"FlowId": 912,
"TaskId": 912,
"ReadOnlyGroupId": "pgrogrp-dh6873gz"
}
}
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 |
|---|---|
| AuthFailure.UnauthorizedOperation | Authentication failed. |
| FailedOperation.AllocateQuotasError | Failed to request a quota for resource tags. |
| FailedOperation.CamSigAndAuthError | Authentication failed. Please try again later. If the problem persists, please contact customer service. |
| FailedOperation.CreateBasicNetworkDeniedError | Classic network creation is unsupported. |
| FailedOperation.DatabaseAccessError | Failed to access database management service. Please try again later. If the problem persists, please contact customer service. |
| FailedOperation.FailedOperationError | Operation failed. Please try again later. |
| FailedOperation.FlowCreateError | Failed to create a task. Please try again later. If the problem persists, please contact customer service. |
| FailedOperation.GetVpcInfoError | Failed to query VPC information. Please try again later. If the problem persists, please contact customer service. |
| FailedOperation.IllegalROInstanceNum | Invalid number of read-only replicas. |
| FailedOperation.MasterInstanceQueryError | Failed to query the primary instance information. |
| FailedOperation.ROGroupNumExceedError | The maximum number of RO groups has been reached. |
| InternalError.InternalHttpServerError | An exception occurred while executing the request. |
| InternalError.SystemError | System error. When this error occurs, please contact customer service for assistance. |
| InvalidParameter | Parameter error. |
| InvalidParameter.ParameterCheckError | Failed to check the parameter. |
| InvalidParameter.VpcNotFoundError | Failed to query VPC information. |
| InvalidParameterValue.InterfaceNameNotFound | Incorrect ACTION. |
| InvalidParameterValue.InvalidParameterValueError | Incorrect parameter value |
| InvalidParameterValue.ParameterCharacterError | Invalid parameter. The parameter can contain only letters, digits, underscores, and hyphens. |
| InvalidParameterValue.ParameterHandleError | Failed to process the parameter. Please check if the parameter value is valid. |
| InvalidParameterValue.ParameterLengthLimitError | The length of parameter exceeds the limit. |
| InvalidParameterValue.RegionNotSupported | The current region is not supported. |
| OperationDenied.CamDeniedError | This operation cannot be performed. |
| OperationDenied.InstanceStatusLimitOpError | This operation cannot be performed on an instance in this status. |
| ResourceNotFound.InstanceNotFoundError | The instance does not exist. |
| StructParseFailed | An error occurred while parsing parameters. |
| UnknownError | Unknown error. When this error occurs, please contact customer service for assistance. |
文档反馈