Repair Replicator

Repair Replicator

This request will repair with the given Replicator instance.

Request
URI
POST
https://{api_host}/replicators/{replicatorId}/reset-cookie
COPY
Path Parameters
string
replicatorId
Required

Replicator ID.

replicatorId example
585e2498-2f0a-4795-bc23-3c98764b748e
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services


Request Body

Update replicator request.

UpdateReplicatorRequest of type(s) application/json
Required
{
    "description": "some description",
    "details": {
        "apiUrl": "https://replicator1:8043",
        "apiThumbprint": "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",
        "rootPassword": "rootappliancepasswordformyreplicator",
        "ssoUser": "Administrator@VSPHERE.LOCAL",
        "ssoPassword": "passwordforssouser"
    }
}
string
description
Optional

Description for the Replicator.

details
Optional

details

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.