Snapservice. Cluster Pairs Create Precheck$ Task

Snapservice. Cluster Pairs Create Precheck$ Task

Precheck validation for creating a new cluster pair.

This operation was added in vSphere API 9.0.0.0.

Returns an authorization error if you do not have all of the privileges described as follows:

  • Operation execution requires VsanDP.Replication.com.vmware.vsan.snapshotservice.Site.Manage.
Request
URI
POST
https://{host}/api/snapservice/cluster-pairs?action=create-precheck&vmw-task=true
COPY
Request Body

Precheck specification for creating the cluster pair.

Snapservice.ClusterPairs.CreateSpec of type(s) application/json
Required
"Snapservice.ClusterPairs.CreateSpec Object"
Authentication
This operation uses the following authentication methods.
Responses
202

Precheck result details with validation and status.

Returns string of type(s) application/json
Operation doesn't return any data structure

400

Vapi.Std.Errors.InvalidArgument If validation of the spec fails.

Vapi.Std.Errors.AlreadyExists If caller tries to create already existing cluster pair.

Returns Vapi.Std.Errors.Error of type(s) application/json
"Vapi.Std.Errors.Error Object"

401

If the caller is not authenticated.

Returns Vapi.Std.Errors.Unauthenticated of type(s) application/json
"Vapi.Std.Errors.Unauthenticated Object"

403

If the caller is not authorized to perform the operation.

Returns Vapi.Std.Errors.Unauthorized of type(s) application/json
"Vapi.Std.Errors.Unauthorized Object"

500

If there is unknown internal error.

Returns Vapi.Std.Errors.Error of type(s) application/json
"Vapi.Std.Errors.Error Object"

503

if the system is unable to communicate with a service to complete the request.

Returns Vapi.Std.Errors.ServiceUnavailable of type(s) application/json
"Vapi.Std.Errors.ServiceUnavailable Object"

Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/api/snapservice/cluster-pairs?action=create-precheck&vmw-task=true