Creates a Global Database Network (GDN).

Note A cluster belongs to only one GDN.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes CreateGlobalDatabaseNetwork

The operation that you want to perform. Set the value to CreateGlobalDatabaseNetwork.

DBClusterId String Yes pc-bp1q76364ird*****

The ID of the primary cluster.

GDNDescription String No GDN-fortest

The description of the GDN. The description must meet the following requirements:

  • It cannot contain the prefix http:// or https://.
  • It must start with a letter.
  • It can contain letters, digits, underscores (_), and hyphens (-).
  • It must be 2 to 126 characters in length.
ResourceGroupId String No rg-************

The ID of the resource group.

Response parameters

Parameter Type Example Description
GDNId String gd-m5ex5wqfqbou*****

The ID of the GDN.

RequestId String C61892A4-0850-4516-9E26-44D96C1782DE

The ID of the request.

Examples

Sample requests

http(s)://polardb.aliyuncs.com/?Action=CreateGlobalDatabaseNetwork
&DBClusterId=pc-bp1q76364ird*****
&GDNDescription=gdn-bp1fttxsrmv*****
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateGlobalDatabaseNetworkResponse>
    <GDNId>gd-m5ex5wqfqbou*****</GDNId>
    <RequestId>C61892A4-0850-4516-9E26-44D96C1782DE</RequestId>
</CreateGlobalDatabaseNetworkResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "GDNId" : "gd-m5ex5wqfqbou*****",
  "RequestId" : "C61892A4-0850-4516-9E26-44D96C1782DE"
}

Error codes

HTTP status code Error code Error message Description
400 MemberIns.Exist Specified member ins already exist. The error message returned because the specified cluster already exists in the GDN.
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. The error message returned because the specified DBClusterId does not exist in the current record.

For a list of error codes, visit the API Error Center.