API Actions: PromoteDbReplicaToPrimaryStatus
Returns the progress of the PromoteDbReplicaToPrimary API call.
Request Syntax:
XML
POST /api/PromoteDbReplicaToPrimaryStatus HTTP/1.1
Host: use.your.host.name:82
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Content-Type: application/xml
X-Amz-Date: 20171115T202130Z
Authorization: AWS4-HMAC-SHA256 Credential= UQOPWUVNBALABCABCABC/20171115/us-east-1/cloudbasic/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=995374189c189e8e68ed3de82c1764ca11971711fb5179eeab2b19edd883dd74
<?xml version="1.0" encoding="utf-8"?>
<PromoteDbReplicaToPrimaryStatusRequest>
<ReplicationId>998acaec-9211-4dac-b90b-196fd1d17993</ReplicationId>
</PromoteDbReplicaToPrimaryStatusRequest>
JSON
POST /api/PromoteDbReplicaToPrimaryStatus HTTP/1.1
Host: use.your.host.name:82
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Content-Type: application/json
X-Amz-Date: 20171115T202130Z
Authorization: AWS4-HMAC-SHA256 Credential= UQOPWUVNBALABCABCABC/20171115/us-east-1/cloudbasic/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=995374189c189e8e68ed3de82c1764ca11971711fb5179eeab2b19edd883dd74
{
"ReplicationId": "998acaec-9211-4dac-b90b-196fd1d17993"
}
Request Parameters
| Parameter | Description | Required |
|---|---|---|
| ReplicationId | A GUID value that uniquely identifies a Replication. | Yes |
| Type: String Default: None |
Request Headers
This implementation uses only request headers that are common to all operations. For more information please see the section Common Request Headers
Response Syntax:
XML
HTTP/1.1 200
status: 200
<?xml version="1.0" encoding="utf-8"?>
<PromoteDbReplicaToPrimaryStatusResponse>
<ReplicationId>998acaec-9211-4dac-b90b-196fd1d17993</ReplicationId>
<Status>Running</Status>
<Progress>10%</Progress>
<Logs>
< ![CDATA[
12/24/2017 6:53:32 PM>>BEGIN
12/24/2017 6:53:32 PM>>Promoting to Primary initiated for database [TestDBALL_1ss3]: Activating FKs, constraints and triggers. 5 Tables found.
12/24/2017 6:53:32 PM>>Source is accessible. Retrieving structure from source database.
12/24/2017 6:53:32 PM>>0 constraints found.
12/24/2017 6:53:32 PM>>0 table triggers found.
12/24/2017 6:53:32 PM>>0 database triggers found.
12/24/2017 6:53:32 PM>>Successfully promoted database [TestDBALL_1ss3] to primary, Total time:0 secs
.....
]]>
</Logs>
</PromoteDbReplicaToPrimaryStatusResponse>
JSON
HTTP/1.1 200
status: 200
{
"replicationId": "998acaec-9211-4dac-b90b-196fd1d17993"
"status": "Running",
"progress":"10%",
"logs":""
}
Response Parameters
| Parameter | Description | Optional |
|---|---|---|
| Id | The requested GUID value that uniquely identifies a Replication. | No |
| Status | Possible values include:
|
No |
| Progress | The progress, in percents, of the Replication. When the Status is Success, this parameter will return 100. | Yes |
| Logs | Detailed progress logs of the PromoteToPrimary process. | Yes |
Error Response Syntax:
XML
HTTP/1.1 400 status: 400 <?xml version="1.0" encoding="utf-8"?> <ErrorResponse> <RequestId>request-id</RequestId> <Errors> <Error> Failed to retrieve status </Error> </Errors> </ErrorResponse>
JSON
HTTP/1.1 400
status: 400
{
"errors": [
"Failed to retrieve status"
],
"requestId": 21
}