Add Local Replicator

Add Local Replicator

This request registers the local Replicator Service on the appliance.

Request
URI
POST
https://{api_host}/replicators/local
COPY
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services


Request Body

The SSO credentials.

SsoCredentials of type(s) application/json
Required
{
    "ssoUser": "Administrator@VSPHERE.LOCAL",
    "ssoPassword": "myssopassword"
}
string
ssoPassword
Optional

The password of the single-sign-on user for the vCenter Server Lookup Service.

string
ssoUser
Optional

The single-sign-on user name for the vCenter Server Lookup Service.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns ReplicatorInfo of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8
{
    "id": "9664de13-6150-4315-9f59-2d85eb4c302f",
    "owner": "tenant1",
    "site": "on-prem-dc1",
    "description": "on-prem replicator 1",
    "apiUrl": "https://replicator1:8043",
    "certThumbprint": "SHA-256:0D:80:21:91:C7:DC:94:BC:9D:E8:A7:04:0F:6B:F1:09:5C:AA:97:C8:4A:72:E5:CF:5E:8F:84:A7:B9:CC:8C:85",
    "pairingCookie": "lBvDMttZLLnWVZwC+85ufqiNt4M=",
    "state": {
        "incomingCommError": {
            "code": "Forbidden",
            "msg": "Permission denied.",
            "args": [],
            "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
        },
        "outgoingCommError": {
            "code": "Forbidden",
            "msg": "Permission denied.",
            "args": [],
            "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
        }
    },
    "isInMaintenanceMode": false,
    "apiVersion": "4.5",
    "dataAddress": "lwd://localhost:44045",
    "buildVersion": "4.5.0.5801221-9aeebc925e"
}
string
apiUrl
Optional

The URL of the REST API of the Replicator Service. Guaranteed to be populated only for completely registered Replicator Service instances. WARNING: This URL changes once L4 tunneling is in place!

string
apiVersion
Optional

The API version used to communicate to this Replicator Service.

string
buildVersion
Optional

The complete build number identifier of the Replicator Service.

string
certThumbprint
Optional

The Replicator Service certificate that is used for trusting both incoming and outgoing connections. Guaranteed to be populated only for completely registered Replicator Service instances.

string
dataAddress
Optional

The data address that is used to communicate to this Replicator Service instance.

string
description
Optional

User-supplied description of this Replicator Service instance.

string As uuid As uuid
id
Optional

Unique identifier of this Replicator Service instance (instance UUID). Note: Before the Replicator Service is completely registered, this UUID might be null.

boolean
isInMaintenanceMode
Optional

Whether this Replicator Service instance is temporarily out of service due to being placed in maintenance mode.

string
owner
Optional

Owner of this Replicator Service instance.

string
pairingCookie
Optional

A cookie that the Replicator Service instance can use to register or re-register with this Manager Service. Note: Registration cookies can only be used once.

string
site
Optional

Site identifier. Not interpreted by the Manager Service. Can be used for filtering or for automatic selection of a Replicator Service instance.

state
Optional

state


401

The returned error codes include (but are not limited to): NotAuthenticated

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


500

The returned error codes include (but are not limited to): GeneralServerFailure

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.