Repair Sites

Repair Sites

This request updates the connection details of a peer vCenter Replication Management Appliance.

The result of this API call is a task which must be polled by using the respective APIs for task polling. If the task succeeds, then the result can be obtained from the result field. If the task fails, there is no result. The failure reason is in the error field.

Request
URI
PUT
https://{api_host}/sites/{id}
COPY
Path Parameters
string
id
Required

The ID of the remote provider peer site.

id example
3fe01842-3acb-4330-8c66-aab5a0a7a09c
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services


Request Body

Update remote provider connection dFetails request.

UpdateSiteRequest of type(s) application/json
Required
{
    "apiThumbprint": "SHA-256:F4:D6:17:37:FD:45:AF:D4:ED:15:BF:B3:52:2E:3D:41:48:29:71:42:B6:52:81:4B:24:97:5F:77:CF:20:4F:74",
    "apiUrl": "https://10.71.248.18:8048/",
    "description": "some description"
}
string
apiThumbprint
Optional

The fingerprint of the peer site's SSL certificate.

string
apiUrl
Optional

The URL of the peer site API endpoint.

string
description
Optional

Optional description of the peer site.

Authentication
This operation uses the following authentication methods.
Responses
202

Accepted

Returns ApiTask_of_ManagerPeerInfo of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8
{
    "endTime": 1499929558827,
    "error": {
        "args": [],
        "code": "Forbidden",
        "msg": "Permission denied.",
        "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
    },
    "id": "f61d60d2-698a-46dc-a266-88df27644956",
    "lastUpdated": 1499929558827,
    "progress": 100,
    "result": {
        "id": "5fd06dbd-ccab-4db8-9067-39575137028c",
        "site": "site1-7z",
        "description": "",
        "apiUrl": "https://tn-de843b57-5958-4b5a-b7bd-47f971ee4853.tnexus.io:8048/",
        "apiPublicUrl": "https://10.71.248.18:8048/",
        "apiThumbprint": "SHA-256:43:1D:24:8E:A8:C7:67:0F:9F:A9:54:3D:4C:98:7B:3E:61:3F:E8:AD:D8:A5:59:98:00:FA:5D:55:AF:55:A2:92",
        "isLocal": false,
        "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."
            }
        },
        "apiVersion": "4.6",
        "isProviderDeployment": false,
        "peerTunnelCert": "MIIDbTCCAlWgAwIBAgIJAOMdOGGfk8EYMA0GCSqGSIb3DQEBCwUAMDgxEDAOBgNVBAoTB1Vua25vd24xEDAOBgNVBAsTB1Vua25vd24xEjAQBgNVBAMTCXR1bm5lbC52bTAeFw0yMzA1MDkwODU4MDNaFw0yNDA1MDgwODU4MDNaMDgxEDAOBgNVBAoTB1Vua25vd24xEDAOBgNVBAsTB1Vua25vd24xEjAQBgNVBAMTCXR1bm5lbC52bTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAK2kRvGMRnVzbYnsb7BCuNuHWMiDo7bFpCetZ23weEXzCvGXYiIqqqNl47X1ZCDzlKYKLSFpjoiGI4ITV1fXFTL4I3kFxwmPvQu4Xin2UgvhUadrlqxMcnVp5cr6oISrJwtuzfidE12U8HerUNg3upk9ct0XOoMoZWSxRz6sYSEMynQoKmQFPY2G9ZxblzMF13Ipwl1v1j8f6D0tiVi1pjDjimC5P8mFfkqIC5tuyRmDzwUILoCe4OKiYe6s84TiQi9x0lTACEv/AhelrGFyzUfkYLwLyFdxgxID/kWJcj61nhVYBe6VvHQv/VmoYgSz5ECOQMPRWs7yiRUUWdNdQikCAwEAAaN6MHgwHQYDVR0OBBYEFMz6clOUFGo9wdFUPyfXTSwycrrdMEIGA1UdEQQ7MDmCMXRuLWFiZjZmOWY3LWFiMDMtNGM0OC1iZjgzLWIyMTZhMzdlZGVhZS50bmV4dXMuaW+HBApH+wEwEwYDVR0lBAwwCgYIKwYBBQUHAwEwDQYJKoZIhvcNAQELBQADggEBAJUdvOEMH5bZ5NZVA09hh0NTtlRIOpa6fCPJWUW8liSbigF4NjpQPwepU58uwwZBnIpX/rUqN2OAKN9bzsg93jt+nkHxJT2FFxTr6mzOTzLQUagmlvLTuhEXbUiZRrwP+9PI/lNuwLjxpyNSGl6c1SxYF6SgW1WdsmL6hBxv4U2LNSFJ72eMNc79rdFyArQtVt9PvwR4zDPNFracN5LarXihM9xdGIo0uxNXD9rZv8xRS48l8ctW2yDX/L8lQRy8EfdYgKNBCeaNZOORNx5PY6S6qr4KSsi17upDA9zkqPfG+cSaeh/ayEZ78n96attiVNX2fGMXkOYQxpZxwW3XmxM="
    },
    "resultType": "string",
    "startTime": 1499929548951,
    "state": "string",
    "user": "root",
    "warnings": [],
    "workflowInfo": {}
}
integer As int64 As int64
endTime
Optional

Timestamp in msec of the completion time of the task. -1 indicates that the task did not complete yet.

error
Optional

error

string As uuid As uuid
id
Optional

The unique identifier of the long-running task. It is unique and can be used for monitoring.

integer As int64 As int64
lastUpdated
Optional

Timestamp in msec of the last task status update.

integer As int32 As int32
progress
Optional

Percentage-based progress of the task.

result
Optional

result

string
resultType
Optional

Indicates the type of the task result. Populates only when the execution succeeds.

integer As int64 As int64
startTime
Optional

Timestamp in msec of the creation time of the task.

state
Optional

state

string
user
Optional

The user who started the task.

warnings
Optional

Warnings, which occurred during the task execution.

workflowInfo
Optional

workflowInfo


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.