VCenter Connections Retry Removal
Starts generation g+1 of a stopped removal for the incomplete hosts only. Hosts already confirmed are never signed again. The pass runs in the background; follow it with GET removal. Requires the ADMIN role.
vCenter connection id: its numeric primary key, with or without the db- prefix. The connection row may be gone; the operation record is looked up by the numeric key
1
The operation id and generation the administrator was shown.
Show optional properties
{
"operationId": 0,
"generation": 0
}
{
"operationId": 7,
"generation": 3
}
Removal operation the caller was shown, so a retry of another operation is refused
Pass number the caller was shown; a newer pass answers 409 REMOVAL_STALE
202 Accepted: the new pass is running in the background; follow it with GET /api/v1/vcenter-connections/{id}/removal
{
"operationId": 7,
"connectionPk": 1,
"displayName": "Primary vCenter",
"host": "vcenter.example.com",
"port": 443,
"state": "ATTENTION_REQUIRED",
"attentionReason": "HOST_FAILURES",
"generation": 3,
"hostsTotal": 120,
"progress": {
"operationId": 7,
"operationState": "ATTENTION_REQUIRED",
"attentionReason": "HOST_FAILURES",
"hostsTotal": 120,
"hostsFinished": 119,
"hostsFailed": 1,
"hostsOutstanding": 0,
"remoteConfirmed": 117,
"noRemoteIdentity": 2,
"forcedUnconfirmed": 0,
"recoveryRequired": 1
},
"requestedBy": "alice.example",
"requestedAt": "2026-01-15T09:30:00Z",
"lastRetryBy": "alice.example",
"lastRetryAt": "2026-01-15T09:40:00Z",
"abandonedBy": null,
"abandonedAt": null,
"abandonReasonCode": null,
"finishedAt": null,
"connectionDeleted": false,
"canRetry": true,
"canAbandonLocal": true
}
Identifier of this removal operation
Primary key the connection had, kept after the row is deleted
Display name the connection had when the removal started
Address the connection had when the removal started
HTTPS port the connection had when the removal started
Where the operation stands: REQUESTED, RUNNING, ATTENTION_REQUIRED, COMPLETED or LOCALLY_ABANDONED
Why the operation stopped for the operator while ATTENTION_REQUIRED: HOST_FAILURES, INTERRUPTED, LATE_ENROLLMENT or FINALIZE_FAILED; null otherwise
Pass number, increased by every retry and by a restart interruption
Hosts the operation tracks, including hosts that appeared after it started
Where a vCenter removal stands while Agent unenrollment runs on the enrollment workers. Counts use the offboarding outcome vocabulary
Account that started the removal
Moment an administrator asked for the removal, in UTC
Account that last started a retry; null before the first retry
When the last retry started; null before the first retry
Account that abandoned the Console records; null unless LOCALLY_ABANDONED
When the Console records were abandoned; null unless LOCALLY_ABANDONED
Reason code given at abandonment: DECOMMISSIONED, PERMANENTLY_UNREACHABLE, REPLACED or OTHER; null unless LOCALLY_ABANDONED
When the operation reached COMPLETED or LOCALLY_ABANDONED; null while it is active
True once the connection row was deleted
Whether Retry Removal may be started now
Whether local abandonment may be requested now: ATTENTION_REQUIRED after at least one retry
400 Bad Request: INVALID_CONNECTION_ID or INVALID_ARGUMENT
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
401 Unauthorized: UNAUTHENTICATED when the VTP_SESSION cookie is missing, unknown, expired or revoked
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
403 Forbidden: FORBIDDEN when the signed-in role is not allowed to call this operation; CSRF_ERROR when the X-XSRF-TOKEN header is missing or wrong on a POST, PUT, PATCH or DELETE (only POST /api/v1/auth/login is exempt, and a request without a valid session gets 401 UNAUTHENTICATED instead); PASSWORD_CHANGE_REQUIRED when the account must change its password first (only GET /api/v1/auth/session, POST /api/v1/auth/logout and POST /api/v1/auth/change-password are exempt); LICENSE_REQUIRED or LICENSE_EXPIRED while the license pool is restricted (no license, or expired past grace) (exempt: every route under /api/v1/auth, GET /api/v1/user/preferences, GET /api/v1/licensing/summary and POST /api/v1/licensing/licenses)
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
404 Not Found: REMOVAL_NOT_FOUND
{
"errorCode": "string",
"message": "string",
"path": "string",
"timestamp": "string",
"reason": "string"
}
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
409 Conflict: REMOVAL_IN_PROGRESS, REMOVAL_FINISHED, REMOVAL_STALE or REMOVAL_NOT_RETRYABLE
"ApiErrorResponse Object"
Stable machine-readable error code. The known values are listed in ApiErrorCode; the set is not closed, so a client must tolerate an unlisted value.
Human-readable error description
Request URI path that produced the error
Timestamp when the error occurred as an ISO 8601 date-time with offset
A finer code, present only where an endpoint documents it. The Rule Pack endpoints' PACK_ENTRY_INVALID carries the import core's code here.
curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"operationId":"integer","generation":"integer"}' https://{api_host}/api/v1/vcenter-connections/{id}/removal/retry