replicationService
The replicationService
data type describes the replication
resource.
replicationService data type properties
The following table describes the properties included in the replicationService
data type.
Property name | Data type | Description | Notes |
allowTenantsToMonitor Namespaces | Boolean |
Specifies whether the Tenant Management Console for HCP tenants displays the status of replication of the tenant and its namespaces. Valid values are:
The default is false. | |
connectivityTimeout Seconds | Integer | Specifies how long the HCP system should wait before reporting a replication link connectivity failure. Valid values are integers greater than or equal to zero. | |
enableDNSFailover | Boolean |
Specifies whether DNS failover is enabled for the HCP system. Valid values are:
The default is false. | |
enableDomainAnd Certificate Synchronization | Boolean |
Specifies whether HCP periodically sends its domains and SSL server certificates to each other HCP system with which it participates as a sending system in a replication link. Valid values are:
The default is false. | This data type has been deprecated and should not be used. |
network | String |
Specifies the replication network for the HCP system. Valid values are any network defined in the HCP system except [hcp_backend]. The default is [hcp_system]. Network names are not case-sensitive. | |
status | String |
Specifies whether all activity on all replication links in which the HCP system participates is currently stopped. Possible values are:
| This property is not valid on a POST request. It is returned only by a verbose GET request. |
verification | String |
Specifies whether replication verification is enabled for the HCP system. Possible values are:
|
Example
Here’s an XML example of the replicationService
data type:
<replicationService> <allowTenantsToMonitorNamespaces>false</allowTenantsToMonitorNamespaces> <enableDNSFailover>true</enableDNSFailover> <network>[hcp_system]</network> <connectivityTimeoutSeconds>30</connectivityTimeoutSeconds> <status>ENABLED</status> <verification>ONCE</verification> </replicationService>
Query parameters for Replication service actions
To shut down all replication links in which the HCP system participates, you use this query parameter:
shutDownAllLinks=reason
reason is a text string that specifies the reason why you’re shutting down all links. This string can be up to 1,024 characters long and can contain any valid UTF-8 characters, including white space. The string you specify must be percent encoded.
To reestablish all replication links in which the HCP system participates after they have been shut down, you use this query parameter:
reestablishAllLinks
You use the shutDownAllLinks and reestablishAllLinks query parameters with a POST request against the replication resource. You cannot include a request body with this request.
Here’s a sample POST request that shuts down all replication links:
curl -k -iX POST -H "Authorization: HCP YWxscm9sZXM=:04EC9F614D89FF5C7126D32ACB448382" "https://admin.hcp-ma.example.com:9090/mapi/services/replication ?shutDownAllLinks=More%20bandwidth%20for%20app%20XYZ"