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 nameData typeDescriptionNotes

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:

  • true

    The Tenant Management Console displays replication status information for all HCP tenants.

  • false

    The Tenant Management Console hide replication status information for all HCP tenants.

The default is false.

connectivityTimeout

Seconds

IntegerSpecifies how long the HCP system should wait before reporting a replication link connectivity failure. Valid values are integers greater than or equal to zero.
enableDNSFailoverBoolean

Specifies whether DNS failover is enabled for the HCP system. Valid values are:

  • true

    DNS failover is enabled for the system.

  • false

    DNS failover is disabled for the system.

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:

  • true

    HCP periodically sends its domains and SSL server certificates to each other system with which it participates as a sending system in a replication link.

  • false

    HCP does not send its domains and SSL server certificates to other systems.

The default is false.

This data type has been deprecated and should not be used.
networkString

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.

statusString

Specifies whether all activity on all replication links in which the HCP system participates is currently stopped. Possible values are:

  • ENABLED

    Activity on each replication link in which the system participates is occurring according the individual link status.

  • SHUTDOWN

    All activity on all replication links in which the system participates is currently stopped.

This property is not valid on a POST request. It is returned only by a verbose GET request.
verificationString

Specifies whether replication verification is enabled for the HCP system. Possible values are:

  • ON

    Replication verification is set to continuously run.

  • ONCE

    Replication verification is set to run only on.

  • OFF

    Replication verification is disabled.

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"