VMware Cloud Foundation API Reference Guide

VMware Cloud Foundation API Reference Guide

3. Paths

3.1. Create a new AVN

POST /internal/avns

3.1.1. Description

Creates a new AVN based on the specified payload. Does not deploy an AVN

3.1.2. Parameters

Type Name Description Schema

Body

avn
required

Spec of the AVN to be created

Avn

3.1.3. Responses

HTTP Code Description Schema

201

Returns the created AVN

Avn

202

Accepted

Avn

400

AVN creation failed due to validation errors

Error

500

Unexpected Error

Error

3.1.4. Consumes

  • application/json

3.1.5. Produces

  • application/json

3.1.6. Tags

  • solution-network-manager-api-controller

3.1.7. Security

Type Name

basic

basicAuth

3.1.8. Example HTTP request

Request path
/internal/avns
Request body
{
  "domainName" : "sfo01.rainpole.local",
  "gateway" : "192.168.31.1",
  "id" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "mtu" : 1500,
  "name" : "vRealize-AVN",
  "portGroupName" : "Mgmt-RegionA-PortGroup",
  "regionType" : "REGION_A",
  "routerName" : "sfo01m01udlr-01",
  "subnet" : "192.168.31.0",
  "subnetMask" : "255.255.255.0"
}

3.1.9. Example HTTP response

Response 201
{
  "domainName" : "sfo01.rainpole.local",
  "gateway" : "192.168.31.1",
  "id" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "mtu" : 1500,
  "name" : "vRealize-AVN",
  "portGroupName" : "Mgmt-RegionA-PortGroup",
  "regionType" : "REGION_A",
  "routerName" : "sfo01m01udlr-01",
  "subnet" : "192.168.31.0",
  "subnetMask" : "255.255.255.0"
}
Response 202
{
  "domainName" : "sfo01.rainpole.local",
  "gateway" : "192.168.31.1",
  "id" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "mtu" : 1500,
  "name" : "vRealize-AVN",
  "portGroupName" : "Mgmt-RegionA-PortGroup",
  "regionType" : "REGION_A",
  "routerName" : "sfo01m01udlr-01",
  "subnet" : "192.168.31.0",
  "subnetMask" : "255.255.255.0"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.2. Fetches specific AVN based on ID

GET /internal/avns/{id}

3.2.1. Description

Returns the single matching AVN

3.2.2. Parameters

Type Name Description Schema

Path

id
required

Pass the AVN ID to fetch the AVN

string

3.2.3. Responses

HTTP Code Description Schema

200

Returns the list of all matching AVNs

Avn

404

AVN with ID not found

Error

500

Unexpected Error

Error

3.2.4. Consumes

  • application/json

3.2.5. Produces

  • application/json

3.2.6. Tags

  • solution-network-manager-api-controller

3.2.7. Security

Type Name

basic

basicAuth

3.2.8. Example HTTP request

Request path
/internal/avns/string

3.2.9. Example HTTP response

Response 200
{
  "domainName" : "sfo01.rainpole.local",
  "gateway" : "192.168.31.1",
  "id" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "mtu" : 1500,
  "name" : "vRealize-AVN",
  "portGroupName" : "Mgmt-RegionA-PortGroup",
  "regionType" : "REGION_A",
  "routerName" : "sfo01m01udlr-01",
  "subnet" : "192.168.31.0",
  "subnetMask" : "255.255.255.0"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.3. Fetches all AVNs

GET /v1/avns

3.3.1. Description

Returns all matching AVNs

3.3.2. Parameters

Type Name Description Schema

Query

regionType
optional

Pass an optional AVN region type matching either Region-A or X-Region

string

3.3.3. Responses

HTTP Code Description Schema

200

Returns the list of all matching AVNs

< Avn > array

500

Unexpected error

Error

3.3.4. Consumes

  • application/json

3.3.5. Produces

  • application/json

3.3.6. Tags

  • solution-network-manager-api-controller

3.3.7. Security

Type Name

basic

basicAuth

3.3.8. Example HTTP request

Request path
/v1/avns

3.3.9. Example HTTP response

Response 200
[ {
  "domainName" : "sfo01.rainpole.local",
  "gateway" : "192.168.31.1",
  "id" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "mtu" : 1500,
  "name" : "vRealize-AVN",
  "portGroupName" : "Mgmt-RegionA-PortGroup",
  "regionType" : "REGION_A",
  "routerName" : "sfo01m01udlr-01",
  "subnet" : "192.168.31.0",
  "subnetMask" : "255.255.255.0"
} ]
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.4. Trigger backup

POST /v1/backups/tasks

3.4.1. Parameters

Type Name Description Schema

Body

backupsSpec
required

backupsSpec

BackupSpec

3.4.2. Responses

HTTP Code Description Schema

200

OK

BackupTask

202

Accepted

BackupTask

400

Bad Request

Error

500

Internal server error

Error

3.4.3. Consumes

  • application/json

3.4.4. Produces

  • application/json

3.4.5. Tags

  • BackupRestore

3.4.6. Security

Type Name

basic

basicAuth

3.4.7. Example HTTP request

Request path
/v1/backups/tasks
Request body
{
  "elements" : [ {
    "resourceType" : "SDDC_MANAGER"
  } ]
}

3.4.8. Example HTTP response

Response 200
{
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: IN_PROGRESS"
}
Response 202
{
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: IN_PROGRESS"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.5. Upload a Bundle

POST /v1/bundles

3.5.1. Description

Upload Bundle to SDDC Manager. Used when you do not have internet connectivity for downloading bundles from VMWare/VxRail to SDDC Manager. The Bundles are manually downloaded from Depot using Bundle Transfer utility

3.5.2. Parameters

Type Name Description Schema

Body

bundleUploadSpec
required

Bundle Upload Specification

BundleUploadSpec

3.5.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.5.4. Consumes

  • application/json

3.5.5. Produces

  • application/json

3.5.6. Tags

  • Bundles

3.5.7. Security

Type Name

basic

basicAuth

3.5.8. Example HTTP request

Request path
/v1/bundles
Request body
{
  "bundleFilePath" : "string",
  "manifestFilePath" : "string",
  "signatureFilePath" : "string"
}

3.5.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.6. Get the Bundles

GET /v1/bundles

3.6.1. Description

Get all Bundles i.e uploaded bundles and also bundles available via depot access.

3.6.2. Responses

HTTP Code Description Schema

200

Ok

PageOfBundle

500

Internal Server Error

Error

3.6.3. Consumes

  • application/json

3.6.4. Produces

  • application/json

3.6.5. Tags

  • Bundles

3.6.6. Security

Type Name

basic

basicAuth

3.6.7. Example HTTP request

Request path
/v1/bundles

3.6.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "components" : [ {
      "description" : "string",
      "fromVersion" : "string",
      "id" : "string",
      "imageType" : "One among: PATCH, INSTALL",
      "releasedDate" : "string",
      "toVersion" : "string",
      "type" : "string",
      "vendor" : "string"
    } ],
    "description" : "string",
    "downloadStatus" : "One among: PENDING, SCHEDULED, IN_PROGRESS, SUCCESSFUL, FAILED",
    "id" : "string",
    "isCumulative" : true,
    "releasedDate" : "string",
    "severity" : "One among: CRITICAL, IMPORTANT, MODERATE, LOW",
    "sizeMB" : 0.0,
    "type" : "One among: SDDC_MANAGER, VMWARE_SOFTWARE, VXRAIL",
    "vendor" : "string",
    "version" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.7. Get a Bundle

GET /v1/bundles/{id}

3.7.1. Description

Get a Bundle

3.7.2. Parameters

Type Name Description Schema

Path

id
required

Bundle ID

string

3.7.3. Responses

HTTP Code Description Schema

200

Ok

Bundle

404

Bundle Not Found

Error

500

Internal Server Error

Error

3.7.4. Consumes

  • application/json

3.7.5. Produces

  • application/json

3.7.6. Tags

  • Bundles

3.7.7. Security

Type Name

basic

basicAuth

3.7.8. Example HTTP request

Request path
/v1/bundles/string

3.7.9. Example HTTP response

Response 200
{
  "components" : [ {
    "description" : "string",
    "fromVersion" : "string",
    "id" : "string",
    "imageType" : "One among: PATCH, INSTALL",
    "releasedDate" : "string",
    "toVersion" : "string",
    "type" : "string",
    "vendor" : "string"
  } ],
  "description" : "string",
  "downloadStatus" : "One among: PENDING, SCHEDULED, IN_PROGRESS, SUCCESSFUL, FAILED",
  "id" : "string",
  "isCumulative" : true,
  "releasedDate" : "string",
  "severity" : "One among: CRITICAL, IMPORTANT, MODERATE, LOW",
  "sizeMB" : 0.0,
  "type" : "One among: SDDC_MANAGER, VMWARE_SOFTWARE, VXRAIL",
  "vendor" : "string",
  "version" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.8. Update a Bundle for downloading from depot

PATCH /v1/bundles/{id}

3.8.1. Description

Update a Bundle for scheduling/triggering download. Only one download can triggered for a Bundle.

3.8.2. Parameters

Type Name Description Schema

Path

id
required

Bundle ID

string

Body

bundleUpdateSpec
required

Bundle Update Specification

BundleUpdateSpec

3.8.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

409

Conflict

Error

500

Internal Server Error

Error

3.8.4. Consumes

  • application/json

3.8.5. Produces

  • application/json

3.8.6. Tags

  • Bundles

3.8.7. Security

Type Name

basic

basicAuth

3.8.8. Example HTTP request

Request path
/v1/bundles/string
Request body
{
  "bundleDownloadSpec" : {
    "downloadNow" : true,
    "scheduledTimestamp" : "string"
  }
}

3.8.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.9. Get certificate authorities information

GET /v1/certificate-authorities

3.9.1. Description

Get certificate authorities information

3.9.2. Responses

HTTP Code Description Schema

200

OK

PageOfCertificateAuthority

400

Bad request

Error

500

Internal Server Error

Error

3.9.3. Consumes

  • application/json

3.9.4. Produces

  • application/json

3.9.5. Tags

  • Certificates

3.9.6. Security

Type Name

basic

basicAuth

3.9.7. Example HTTP request

Request path
/v1/certificate-authorities

3.9.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "commonName" : "string",
    "country" : "string",
    "id" : "One among: OpenSSL, Microsoft",
    "locality" : "string",
    "organization" : "string",
    "organizationUnit" : "string",
    "serverUrl" : "string",
    "state" : "string",
    "templateName" : "string",
    "username" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.10. Create a certificate authority

PUT /v1/certificate-authorities

3.10.1. Description

Creates a certificate authority. This is required to generate signed certificates by supporting CAs.

3.10.2. Parameters

Type Name Description Schema

Body

certificateAuthorityCreationSpec
required

certificateAuthorityCreationSpec

CertificateAuthorityCreationSpec

3.10.3. Responses

HTTP Code Description Schema

200

OK

object

400

Bad request

Error

500

Internal server error

Error

3.10.4. Consumes

  • application/json

3.10.5. Produces

  • */*

3.10.6. Tags

  • Certificates

3.10.7. Security

Type Name

basic

basicAuth

3.10.8. Example HTTP request

Request path
/v1/certificate-authorities
Request body
{
  "microsoftCertificateAuthoritySpec" : {
    "secret" : "string",
    "serverUrl" : "string",
    "templateName" : "string",
    "username" : "string"
  },
  "openSSLCertificateAuthoritySpec" : {
    "commonName" : "string",
    "country" : "string",
    "locality" : "string",
    "organization" : "string",
    "organizationUnit" : "string",
    "state" : "string"
  }
}

3.10.9. Example HTTP response

Response 200
{ }
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.11. Configure existing certificate authority

PATCH /v1/certificate-authorities

3.11.1. Description

Configure existing certificate authority

3.11.2. Parameters

Type Name Description Schema

Body

certificateAuthoritySpec
required

certificateAuthoritySpec

CertificateAuthorityCreationSpec

3.11.3. Responses

HTTP Code Description Schema

200

OK

object

400

Bad request

Error

404

Not Found

Error

500

Internal server error

Error

3.11.4. Consumes

  • application/json

3.11.5. Produces

  • */*

3.11.6. Tags

  • Certificates

3.11.7. Security

Type Name

basic

basicAuth

3.11.8. Example HTTP request

Request path
/v1/certificate-authorities
Request body
{
  "microsoftCertificateAuthoritySpec" : {
    "secret" : "string",
    "serverUrl" : "string",
    "templateName" : "string",
    "username" : "string"
  },
  "openSSLCertificateAuthoritySpec" : {
    "commonName" : "string",
    "country" : "string",
    "locality" : "string",
    "organization" : "string",
    "organizationUnit" : "string",
    "state" : "string"
  }
}

3.11.9. Example HTTP response

Response 200
{ }
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.12. Get certificate authority information

GET /v1/certificate-authorities/{id}

3.12.1. Description

Get certificate authority information

3.12.2. Parameters

Type Name Description Schema

Path

id
required

CA type

string

3.12.3. Responses

HTTP Code Description Schema

200

OK

CertificateAuthority

404

Not Found

Error

500

Internal Server Error

Error

3.12.4. Consumes

  • application/json

3.12.5. Produces

  • application/json

3.12.6. Tags

  • Certificates

3.12.7. Security

Type Name

basic

basicAuth

3.12.8. Example HTTP request

Request path
/v1/certificate-authorities/string

3.12.9. Example HTTP response

Response 200
{
  "commonName" : "string",
  "country" : "string",
  "id" : "One among: OpenSSL, Microsoft",
  "locality" : "string",
  "organization" : "string",
  "organizationUnit" : "string",
  "serverUrl" : "string",
  "state" : "string",
  "templateName" : "string",
  "username" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.13. Create a Cluster and add to an existing Domain

POST /v1/clusters

3.13.1. Parameters

Type Name Description Schema

Body

clusterCreationSpec
required

Cluster Creation Spec

ClusterCreationSpec

3.13.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

InternalServerError

Error

3.13.3. Consumes

  • application/json

3.13.4. Produces

  • application/json

3.13.5. Tags

  • Clusters

3.13.6. Security

Type Name

basic

basicAuth

3.13.7. Example HTTP request

Request path
/v1/clusters
Request body
{
  "computeSpec" : {
    "clusterSpecs" : [ {
      "advancedOptions" : {
        "evcMode" : "One among: INTEL_MEROM, INTEL_PENRYN, INTEL_NEALEM, INTEL_WESTMERE, INTEL_SANDYBRIDGE, INTEL_IVYBRIDGE, INTEL_HASWELL, INTEL_BROADWELL, INTEL_SKYLAKE, AMD_REV_E, AMD_REV_F, AMD_GREYHOUND_NO3DNOW, AMD_GREYHOUND, AMD_BULLDOZER, AMD_PILEDRIVER, AMD_STREAMROLLER, AMD_ZEN",
        "highAvailability" : {
          "enabled" : true
        }
      },
      "datastoreSpec" : {
        "nfsDatastoreSpecs" : [ {
          "datastoreName" : "string",
          "nasVolume" : {
            "path" : "string",
            "readOnly" : true,
            "serverName" : [ "string" ],
            "userTag" : "string"
          }
        } ],
        "vmfsDatastoreSpec" : {
          "fcSpec" : [ {
            "datastoreName" : "string"
          } ]
        },
        "vsanDatastoreSpec" : {
          "datastoreName" : "string",
          "dedupAndCompressionEnabled" : true,
          "failuresToTolerate" : 0,
          "licenseKey" : "string"
        }
      },
      "hostSpecs" : [ {
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "string",
            "moveToNvds" : true,
            "vdsName" : "string"
          } ]
        },
        "id" : "string",
        "licenseKey" : "string"
      } ],
      "name" : "string",
      "networkSpec" : {
        "nsxClusterSpec" : {
          "nsxTClusterSpec" : {
            "geneveVlanId" : 0
          },
          "nsxVClusterSpec" : {
            "licenseKey" : "string",
            "vdsNameForVxlanConfig" : "string",
            "vlanId" : 0
          }
        },
        "vdsSpecs" : [ {
          "name" : "string",
          "niocBandwidthAllocationSpecs" : [ {
            "niocTrafficResourceAllocation" : {
              "limit" : 0,
              "reservation" : 0
            },
            "type" : "string"
          } ],
          "portGroupSpecs" : [ {
            "name" : "string",
            "transportType" : "One among: VSAN, VMOTION, MANAGEMENT, PUBLIC, NFS"
          } ]
        } ]
      }
    } ]
  },
  "domainId" : "string"
}

3.13.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.14. Get the Clusters

GET /v1/clusters

3.14.1. Parameters

Type Name Description Schema

Query

isStretched
optional

isStretched

boolean

3.14.2. Responses

HTTP Code Description Schema

200

Ok

PageOfCluster

400

Bad Request

Error

500

InternalServerError

Error

3.14.3. Consumes

  • application/json

3.14.4. Produces

  • application/json

3.14.5. Tags

  • Clusters

3.14.6. Security

Type Name

basic

basicAuth

3.14.7. Example HTTP request

Request path
/v1/clusters

3.14.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "hosts" : [ {
      "id" : "string"
    } ],
    "id" : "string",
    "isStretched" : true,
    "name" : "string",
    "primaryDatastoreName" : "string",
    "primaryDatastoreType" : "One among: VSAN, NFS, FC"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.15. Validate the input spec for clusters operations

POST /v1/clusters/validations

3.15.1. Parameters

Type Name Description Schema

Body

clustersOperationSpecValidation
required

Clusters Operation Spec Validation

ClustersOperationSpecValidation

3.15.2. Responses

HTTP Code Description Schema

200

Ok

Validation

400

Bad Request

Error

500

InternalServerError

Error

3.15.3. Consumes

  • application/json

3.15.4. Produces

  • application/json

3.15.5. Tags

  • Clusters

3.15.6. Security

Type Name

basic

basicAuth

3.15.7. Example HTTP request

Request path
/v1/clusters/validations
Request body
{
  "clusterCreationSpec" : {
    "computeSpec" : {
      "clusterSpecs" : [ {
        "advancedOptions" : {
          "evcMode" : "One among: INTEL_MEROM, INTEL_PENRYN, INTEL_NEALEM, INTEL_WESTMERE, INTEL_SANDYBRIDGE, INTEL_IVYBRIDGE, INTEL_HASWELL, INTEL_BROADWELL, INTEL_SKYLAKE, AMD_REV_E, AMD_REV_F, AMD_GREYHOUND_NO3DNOW, AMD_GREYHOUND, AMD_BULLDOZER, AMD_PILEDRIVER, AMD_STREAMROLLER, AMD_ZEN",
          "highAvailability" : {
            "enabled" : true
          }
        },
        "datastoreSpec" : {
          "nfsDatastoreSpecs" : [ {
            "datastoreName" : "string",
            "nasVolume" : {
              "path" : "string",
              "readOnly" : true,
              "serverName" : [ "string" ],
              "userTag" : "string"
            }
          } ],
          "vmfsDatastoreSpec" : {
            "fcSpec" : [ {
              "datastoreName" : "string"
            } ]
          },
          "vsanDatastoreSpec" : {
            "datastoreName" : "string",
            "dedupAndCompressionEnabled" : true,
            "failuresToTolerate" : 0,
            "licenseKey" : "string"
          }
        },
        "hostSpecs" : [ {
          "hostNetworkSpec" : {
            "vmNics" : [ {
              "id" : "string",
              "moveToNvds" : true,
              "vdsName" : "string"
            } ]
          },
          "id" : "string",
          "licenseKey" : "string"
        } ],
        "name" : "string",
        "networkSpec" : {
          "nsxClusterSpec" : {
            "nsxTClusterSpec" : {
              "geneveVlanId" : 0
            },
            "nsxVClusterSpec" : {
              "licenseKey" : "string",
              "vdsNameForVxlanConfig" : "string",
              "vlanId" : 0
            }
          },
          "vdsSpecs" : [ {
            "name" : "string",
            "niocBandwidthAllocationSpecs" : [ {
              "niocTrafficResourceAllocation" : {
                "limit" : 0,
                "reservation" : 0
              },
              "type" : "string"
            } ],
            "portGroupSpecs" : [ {
              "name" : "string",
              "transportType" : "One among: VSAN, VMOTION, MANAGEMENT, PUBLIC, NFS"
            } ]
          } ]
        }
      } ]
    },
    "domainId" : "string"
  }
}

3.15.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.16. Get a Cluster

GET /v1/clusters/{id}

3.16.1. Parameters

Type Name Description Schema

Path

id
required

Cluster ID

string

3.16.2. Responses

HTTP Code Description Schema

200

Ok

Cluster

404

Cluster not found

Error

500

InternalServerError

Error

3.16.3. Consumes

  • application/json

3.16.4. Produces

  • application/json

3.16.5. Tags

  • Clusters

3.16.6. Security

Type Name

basic

basicAuth

3.16.7. Example HTTP request

Request path
/v1/clusters/string

3.16.8. Example HTTP response

Response 200
{
  "hosts" : [ {
    "id" : "string"
  } ],
  "id" : "string",
  "isStretched" : true,
  "name" : "string",
  "primaryDatastoreName" : "string",
  "primaryDatastoreType" : "One among: VSAN, NFS, FC"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.17. Delete a Cluster from a Domain if it has been previously initialized for deletion

DELETE /v1/clusters/{id}

3.17.1. Parameters

Type Name Description Schema

Path

id
required

Cluster ID

string

3.17.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Error

3.17.3. Consumes

  • application/json

3.17.4. Produces

  • application/json

3.17.5. Tags

  • Clusters

3.17.6. Security

Type Name

basic

basicAuth

3.17.7. Example HTTP request

Request path
/v1/clusters/string

3.17.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.18. Update a Cluster by adding or removing Hosts, Stretching a standard vSAN cluster, Unstretching a stretched cluster or by marking for deletion

PATCH /v1/clusters/{id}

3.18.1. Parameters

Type Name Description Schema

Path

id
required

Cluster ID

string

Body

clusterUpdateSpec
required

Cluster Update Data

ClusterUpdateSpec

3.18.2. Responses

HTTP Code Description Schema

200

Ok

Task

202

Accepted

Task

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Error

3.18.3. Consumes

  • application/json

3.18.4. Produces

  • application/json

3.18.5. Tags

  • Clusters

3.18.6. Security

Type Name

basic

basicAuth

3.18.7. Example HTTP request

Request path
/v1/clusters/string
Request body
{
  "clusterCompactionSpec" : {
    "force" : true,
    "hosts" : [ {
      "id" : "string"
    } ]
  },
  "clusterExpansionSpec" : {
    "hostSpecs" : [ {
      "hostNetworkSpec" : {
        "vmNics" : [ {
          "id" : "string",
          "moveToNvds" : true,
          "vdsName" : "string"
        } ]
      },
      "id" : "string",
      "licenseKey" : "string"
    } ]
  },
  "clusterStretchSpec" : {
    "hostSpecs" : [ {
      "hostNetworkSpec" : {
        "vmNics" : [ {
          "id" : "string",
          "moveToNvds" : true,
          "vdsName" : "string"
        } ]
      },
      "id" : "string",
      "licenseKey" : "string"
    } ],
    "witnessSpec" : {
      "fqdn" : "string",
      "vsanCidr" : "string",
      "vsanIp" : "string"
    }
  },
  "clusterUnstretchSpec" : { },
  "markForDeletion" : true
}

3.18.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.19. Validate the input spec for operations on a cluster

POST /v1/clusters/{id}/validations

3.19.1. Parameters

Type Name Description Schema

Path

id
required

Cluster ID

string

Body

clusterOperationSpecValidation
required

clusterOperationSpecValidation

ClusterOperationSpecValidation

3.19.2. Responses

HTTP Code Description Schema

200

Ok

Validation

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Error

3.19.3. Consumes

  • application/json

3.19.4. Produces

  • application/json

3.19.5. Tags

  • Clusters

3.19.6. Security

Type Name

basic

basicAuth

3.19.7. Example HTTP request

Request path
/v1/clusters/string/validations
Request body
{
  "clusterUpdateSpec" : {
    "clusterCompactionSpec" : {
      "force" : true,
      "hosts" : [ {
        "id" : "string"
      } ]
    },
    "clusterExpansionSpec" : {
      "hostSpecs" : [ {
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "string",
            "moveToNvds" : true,
            "vdsName" : "string"
          } ]
        },
        "id" : "string",
        "licenseKey" : "string"
      } ]
    },
    "clusterStretchSpec" : {
      "hostSpecs" : [ {
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "string",
            "moveToNvds" : true,
            "vdsName" : "string"
          } ]
        },
        "id" : "string",
        "licenseKey" : "string"
      } ],
      "witnessSpec" : {
        "fqdn" : "string",
        "vsanCidr" : "string",
        "vsanIp" : "string"
      }
    },
    "clusterUnstretchSpec" : { },
    "markForDeletion" : true
  }
}

3.19.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.20. Get the Credentials

GET /v1/credentials

3.20.1. Description

Get the Credentials

3.20.2. Parameters

Type Name Description Schema

Header

privileged-password
required

The privileged user password

string

Header

privileged-username
required

The privileged user name

string

Query

domainName
optional

The name of the domain to which the resource belongs to (may be null in case there is no associated domain)

string

Query

pageNumber
optional

The page number (must be a positive number), starts with 0

string

Query

pageSize
optional

The page size (must be a positive number, 0 as page size returns all records in one page

string

Query

resourceIp
optional

The IP address of the resource

string

Query

resourceName
optional

The name of the resource

string

Query

resourceType
optional

The type of the resource. One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP

string

3.20.3. Responses

HTTP Code Description Schema

200

OK

PageOfCredential

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

500

Internal Server Error

Error

3.20.4. Consumes

  • application/json

3.20.5. Produces

  • application/json

3.20.6. Tags

  • Credentials

3.20.7. Security

Type Name

basic

basicAuth

3.20.8. Example HTTP request

Request path
/v1/credentials
Request header
privileged-username:"string"

3.20.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "credentialType" : "One among: SSO, SSH, API, BASIC_AUTH, ADMINISTRATOR, FTP, JDBC, LDAP_DOMAIN_ADMIN, LDAP_READ_WRITE_ACCOUNT, VDI_ADMIN, SQL_SUPER_USER, SQL_DB_OWNER, SERVICE_ACCOUNT",
    "id" : "string",
    "password" : "string",
    "resource" : {
      "domainName" : "string",
      "resourceId" : "string",
      "resourceIp" : "string",
      "resourceName" : "string",
      "resourceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP",
      "serviceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP",
      "targetType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP"
    },
    "username" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 401
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 403
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.21. Update or rotate passwords for a list of resources

PATCH /v1/credentials

3.21.1. Description

Update passwords for given list of resources by supplying new passwords or rotate the passwords using system generated passwords

3.21.2. Parameters

Type Name Description Schema

Header

privileged-password
required

The privileged user password

string

Header

privileged-username
required

The privileged user name

string

Body

credentialsUpdateSpec
required

credentialsUpdateSpec

CredentialsUpdateSpec

3.21.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

500

Internal Server Error

Error

3.21.4. Consumes

  • application/json

3.21.5. Produces

  • application/json

3.21.6. Tags

  • Credentials

3.21.7. Security

Type Name

basic

basicAuth

3.21.8. Example HTTP request

Request path
/v1/credentials
Request header
privileged-username:"string"
Request body
{
  "elements" : [ {
    "credentials" : [ {
      "credentialType" : "One among: SSO, SSH, API, BASIC_AUTH, ADMINISTRATOR, FTP, JDBC, LDAP_DOMAIN_ADMIN, LDAP_READ_WRITE_ACCOUNT, VDI_ADMIN, SQL_SUPER_USER, SQL_DB_OWNER, SERVICE_ACCOUNT",
      "password" : "string",
      "username" : "string"
    } ],
    "resourceId" : "string",
    "resourceName" : "string",
    "resourceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP"
  } ],
  "operationType" : "One among: UPDATE, ROTATE"
}

3.21.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 401
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 403
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.22. Fetch the credentials tasks

GET /v1/credentials/tasks

3.22.1. Description

Fetch all credentials tasks in reverse chronological order

3.22.2. Parameters

Type Name Description Schema

Query

limit
optional

The number of elements to be returned in the result

integer (int32)

3.22.3. Responses

HTTP Code Description Schema

200

OK

PageOfCredentialsTask

400

Bad Request

Error

500

Internal Server Error

Error

3.22.4. Consumes

  • application/json

3.22.5. Produces

  • application/json

3.22.6. Tags

  • Credentials

3.22.7. Security

Type Name

basic

basicAuth

3.22.8. Example HTTP request

Request path
/v1/credentials/tasks

3.22.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "creationTimestamp" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "id" : "string",
    "name" : "string",
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
    "subTasks" : [ {
      "creationTimestamp" : "string",
      "credentialType" : "string",
      "dependentSubTasks" : [ {
        "creationTimestamp" : "string",
        "credentialType" : "string",
        "dependentSubTasks" : [ "..." ],
        "description" : "string",
        "entityType" : "string",
        "errors" : [ {
          "arguments" : [ "string" ],
          "causes" : [ {
            "message" : "string",
            "type" : "string"
          } ],
          "context" : {
            "string" : "string"
          },
          "errorCode" : "string",
          "message" : "string",
          "nestedErrors" : [ "..." ],
          "referenceToken" : "string",
          "remediationMessage" : "string"
        } ],
        "id" : "string",
        "name" : "string",
        "newPassword" : "string",
        "oldPassword" : "string",
        "resourceName" : "string",
        "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
        "username" : "string"
      } ],
      "description" : "string",
      "entityType" : "string",
      "errors" : [ "..." ],
      "id" : "string",
      "name" : "string",
      "newPassword" : "string",
      "oldPassword" : "string",
      "resourceName" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
      "username" : "string"
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.23. Fetch a credentials task

GET /v1/credentials/tasks/{id}

3.23.1. Description

Fetch credentials task for a given ID

3.23.2. Parameters

Type Name Description Schema

Path

id
required

The ID of the credentials task

string

3.23.3. Responses

HTTP Code Description Schema

200

OK

CredentialsTask

400

Bad Request

Error

500

Internal Server Error

Error

3.23.4. Consumes

  • application/json

3.23.5. Produces

  • application/json

3.23.6. Tags

  • Credentials

3.23.7. Security

Type Name

basic

basicAuth

3.23.8. Example HTTP request

Request path
/v1/credentials/tasks/string

3.23.9. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
  "subTasks" : [ {
    "creationTimestamp" : "string",
    "credentialType" : "string",
    "dependentSubTasks" : [ {
      "creationTimestamp" : "string",
      "credentialType" : "string",
      "dependentSubTasks" : [ "..." ],
      "description" : "string",
      "entityType" : "string",
      "errors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "id" : "string",
      "name" : "string",
      "newPassword" : "string",
      "oldPassword" : "string",
      "resourceName" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
      "username" : "string"
    } ],
    "description" : "string",
    "entityType" : "string",
    "errors" : [ "..." ],
    "id" : "string",
    "name" : "string",
    "newPassword" : "string",
    "oldPassword" : "string",
    "resourceName" : "string",
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
    "username" : "string"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.24. Cancel a failed credentials task for a given ID

DELETE /v1/credentials/tasks/{id}

3.24.1. Description

Cancel a failed credentials task for a given ID

3.24.2. Parameters

Type Name Description Schema

Path

id
required

Task ID of the failed operation required to be cancelled

string

3.24.3. Responses

HTTP Code Description Schema

200

OK

Task

204

No content

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.24.4. Consumes

  • application/json

3.24.5. Produces

  • application/json

3.24.6. Tags

  • Credentials

3.24.7. Security

Type Name

basic

basicAuth

3.24.8. Example HTTP request

Request path
/v1/credentials/tasks/string

3.24.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 204
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.25. Retry a failed credentials task for a given ID

PATCH /v1/credentials/tasks/{id}

3.25.1. Description

Retry a failed credentials task for a given ID

3.25.2. Parameters

Type Name Description Schema

Header

privileged-password
required

The privileged user password

string

Header

privileged-username
required

The privileged user name

string

Path

id
required

Task ID of the failed operation that is to be retried

string

Body

credentialsUpdateSpec
required

credentialsUpdateSpec

CredentialsUpdateSpec

3.25.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

500

Internal Server Error

Error

3.25.4. Consumes

  • application/json

3.25.5. Produces

  • application/json

3.25.6. Tags

  • Credentials

3.25.7. Security

Type Name

basic

basicAuth

3.25.8. Example HTTP request

Request path
/v1/credentials/tasks/string
Request header
privileged-username:"string"
Request body
{
  "elements" : [ {
    "credentials" : [ {
      "credentialType" : "One among: SSO, SSH, API, BASIC_AUTH, ADMINISTRATOR, FTP, JDBC, LDAP_DOMAIN_ADMIN, LDAP_READ_WRITE_ACCOUNT, VDI_ADMIN, SQL_SUPER_USER, SQL_DB_OWNER, SERVICE_ACCOUNT",
      "password" : "string",
      "username" : "string"
    } ],
    "resourceId" : "string",
    "resourceName" : "string",
    "resourceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP"
  } ],
  "operationType" : "One among: UPDATE, ROTATE"
}

3.25.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 401
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 403
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.26. Fetch resource credentials for a given credentials task ID

GET /v1/credentials/tasks/{id}/resource-credentials

3.26.1. Description

Fetch resource credentials for a given credentials task ID

3.26.2. Parameters

Type Name Description Schema

Path

id
required

The ID of the credentials task

string

3.26.3. Responses

HTTP Code Description Schema

200

OK

< ResourceCredentials > array

400

Bad Request

Error

500

Internal Server Error

Error

3.26.4. Consumes

  • application/json

3.26.5. Produces

  • application/json

3.26.6. Tags

  • Credentials

3.26.7. Security

Type Name

basic

basicAuth

3.26.8. Example HTTP request

Request path
/v1/credentials/tasks/string/resource-credentials

3.26.9. Example HTTP response

Response 200
[ {
  "credentials" : [ {
    "credentialType" : "One among: SSO, SSH, API, BASIC_AUTH, ADMINISTRATOR, FTP, JDBC, LDAP_DOMAIN_ADMIN, LDAP_READ_WRITE_ACCOUNT, VDI_ADMIN, SQL_SUPER_USER, SQL_DB_OWNER, SERVICE_ACCOUNT",
    "password" : "string",
    "username" : "string"
  } ],
  "resourceId" : "string",
  "resourceName" : "string",
  "resourceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP"
} ]
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.27. Fetch details of a subtask for a given credentials task ID and sub-task ID.

GET /v1/credentials/tasks/{id}/subtasks/{subtaskId}

3.27.1. Description

Fetch details of a subtask for a given credentials task ID and sub-task ID.

3.27.2. Parameters

Type Name Description Schema

Path

id
required

The ID of the credentials task

string

Path

subtaskId
required

The ID of the credentials sub-task

string

3.27.3. Responses

HTTP Code Description Schema

200

OK

CredentialsTask

400

Bad Request

Error

500

Internal Server Error

Error

3.27.4. Consumes

  • application/json

3.27.5. Produces

  • application/json

3.27.6. Tags

  • Credentials

3.27.7. Security

Type Name

basic

basicAuth

3.27.8. Example HTTP request

Request path
/v1/credentials/tasks/string/subtasks/string

3.27.9. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
  "subTasks" : [ {
    "creationTimestamp" : "string",
    "credentialType" : "string",
    "dependentSubTasks" : [ {
      "creationTimestamp" : "string",
      "credentialType" : "string",
      "dependentSubTasks" : [ "..." ],
      "description" : "string",
      "entityType" : "string",
      "errors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "id" : "string",
      "name" : "string",
      "newPassword" : "string",
      "oldPassword" : "string",
      "resourceName" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
      "username" : "string"
    } ],
    "description" : "string",
    "entityType" : "string",
    "errors" : [ "..." ],
    "id" : "string",
    "name" : "string",
    "newPassword" : "string",
    "oldPassword" : "string",
    "resourceName" : "string",
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, USER_CANCELLED, INCONSISTENT",
    "username" : "string"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.28. Get a Credential

GET /v1/credentials/{id}

3.28.1. Description

Get a Credential

3.28.2. Parameters

Type Name Description Schema

Header

privileged-password
required

The privileged user password

string

Header

privileged-username
required

The privileged user name

string

Path

id
required

The ID of the credential

string

3.28.3. Responses

HTTP Code Description Schema

200

OK

Credential

400

Bad Request

Error

401

Unauthorized

Error

403

Forbidden

Error

404

Not Found

Error

500

Internal Server Error

Error

3.28.4. Consumes

  • application/json

3.28.5. Produces

  • application/json

3.28.6. Tags

  • Credentials

3.28.7. Security

Type Name

basic

basicAuth

3.28.8. Example HTTP request

Request path
/v1/credentials/string
Request header
privileged-username:"string"

3.28.9. Example HTTP response

Response 200
{
  "credentialType" : "One among: SSO, SSH, API, BASIC_AUTH, ADMINISTRATOR, FTP, JDBC, LDAP_DOMAIN_ADMIN, LDAP_READ_WRITE_ACCOUNT, VDI_ADMIN, SQL_SUPER_USER, SQL_DB_OWNER, SERVICE_ACCOUNT",
  "id" : "string",
  "password" : "string",
  "resource" : {
    "domainName" : "string",
    "resourceId" : "string",
    "resourceIp" : "string",
    "resourceName" : "string",
    "resourceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP",
    "serviceType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP",
    "targetType" : "One among: ESXI, VCENTER, PSC, NSX_MANAGER, NSX_CONTROLLER, NSX_EDGE, NSXT_MANAGER, NSXT_EDGE, VRLI, VROPS, LCM_REPO, VRA, VRSLCM, DEPOT_USER, VXRAIL_MANAGER, AD, BACKUP"
  },
  "username" : "string"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 401
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 403
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.29. Create a Domain

POST /v1/domains

3.29.1. Parameters

Type Name Description Schema

Body

domainCreationSpec
required

Domain creation data

DomainCreationSpec

3.29.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

InternalServerError

Error

3.29.3. Consumes

  • application/json

3.29.4. Produces

  • application/json

3.29.5. Tags

  • Domains

3.29.6. Security

Type Name

basic

basicAuth

3.29.7. Example HTTP request

Request path
/v1/domains
Request body
{
  "computeSpec" : {
    "clusterSpecs" : [ {
      "advancedOptions" : {
        "evcMode" : "One among: INTEL_MEROM, INTEL_PENRYN, INTEL_NEALEM, INTEL_WESTMERE, INTEL_SANDYBRIDGE, INTEL_IVYBRIDGE, INTEL_HASWELL, INTEL_BROADWELL, INTEL_SKYLAKE, AMD_REV_E, AMD_REV_F, AMD_GREYHOUND_NO3DNOW, AMD_GREYHOUND, AMD_BULLDOZER, AMD_PILEDRIVER, AMD_STREAMROLLER, AMD_ZEN",
        "highAvailability" : {
          "enabled" : true
        }
      },
      "datastoreSpec" : {
        "nfsDatastoreSpecs" : [ {
          "datastoreName" : "string",
          "nasVolume" : {
            "path" : "string",
            "readOnly" : true,
            "serverName" : [ "string" ],
            "userTag" : "string"
          }
        } ],
        "vmfsDatastoreSpec" : {
          "fcSpec" : [ {
            "datastoreName" : "string"
          } ]
        },
        "vsanDatastoreSpec" : {
          "datastoreName" : "string",
          "dedupAndCompressionEnabled" : true,
          "failuresToTolerate" : 0,
          "licenseKey" : "string"
        }
      },
      "hostSpecs" : [ {
        "hostNetworkSpec" : {
          "vmNics" : [ {
            "id" : "string",
            "moveToNvds" : true,
            "vdsName" : "string"
          } ]
        },
        "id" : "string",
        "licenseKey" : "string"
      } ],
      "name" : "string",
      "networkSpec" : {
        "nsxClusterSpec" : {
          "nsxTClusterSpec" : {
            "geneveVlanId" : 0
          },
          "nsxVClusterSpec" : {
            "licenseKey" : "string",
            "vdsNameForVxlanConfig" : "string",
            "vlanId" : 0
          }
        },
        "vdsSpecs" : [ {
          "name" : "string",
          "niocBandwidthAllocationSpecs" : [ {
            "niocTrafficResourceAllocation" : {
              "limit" : 0,
              "reservation" : 0
            },
            "type" : "string"
          } ],
          "portGroupSpecs" : [ {
            "name" : "string",
            "transportType" : "One among: VSAN, VMOTION, MANAGEMENT, PUBLIC, NFS"
          } ]
        } ]
      }
    } ]
  },
  "domainName" : "string",
  "nsxTSpec" : {
    "licenseKey" : "string",
    "nsxManagerAdminPassword" : "string",
    "nsxManagerSpecs" : [ {
      "name" : "string",
      "networkDetailsSpec" : {
        "dnsName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string"
      }
    } ],
    "vip" : "string",
    "vipFqdn" : "string"
  },
  "nsxVSpec" : {
    "licenseKey" : "string",
    "nsxManagerAdminPassword" : "string",
    "nsxManagerEnablePassword" : "string",
    "nsxManagerSpec" : {
      "name" : "string",
      "networkDetailsSpec" : {
        "dnsName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string"
      }
    },
    "nsxVControllerSpec" : {
      "nsxControllerGateway" : "string",
      "nsxControllerIps" : [ "string" ],
      "nsxControllerPassword" : "string",
      "nsxControllerSubnetMask" : "string"
    }
  },
  "vcenterSpec" : {
    "datacenterName" : "string",
    "licenseKey" : "string",
    "name" : "string",
    "networkDetailsSpec" : {
      "dnsName" : "string",
      "gateway" : "string",
      "ipAddress" : "string",
      "subnetMask" : "string"
    },
    "rootPassword" : "string"
  }
}

3.29.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.30. Get the Domains

GET /v1/domains

3.30.1. Responses

HTTP Code Description Schema

200

Ok

Domain

400

Bad Request

Error

500

InternalServerError

Error

3.30.2. Consumes

  • application/json

3.30.3. Produces

  • application/json

3.30.4. Tags

  • Domains

3.30.5. Security

Type Name

basic

basicAuth

3.30.6. Example HTTP request

Request path
/v1/domains

3.30.7. Example HTTP response

Response 200
{
  "clusters" : [ {
    "id" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "vcenters" : [ {
    "fqdn" : "string",
    "id" : "string"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.31. Validate the input spec for domains operations

POST /v1/domains/validations

3.31.1. Parameters

Type Name Description Schema

Body

domainsOperationSpecValidation
required

Domains Operation Spec Validation

DomainsOperationSpecValidation

3.31.2. Responses

HTTP Code Description Schema

200

Ok

Validation

400

Bad Request

Error

500

InternalServerError

Error

3.31.3. Consumes

  • application/json

3.31.4. Produces

  • application/json

3.31.5. Tags

  • Domains

3.31.6. Security

Type Name

basic

basicAuth

3.31.7. Example HTTP request

Request path
/v1/domains/validations
Request body
{
  "domainCreationSpec" : {
    "computeSpec" : {
      "clusterSpecs" : [ {
        "advancedOptions" : {
          "evcMode" : "One among: INTEL_MEROM, INTEL_PENRYN, INTEL_NEALEM, INTEL_WESTMERE, INTEL_SANDYBRIDGE, INTEL_IVYBRIDGE, INTEL_HASWELL, INTEL_BROADWELL, INTEL_SKYLAKE, AMD_REV_E, AMD_REV_F, AMD_GREYHOUND_NO3DNOW, AMD_GREYHOUND, AMD_BULLDOZER, AMD_PILEDRIVER, AMD_STREAMROLLER, AMD_ZEN",
          "highAvailability" : {
            "enabled" : true
          }
        },
        "datastoreSpec" : {
          "nfsDatastoreSpecs" : [ {
            "datastoreName" : "string",
            "nasVolume" : {
              "path" : "string",
              "readOnly" : true,
              "serverName" : [ "string" ],
              "userTag" : "string"
            }
          } ],
          "vmfsDatastoreSpec" : {
            "fcSpec" : [ {
              "datastoreName" : "string"
            } ]
          },
          "vsanDatastoreSpec" : {
            "datastoreName" : "string",
            "dedupAndCompressionEnabled" : true,
            "failuresToTolerate" : 0,
            "licenseKey" : "string"
          }
        },
        "hostSpecs" : [ {
          "hostNetworkSpec" : {
            "vmNics" : [ {
              "id" : "string",
              "moveToNvds" : true,
              "vdsName" : "string"
            } ]
          },
          "id" : "string",
          "licenseKey" : "string"
        } ],
        "name" : "string",
        "networkSpec" : {
          "nsxClusterSpec" : {
            "nsxTClusterSpec" : {
              "geneveVlanId" : 0
            },
            "nsxVClusterSpec" : {
              "licenseKey" : "string",
              "vdsNameForVxlanConfig" : "string",
              "vlanId" : 0
            }
          },
          "vdsSpecs" : [ {
            "name" : "string",
            "niocBandwidthAllocationSpecs" : [ {
              "niocTrafficResourceAllocation" : {
                "limit" : 0,
                "reservation" : 0
              },
              "type" : "string"
            } ],
            "portGroupSpecs" : [ {
              "name" : "string",
              "transportType" : "One among: VSAN, VMOTION, MANAGEMENT, PUBLIC, NFS"
            } ]
          } ]
        }
      } ]
    },
    "domainName" : "string",
    "nsxTSpec" : {
      "licenseKey" : "string",
      "nsxManagerAdminPassword" : "string",
      "nsxManagerSpecs" : [ {
        "name" : "string",
        "networkDetailsSpec" : {
          "dnsName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string"
        }
      } ],
      "vip" : "string",
      "vipFqdn" : "string"
    },
    "nsxVSpec" : {
      "licenseKey" : "string",
      "nsxManagerAdminPassword" : "string",
      "nsxManagerEnablePassword" : "string",
      "nsxManagerSpec" : {
        "name" : "string",
        "networkDetailsSpec" : {
          "dnsName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string"
        }
      },
      "nsxVControllerSpec" : {
        "nsxControllerGateway" : "string",
        "nsxControllerIps" : [ "string" ],
        "nsxControllerPassword" : "string",
        "nsxControllerSubnetMask" : "string"
      }
    },
    "vcenterSpec" : {
      "datacenterName" : "string",
      "licenseKey" : "string",
      "name" : "string",
      "networkDetailsSpec" : {
        "dnsName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string"
      },
      "rootPassword" : "string"
    }
  }
}

3.31.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.32. Get latest generated certificate(s) in a domain.

GET /v1/domains/{domainName}/certificates

3.32.1. Description

Get latest generated certificate(s) in a domain.

3.32.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

3.32.3. Responses

HTTP Code Description Schema

200

OK

PageOfCertificate

404

Not Found

Error

500

Internal server error

Error

3.32.4. Consumes

  • application/json

3.32.5. Produces

  • application/json

3.32.6. Tags

  • Certificates

3.32.7. Security

Type Name

basic

basicAuth

3.32.8. Example HTTP request

Request path
/v1/domains/string/certificates

3.32.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "expirationStatus" : "One among: ACTIVE, ABOUT_TO_EXPIRE, EXPIRED",
    "getCertificateError" : "string",
    "isInstalled" : true,
    "issuedBy" : "string",
    "issuedTo" : "string",
    "keySize" : "One among: 2048, 3072, 4096",
    "notAfter" : "string",
    "notBefore" : "string",
    "numberOfDaysToExpire" : 0,
    "pemEncoded" : "string",
    "publicKey" : "string",
    "publicKeyAlgorithm" : "One among: RSA",
    "serialNumber" : "string",
    "signatureAlgorithm" : "string",
    "subject" : "string",
    "subjectAlternativeName" : [ "string" ],
    "thumbprint" : "string",
    "thumbprintAlgorithm" : "string",
    "version" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.33. Generate certificate(s) for the selected resource(s) in a domain

PUT /v1/domains/{domainName}/certificates

3.33.1. Description

Generate certificate(s) for the selected resource(s) in a domain. CA must be configured and CSR must be generated beforehand.

3.33.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

Body

certificateGenerationSpec
required

certificateGenerationSpec

CertificatesGenerationSpec

3.33.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad request

Error

404

Not Found

Error

500

Internal server error

Error

3.33.4. Consumes

  • application/json

3.33.5. Produces

  • application/json

3.33.6. Tags

  • Certificates

3.33.7. Security

Type Name

basic

basicAuth

3.33.8. Example HTTP request

Request path
/v1/domains/string/certificates
Request body
{
  "caType" : "One among: OpenSSL, Microsoft",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ]
}

3.33.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.34. Replace certificate(s) for the selected resource(s) in a domain

PATCH /v1/domains/{domainName}/certificates

3.34.1. Description

Replace certificate(s) for the selected resource(s) in a domain

3.34.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

Body

certificateOperationSpec
required

certificateOperationSpec

CertificateOperationSpec

3.34.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad request

Error

403

Forbidden

Error

404

Not Found

Error

500

Internal server error

Error

3.34.4. Consumes

  • application/json

3.34.5. Produces

  • application/json

3.34.6. Tags

  • Certificates

3.34.7. Security

Type Name

basic

basicAuth

3.34.8. Example HTTP request

Request path
/v1/domains/string/certificates
Request body
{
  "operationType" : "One among: INSTALL",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ]
}

3.34.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 403
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.35. Upload certificates to the certificate store

PUT /v1/domains/{domainName}/certificates/uploads

3.35.1. Description

Upload certificates to the certificate store

3.35.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

FormData

file
required

file

file

3.35.3. Responses

HTTP Code Description Schema

200

OK

object

400

Bad request.

Error

404

Not Found

Error

500

Internal server error

Error

3.35.4. Consumes

  • multipart/form-data

3.35.5. Produces

  • application/json

3.35.6. Tags

  • Certificates

3.35.7. Security

Type Name

basic

basicAuth

3.35.8. Example HTTP request

Request path
/v1/domains/string/certificates/uploads
Request formData
"file"

3.35.9. Example HTTP response

Response 200
{ }
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.36. Get available CSR(s) in json format

GET /v1/domains/{domainName}/csrs

3.36.1. Description

Get available CSR(s) in json format

3.36.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

3.36.3. Responses

HTTP Code Description Schema

200

OK

PageOfCsr

404

Not Found

Error

500

Internal server error

Error

3.36.4. Consumes

  • application/json

3.36.5. Produces

  • application/json

3.36.6. Tags

  • Certificates

3.36.7. Security

Type Name

basic

basicAuth

3.36.8. Example HTTP request

Request path
/v1/domains/string/csrs

3.36.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "csrEncodedContent" : "string",
    "resource" : {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    }
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.37. Generate CSR(s)

PUT /v1/domains/{domainName}/csrs

3.37.1. Description

Generate CSR(s) for the selected resource(s) in the domain

3.37.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

Body

csrsGenerationSpec
required

csrsGenerationSpec

CsrsGenerationSpec

3.37.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad request

Error

404

Not Found

Error

500

Internal server error

Error

3.37.4. Consumes

  • application/json

3.37.5. Produces

  • application/json

3.37.6. Tags

  • Certificates

3.37.7. Security

Type Name

basic

basicAuth

3.37.8. Example HTTP request

Request path
/v1/domains/string/csrs
Request body
{
  "csrGenerationSpec" : {
    "country" : "string",
    "email" : "string",
    "keyAlgorithm" : "One among: RSA",
    "keySize" : "One among: 2048, 3072, 4096",
    "locality" : "string",
    "organization" : "string",
    "organizationUnit" : "string",
    "state" : "string"
  },
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ]
}

3.37.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.38. Download available CSR(s) in tar.gz format

GET /v1/domains/{domainName}/csrs/downloads

3.38.1. Description

Download available CSR(s) in tar.gz format

3.38.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

3.38.3. Responses

HTTP Code Description Schema

200

OK

string (byte)

404

Not Found

Error

500

Internal server error

Error

3.38.4. Consumes

  • application/json

3.38.5. Produces

  • application/octet-stream

3.38.6. Tags

  • Certificates

3.38.7. Security

Type Name

basic

basicAuth

3.38.8. Example HTTP request

Request path
/v1/domains/string/csrs/downloads

3.38.9. Example HTTP response

Response 200
"Ynl0ZQ=="
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.39. View certificate of all the resources in a domain

GET /v1/domains/{domainName}/resource-certificates

3.39.1. Description

View detailed metadata about the certificate(s) of all the resources in a domain

3.39.2. Parameters

Type Name Description Schema

Path

domainName
required

The domain name

string

3.39.3. Responses

HTTP Code Description Schema

200

OK

PageOfCertificate

404

Not Found

Error

500

Internal server error

Error

3.39.4. Consumes

  • application/json

3.39.5. Produces

  • application/json

3.39.6. Tags

  • Certificates

3.39.7. Security

Type Name

basic

basicAuth

3.39.8. Example HTTP request

Request path
/v1/domains/string/resource-certificates

3.39.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "expirationStatus" : "One among: ACTIVE, ABOUT_TO_EXPIRE, EXPIRED",
    "getCertificateError" : "string",
    "isInstalled" : true,
    "issuedBy" : "string",
    "issuedTo" : "string",
    "keySize" : "One among: 2048, 3072, 4096",
    "notAfter" : "string",
    "notBefore" : "string",
    "numberOfDaysToExpire" : 0,
    "pemEncoded" : "string",
    "publicKey" : "string",
    "publicKeyAlgorithm" : "One among: RSA",
    "serialNumber" : "string",
    "signatureAlgorithm" : "string",
    "subject" : "string",
    "subjectAlternativeName" : [ "string" ],
    "thumbprint" : "string",
    "thumbprintAlgorithm" : "string",
    "version" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.40. Get a Domain

GET /v1/domains/{id}

3.40.1. Parameters

Type Name Description Schema

Path

id
required

Domain ID

string

3.40.2. Responses

HTTP Code Description Schema

200

Ok

Domain

404

Domain not found

Error

500

InternalServerError

Error

3.40.3. Consumes

  • application/json

3.40.4. Produces

  • application/json

3.40.5. Tags

  • Domains

3.40.6. Security

Type Name

basic

basicAuth

3.40.7. Example HTTP request

Request path
/v1/domains/string

3.40.8. Example HTTP response

Response 200
{
  "clusters" : [ {
    "id" : "string"
  } ],
  "id" : "string",
  "name" : "string",
  "vcenters" : [ {
    "fqdn" : "string",
    "id" : "string"
  } ]
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.41. Delete a Domain if it has been previously initialized for deletion

DELETE /v1/domains/{id}

3.41.1. Parameters

Type Name Description Schema

Path

id
required

Domain ID

string

3.41.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Error

3.41.3. Consumes

  • application/json

3.41.4. Produces

  • application/json

3.41.5. Tags

  • Domains

3.41.6. Security

Type Name

basic

basicAuth

3.41.7. Example HTTP request

Request path
/v1/domains/string

3.41.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.42. Update a Domain by marking for deletion

PATCH /v1/domains/{id}

3.42.1. Parameters

Type Name Description Schema

Path

id
required

Domain ID

string

Body

domainUpdateSpec
required

Domain Update Data

DomainUpdateSpec

3.42.2. Responses

HTTP Code Description Schema

200

Ok

Task

400

Bad Request

Error

404

Not Found

Error

500

InternalServerError

Error

3.42.3. Consumes

  • application/json

3.42.4. Produces

  • application/json

3.42.5. Tags

  • Domains

3.42.6. Security

Type Name

basic

basicAuth

3.42.7. Example HTTP request

Request path
/v1/domains/string
Request body
{
  "markForDeletion" : true
}

3.42.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.43. Get Endpoints of a Domain

GET /v1/domains/{id}/endpoints

3.43.1. Parameters

Type Name Description Schema

Path

id
required

Domain ID

string

3.43.2. Responses

HTTP Code Description Schema

200

Ok

Endpoint

404

Domain not found

Error

500

InternalServerError

Error

3.43.3. Consumes

  • application/json

3.43.4. Produces

  • application/json

3.43.5. Tags

  • Domains

3.43.6. Security

Type Name

basic

basicAuth

3.43.7. Example HTTP request

Request path
/v1/domains/string/endpoints

3.43.8. Example HTTP response

Response 200
{
  "type" : "One among: PSC, VCENTER, NSX_MANAGER, NSX_T_MANAGER, VRLI, VRA, VROPS, VRSLCM",
  "url" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.44. Deploy Horizon Suite

POST /v1/horizons

3.44.1. Parameters

Type Name Description Schema

Body

horizonSpec
required

Horizon specification

Horizon

3.44.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

409

Conflict

Error

500

Internal server error

Error

3.44.3. Consumes

  • application/json

3.44.4. Produces

  • application/json

3.44.5. Tags

  • HorizonManager

3.44.6. Security

Type Name

basic

basicAuth

3.44.7. Example HTTP request

Request path
/v1/horizons
Request body
{
  "appVolumesDetails" : {
    "adminGroupName" : "string",
    "appVolumes" : [ {
      "deployDetails" : {
        "computerName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "state" : "NEW"
    } ],
    "datastores" : [ {
      "id" : "string",
      "isPrimary" : true
    } ],
    "dbName" : "string",
    "lbFqdn" : "string",
    "license" : "string",
    "sqlId" : "string"
  },
  "horizon" : {
    "adminGroupName" : "string",
    "externalLbFqdn" : "string",
    "internalLbFqdn" : "string",
    "license" : "string",
    "pods" : [ {
      "composerServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "composerServiceAccount" : "string",
        "composerServicePassword" : "string",
        "dbName" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "internalDbPassword" : "string",
        "internalDbUsername" : "string",
        "sqlId" : "string",
        "state" : "NEW",
        "vcFqdn" : "string"
      } ],
      "connectionServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "eventDbName" : "string",
      "sqlId" : "string",
      "uagAppliances" : [ {
        "administratorPassword" : "string",
        "defaultGateway" : "string",
        "externalIpAddress" : "string",
        "externalSubnetMask" : "string",
        "internalIpAddress" : "string",
        "internalSubnetMask" : "string",
        "mgmtIpAddress" : "string",
        "mgmtSubnetMask" : "string",
        "state" : "NEW",
        "vmName" : "string"
      } ],
      "vcFqdns" : [ "string" ]
    } ],
    "uemDetails" : {
      "license" : "string",
      "uems" : [ {
        "configurationShare" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "configurationShareLocation" : "string",
          "dataDriveSizeGb" : 0,
          "gateway" : "string",
          "ipAddress" : "string",
          "profileArchiveShareLocation" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "profileArchiveShare" : "string",
        "state" : "NEW"
      } ]
    }
  },
  "id" : "string",
  "managementVcenters" : [ {
    "clusterName" : "string",
    "datacenterName" : "string",
    "datastoreName" : "string",
    "dmzPortgroup" : "string",
    "host" : "string",
    "interconnectPortgroup" : "string",
    "managementPortgroup" : "string",
    "nsx" : {
      "host" : "string",
      "password" : "string"
    },
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "uagManagementPortgroup" : "string",
    "username" : "string"
  } ],
  "name" : "string",
  "peripheralServices" : {
    "activeDirectory" : {
      "adminPassword" : "string",
      "adminUsername" : "string",
      "domainControllers" : [ {
        "fqdn" : "string",
        "ipAddress" : "string",
        "sslThumbprint" : "string",
        "state" : "NEW"
      } ],
      "fqdn" : "string",
      "netBiosName" : "string",
      "ouRwPassword" : "string",
      "ouRwUsername" : "string",
      "securedAD" : true,
      "vdiAdminPassword" : "string",
      "vdiAdminUsername" : "string",
      "vdiServerOu" : "string"
    },
    "installDetails" : {
      "appVolumesServerBinaryPath" : "string",
      "appVolumesServerVersion" : "string",
      "composerServerBinaryPath" : "string",
      "composerServerVersion" : "string",
      "connectionServerBinaryPath" : "string",
      "connectionServerVersion" : "string",
      "dotNet462BinaryPath" : "string",
      "imagePath" : "string",
      "ova" : {
        "administratorPassword" : "string",
        "administratorUsername" : "string"
      },
      "sqlExpressPath" : "string",
      "sqlExpressVersion" : "string",
      "uagOvaPath" : "string",
      "uagOvaVersion" : "string",
      "uemBinaryPath" : "string",
      "uemVersion" : "string",
      "updateKb2919355BinaryPath" : "string",
      "updateKb2919442BinaryPath" : "string"
    },
    "loadBalancers" : [ {
      "certificatePassword" : "string",
      "certificatePath" : "string",
      "deployDetails" : {
        "cliPassword" : "string",
        "gateway" : "string",
        "portgroup" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "ipAddress" : "string",
      "state" : "NEW"
    } ],
    "sqlConnections" : [ {
      "dbPassword" : "string",
      "dbUsername" : "string",
      "fqdn" : "string",
      "id" : "string",
      "sqlInstanceName" : "string",
      "sqlPort" : 0,
      "state" : "NEW"
    } ]
  },
  "resourceVcenters" : [ {
    "datacenters" : [ {
      "clusters" : [ {
        "hosts" : [ {
          "fqdn" : "string",
          "id" : "string",
          "password" : "string",
          "username" : "string"
        } ],
        "name" : "string"
      } ],
      "datastores" : [ {
        "hostIds" : [ "string" ],
        "id" : "string",
        "name" : "string"
      } ],
      "name" : "string"
    } ],
    "host" : "string",
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "state" : "NEW",
    "username" : "string"
  } ]
}

3.44.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.45. Get Horizon Suite configuration specs

GET /v1/horizons

3.45.1. Parameters

Type Name Description Schema

Query

id
optional

id

< string > array(multi)

3.45.2. Responses

HTTP Code Description Schema

200

OK

PageOfHorizon

400

Bad Request

Error

404

Not Found

Error

409

Conflict

Error

500

Internal server error

Error

3.45.3. Consumes

  • application/json

3.45.4. Produces

  • application/json

3.45.5. Tags

  • HorizonManager

3.45.6. Security

Type Name

basic

basicAuth

3.45.7. Example HTTP request

Request path
/v1/horizons

3.45.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "appVolumesDetails" : {
      "adminGroupName" : "string",
      "appVolumes" : [ {
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "datastores" : [ {
        "id" : "string",
        "isPrimary" : true
      } ],
      "dbName" : "string",
      "lbFqdn" : "string",
      "license" : "string",
      "sqlId" : "string"
    },
    "horizon" : {
      "adminGroupName" : "string",
      "externalLbFqdn" : "string",
      "internalLbFqdn" : "string",
      "license" : "string",
      "pods" : [ {
        "composerServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "composerServiceAccount" : "string",
          "composerServicePassword" : "string",
          "dbName" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "internalDbPassword" : "string",
          "internalDbUsername" : "string",
          "sqlId" : "string",
          "state" : "NEW",
          "vcFqdn" : "string"
        } ],
        "connectionServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "state" : "NEW"
        } ],
        "eventDbName" : "string",
        "sqlId" : "string",
        "uagAppliances" : [ {
          "administratorPassword" : "string",
          "defaultGateway" : "string",
          "externalIpAddress" : "string",
          "externalSubnetMask" : "string",
          "internalIpAddress" : "string",
          "internalSubnetMask" : "string",
          "mgmtIpAddress" : "string",
          "mgmtSubnetMask" : "string",
          "state" : "NEW",
          "vmName" : "string"
        } ],
        "vcFqdns" : [ "string" ]
      } ],
      "uemDetails" : {
        "license" : "string",
        "uems" : [ {
          "configurationShare" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "configurationShareLocation" : "string",
            "dataDriveSizeGb" : 0,
            "gateway" : "string",
            "ipAddress" : "string",
            "profileArchiveShareLocation" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "profileArchiveShare" : "string",
          "state" : "NEW"
        } ]
      }
    },
    "id" : "string",
    "managementVcenters" : [ {
      "clusterName" : "string",
      "datacenterName" : "string",
      "datastoreName" : "string",
      "dmzPortgroup" : "string",
      "host" : "string",
      "interconnectPortgroup" : "string",
      "managementPortgroup" : "string",
      "nsx" : {
        "host" : "string",
        "password" : "string"
      },
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "uagManagementPortgroup" : "string",
      "username" : "string"
    } ],
    "name" : "string",
    "peripheralServices" : {
      "activeDirectory" : {
        "adminPassword" : "string",
        "adminUsername" : "string",
        "domainControllers" : [ {
          "fqdn" : "string",
          "ipAddress" : "string",
          "sslThumbprint" : "string",
          "state" : "NEW"
        } ],
        "fqdn" : "string",
        "netBiosName" : "string",
        "ouRwPassword" : "string",
        "ouRwUsername" : "string",
        "securedAD" : true,
        "vdiAdminPassword" : "string",
        "vdiAdminUsername" : "string",
        "vdiServerOu" : "string"
      },
      "installDetails" : {
        "appVolumesServerBinaryPath" : "string",
        "appVolumesServerVersion" : "string",
        "composerServerBinaryPath" : "string",
        "composerServerVersion" : "string",
        "connectionServerBinaryPath" : "string",
        "connectionServerVersion" : "string",
        "dotNet462BinaryPath" : "string",
        "imagePath" : "string",
        "ova" : {
          "administratorPassword" : "string",
          "administratorUsername" : "string"
        },
        "sqlExpressPath" : "string",
        "sqlExpressVersion" : "string",
        "uagOvaPath" : "string",
        "uagOvaVersion" : "string",
        "uemBinaryPath" : "string",
        "uemVersion" : "string",
        "updateKb2919355BinaryPath" : "string",
        "updateKb2919442BinaryPath" : "string"
      },
      "loadBalancers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "cliPassword" : "string",
          "gateway" : "string",
          "portgroup" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "ipAddress" : "string",
        "state" : "NEW"
      } ],
      "sqlConnections" : [ {
        "dbPassword" : "string",
        "dbUsername" : "string",
        "fqdn" : "string",
        "id" : "string",
        "sqlInstanceName" : "string",
        "sqlPort" : 0,
        "state" : "NEW"
      } ]
    },
    "resourceVcenters" : [ {
      "datacenters" : [ {
        "clusters" : [ {
          "hosts" : [ {
            "fqdn" : "string",
            "id" : "string",
            "password" : "string",
            "username" : "string"
          } ],
          "name" : "string"
        } ],
        "datastores" : [ {
          "hostIds" : [ "string" ],
          "id" : "string",
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "host" : "string",
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "state" : "NEW",
      "username" : "string"
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.46. Validates Horizon configuration

POST /v1/horizons/validations

3.46.1. Parameters

Type Name Description Schema

Body

horizonValidationSpec
required

Validation specification

HorizonValidationSpec

3.46.2. Responses

HTTP Code Description Schema

200

OK

Validation

202

Accepted

Validation

400

Bad Request

Error

409

Conflict

Error

500

Internal server error

Error

3.46.3. Consumes

  • application/json

3.46.4. Produces

  • application/json

3.46.5. Tags

  • HorizonManager

3.46.6. Security

Type Name

basic

basicAuth

3.46.7. Example HTTP request

Request path
/v1/horizons/validations
Request body
{
  "horizon" : {
    "appVolumesDetails" : {
      "adminGroupName" : "string",
      "appVolumes" : [ {
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "datastores" : [ {
        "id" : "string",
        "isPrimary" : true
      } ],
      "dbName" : "string",
      "lbFqdn" : "string",
      "license" : "string",
      "sqlId" : "string"
    },
    "horizon" : {
      "adminGroupName" : "string",
      "externalLbFqdn" : "string",
      "internalLbFqdn" : "string",
      "license" : "string",
      "pods" : [ {
        "composerServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "composerServiceAccount" : "string",
          "composerServicePassword" : "string",
          "dbName" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "internalDbPassword" : "string",
          "internalDbUsername" : "string",
          "sqlId" : "string",
          "state" : "NEW",
          "vcFqdn" : "string"
        } ],
        "connectionServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "state" : "NEW"
        } ],
        "eventDbName" : "string",
        "sqlId" : "string",
        "uagAppliances" : [ {
          "administratorPassword" : "string",
          "defaultGateway" : "string",
          "externalIpAddress" : "string",
          "externalSubnetMask" : "string",
          "internalIpAddress" : "string",
          "internalSubnetMask" : "string",
          "mgmtIpAddress" : "string",
          "mgmtSubnetMask" : "string",
          "state" : "NEW",
          "vmName" : "string"
        } ],
        "vcFqdns" : [ "string" ]
      } ],
      "uemDetails" : {
        "license" : "string",
        "uems" : [ {
          "configurationShare" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "configurationShareLocation" : "string",
            "dataDriveSizeGb" : 0,
            "gateway" : "string",
            "ipAddress" : "string",
            "profileArchiveShareLocation" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "profileArchiveShare" : "string",
          "state" : "NEW"
        } ]
      }
    },
    "id" : "string",
    "managementVcenters" : [ {
      "clusterName" : "string",
      "datacenterName" : "string",
      "datastoreName" : "string",
      "dmzPortgroup" : "string",
      "host" : "string",
      "interconnectPortgroup" : "string",
      "managementPortgroup" : "string",
      "nsx" : {
        "host" : "string",
        "password" : "string"
      },
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "uagManagementPortgroup" : "string",
      "username" : "string"
    } ],
    "name" : "string",
    "peripheralServices" : {
      "activeDirectory" : {
        "adminPassword" : "string",
        "adminUsername" : "string",
        "domainControllers" : [ {
          "fqdn" : "string",
          "ipAddress" : "string",
          "sslThumbprint" : "string",
          "state" : "NEW"
        } ],
        "fqdn" : "string",
        "netBiosName" : "string",
        "ouRwPassword" : "string",
        "ouRwUsername" : "string",
        "securedAD" : true,
        "vdiAdminPassword" : "string",
        "vdiAdminUsername" : "string",
        "vdiServerOu" : "string"
      },
      "installDetails" : {
        "appVolumesServerBinaryPath" : "string",
        "appVolumesServerVersion" : "string",
        "composerServerBinaryPath" : "string",
        "composerServerVersion" : "string",
        "connectionServerBinaryPath" : "string",
        "connectionServerVersion" : "string",
        "dotNet462BinaryPath" : "string",
        "imagePath" : "string",
        "ova" : {
          "administratorPassword" : "string",
          "administratorUsername" : "string"
        },
        "sqlExpressPath" : "string",
        "sqlExpressVersion" : "string",
        "uagOvaPath" : "string",
        "uagOvaVersion" : "string",
        "uemBinaryPath" : "string",
        "uemVersion" : "string",
        "updateKb2919355BinaryPath" : "string",
        "updateKb2919442BinaryPath" : "string"
      },
      "loadBalancers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "cliPassword" : "string",
          "gateway" : "string",
          "portgroup" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "ipAddress" : "string",
        "state" : "NEW"
      } ],
      "sqlConnections" : [ {
        "dbPassword" : "string",
        "dbUsername" : "string",
        "fqdn" : "string",
        "id" : "string",
        "sqlInstanceName" : "string",
        "sqlPort" : 0,
        "state" : "NEW"
      } ]
    },
    "resourceVcenters" : [ {
      "datacenters" : [ {
        "clusters" : [ {
          "hosts" : [ {
            "fqdn" : "string",
            "id" : "string",
            "password" : "string",
            "username" : "string"
          } ],
          "name" : "string"
        } ],
        "datastores" : [ {
          "hostIds" : [ "string" ],
          "id" : "string",
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "host" : "string",
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "state" : "NEW",
      "username" : "string"
    } ]
  },
  "horizonValidationOperation" : {
    "type" : "PRE_VALIDATION_CREATION, PRE_VALIDATION_EXPANSION"
  }
}

3.46.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.47. Get Horizon Validation

GET /v1/horizons/validations/{id}

3.47.1. Parameters

Type Name Description Schema

Path

id
required

Validation ID

string

3.47.2. Responses

HTTP Code Description Schema

200

Accepted

Validation

400

Bad Request

Error

404

Not Found

Error

409

Conflict

Error

500

Internal server error

Error

3.47.3. Consumes

  • application/json

3.47.4. Produces

  • application/json

3.47.5. Tags

  • HorizonManager

3.47.6. Security

Type Name

basic

basicAuth

3.47.7. Example HTTP request

Request path
/v1/horizons/validations/string

3.47.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.48. Get Horizon Suite configuration spec

GET /v1/horizons/{id}

3.48.1. Parameters

Type Name Description Schema

Path

id
required

Horizon ID

string

3.48.2. Responses

HTTP Code Description Schema

200

OK

Horizon

400

Bad Request

Error

404

Not Found

Error

409

Conflict

Error

500

Internal server error

Error

3.48.3. Consumes

  • application/json

3.48.4. Produces

  • application/json

3.48.5. Tags

  • HorizonManager

3.48.6. Security

Type Name

basic

basicAuth

3.48.7. Example HTTP request

Request path
/v1/horizons/string

3.48.8. Example HTTP response

Response 200
{
  "appVolumesDetails" : {
    "adminGroupName" : "string",
    "appVolumes" : [ {
      "deployDetails" : {
        "computerName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "state" : "NEW"
    } ],
    "datastores" : [ {
      "id" : "string",
      "isPrimary" : true
    } ],
    "dbName" : "string",
    "lbFqdn" : "string",
    "license" : "string",
    "sqlId" : "string"
  },
  "horizon" : {
    "adminGroupName" : "string",
    "externalLbFqdn" : "string",
    "internalLbFqdn" : "string",
    "license" : "string",
    "pods" : [ {
      "composerServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "composerServiceAccount" : "string",
        "composerServicePassword" : "string",
        "dbName" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "internalDbPassword" : "string",
        "internalDbUsername" : "string",
        "sqlId" : "string",
        "state" : "NEW",
        "vcFqdn" : "string"
      } ],
      "connectionServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "eventDbName" : "string",
      "sqlId" : "string",
      "uagAppliances" : [ {
        "administratorPassword" : "string",
        "defaultGateway" : "string",
        "externalIpAddress" : "string",
        "externalSubnetMask" : "string",
        "internalIpAddress" : "string",
        "internalSubnetMask" : "string",
        "mgmtIpAddress" : "string",
        "mgmtSubnetMask" : "string",
        "state" : "NEW",
        "vmName" : "string"
      } ],
      "vcFqdns" : [ "string" ]
    } ],
    "uemDetails" : {
      "license" : "string",
      "uems" : [ {
        "configurationShare" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "configurationShareLocation" : "string",
          "dataDriveSizeGb" : 0,
          "gateway" : "string",
          "ipAddress" : "string",
          "profileArchiveShareLocation" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "profileArchiveShare" : "string",
        "state" : "NEW"
      } ]
    }
  },
  "id" : "string",
  "managementVcenters" : [ {
    "clusterName" : "string",
    "datacenterName" : "string",
    "datastoreName" : "string",
    "dmzPortgroup" : "string",
    "host" : "string",
    "interconnectPortgroup" : "string",
    "managementPortgroup" : "string",
    "nsx" : {
      "host" : "string",
      "password" : "string"
    },
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "uagManagementPortgroup" : "string",
    "username" : "string"
  } ],
  "name" : "string",
  "peripheralServices" : {
    "activeDirectory" : {
      "adminPassword" : "string",
      "adminUsername" : "string",
      "domainControllers" : [ {
        "fqdn" : "string",
        "ipAddress" : "string",
        "sslThumbprint" : "string",
        "state" : "NEW"
      } ],
      "fqdn" : "string",
      "netBiosName" : "string",
      "ouRwPassword" : "string",
      "ouRwUsername" : "string",
      "securedAD" : true,
      "vdiAdminPassword" : "string",
      "vdiAdminUsername" : "string",
      "vdiServerOu" : "string"
    },
    "installDetails" : {
      "appVolumesServerBinaryPath" : "string",
      "appVolumesServerVersion" : "string",
      "composerServerBinaryPath" : "string",
      "composerServerVersion" : "string",
      "connectionServerBinaryPath" : "string",
      "connectionServerVersion" : "string",
      "dotNet462BinaryPath" : "string",
      "imagePath" : "string",
      "ova" : {
        "administratorPassword" : "string",
        "administratorUsername" : "string"
      },
      "sqlExpressPath" : "string",
      "sqlExpressVersion" : "string",
      "uagOvaPath" : "string",
      "uagOvaVersion" : "string",
      "uemBinaryPath" : "string",
      "uemVersion" : "string",
      "updateKb2919355BinaryPath" : "string",
      "updateKb2919442BinaryPath" : "string"
    },
    "loadBalancers" : [ {
      "certificatePassword" : "string",
      "certificatePath" : "string",
      "deployDetails" : {
        "cliPassword" : "string",
        "gateway" : "string",
        "portgroup" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "ipAddress" : "string",
      "state" : "NEW"
    } ],
    "sqlConnections" : [ {
      "dbPassword" : "string",
      "dbUsername" : "string",
      "fqdn" : "string",
      "id" : "string",
      "sqlInstanceName" : "string",
      "sqlPort" : 0,
      "state" : "NEW"
    } ]
  },
  "resourceVcenters" : [ {
    "datacenters" : [ {
      "clusters" : [ {
        "hosts" : [ {
          "fqdn" : "string",
          "id" : "string",
          "password" : "string",
          "username" : "string"
        } ],
        "name" : "string"
      } ],
      "datastores" : [ {
        "hostIds" : [ "string" ],
        "id" : "string",
        "name" : "string"
      } ],
      "name" : "string"
    } ],
    "host" : "string",
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "state" : "NEW",
    "username" : "string"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.49. Expand Horizon Suite

PUT /v1/horizons/{id}

3.49.1. Parameters

Type Name Description Schema

Path

id
required

Horizon ID

string

Body

horizonSpec
required

Horizon expand specification

Horizon

3.49.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

409

Conflict

Error

500

Internal server error

Error

3.49.3. Consumes

  • application/json

3.49.4. Produces

  • application/json

3.49.5. Tags

  • HorizonManager

3.49.6. Security

Type Name

basic

basicAuth

3.49.7. Example HTTP request

Request path
/v1/horizons/string
Request body
{
  "appVolumesDetails" : {
    "adminGroupName" : "string",
    "appVolumes" : [ {
      "deployDetails" : {
        "computerName" : "string",
        "gateway" : "string",
        "ipAddress" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "state" : "NEW"
    } ],
    "datastores" : [ {
      "id" : "string",
      "isPrimary" : true
    } ],
    "dbName" : "string",
    "lbFqdn" : "string",
    "license" : "string",
    "sqlId" : "string"
  },
  "horizon" : {
    "adminGroupName" : "string",
    "externalLbFqdn" : "string",
    "internalLbFqdn" : "string",
    "license" : "string",
    "pods" : [ {
      "composerServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "composerServiceAccount" : "string",
        "composerServicePassword" : "string",
        "dbName" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "internalDbPassword" : "string",
        "internalDbUsername" : "string",
        "sqlId" : "string",
        "state" : "NEW",
        "vcFqdn" : "string"
      } ],
      "connectionServers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "eventDbName" : "string",
      "sqlId" : "string",
      "uagAppliances" : [ {
        "administratorPassword" : "string",
        "defaultGateway" : "string",
        "externalIpAddress" : "string",
        "externalSubnetMask" : "string",
        "internalIpAddress" : "string",
        "internalSubnetMask" : "string",
        "mgmtIpAddress" : "string",
        "mgmtSubnetMask" : "string",
        "state" : "NEW",
        "vmName" : "string"
      } ],
      "vcFqdns" : [ "string" ]
    } ],
    "uemDetails" : {
      "license" : "string",
      "uems" : [ {
        "configurationShare" : "string",
        "deployDetails" : {
          "computerName" : "string",
          "configurationShareLocation" : "string",
          "dataDriveSizeGb" : 0,
          "gateway" : "string",
          "ipAddress" : "string",
          "profileArchiveShareLocation" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "profileArchiveShare" : "string",
        "state" : "NEW"
      } ]
    }
  },
  "id" : "string",
  "managementVcenters" : [ {
    "clusterName" : "string",
    "datacenterName" : "string",
    "datastoreName" : "string",
    "dmzPortgroup" : "string",
    "host" : "string",
    "interconnectPortgroup" : "string",
    "managementPortgroup" : "string",
    "nsx" : {
      "host" : "string",
      "password" : "string"
    },
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "uagManagementPortgroup" : "string",
    "username" : "string"
  } ],
  "name" : "string",
  "peripheralServices" : {
    "activeDirectory" : {
      "adminPassword" : "string",
      "adminUsername" : "string",
      "domainControllers" : [ {
        "fqdn" : "string",
        "ipAddress" : "string",
        "sslThumbprint" : "string",
        "state" : "NEW"
      } ],
      "fqdn" : "string",
      "netBiosName" : "string",
      "ouRwPassword" : "string",
      "ouRwUsername" : "string",
      "securedAD" : true,
      "vdiAdminPassword" : "string",
      "vdiAdminUsername" : "string",
      "vdiServerOu" : "string"
    },
    "installDetails" : {
      "appVolumesServerBinaryPath" : "string",
      "appVolumesServerVersion" : "string",
      "composerServerBinaryPath" : "string",
      "composerServerVersion" : "string",
      "connectionServerBinaryPath" : "string",
      "connectionServerVersion" : "string",
      "dotNet462BinaryPath" : "string",
      "imagePath" : "string",
      "ova" : {
        "administratorPassword" : "string",
        "administratorUsername" : "string"
      },
      "sqlExpressPath" : "string",
      "sqlExpressVersion" : "string",
      "uagOvaPath" : "string",
      "uagOvaVersion" : "string",
      "uemBinaryPath" : "string",
      "uemVersion" : "string",
      "updateKb2919355BinaryPath" : "string",
      "updateKb2919442BinaryPath" : "string"
    },
    "loadBalancers" : [ {
      "certificatePassword" : "string",
      "certificatePath" : "string",
      "deployDetails" : {
        "cliPassword" : "string",
        "gateway" : "string",
        "portgroup" : "string",
        "subnetMask" : "string",
        "vmName" : "string"
      },
      "fqdn" : "string",
      "ipAddress" : "string",
      "state" : "NEW"
    } ],
    "sqlConnections" : [ {
      "dbPassword" : "string",
      "dbUsername" : "string",
      "fqdn" : "string",
      "id" : "string",
      "sqlInstanceName" : "string",
      "sqlPort" : 0,
      "state" : "NEW"
    } ]
  },
  "resourceVcenters" : [ {
    "datacenters" : [ {
      "clusters" : [ {
        "hosts" : [ {
          "fqdn" : "string",
          "id" : "string",
          "password" : "string",
          "username" : "string"
        } ],
        "name" : "string"
      } ],
      "datastores" : [ {
        "hostIds" : [ "string" ],
        "id" : "string",
        "name" : "string"
      } ],
      "name" : "string"
    } ],
    "host" : "string",
    "password" : "string",
    "psc" : {
      "host" : "string"
    },
    "state" : "NEW",
    "username" : "string"
  } ]
}

3.49.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.50. Delete Horizon Suite

DELETE /v1/horizons/{id}

3.50.1. Parameters

Type Name Description Schema

Path

id
required

Horizon ID

string

3.50.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

404

Not Found

Error

409

Conflict

Error

500

Internal server error

Error

3.50.3. Consumes

  • application/json

3.50.4. Produces

  • application/json

3.50.5. Tags

  • HorizonManager

3.50.6. Security

Type Name

basic

basicAuth

3.50.7. Example HTTP request

Request path
/v1/horizons/string

3.50.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.51. Initialize Horizon Suite deletion

PATCH /v1/horizons/{id}

3.51.1. Parameters

Type Name Description Schema

Path

id
required

Horizon ID

string

Body

horizonUpdateSpec
required

horizonUpdateSpec

HorizonUpdateSpec

3.51.2. Responses

HTTP Code Description Schema

200

Ok

No Content

400

Bad Request

Error

409

Conflict

Error

500

Internal server error

Error

3.51.3. Consumes

  • application/json

3.51.4. Produces

  • application/json

3.51.5. Tags

  • HorizonManager

3.51.6. Security

Type Name

basic

basicAuth

3.51.7. Example HTTP request

Request path
/v1/horizons/string
Request body
{
  "markForDeletion" : true
}

3.51.8. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.52. Validates Horizon configuration

POST /v1/horizons/{id}/validations

3.52.1. Parameters

Type Name Description Schema

Path

id
required

Horizon ID

string

Body

horizonValidationSpec
required

Validation specification

HorizonValidationSpec

3.52.2. Responses

HTTP Code Description Schema

200

OK

Validation

202

Accepted

Validation

400

Bad Request

Error

409

Conflict

Error

500

Internal server error

Error

3.52.3. Consumes

  • application/json

3.52.4. Produces

  • application/json

3.52.5. Tags

  • HorizonManager

3.52.6. Security

Type Name

basic

basicAuth

3.52.7. Example HTTP request

Request path
/v1/horizons/string/validations
Request body
{
  "horizon" : {
    "appVolumesDetails" : {
      "adminGroupName" : "string",
      "appVolumes" : [ {
        "deployDetails" : {
          "computerName" : "string",
          "gateway" : "string",
          "ipAddress" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "state" : "NEW"
      } ],
      "datastores" : [ {
        "id" : "string",
        "isPrimary" : true
      } ],
      "dbName" : "string",
      "lbFqdn" : "string",
      "license" : "string",
      "sqlId" : "string"
    },
    "horizon" : {
      "adminGroupName" : "string",
      "externalLbFqdn" : "string",
      "internalLbFqdn" : "string",
      "license" : "string",
      "pods" : [ {
        "composerServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "composerServiceAccount" : "string",
          "composerServicePassword" : "string",
          "dbName" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "internalDbPassword" : "string",
          "internalDbUsername" : "string",
          "sqlId" : "string",
          "state" : "NEW",
          "vcFqdn" : "string"
        } ],
        "connectionServers" : [ {
          "certificatePassword" : "string",
          "certificatePath" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "gateway" : "string",
            "ipAddress" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "state" : "NEW"
        } ],
        "eventDbName" : "string",
        "sqlId" : "string",
        "uagAppliances" : [ {
          "administratorPassword" : "string",
          "defaultGateway" : "string",
          "externalIpAddress" : "string",
          "externalSubnetMask" : "string",
          "internalIpAddress" : "string",
          "internalSubnetMask" : "string",
          "mgmtIpAddress" : "string",
          "mgmtSubnetMask" : "string",
          "state" : "NEW",
          "vmName" : "string"
        } ],
        "vcFqdns" : [ "string" ]
      } ],
      "uemDetails" : {
        "license" : "string",
        "uems" : [ {
          "configurationShare" : "string",
          "deployDetails" : {
            "computerName" : "string",
            "configurationShareLocation" : "string",
            "dataDriveSizeGb" : 0,
            "gateway" : "string",
            "ipAddress" : "string",
            "profileArchiveShareLocation" : "string",
            "subnetMask" : "string",
            "vmName" : "string"
          },
          "fqdn" : "string",
          "profileArchiveShare" : "string",
          "state" : "NEW"
        } ]
      }
    },
    "id" : "string",
    "managementVcenters" : [ {
      "clusterName" : "string",
      "datacenterName" : "string",
      "datastoreName" : "string",
      "dmzPortgroup" : "string",
      "host" : "string",
      "interconnectPortgroup" : "string",
      "managementPortgroup" : "string",
      "nsx" : {
        "host" : "string",
        "password" : "string"
      },
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "uagManagementPortgroup" : "string",
      "username" : "string"
    } ],
    "name" : "string",
    "peripheralServices" : {
      "activeDirectory" : {
        "adminPassword" : "string",
        "adminUsername" : "string",
        "domainControllers" : [ {
          "fqdn" : "string",
          "ipAddress" : "string",
          "sslThumbprint" : "string",
          "state" : "NEW"
        } ],
        "fqdn" : "string",
        "netBiosName" : "string",
        "ouRwPassword" : "string",
        "ouRwUsername" : "string",
        "securedAD" : true,
        "vdiAdminPassword" : "string",
        "vdiAdminUsername" : "string",
        "vdiServerOu" : "string"
      },
      "installDetails" : {
        "appVolumesServerBinaryPath" : "string",
        "appVolumesServerVersion" : "string",
        "composerServerBinaryPath" : "string",
        "composerServerVersion" : "string",
        "connectionServerBinaryPath" : "string",
        "connectionServerVersion" : "string",
        "dotNet462BinaryPath" : "string",
        "imagePath" : "string",
        "ova" : {
          "administratorPassword" : "string",
          "administratorUsername" : "string"
        },
        "sqlExpressPath" : "string",
        "sqlExpressVersion" : "string",
        "uagOvaPath" : "string",
        "uagOvaVersion" : "string",
        "uemBinaryPath" : "string",
        "uemVersion" : "string",
        "updateKb2919355BinaryPath" : "string",
        "updateKb2919442BinaryPath" : "string"
      },
      "loadBalancers" : [ {
        "certificatePassword" : "string",
        "certificatePath" : "string",
        "deployDetails" : {
          "cliPassword" : "string",
          "gateway" : "string",
          "portgroup" : "string",
          "subnetMask" : "string",
          "vmName" : "string"
        },
        "fqdn" : "string",
        "ipAddress" : "string",
        "state" : "NEW"
      } ],
      "sqlConnections" : [ {
        "dbPassword" : "string",
        "dbUsername" : "string",
        "fqdn" : "string",
        "id" : "string",
        "sqlInstanceName" : "string",
        "sqlPort" : 0,
        "state" : "NEW"
      } ]
    },
    "resourceVcenters" : [ {
      "datacenters" : [ {
        "clusters" : [ {
          "hosts" : [ {
            "fqdn" : "string",
            "id" : "string",
            "password" : "string",
            "username" : "string"
          } ],
          "name" : "string"
        } ],
        "datastores" : [ {
          "hostIds" : [ "string" ],
          "id" : "string",
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "host" : "string",
      "password" : "string",
      "psc" : {
        "host" : "string"
      },
      "state" : "NEW",
      "username" : "string"
    } ]
  },
  "horizonValidationOperation" : {
    "type" : "PRE_VALIDATION_CREATION, PRE_VALIDATION_EXPANSION"
  }
}

3.52.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.53. Commission the Hosts

POST /v1/hosts

3.53.1. Parameters

Type Name Description Schema

Body

hostCommissionSpecs
required

hostCommissionSpecs

< HostCommissionSpec > array

3.53.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

Error

3.53.3. Consumes

  • application/json

3.53.4. Produces

  • application/json

3.53.5. Tags

  • Hosts

3.53.6. Security

Type Name

basic

basicAuth

3.53.7. Example HTTP request

Request path
/v1/hosts
Request body
[ {
  "fqdn" : "string",
  "networkPoolId" : "string",
  "networkPoolName" : "string",
  "password" : "string",
  "storageType" : "One among: VSAN, NFS, VMFS_FC",
  "username" : "string"
} ]

3.53.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.54. Get the Hosts

GET /v1/hosts

3.54.1. Parameters

Type Name Description Schema

Query

clusterId
optional

ID of the Cluster

string

Query

datastoreName
optional

Name of the datastore

string

Query

domainId
optional

ID of the Domain

string

Query

networkpoolId
optional

ID of the Network pool

string

Query

status
optional

Status of the Host.One among: ASSIGNED, UNASSIGNED_USEABLE, UNASSIGNED_UNUSEABLE

string

Query

storageType
optional

Type of the Storage.VMFS_FC

string

3.54.2. Responses

HTTP Code Description Schema

200

Ok

PageOfHost

400

Bad Request

Error

500

Internal Server Error

Error

3.54.3. Consumes

  • application/json

3.54.4. Produces

  • application/json

3.54.5. Tags

  • Hosts

3.54.6. Security

Type Name

basic

basicAuth

3.54.7. Example HTTP request

Request path
/v1/hosts

3.54.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleRepoDatastore" : "string",
    "cluster" : {
      "id" : "string"
    },
    "compatibleStorageType" : "string",
    "cpu" : {
      "cores" : 0,
      "cpuCores" : [ {
        "frequencyMHz" : 0.0,
        "manufacturer" : "string",
        "model" : "string"
      } ],
      "frequencyMHz" : 0.0,
      "usedFrequencyMHz" : 0.0
    },
    "domain" : {
      "id" : "string"
    },
    "esxiVersion" : "string",
    "fqdn" : "string",
    "hardwareModel" : "string",
    "hardwareVendor" : "string",
    "hybrid" : true,
    "id" : "string",
    "ipAddresses" : [ {
      "ipAddress" : "string",
      "type" : "One among: MANAGEMENT, VSAN, VMOTION, NFS"
    } ],
    "memory" : {
      "totalCapacityMB" : 0.0,
      "usedCapacityMB" : 0.0
    },
    "networkpool" : {
      "id" : "string",
      "name" : "string"
    },
    "physicalNics" : [ {
      "deviceName" : "string",
      "macAddress" : "string"
    } ],
    "status" : "One among: ASSIGNED, UNASSIGNED_USEABLE, UNASSIGNED_UNUSEABLE",
    "storage" : {
      "disks" : [ {
        "capacityMB" : 0.0,
        "diskType" : "One among: HDD, FLASH",
        "manufacturer" : "string",
        "model" : "string"
      } ],
      "totalCapacityMB" : 0.0,
      "usedCapacityMB" : 0.0
    }
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.55. Decommission the Hosts

DELETE /v1/hosts

3.55.1. Parameters

Type Name Description Schema

Body

hostDecommissionSpecs
required

hostDecommissionSpecs

< HostDecommissionSpec > array

3.55.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

No Content

3.55.3. Consumes

  • application/json

3.55.4. Produces

  • application/json

3.55.5. Tags

  • Hosts

3.55.6. Security

Type Name

basic

basicAuth

3.55.7. Example HTTP request

Request path
/v1/hosts
Request body
[ {
  "fqdn" : "string"
} ]

3.55.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.56. Get all criteria

GET /v1/hosts/criteria

3.56.1. Responses

HTTP Code Description Schema

200

Ok

PageOfHostCriterion

3.56.2. Consumes

  • application/json

3.56.3. Produces

  • application/json

3.56.4. Tags

  • Hosts

3.56.5. Security

Type Name

basic

basicAuth

3.56.6. Example HTTP request

Request path
/v1/hosts/criteria

3.56.7. Example HTTP response

Response 200
{
  "elements" : [ {
    "arguments" : {
      "string" : "string"
    },
    "description" : "string",
    "name" : "One among: HOST_COMPATIBLE_WITH_CLUSTER_USING_PNICS"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}

3.57. Get a criterion

GET /v1/hosts/criteria/{name}

3.57.1. Parameters

Type Name Description Schema

Path

name
required

name

string

3.57.2. Responses

HTTP Code Description Schema

200

Ok

HostCriterion

404

Criterion Not Found

Error

3.57.3. Consumes

  • application/json

3.57.4. Produces

  • application/json

3.57.5. Tags

  • Hosts

3.57.6. Security

Type Name

basic

basicAuth

3.57.7. Example HTTP request

Request path
/v1/hosts/criteria/string

3.57.8. Example HTTP response

Response 200
{
  "arguments" : {
    "string" : "string"
  },
  "description" : "string",
  "name" : "One among: HOST_COMPATIBLE_WITH_CLUSTER_USING_PNICS"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.58. Post a query

POST /v1/hosts/queries

3.58.1. Parameters

Type Name Description Schema

Body

hostCriterion
required

hostCriterion

HostCriterion

3.58.2. Responses

HTTP Code Description Schema

200

Ok

HostQueryResponse

400

Bad Request

Error

500

Internal Server Error

Error

3.58.3. Consumes

  • application/json

3.58.4. Produces

  • application/json

3.58.5. Tags

  • Hosts

3.58.6. Security

Type Name

basic

basicAuth

3.58.7. Example HTTP request

Request path
/v1/hosts/queries
Request body
{
  "arguments" : {
    "string" : "string"
  },
  "description" : "string",
  "name" : "One among: HOST_COMPATIBLE_WITH_CLUSTER_USING_PNICS"
}

3.58.8. Example HTTP response

Response 200
{
  "queryInfo" : {
    "completed" : true,
    "failure" : true,
    "processing" : true,
    "status" : "string"
  },
  "result" : {
    "elements" : [ {
      "bundleRepoDatastore" : "string",
      "cluster" : {
        "id" : "string"
      },
      "compatibleStorageType" : "string",
      "cpu" : {
        "cores" : 0,
        "cpuCores" : [ {
          "frequencyMHz" : 0.0,
          "manufacturer" : "string",
          "model" : "string"
        } ],
        "frequencyMHz" : 0.0,
        "usedFrequencyMHz" : 0.0
      },
      "domain" : {
        "id" : "string"
      },
      "esxiVersion" : "string",
      "fqdn" : "string",
      "hardwareModel" : "string",
      "hardwareVendor" : "string",
      "hybrid" : true,
      "id" : "string",
      "ipAddresses" : [ {
        "ipAddress" : "string",
        "type" : "One among: MANAGEMENT, VSAN, VMOTION, NFS"
      } ],
      "memory" : {
        "totalCapacityMB" : 0.0,
        "usedCapacityMB" : 0.0
      },
      "networkpool" : {
        "id" : "string",
        "name" : "string"
      },
      "physicalNics" : [ {
        "deviceName" : "string",
        "macAddress" : "string"
      } ],
      "status" : "One among: ASSIGNED, UNASSIGNED_USEABLE, UNASSIGNED_UNUSEABLE",
      "storage" : {
        "disks" : [ {
          "capacityMB" : 0.0,
          "diskType" : "One among: HDD, FLASH",
          "manufacturer" : "string",
          "model" : "string"
        } ],
        "totalCapacityMB" : 0.0,
        "usedCapacityMB" : 0.0
      }
    } ],
    "pageMetadata" : {
      "pageNumber" : 0,
      "pageSize" : 0,
      "totalElements" : 0,
      "totalPages" : 0
    }
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.59. Get query response

GET /v1/hosts/queries/{id}

3.59.1. Parameters

Type Name Description Schema

Path

id
required

id

string

3.59.2. Responses

HTTP Code Description Schema

200

Ok

HostQueryResponse

400

Bad Request

Error

404

Query Not Found

Error

500

Internal Server Error

Error

3.59.3. Consumes

  • application/json

3.59.4. Produces

  • application/json

3.59.5. Tags

  • Hosts

3.59.6. Security

Type Name

basic

basicAuth

3.59.7. Example HTTP request

Request path
/v1/hosts/queries/string

3.59.8. Example HTTP response

Response 200
{
  "queryInfo" : {
    "completed" : true,
    "failure" : true,
    "processing" : true,
    "status" : "string"
  },
  "result" : {
    "elements" : [ {
      "bundleRepoDatastore" : "string",
      "cluster" : {
        "id" : "string"
      },
      "compatibleStorageType" : "string",
      "cpu" : {
        "cores" : 0,
        "cpuCores" : [ {
          "frequencyMHz" : 0.0,
          "manufacturer" : "string",
          "model" : "string"
        } ],
        "frequencyMHz" : 0.0,
        "usedFrequencyMHz" : 0.0
      },
      "domain" : {
        "id" : "string"
      },
      "esxiVersion" : "string",
      "fqdn" : "string",
      "hardwareModel" : "string",
      "hardwareVendor" : "string",
      "hybrid" : true,
      "id" : "string",
      "ipAddresses" : [ {
        "ipAddress" : "string",
        "type" : "One among: MANAGEMENT, VSAN, VMOTION, NFS"
      } ],
      "memory" : {
        "totalCapacityMB" : 0.0,
        "usedCapacityMB" : 0.0
      },
      "networkpool" : {
        "id" : "string",
        "name" : "string"
      },
      "physicalNics" : [ {
        "deviceName" : "string",
        "macAddress" : "string"
      } ],
      "status" : "One among: ASSIGNED, UNASSIGNED_USEABLE, UNASSIGNED_UNUSEABLE",
      "storage" : {
        "disks" : [ {
          "capacityMB" : 0.0,
          "diskType" : "One among: HDD, FLASH",
          "manufacturer" : "string",
          "model" : "string"
        } ],
        "totalCapacityMB" : 0.0,
        "usedCapacityMB" : 0.0
      }
    } ],
    "pageMetadata" : {
      "pageNumber" : 0,
      "pageSize" : 0,
      "totalElements" : 0,
      "totalPages" : 0
    }
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.60. Validate the input spec for hosts operations

POST /v1/hosts/validations

3.60.1. Parameters

Type Name Description Schema

Body

hostsOperationSpecValidation
required

hostsOperationSpecValidation

HostsOperationSpecValidation

3.60.2. Responses

HTTP Code Description Schema

200

OK

Validation

202

Accepted

Validation

400

Bad Request

Error

500

Internal server error

No Content

3.60.3. Consumes

  • application/json

3.60.4. Produces

  • application/json

3.60.5. Tags

  • Hosts

3.60.6. Security

Type Name

basic

basicAuth

3.60.7. Example HTTP request

Request path
/v1/hosts/validations
Request body
{
  "hostCommissionSpecs" : [ {
    "fqdn" : "string",
    "networkPoolId" : "string",
    "networkPoolName" : "string",
    "password" : "string",
    "storageType" : "One among: VSAN, NFS, VMFS_FC",
    "username" : "string"
  } ]
}

3.60.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.61. Get the status of the validation of the input specification to commission the Hosts

GET /v1/hosts/validations/{id}

3.61.1. Parameters

Type Name Description Schema

Path

id
required

The validation ID

string

3.61.2. Responses

HTTP Code Description Schema

200

OK

Validation

400

Bad Request

Error

500

Internal server error

No Content

3.61.3. Consumes

  • application/json

3.61.4. Produces

  • application/json

3.61.5. Tags

  • Hosts

3.61.6. Security

Type Name

basic

basicAuth

3.61.7. Example HTTP request

Request path
/v1/hosts/validations/string

3.61.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.62. Get a Host

GET /v1/hosts/{id}

3.62.1. Parameters

Type Name Description Schema

Path

id
required

id

string

3.62.2. Responses

HTTP Code Description Schema

200

Ok

Host

400

Bad Request

Error

404

Host Not Found

Error

500

Internal Server Error

Error

3.62.3. Consumes

  • application/json

3.62.4. Produces

  • application/json

3.62.5. Tags

  • Hosts

3.62.6. Security

Type Name

basic

basicAuth

3.62.7. Example HTTP request

Request path
/v1/hosts/string

3.62.8. Example HTTP response

Response 200
{
  "bundleRepoDatastore" : "string",
  "cluster" : {
    "id" : "string"
  },
  "compatibleStorageType" : "string",
  "cpu" : {
    "cores" : 0,
    "cpuCores" : [ {
      "frequencyMHz" : 0.0,
      "manufacturer" : "string",
      "model" : "string"
    } ],
    "frequencyMHz" : 0.0,
    "usedFrequencyMHz" : 0.0
  },
  "domain" : {
    "id" : "string"
  },
  "esxiVersion" : "string",
  "fqdn" : "string",
  "hardwareModel" : "string",
  "hardwareVendor" : "string",
  "hybrid" : true,
  "id" : "string",
  "ipAddresses" : [ {
    "ipAddress" : "string",
    "type" : "One among: MANAGEMENT, VSAN, VMOTION, NFS"
  } ],
  "memory" : {
    "totalCapacityMB" : 0.0,
    "usedCapacityMB" : 0.0
  },
  "networkpool" : {
    "id" : "string",
    "name" : "string"
  },
  "physicalNics" : [ {
    "deviceName" : "string",
    "macAddress" : "string"
  } ],
  "status" : "One among: ASSIGNED, UNASSIGNED_USEABLE, UNASSIGNED_UNUSEABLE",
  "storage" : {
    "disks" : [ {
      "capacityMB" : 0.0,
      "diskType" : "One among: HDD, FLASH",
      "manufacturer" : "string",
      "model" : "string"
    } ],
    "totalCapacityMB" : 0.0,
    "usedCapacityMB" : 0.0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.63. Add a License Key

POST /v1/license-keys

3.63.1. Parameters

Type Name Description Schema

Body

licenseKey
required

License key with other attributes

LicenseKey

3.63.2. Responses

HTTP Code Description Schema

200

OK

LicenseKey

201

Created

LicenseKey

500

Internal server error

Error

3.63.3. Consumes

  • application/json

3.63.4. Produces

  • */*

3.63.5. Tags

  • License Keys

3.63.6. Security

Type Name

basic

basicAuth

3.63.7. Example HTTP request

Request path
/v1/license-keys
Request body
{
  "description" : "string",
  "id" : "string",
  "isUnlimited" : true,
  "key" : "XX0XX-XX0XX-XX0XX-XX0XX-XX0XX",
  "licenseKeyUsage" : {
    "licenseUnit" : "One among: CPUPACKAGE, INSTANCE, VMS, CCU, PLU, DESKTOPVM, SERVERVM, VM, SERVER, CORES, CONCURRENTUSER, NAMEDUSER",
    "remaining" : 0,
    "total" : 0,
    "used" : 0
  },
  "licenseKeyValidity" : {
    "expiryDate" : "string",
    "licenseKeyStatus" : "One among: EXPIRED, ACTIVE, NEVER_EXPIRES"
  },
  "productType" : "One among: VCENTER, VSAN, NSXV, SDDC_MANAGER, ESXI, VRA, VROPS, NSXT"
}

3.63.8. Example HTTP response

Response 200
{
  "description" : "string",
  "id" : "string",
  "isUnlimited" : true,
  "key" : "XX0XX-XX0XX-XX0XX-XX0XX-XX0XX",
  "licenseKeyUsage" : {
    "licenseUnit" : "One among: CPUPACKAGE, INSTANCE, VMS, CCU, PLU, DESKTOPVM, SERVERVM, VM, SERVER, CORES, CONCURRENTUSER, NAMEDUSER",
    "remaining" : 0,
    "total" : 0,
    "used" : 0
  },
  "licenseKeyValidity" : {
    "expiryDate" : "string",
    "licenseKeyStatus" : "One among: EXPIRED, ACTIVE, NEVER_EXPIRES"
  },
  "productType" : "One among: VCENTER, VSAN, NSXV, SDDC_MANAGER, ESXI, VRA, VROPS, NSXT"
}
Response 201
{
  "description" : "string",
  "id" : "string",
  "isUnlimited" : true,
  "key" : "XX0XX-XX0XX-XX0XX-XX0XX-XX0XX",
  "licenseKeyUsage" : {
    "licenseUnit" : "One among: CPUPACKAGE, INSTANCE, VMS, CCU, PLU, DESKTOPVM, SERVERVM, VM, SERVER, CORES, CONCURRENTUSER, NAMEDUSER",
    "remaining" : 0,
    "total" : 0,
    "used" : 0
  },
  "licenseKeyValidity" : {
    "expiryDate" : "string",
    "licenseKeyStatus" : "One among: EXPIRED, ACTIVE, NEVER_EXPIRES"
  },
  "productType" : "One among: VCENTER, VSAN, NSXV, SDDC_MANAGER, ESXI, VRA, VROPS, NSXT"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.64. Get the License Keys

GET /v1/license-keys

3.64.1. Parameters

Type Name Description Schema

Query

licenseKeyStatus
optional

Status of a License Key

< string > array(multi)

Query

productType
optional

Type of a Product

< string > array(multi)

3.64.2. Responses

HTTP Code Description Schema

200

Successful

PageOfLicenseKey

500

Internal server error

Error

3.64.3. Consumes

  • application/json

3.64.4. Produces

  • */*

3.64.5. Tags

  • License Keys

3.64.6. Security

Type Name

basic

basicAuth

3.64.7. Example HTTP request

Request path
/v1/license-keys

3.64.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "description" : "string",
    "id" : "string",
    "isUnlimited" : true,
    "key" : "XX0XX-XX0XX-XX0XX-XX0XX-XX0XX",
    "licenseKeyUsage" : {
      "licenseUnit" : "One among: CPUPACKAGE, INSTANCE, VMS, CCU, PLU, DESKTOPVM, SERVERVM, VM, SERVER, CORES, CONCURRENTUSER, NAMEDUSER",
      "remaining" : 0,
      "total" : 0,
      "used" : 0
    },
    "licenseKeyValidity" : {
      "expiryDate" : "string",
      "licenseKeyStatus" : "One among: EXPIRED, ACTIVE, NEVER_EXPIRES"
    },
    "productType" : "One among: VCENTER, VSAN, NSXV, SDDC_MANAGER, ESXI, VRA, VROPS, NSXT"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.65. Get a License Key by key

GET /v1/license-keys/{key}

3.65.1. Parameters

Type Name Description Schema

Path

key
required

The 29 alpha numeric character license key with hyphens

string

3.65.2. Responses

HTTP Code Description Schema

200

Successful

LicenseKey

404

License key not found

Error

500

Internal server error

Error

3.65.3. Consumes

  • application/json

3.65.4. Produces

  • */*

3.65.5. Tags

  • License Keys

3.65.6. Security

Type Name

basic

basicAuth

3.65.7. Example HTTP request

Request path
/v1/license-keys/string

3.65.8. Example HTTP response

Response 200
{
  "description" : "string",
  "id" : "string",
  "isUnlimited" : true,
  "key" : "XX0XX-XX0XX-XX0XX-XX0XX-XX0XX",
  "licenseKeyUsage" : {
    "licenseUnit" : "One among: CPUPACKAGE, INSTANCE, VMS, CCU, PLU, DESKTOPVM, SERVERVM, VM, SERVER, CORES, CONCURRENTUSER, NAMEDUSER",
    "remaining" : 0,
    "total" : 0,
    "used" : 0
  },
  "licenseKeyValidity" : {
    "expiryDate" : "string",
    "licenseKeyStatus" : "One among: EXPIRED, ACTIVE, NEVER_EXPIRES"
  },
  "productType" : "One among: VCENTER, VSAN, NSXV, SDDC_MANAGER, ESXI, VRA, VROPS, NSXT"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.66. Delete a License Key

DELETE /v1/license-keys/{key}

3.66.1. Parameters

Type Name Description Schema

Path

key
required

The 29 alpha numeric character license key with hyphens

string

3.66.2. Responses

HTTP Code Description Schema

200

OK

No Content

204

No content

No Content

404

License key not found

No Content

500

Internal server error

Error

3.66.3. Consumes

  • application/json

3.66.4. Produces

  • */*

3.66.5. Tags

  • License Keys

3.66.6. Security

Type Name

basic

basicAuth

3.66.7. Example HTTP request

Request path
/v1/license-keys/string

3.66.8. Example HTTP response

Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.67. Create a Network Pool

POST /v1/network-pools

3.67.1. Description

Create a Network Pool

3.67.2. Parameters

Type Name Description Schema

Body

networkPool
required

Specification of the Network pool to create

NetworkPool

3.67.3. Responses

HTTP Code Description Schema

200

OK

NetworkPool

201

The newly created network pool

NetworkPool

400

Errors due to network pool validations failures

Error

500

Unexpected error

Error

3.67.4. Consumes

  • application/json

3.67.5. Produces

  • application/json

3.67.6. Tags

  • Network Pools

3.67.7. Security

Type Name

basic

basicAuth

3.67.8. Example HTTP request

Request path
/v1/network-pools
Request body
{
  "id" : "string",
  "name" : "string",
  "networks" : [ {
    "freeIps" : [ "string" ],
    "gateway" : "string",
    "id" : "string",
    "ipPools" : [ {
      "end" : "string",
      "start" : "string"
    } ],
    "mask" : "string",
    "mtu" : 0,
    "subnet" : "string",
    "type" : "string",
    "usedIps" : [ "string" ],
    "vlanId" : 0
  } ]
}

3.67.9. Example HTTP response

Response 200
{
  "id" : "string",
  "name" : "string",
  "networks" : [ {
    "freeIps" : [ "string" ],
    "gateway" : "string",
    "id" : "string",
    "ipPools" : [ {
      "end" : "string",
      "start" : "string"
    } ],
    "mask" : "string",
    "mtu" : 0,
    "subnet" : "string",
    "type" : "string",
    "usedIps" : [ "string" ],
    "vlanId" : 0
  } ]
}
Response 201
{
  "id" : "string",
  "name" : "string",
  "networks" : [ {
    "freeIps" : [ "string" ],
    "gateway" : "string",
    "id" : "string",
    "ipPools" : [ {
      "end" : "string",
      "start" : "string"
    } ],
    "mask" : "string",
    "mtu" : 0,
    "subnet" : "string",
    "type" : "string",
    "usedIps" : [ "string" ],
    "vlanId" : 0
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.68. Get the Network Pools

GET /v1/network-pools

3.68.1. Description

Get the Network Pools

3.68.2. Responses

HTTP Code Description Schema

200

Referenced network pool

PageOfNetworkPool

404

Referenced network pool not found

Error

500

Unexpected error

Error

3.68.3. Consumes

  • application/json

3.68.4. Produces

  • application/json

3.68.5. Tags

  • Network Pools

3.68.6. Security

Type Name

basic

basicAuth

3.68.7. Example HTTP request

Request path
/v1/network-pools

3.68.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "id" : "string",
    "name" : "string",
    "networks" : [ {
      "freeIps" : [ "string" ],
      "gateway" : "string",
      "id" : "string",
      "ipPools" : [ {
        "end" : "string",
        "start" : "string"
      } ],
      "mask" : "string",
      "mtu" : 0,
      "subnet" : "string",
      "type" : "string",
      "usedIps" : [ "string" ],
      "vlanId" : 0
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.69. Get a Network Pool

GET /v1/network-pools/{id}

3.69.1. Description

Get a Network Pool by ID, if it exists

3.69.2. Parameters

Type Name Description Schema

Path

id
required

ID of the network pool to fetch

string

3.69.3. Responses

HTTP Code Description Schema

200

Referenced network pool

NetworkPool

404

Referenced network pool not found

Error

500

Unexpected error

Error

3.69.4. Consumes

  • application/json

3.69.5. Produces

  • application/json

3.69.6. Tags

  • Network Pools

3.69.7. Security

Type Name

basic

basicAuth

3.69.8. Example HTTP request

Request path
/v1/network-pools/string

3.69.9. Example HTTP response

Response 200
{
  "id" : "string",
  "name" : "string",
  "networks" : [ {
    "freeIps" : [ "string" ],
    "gateway" : "string",
    "id" : "string",
    "ipPools" : [ {
      "end" : "string",
      "start" : "string"
    } ],
    "mask" : "string",
    "mtu" : 0,
    "subnet" : "string",
    "type" : "string",
    "usedIps" : [ "string" ],
    "vlanId" : 0
  } ]
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.70. Delete a Network Pool

DELETE /v1/network-pools/{id}

3.70.1. Description

Delete the Network Pool by the ID, if it exists and is unused

3.70.2. Parameters

Type Name Description Schema

Path

id
required

ID of the network pool

string

3.70.3. Responses

HTTP Code Description Schema

200

OK

No Content

204

The specification of the deleted network pool

No Content

400

Hosts are still associated with NetworkPool

Error

404

Referenced network pool not found

Error

500

Unexpected error

Error

3.70.4. Consumes

  • application/json

3.70.5. Produces

  • */*

3.70.6. Tags

  • Network Pools

3.70.7. Security

Type Name

basic

basicAuth

3.70.8. Example HTTP request

Request path
/v1/network-pools/string

3.70.9. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.71. Get the Networks of a Network Pool

GET /v1/network-pools/{id}/networks

3.71.1. Description

Get the Networks that are part of a Network Pool

3.71.2. Parameters

Type Name Description Schema

Path

id
required

ID for Networkpool to get the networks from

string

3.71.3. Responses

HTTP Code Description Schema

200

Networks for referenced network pool

PageOfNetwork

404

Network pool not found

Error

500

Unexpected error

Error

3.71.4. Consumes

  • application/json

3.71.5. Produces

  • application/json

3.71.6. Tags

  • Network Pools

3.71.7. Security

Type Name

basic

basicAuth

3.71.8. Example HTTP request

Request path
/v1/network-pools/string/networks

3.71.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "freeIps" : [ "string" ],
    "gateway" : "string",
    "id" : "string",
    "ipPools" : [ {
      "end" : "string",
      "start" : "string"
    } ],
    "mask" : "string",
    "mtu" : 0,
    "subnet" : "string",
    "type" : "string",
    "usedIps" : [ "string" ],
    "vlanId" : 0
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.72. Get a Network of a Network Pool

GET /v1/network-pools/{id}/networks/{networkId}

3.72.1. Description

Get a Network that is part of a Network Pool

3.72.2. Parameters

Type Name Description Schema

Path

id
required

Id of the Network pool

string

Path

networkId
required

Id of the Network

string

3.72.3. Responses

HTTP Code Description Schema

200

Network for referenced network pool

Network

404

Networkpool not found

Error

500

Unexpected error

Error

3.72.4. Consumes

  • application/json

3.72.5. Produces

  • application/json

3.72.6. Tags

  • Network Pools

3.72.7. Security

Type Name

basic

basicAuth

3.72.8. Example HTTP request

Request path
/v1/network-pools/string/networks/string

3.72.9. Example HTTP response

Response 200
{
  "freeIps" : [ "string" ],
  "gateway" : "string",
  "id" : "string",
  "ipPools" : [ {
    "end" : "string",
    "start" : "string"
  } ],
  "mask" : "string",
  "mtu" : 0,
  "subnet" : "string",
  "type" : "string",
  "usedIps" : [ "string" ],
  "vlanId" : 0
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.73. Add an IP Pool to a Network of a Network Pool

POST /v1/network-pools/{id}/networks/{networkId}/ip-pools

3.73.1. Description

Add an IP Pool to a Network of a Network Pool

3.73.2. Parameters

Type Name Description Schema

Path

id
required

Id of the networkpoolk

string

Path

networkId
required

Id of the network

string

Body

ipPool
required

ipPool

IpPool

3.73.3. Responses

HTTP Code Description Schema

200

Add the IP Pool associated with a Network of a Network Pool

Network

400

IP range validation failed error

Error

404

Either Network Pool ID or Network ID not found

Error

500

Unexpected error

Error

3.73.4. Consumes

  • application/json

3.73.5. Produces

  • application/json

3.73.6. Tags

  • Network Pools

3.73.7. Security

Type Name

basic

basicAuth

3.73.8. Example HTTP request

Request path
/v1/network-pools/string/networks/string/ip-pools
Request body
{
  "end" : "string",
  "start" : "string"
}

3.73.9. Example HTTP response

Response 200
{
  "freeIps" : [ "string" ],
  "gateway" : "string",
  "id" : "string",
  "ipPools" : [ {
    "end" : "string",
    "start" : "string"
  } ],
  "mask" : "string",
  "mtu" : 0,
  "subnet" : "string",
  "type" : "string",
  "usedIps" : [ "string" ],
  "vlanId" : 0
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.74. Delete an IP Pool from a Network of a Network Pool

DELETE /v1/network-pools/{id}/networks/{networkId}/ip-pools

3.74.1. Description

Delete an IP Pool from a Network of a Network Pool

3.74.2. Parameters

Type Name Description Schema

Path

id
required

ID of the networkpool

string

Path

networkId
required

ID of the network

string

Body

ipPool
required

ipPool

IpPool

3.74.3. Responses

HTTP Code Description Schema

200

Delete the IP Pool associated with a Network of a Network Pool

No Content

400

Errors due to network/networkpool validations failures

Error

404

Either network or Network pool not found

Error

500

Unexpected error

Error

3.74.4. Consumes

  • application/json

3.74.5. Produces

  • application/json

3.74.6. Tags

  • Network Pools

3.74.7. Security

Type Name

basic

basicAuth

3.74.8. Example HTTP request

Request path
/v1/network-pools/string/networks/string/ip-pools
Request body
{
  "end" : "string",
  "start" : "string"
}

3.74.9. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.75. Get NsxManagers

GET /v1/nsx-managers

3.75.1. Parameters

Type Name Description Schema

Query

domainId
optional

ID of the domain

string

3.75.2. Responses

HTTP Code Description Schema

200

Ok

NsxManager

400

Bad Request

Error

500

InternalServerError

Error

3.75.3. Consumes

  • application/json

3.75.4. Produces

  • application/json

3.75.5. Tags

  • NsxManagers

3.75.6. Security

Type Name

basic

basicAuth

3.75.7. Example HTTP request

Request path
/v1/nsx-managers

3.75.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "vcenter" : {
    "fqdn" : "string",
    "id" : "string"
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.76. Get a NsxManager

GET /v1/nsx-managers/{id}

3.76.1. Parameters

Type Name Description Schema

Path

id
required

NsxManager ID

string

3.76.2. Responses

HTTP Code Description Schema

200

Ok

NsxManager

404

NsxManager not found

Error

500

InternalServerError

Error

3.76.3. Consumes

  • application/json

3.76.4. Produces

  • application/json

3.76.5. Tags

  • NsxManagers

3.76.6. Security

Type Name

basic

basicAuth

3.76.7. Example HTTP request

Request path
/v1/nsx-managers/string

3.76.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "vcenter" : {
    "fqdn" : "string",
    "id" : "string"
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.77. Get the NSX-T clusters

GET /v1/nsxt-clusters

3.77.1. Responses

HTTP Code Description Schema

200

Ok

NsxTCluster

400

Bad Request

Error

500

InternalServerError

Error

3.77.2. Consumes

  • application/json

3.77.3. Produces

  • application/json

3.77.4. Tags

  • NSX-T Clusters

3.77.5. Security

Type Name

basic

basicAuth

3.77.6. Example HTTP request

Request path
/v1/nsxt-clusters

3.77.7. Example HTTP response

Response 200
{
  "domains" : [ {
    "id" : "string"
  } ],
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "nodes" : [ {
    "fqdn" : "string",
    "vmName" : "string"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.78. Get a NSX-T cluster

GET /v1/nsxt-clusters/{id}

3.78.1. Parameters

Type Name Description Schema

Path

id
required

NSX-T cluster ID

string

3.78.2. Responses

HTTP Code Description Schema

200

Ok

NsxTCluster

404

NSX-T cluster not found

Error

500

InternalServerError

Error

3.78.3. Consumes

  • application/json

3.78.4. Produces

  • application/json

3.78.5. Tags

  • NSX-T Clusters

3.78.6. Security

Type Name

basic

basicAuth

3.78.7. Example HTTP request

Request path
/v1/nsxt-clusters/string

3.78.8. Example HTTP response

Response 200
{
  "domains" : [ {
    "id" : "string"
  } ],
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "nodes" : [ {
    "fqdn" : "string",
    "vmName" : "string"
  } ]
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.79. Install PKS

POST /v1/pkses

3.79.1. Parameters

Type Name Description Schema

Body

pksInstallationSpec
required

PKS install specification

PksInstallationSpec

3.79.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.79.3. Consumes

  • application/json

3.79.4. Produces

  • application/json

3.79.5. Tags

  • PKS

3.79.6. Security

Type Name

basic

basicAuth

3.79.7. Example HTTP request

Request path
/v1/pkses
Request body
{
  "adminPassword" : "string",
  "availabilityZoneSpec" : {
    "kubernetesNetwork" : {
      "cidr" : "10.255.0.0/24",
      "dnsServer" : "dns.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "reservedRanges" : "10.255.0.1-10.255.0.10",
      "vcenterNetwork" : "string"
    },
    "kubernetesZones" : [ {
      "clusterName" : "string",
      "name" : "string",
      "resourcePoolName" : "string"
    } ],
    "managementNetwork" : {
      "cidr" : "10.255.0.0/24",
      "dnsServer" : "dns.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "reservedRanges" : "10.255.0.1-10.255.0.10",
      "vcenterNetwork" : "string"
    },
    "managementZone" : {
      "clusterName" : "string",
      "name" : "string",
      "resourcePoolName" : "string"
    }
  },
  "certificateBundle" : {
    "harborRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "nsxtRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "pcfRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "pksRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "trustedCertificates" : "string"
  },
  "datastore" : "string",
  "decryptionPassphrase" : "string",
  "domainId" : "76df11e9-5c1f-4376-b913-0ea93ebda983",
  "harborHostname" : "harbor.sfo01.rainpole.local",
  "installHarbor" : true,
  "name" : "PKS-1",
  "nsxtItemsSpec" : {
    "floatingIpPoolId" : "ee7d0bc1-0cd3-4c59-8944-65a36fe35cf7",
    "nodesIpBlockId" : "b73446a0-9ffe-4291-b34f-ff0b6ee67ff3",
    "podsIpBlockId" : "6f5db6d2-30f6-47e3-a765-3ebc34390bce",
    "t0routerId" : "bc3fda31-74b9-4759-8e1f-ff72726b8d5d"
  },
  "pksApiHostname" : "pksApi.sfo01.rainpole.local",
  "pksOpsManagerVmSpec" : {
    "appliance" : {
      "hostname" : "pcf.sfo01.rainpole.local",
      "ip" : "10.255.0.10",
      "vmName" : "ops-manager"
    },
    "network" : {
      "dnsServers" : "dns.sfo01.rainpole.local, dns1.sfo01.rainpole.local",
      "dnsSuffix" : "*.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "netmask" : "255.255.255.0",
      "network" : "string",
      "ntpServers" : "ntp.sfo01.rainpole.local, ntp1.sfo01.rainpole.local"
    }
  }
}

3.79.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.80. Get a list of installed PKS

GET /v1/pkses

3.80.1. Responses

HTTP Code Description Schema

200

Accepted

Page

400

Bad Request

Error

500

Internal Server Error

Error

3.80.2. Consumes

  • application/json

3.80.3. Produces

  • application/json

3.80.4. Tags

  • PKS

3.80.5. Security

Type Name

basic

basicAuth

3.80.6. Example HTTP request

Request path
/v1/pkses

3.80.7. Example HTTP response

Response 200
{
  "elements" : [ "object" ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.81. Validate PKS specification before installation

POST /v1/pkses/validations

3.81.1. Parameters

Type Name Description Schema

Body

pksInstallationSpec
required

PKS install specification

PksInstallationSpec

3.81.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.81.3. Consumes

  • application/json

3.81.4. Produces

  • application/json

3.81.5. Tags

  • PKS

3.81.6. Security

Type Name

basic

basicAuth

3.81.7. Example HTTP request

Request path
/v1/pkses/validations
Request body
{
  "adminPassword" : "string",
  "availabilityZoneSpec" : {
    "kubernetesNetwork" : {
      "cidr" : "10.255.0.0/24",
      "dnsServer" : "dns.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "reservedRanges" : "10.255.0.1-10.255.0.10",
      "vcenterNetwork" : "string"
    },
    "kubernetesZones" : [ {
      "clusterName" : "string",
      "name" : "string",
      "resourcePoolName" : "string"
    } ],
    "managementNetwork" : {
      "cidr" : "10.255.0.0/24",
      "dnsServer" : "dns.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "reservedRanges" : "10.255.0.1-10.255.0.10",
      "vcenterNetwork" : "string"
    },
    "managementZone" : {
      "clusterName" : "string",
      "name" : "string",
      "resourcePoolName" : "string"
    }
  },
  "certificateBundle" : {
    "harborRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "nsxtRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "pcfRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "pksRsaCert" : {
      "privateKey" : "string",
      "publicCert" : "string"
    },
    "trustedCertificates" : "string"
  },
  "datastore" : "string",
  "decryptionPassphrase" : "string",
  "domainId" : "76df11e9-5c1f-4376-b913-0ea93ebda983",
  "harborHostname" : "harbor.sfo01.rainpole.local",
  "installHarbor" : true,
  "name" : "PKS-1",
  "nsxtItemsSpec" : {
    "floatingIpPoolId" : "ee7d0bc1-0cd3-4c59-8944-65a36fe35cf7",
    "nodesIpBlockId" : "b73446a0-9ffe-4291-b34f-ff0b6ee67ff3",
    "podsIpBlockId" : "6f5db6d2-30f6-47e3-a765-3ebc34390bce",
    "t0routerId" : "bc3fda31-74b9-4759-8e1f-ff72726b8d5d"
  },
  "pksApiHostname" : "pksApi.sfo01.rainpole.local",
  "pksOpsManagerVmSpec" : {
    "appliance" : {
      "hostname" : "pcf.sfo01.rainpole.local",
      "ip" : "10.255.0.10",
      "vmName" : "ops-manager"
    },
    "network" : {
      "dnsServers" : "dns.sfo01.rainpole.local, dns1.sfo01.rainpole.local",
      "dnsSuffix" : "*.sfo01.rainpole.local",
      "gateway" : "10.255.0.1",
      "netmask" : "255.255.255.0",
      "network" : "string",
      "ntpServers" : "ntp.sfo01.rainpole.local, ntp1.sfo01.rainpole.local"
    }
  }
}

3.81.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.82. Get validation results

GET /v1/pkses/validations/{id}

3.82.1. Parameters

Type Name Description Schema

Path

id
required

Validation ID

string

3.82.2. Responses

HTTP Code Description Schema

200

Accepted

Validation

400

Bad Request

Error

404

Not Found

Error

500

Internal Server Error

Error

3.82.3. Consumes

  • application/json

3.82.4. Produces

  • application/json

3.82.5. Tags

  • PKS

3.82.6. Security

Type Name

basic

basicAuth

3.82.7. Example HTTP request

Request path
/v1/pkses/validations/string

3.82.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.83. Get PKS details

GET /v1/pkses/{id}

3.83.1. Parameters

Type Name Description Schema

Path

id
required

PKS ID

string

Query

filter
optional

PKS details filter

< string > array(multi)

3.83.2. Responses

HTTP Code Description Schema

200

Accepted

Pks

400

Bad Request

Error

404

Not Found

Error

500

Internal Server Error

Error

3.83.3. Consumes

  • application/json

3.83.4. Produces

  • application/json

3.83.5. Tags

  • PKS

3.83.6. Security

Type Name

basic

basicAuth

3.83.7. Example HTTP request

Request path
/v1/pkses/string

3.83.8. Example HTTP response

Response 200
{
  "info" : {
    "domainId" : "string",
    "id" : "string",
    "name" : "string",
    "status" : "string"
  },
  "inputSpec" : {
    "adminPassword" : "string",
    "availabilityZoneSpec" : {
      "kubernetesNetwork" : {
        "cidr" : "10.255.0.0/24",
        "dnsServer" : "dns.sfo01.rainpole.local",
        "gateway" : "10.255.0.1",
        "reservedRanges" : "10.255.0.1-10.255.0.10",
        "vcenterNetwork" : "string"
      },
      "kubernetesZones" : [ {
        "clusterName" : "string",
        "name" : "string",
        "resourcePoolName" : "string"
      } ],
      "managementNetwork" : {
        "cidr" : "10.255.0.0/24",
        "dnsServer" : "dns.sfo01.rainpole.local",
        "gateway" : "10.255.0.1",
        "reservedRanges" : "10.255.0.1-10.255.0.10",
        "vcenterNetwork" : "string"
      },
      "managementZone" : {
        "clusterName" : "string",
        "name" : "string",
        "resourcePoolName" : "string"
      }
    },
    "certificateBundle" : {
      "harborRsaCert" : {
        "privateKey" : "string",
        "publicCert" : "string"
      },
      "nsxtRsaCert" : {
        "privateKey" : "string",
        "publicCert" : "string"
      },
      "pcfRsaCert" : {
        "privateKey" : "string",
        "publicCert" : "string"
      },
      "pksRsaCert" : {
        "privateKey" : "string",
        "publicCert" : "string"
      },
      "trustedCertificates" : "string"
    },
    "datastore" : "string",
    "decryptionPassphrase" : "string",
    "domainId" : "76df11e9-5c1f-4376-b913-0ea93ebda983",
    "harborHostname" : "harbor.sfo01.rainpole.local",
    "installHarbor" : true,
    "name" : "PKS-1",
    "nsxtItemsSpec" : {
      "floatingIpPoolId" : "ee7d0bc1-0cd3-4c59-8944-65a36fe35cf7",
      "nodesIpBlockId" : "b73446a0-9ffe-4291-b34f-ff0b6ee67ff3",
      "podsIpBlockId" : "6f5db6d2-30f6-47e3-a765-3ebc34390bce",
      "t0routerId" : "bc3fda31-74b9-4759-8e1f-ff72726b8d5d"
    },
    "pksApiHostname" : "pksApi.sfo01.rainpole.local",
    "pksOpsManagerVmSpec" : {
      "appliance" : {
        "hostname" : "pcf.sfo01.rainpole.local",
        "ip" : "10.255.0.10",
        "vmName" : "ops-manager"
      },
      "network" : {
        "dnsServers" : "dns.sfo01.rainpole.local, dns1.sfo01.rainpole.local",
        "dnsSuffix" : "*.sfo01.rainpole.local",
        "gateway" : "10.255.0.1",
        "netmask" : "255.255.255.0",
        "network" : "string",
        "ntpServers" : "ntp.sfo01.rainpole.local, ntp1.sfo01.rainpole.local"
      }
    }
  },
  "serviceVms" : [ {
    "ip" : "string",
    "name" : "string",
    "url" : "string"
  } ],
  "summary" : {
    "harborRegistryUrl" : "https://harbor.sfo01.rainpole.local",
    "kubernetesZonesCount" : 1,
    "managementZonesCount" : 1,
    "opsManagerUrl" : "https://pcf.sfo01.rainpole.local",
    "pksApiFqdn" : "pksApi.sfo01.rainpole.local",
    "wldName" : "string"
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.84. Delete PKS

DELETE /v1/pkses/{id}

3.84.1. Parameters

Type Name Description Schema

Path

id
required

PKS ID

string

3.84.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

409

Conflict

Error

500

Internal Server Error

Error

3.84.3. Consumes

  • application/json

3.84.4. Produces

  • application/json

3.84.5. Tags

  • PKS

3.84.6. Security

Type Name

basic

basicAuth

3.84.7. Example HTTP request

Request path
/v1/pkses/string

3.84.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.85. Initialize PKS deletion

PATCH /v1/pkses/{id}

3.85.1. Parameters

Type Name Description Schema

Path

id
required

PKS ID

string

Body

pksUpdateSpec
required

PKS update specification

PksUpdateSpec

3.85.2. Responses

HTTP Code Description Schema

200

Ok

No Content

400

Bad Request

Error

500

Internal Server Error

Error

3.85.3. Consumes

  • application/json

3.85.4. Produces

  • */*

3.85.5. Tags

  • PKS

3.85.6. Security

Type Name

basic

basicAuth

3.85.7. Example HTTP request

Request path
/v1/pkses/string
Request body
{
  "markForDeletion" : true
}

3.85.8. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.86. Get the PSCs

GET /v1/pscs

3.86.1. Responses

HTTP Code Description Schema

200

Ok

Psc

400

Bad Request

Error

500

InternalServerError

Error

3.86.2. Consumes

  • application/json

3.86.3. Produces

  • application/json

3.86.4. Tags

  • PSCs

3.86.5. Security

Type Name

basic

basicAuth

3.86.6. Example HTTP request

Request path
/v1/pscs

3.86.7. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "isReplica" : true,
  "ssoDomainName" : "string",
  "ssoSubDomainName" : "string"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.87. Get a PSC

GET /v1/pscs/{id}

3.87.1. Parameters

Type Name Description Schema

Path

id
required

PSC ID

string

3.87.2. Responses

HTTP Code Description Schema

200

Ok

Psc

404

Psc not found

Error

500

InternalServerError

Error

3.87.3. Consumes

  • application/json

3.87.4. Produces

  • application/json

3.87.5. Tags

  • PSCs

3.87.6. Security

Type Name

basic

basicAuth

3.87.7. Example HTTP request

Request path
/v1/pscs/string

3.87.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "isReplica" : true,
  "ssoDomainName" : "string",
  "ssoSubDomainName" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.88. Trigger Restore

POST /v1/restores/tasks

3.88.1. Parameters

Type Name Description Schema

Body

restoreSpec
required

restoreSpec

RestoreSpec

3.88.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

Error

3.88.3. Consumes

  • application/json

3.88.4. Produces

  • application/json

3.88.5. Tags

  • BackupRestore

3.88.6. Security

Type Name

basic

basicAuth

3.88.7. Example HTTP request

Request path
/v1/restores/tasks
Request body
{
  "backupFile" : "string",
  "elements" : [ {
    "resourceType" : "SDDC_MANAGER"
  } ],
  "encryption" : {
    "passphrase" : "string"
  }
}

3.88.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.89. Fetch the restores task

GET /v1/restores/tasks/{id}

3.89.1. Parameters

Type Name Description Schema

Path

id
required

The restore task ID

string

3.89.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

Error

3.89.3. Consumes

  • application/json

3.89.4. Produces

  • application/json

3.89.5. Tags

  • BackupRestore

3.89.6. Security

Type Name

basic

basicAuth

3.89.7. Example HTTP request

Request path
/v1/restores/tasks/string

3.89.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.90. Get details of a federation

GET /v1/sddc-federation

3.90.1. Responses

HTTP Code Description Schema

200

OK

< MemberInfo > array

3.90.2. Consumes

  • application/json

3.90.3. Produces

  • application/json

3.90.4. Tags

  • Federation

3.90.5. Security

Type Name

basic

basicAuth

3.90.6. Example HTTP request

Request path
/v1/sddc-federation

3.90.7. Example HTTP response

Response 200
[ {
  "memberDetails" : {
    "city" : "string",
    "coordinate" : {
      "latitude" : 0.0,
      "longitude" : 0.0
    },
    "country" : "string",
    "fqdn" : "string",
    "role" : "CONTROLLER",
    "siteName" : "string",
    "siteType" : "DATACENTER",
    "state" : "string"
  },
  "memberHealth" : {
    "healthCode" : "GREEN",
    "healthDetails" : [ "string" ]
  },
  "memberInventory" : {
    "capacity" : {
      "summary" : {
        "aggregatedCapacity" : {
          "cpu" : {
            "free" : 0.0,
            "total" : 0.0,
            "unallocated" : 0.0,
            "unit" : "GHZ",
            "used" : 0.0
          },
          "datastores" : [ {
            "capacity" : 0.0,
            "datastoreName" : "string",
            "datastoreType" : "VSAN",
            "freeSpace" : 0.0,
            "unallocated" : 0.0,
            "unit" : "GHZ",
            "used" : 0.0
          } ],
          "hostCount" : {
            "total" : 0,
            "unallocated" : 0,
            "used" : 0
          },
          "memory" : {
            "totalCapacityMB" : 0.0,
            "usedCapacityMB" : 0.0
          }
        },
        "domainCount" : 0,
        "domainInfo" : [ {
          "domainCapacity" : {
            "cpu" : {
              "free" : 0.0,
              "total" : 0.0,
              "unallocated" : 0.0,
              "unit" : "GHZ",
              "used" : 0.0
            },
            "datastores" : [ {
              "capacity" : 0.0,
              "datastoreName" : "string",
              "datastoreType" : "VSAN",
              "freeSpace" : 0.0,
              "unallocated" : 0.0,
              "unit" : "GHZ",
              "used" : 0.0
            } ],
            "hostCount" : {
              "total" : 0,
              "unallocated" : 0,
              "used" : 0
            },
            "memory" : {
              "totalCapacityMB" : 0.0,
              "usedCapacityMB" : 0.0
            }
          },
          "domainId" : "string",
          "name" : "string",
          "status" : "string",
          "type" : "string"
        } ],
        "domainTypeInfo" : [ {
          "aggregatedCapacity" : {
            "cpu" : {
              "free" : 0.0,
              "total" : 0.0,
              "unallocated" : 0.0,
              "unit" : "GHZ",
              "used" : 0.0
            },
            "datastores" : [ {
              "capacity" : 0.0,
              "datastoreName" : "string",
              "datastoreType" : "VSAN",
              "freeSpace" : 0.0,
              "unallocated" : 0.0,
              "unit" : "GHZ",
              "used" : 0.0
            } ],
            "hostCount" : {
              "total" : 0,
              "unallocated" : 0,
              "used" : 0
            },
            "memory" : {
              "totalCapacityMB" : 0.0,
              "usedCapacityMB" : 0.0
            }
          },
          "domainCount" : 0,
          "type" : "string"
        } ]
      }
    },
    "creationTime" : "string",
    "inventoryInfo" : {
      "hostCount" : {
        "total" : 0,
        "unallocated" : 0,
        "used" : 0
      }
    },
    "softwareInfo" : {
      "pendingUpdates" : 0
    }
  },
  "memberLiveness" : {
    "livelinessCode" : "GREEN",
    "livelinessDetails" : [ "string" ]
  }
} ]

3.91. Bootstrap a VMware Cloud Foundation to form a federation

PUT /v1/sddc-federation

3.91.1. Parameters

Type Name Description Schema

Body

bootstrapSpec
required

Bootstrap Spec

BootstrapSpec

3.91.2. Responses

HTTP Code Description Schema

202

Accepted

FederationTask

3.91.3. Consumes

  • application/json

3.91.4. Produces

  • application/json

3.91.5. Tags

  • Federation

3.91.6. Security

Type Name

basic

basicAuth

3.91.7. Example HTTP request

Request path
/v1/sddc-federation
Request body
{
  "federationName" : "string",
  "memberJoinDetail" : {
    "city" : "string",
    "coordinate" : {
      "latitude" : 0.0,
      "longitude" : 0.0
    },
    "country" : "string",
    "fqdn" : "string",
    "role" : "CONTROLLER",
    "siteName" : "string",
    "siteType" : "DATACENTER",
    "state" : "string"
  }
}

3.91.8. Example HTTP response

Response 202
{
  "created" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "errors" : [ {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  } ],
  "lastUpdated" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "operation" : "BOOTSTRAP",
  "payload" : {
    "assignedBrokerId" : 0,
    "assignedZkId" : 0,
    "mbServers" : {
      "messageBusServersInfo" : [ {
        "brokerId" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "port" : 0
      } ]
    },
    "srServers" : {
      "schemaRegistryServersInfo" : [ {
        "hostAddress" : "string",
        "port" : 0,
        "protocol" : "string"
      } ]
    },
    "zkServers" : {
      "zookeeperServersInfo" : [ {
        "clientPort" : 0,
        "electionPort" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "peerPort" : 0,
        "securePort" : 0,
        "zkId" : 0,
        "zkRole" : "string"
      } ]
    }
  },
  "progressDetails" : "string",
  "remoteOperationTask" : {
    "created" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "errors" : [ {
      "error" : "string",
      "errorPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      },
      "suggestedRemedy" : "string",
      "suggestedRemedyPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      }
    } ],
    "lastUpdated" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "operation" : "BOOTSTRAP",
    "payload" : {
      "assignedBrokerId" : 0,
      "assignedZkId" : 0,
      "mbServers" : {
        "messageBusServersInfo" : [ {
          "brokerId" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "port" : 0
        } ]
      },
      "srServers" : {
        "schemaRegistryServersInfo" : [ {
          "hostAddress" : "string",
          "port" : 0,
          "protocol" : "string"
        } ]
      },
      "zkServers" : {
        "zookeeperServersInfo" : [ {
          "clientPort" : 0,
          "electionPort" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "peerPort" : 0,
          "securePort" : 0,
          "zkId" : 0,
          "zkRole" : "string"
        } ]
      }
    },
    "progressDetails" : "string",
    "remoteOperationTask" : "...",
    "status" : "NOT_STARTED",
    "taskId" : "string"
  },
  "status" : "NOT_STARTED",
  "taskId" : "string"
}

3.92. Teardown a federation

DELETE /v1/sddc-federation

3.92.1. Responses

HTTP Code Description Schema

202

ACCEPTED

FederationTask

3.92.2. Consumes

  • application/json

3.92.3. Produces

  • application/json

3.92.4. Tags

  • Federation

3.92.5. Security

Type Name

basic

basicAuth

3.92.6. Example HTTP request

Request path
/v1/sddc-federation

3.92.7. Example HTTP response

Response 202
{
  "created" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "errors" : [ {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  } ],
  "lastUpdated" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "operation" : "BOOTSTRAP",
  "payload" : {
    "assignedBrokerId" : 0,
    "assignedZkId" : 0,
    "mbServers" : {
      "messageBusServersInfo" : [ {
        "brokerId" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "port" : 0
      } ]
    },
    "srServers" : {
      "schemaRegistryServersInfo" : [ {
        "hostAddress" : "string",
        "port" : 0,
        "protocol" : "string"
      } ]
    },
    "zkServers" : {
      "zookeeperServersInfo" : [ {
        "clientPort" : 0,
        "electionPort" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "peerPort" : 0,
        "securePort" : 0,
        "zkId" : 0,
        "zkRole" : "string"
      } ]
    }
  },
  "progressDetails" : "string",
  "remoteOperationTask" : {
    "created" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "errors" : [ {
      "error" : "string",
      "errorPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      },
      "suggestedRemedy" : "string",
      "suggestedRemedyPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      }
    } ],
    "lastUpdated" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "operation" : "BOOTSTRAP",
    "payload" : {
      "assignedBrokerId" : 0,
      "assignedZkId" : 0,
      "mbServers" : {
        "messageBusServersInfo" : [ {
          "brokerId" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "port" : 0
        } ]
      },
      "srServers" : {
        "schemaRegistryServersInfo" : [ {
          "hostAddress" : "string",
          "port" : 0,
          "protocol" : "string"
        } ]
      },
      "zkServers" : {
        "zookeeperServersInfo" : [ {
          "clientPort" : 0,
          "electionPort" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "peerPort" : 0,
          "securePort" : 0,
          "zkId" : 0,
          "zkRole" : "string"
        } ]
      }
    },
    "progressDetails" : "string",
    "remoteOperationTask" : "...",
    "status" : "NOT_STARTED",
    "taskId" : "string"
  },
  "status" : "NOT_STARTED",
  "taskId" : "string"
}

3.93. Join a VMware Cloud Foundation to a federation

POST /v1/sddc-federation/members

3.93.1. Parameters

Type Name Description Schema

Body

joinSpec
required

Member Join Spec

MemberJoinSpec

3.93.2. Responses

HTTP Code Description Schema

202

ACCEPTED

FederationTask

3.93.3. Consumes

  • application/json

3.93.4. Produces

  • application/json

3.93.5. Tags

  • Members

3.93.6. Security

Type Name

basic

basicAuth

3.93.7. Example HTTP request

Request path
/v1/sddc-federation/members
Request body
{
  "commonName" : "string",
  "controllerFqdn" : "string",
  "joinToken" : "string",
  "memberJoinDetail" : {
    "city" : "string",
    "coordinate" : {
      "latitude" : 0.0,
      "longitude" : 0.0
    },
    "country" : "string",
    "fqdn" : "string",
    "role" : "CONTROLLER",
    "siteName" : "string",
    "siteType" : "DATACENTER",
    "state" : "string"
  }
}

3.93.8. Example HTTP response

Response 202
{
  "created" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "errors" : [ {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  } ],
  "lastUpdated" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "operation" : "BOOTSTRAP",
  "payload" : {
    "assignedBrokerId" : 0,
    "assignedZkId" : 0,
    "mbServers" : {
      "messageBusServersInfo" : [ {
        "brokerId" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "port" : 0
      } ]
    },
    "srServers" : {
      "schemaRegistryServersInfo" : [ {
        "hostAddress" : "string",
        "port" : 0,
        "protocol" : "string"
      } ]
    },
    "zkServers" : {
      "zookeeperServersInfo" : [ {
        "clientPort" : 0,
        "electionPort" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "peerPort" : 0,
        "securePort" : 0,
        "zkId" : 0,
        "zkRole" : "string"
      } ]
    }
  },
  "progressDetails" : "string",
  "remoteOperationTask" : {
    "created" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "errors" : [ {
      "error" : "string",
      "errorPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      },
      "suggestedRemedy" : "string",
      "suggestedRemedyPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      }
    } ],
    "lastUpdated" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "operation" : "BOOTSTRAP",
    "payload" : {
      "assignedBrokerId" : 0,
      "assignedZkId" : 0,
      "mbServers" : {
        "messageBusServersInfo" : [ {
          "brokerId" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "port" : 0
        } ]
      },
      "srServers" : {
        "schemaRegistryServersInfo" : [ {
          "hostAddress" : "string",
          "port" : 0,
          "protocol" : "string"
        } ]
      },
      "zkServers" : {
        "zookeeperServersInfo" : [ {
          "clientPort" : 0,
          "electionPort" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "peerPort" : 0,
          "securePort" : 0,
          "zkId" : 0,
          "zkRole" : "string"
        } ]
      }
    },
    "progressDetails" : "string",
    "remoteOperationTask" : "...",
    "status" : "NOT_STARTED",
    "taskId" : "string"
  },
  "status" : "NOT_STARTED",
  "taskId" : "string"
}

3.94. Get fact about a VMware Cloud Foundation

GET /v1/sddc-federation/members

3.94.1. Parameters

Type Name Description Schema

Query

local
optional

Provide current member fact

boolean

3.94.2. Responses

HTTP Code Description Schema

200

OK

MemberFact

3.94.3. Consumes

  • application/json

3.94.4. Produces

  • application/json

3.94.5. Tags

  • Members

3.94.6. Security

Type Name

basic

basicAuth

3.94.7. Example HTTP request

Request path
/v1/sddc-federation/members

3.94.8. Example HTTP response

Response 200
{
  "error" : {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  },
  "federationName" : "string",
  "memberDetail" : {
    "city" : "string",
    "coordinate" : {
      "latitude" : 0.0,
      "longitude" : 0.0
    },
    "country" : "string",
    "fqdn" : "string",
    "role" : "CONTROLLER",
    "siteName" : "string",
    "siteType" : "DATACENTER",
    "state" : "string"
  },
  "permissions" : [ "BOOTSTRAP" ]
}

3.95. Leave a VMware Cloud Foundation from a federation

DELETE /v1/sddc-federation/members/{memberId}

3.95.1. Parameters

Type Name Description Schema

Path

memberId
required

Member FQDN

string

Query

force
optional

force

boolean

3.95.2. Responses

HTTP Code Description Schema

202

ACCEPTED

FederationTask

3.95.3. Consumes

  • application/json

3.95.4. Produces

  • application/json

3.95.5. Tags

  • Members

3.95.6. Security

Type Name

basic

basicAuth

3.95.7. Example HTTP request

Request path
/v1/sddc-federation/members/string

3.95.8. Example HTTP response

Response 202
{
  "created" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "errors" : [ {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  } ],
  "lastUpdated" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "operation" : "BOOTSTRAP",
  "payload" : {
    "assignedBrokerId" : 0,
    "assignedZkId" : 0,
    "mbServers" : {
      "messageBusServersInfo" : [ {
        "brokerId" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "port" : 0
      } ]
    },
    "srServers" : {
      "schemaRegistryServersInfo" : [ {
        "hostAddress" : "string",
        "port" : 0,
        "protocol" : "string"
      } ]
    },
    "zkServers" : {
      "zookeeperServersInfo" : [ {
        "clientPort" : 0,
        "electionPort" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "peerPort" : 0,
        "securePort" : 0,
        "zkId" : 0,
        "zkRole" : "string"
      } ]
    }
  },
  "progressDetails" : "string",
  "remoteOperationTask" : {
    "created" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "errors" : [ {
      "error" : "string",
      "errorPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      },
      "suggestedRemedy" : "string",
      "suggestedRemedyPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      }
    } ],
    "lastUpdated" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "operation" : "BOOTSTRAP",
    "payload" : {
      "assignedBrokerId" : 0,
      "assignedZkId" : 0,
      "mbServers" : {
        "messageBusServersInfo" : [ {
          "brokerId" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "port" : 0
        } ]
      },
      "srServers" : {
        "schemaRegistryServersInfo" : [ {
          "hostAddress" : "string",
          "port" : 0,
          "protocol" : "string"
        } ]
      },
      "zkServers" : {
        "zookeeperServersInfo" : [ {
          "clientPort" : 0,
          "electionPort" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "peerPort" : 0,
          "securePort" : 0,
          "zkId" : 0,
          "zkRole" : "string"
        } ]
      }
    },
    "progressDetails" : "string",
    "remoteOperationTask" : "...",
    "status" : "NOT_STARTED",
    "taskId" : "string"
  },
  "status" : "NOT_STARTED",
  "taskId" : "string"
}

3.96. Invite a VMware Cloud Foundation to be member of a federation

POST /v1/sddc-federation/membership-tokens

3.96.1. Parameters

Type Name Description Schema

Body

inviteSpec
required

Invitation Spec

InvitationSpec

3.96.2. Responses

HTTP Code Description Schema

200

OK

MembershipInvitation

3.96.3. Consumes

  • application/json

3.96.4. Produces

  • application/json

3.96.5. Tags

  • Membership Token

3.96.6. Security

Type Name

basic

basicAuth

3.96.7. Example HTTP request

Request path
/v1/sddc-federation/membership-tokens
Request body
{
  "inviteeFqdn" : "string",
  "inviteeRole" : "CONTROLLER",
  "tokenExpiryHours" : 0.0
}

3.96.8. Example HTTP response

Response 200
{
  "controllerFqdn" : [ "string" ],
  "error" : {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  },
  "invitationToken" : "string",
  "inviteeFqdn" : "string",
  "inviteeRole" : "CONTROLLER"
}

3.97. Get progress of an invoked operation

GET /v1/sddc-federation/tasks/{taskId}

3.97.1. Parameters

Type Name Description Schema

Path

taskId
required

Task ID

string

3.97.2. Responses

HTTP Code Description Schema

200

OK

FederationTask

3.97.3. Consumes

  • application/json

3.97.4. Produces

  • application/json

3.97.5. Tags

  • Progress

3.97.6. Security

Type Name

basic

basicAuth

3.97.7. Example HTTP request

Request path
/v1/sddc-federation/tasks/string

3.97.8. Example HTTP response

Response 200
{
  "created" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "errors" : [ {
    "error" : "string",
    "errorPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    },
    "suggestedRemedy" : "string",
    "suggestedRemedyPack" : {
      "arguments" : [ "object" ],
      "component" : "string",
      "defaultMessage" : "string",
      "localBundle" : "string",
      "messageKey" : "string"
    }
  } ],
  "lastUpdated" : {
    "dateTime" : "string",
    "timestamp" : 0
  },
  "operation" : "BOOTSTRAP",
  "payload" : {
    "assignedBrokerId" : 0,
    "assignedZkId" : 0,
    "mbServers" : {
      "messageBusServersInfo" : [ {
        "brokerId" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "port" : 0
      } ]
    },
    "srServers" : {
      "schemaRegistryServersInfo" : [ {
        "hostAddress" : "string",
        "port" : 0,
        "protocol" : "string"
      } ]
    },
    "zkServers" : {
      "zookeeperServersInfo" : [ {
        "clientPort" : 0,
        "electionPort" : 0,
        "fqdn" : "string",
        "hostAddress" : "string",
        "peerPort" : 0,
        "securePort" : 0,
        "zkId" : 0,
        "zkRole" : "string"
      } ]
    }
  },
  "progressDetails" : "string",
  "remoteOperationTask" : {
    "created" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "errors" : [ {
      "error" : "string",
      "errorPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      },
      "suggestedRemedy" : "string",
      "suggestedRemedyPack" : {
        "arguments" : [ "object" ],
        "component" : "string",
        "defaultMessage" : "string",
        "localBundle" : "string",
        "messageKey" : "string"
      }
    } ],
    "lastUpdated" : {
      "dateTime" : "string",
      "timestamp" : 0
    },
    "operation" : "BOOTSTRAP",
    "payload" : {
      "assignedBrokerId" : 0,
      "assignedZkId" : 0,
      "mbServers" : {
        "messageBusServersInfo" : [ {
          "brokerId" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "port" : 0
        } ]
      },
      "srServers" : {
        "schemaRegistryServersInfo" : [ {
          "hostAddress" : "string",
          "port" : 0,
          "protocol" : "string"
        } ]
      },
      "zkServers" : {
        "zookeeperServersInfo" : [ {
          "clientPort" : 0,
          "electionPort" : 0,
          "fqdn" : "string",
          "hostAddress" : "string",
          "peerPort" : 0,
          "securePort" : 0,
          "zkId" : 0,
          "zkRole" : "string"
        } ]
      }
    },
    "progressDetails" : "string",
    "remoteOperationTask" : "...",
    "status" : "NOT_STARTED",
    "taskId" : "string"
  },
  "status" : "NOT_STARTED",
  "taskId" : "string"
}

3.98. Get the Sddc Managers

GET /v1/sddc-managers

3.98.1. Responses

HTTP Code Description Schema

200

Ok

SddcManager

400

Bad Request

Error

500

InternalServerError

Error

3.98.2. Consumes

  • application/json

3.98.3. Produces

  • application/json

3.98.4. Tags

  • SddcManagers

3.98.5. Security

Type Name

basic

basicAuth

3.98.6. Example HTTP request

Request path
/v1/sddc-managers

3.98.7. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "version" : "string"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.99. Get a Sddc Manager

GET /v1/sddc-managers/{id}

3.99.1. Parameters

Type Name Description Schema

Path

id
required

Sddc Manager ID

string

3.99.2. Responses

HTTP Code Description Schema

200

Ok

SddcManager

404

Sddc Manager not found

Error

500

InternalServerError

Error

3.99.3. Consumes

  • application/json

3.99.4. Produces

  • application/json

3.99.5. Tags

  • SddcManagers

3.99.6. Security

Type Name

basic

basicAuth

3.99.7. Example HTTP request

Request path
/v1/sddc-managers/string

3.99.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "version" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.100. Create SDDC

POST /v1/sddcs

3.100.1. Parameters

Type Name Description Schema

Body

sddcSpec
required

SDDC specification

SddcSpec

3.100.2. Responses

HTTP Code Description Schema

200

OK

SddcTask

202

Success

SddcTask

400

SDDC already exists, Bad Request

Error

500

Internal Server Error

Error

3.100.3. Consumes

  • application/json

3.100.4. Produces

  • application/json

3.100.5. Tags

  • SDDC

3.100.6. Security

Type Name

basic

basicAuth

3.100.7. Example HTTP request

Request path
/v1/sddcs
Request body
{
  "adSpec" : {
    "childAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "domainControllers" : [ "string" ],
    "groups" : {
      "string" : "string"
    },
    "requireSsl" : true,
    "rootAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "skipJoinEsxi" : true,
    "useSubDomainForUsers" : true,
    "users" : {
      "string" : "<<_sddccredentials>>"
    }
  },
  "ceipEnabled" : true,
  "certificatesPassphrase" : "string",
  "clusterSpec" : {
    "clusterEvcMode" : "string",
    "clusterName" : "string",
    "hostFailuresToTolerate" : 0,
    "hostProfileComplianceCheckHour" : 0,
    "hostProfileComplianceCheckMinute" : 0,
    "hosts" : [ "string" ],
    "resourcePoolSpecs" : [ {
      "cpuLimit" : 0,
      "cpuReservationExpandable" : true,
      "cpuReservationMhz" : 0,
      "cpuReservationPercentage" : 0,
      "cpuSharesLevel" : "custom",
      "cpuSharesValue" : 0,
      "memoryLimit" : 0,
      "memoryReservationExpandable" : true,
      "memoryReservationMb" : 0,
      "memoryReservationPercentage" : 0,
      "memorySharesLevel" : "custom",
      "memorySharesValue" : 0,
      "name" : "string",
      "type" : "management"
    } ],
    "vmFolders" : {
      "string" : "string"
    }
  },
  "deploymentEndpointSpec" : {
    "cluster" : "string",
    "datacenter" : "string",
    "resourcePool" : "string",
    "storage" : "string",
    "vcenter" : {
      "address" : "string",
      "password" : "string",
      "username" : "string"
    },
    "vmFolder" : "string",
    "vmFolders" : {
      "string" : "string"
    }
  },
  "dnsSpec" : {
    "domain" : "vmware.com",
    "nameserver" : "172.0.0.4",
    "secondaryNameserver" : "172.0.0.5",
    "subdomain" : "vcf.vmware.com"
  },
  "dvSwitchVersion" : "One among:6.0.0, 6.5.0",
  "dvsSpecs" : [ {
    "dvsName" : "string",
    "mtu" : 0,
    "networks" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "niocSpecs" : [ {
      "trafficType" : "One among:VSAN, VMOTION, VIRTUALMACHINE, MANAGEMENT, NFS, VDP, HBR, FAULTTOLERANCE, ISCSI",
      "value" : "string"
    } ],
    "vmnics" : [ "string" ]
  } ],
  "esxLicense" : "string",
  "excludedComponents" : "One among:Foundation, VsphereHostProfiles, LogInsight, NSX, VrealizeNetwork, VSAN, VSANCleanup, VROPS, VRA, DRDeployment, DRConfiguration, ConfigurationBackup, VRB, VRSLCM, Inventory, UMDS, EsxThumbprintValidation, AVN, CEIP, Backup",
  "hostSpecs" : [ {
    "association" : "string",
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "hostname" : "esx-1",
    "ipAddressPrivate" : {
      "cidr" : "172.0.0.0/24",
      "gateway" : "192.168.0.1",
      "ipAddress" : "192.168.0.123",
      "subnet" : "255.255.255.252"
    },
    "key" : "string",
    "serverId" : "string",
    "sshThumbprint" : "string",
    "sslThumbprint" : "string",
    "vSwitch" : "string",
    "vmknicSpecs" : [ {
      "ipAddress" : "string",
      "macAddress" : "string",
      "portgroup" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION"
    } ],
    "vswitch" : "string"
  } ],
  "managementPoolName" : "string",
  "networkSpecs" : [ {
    "activeUplinks" : [ "string" ],
    "excludeIpAddressRanges" : [ "string" ],
    "excludeIpaddresses" : [ "string" ],
    "gateway" : "string",
    "includeIpAddress" : [ "string" ],
    "includeIpAddressRanges" : [ {
      "endIpAddress" : "192.168.0.128",
      "startIpAddress" : "192.168.0.123"
    } ],
    "mtu" : "string",
    "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "portGroupKey" : "string",
    "standbyUplinks" : [ "string" ],
    "subnet" : "string",
    "subnetMask" : "string",
    "teamingPolicy" : "One among:loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit, loadbalance_loadbased",
    "vlanId" : "string"
  } ],
  "nfsDatastoreName" : "string",
  "nsxSpec" : {
    "adminNsxControllerPassword" : "string",
    "adminNsxManagerPassword" : "string",
    "backupFtpServerAddress" : "string",
    "controllerIPPoolSpec" : {
      "defaultGateway" : "string",
      "endIp" : "string",
      "poolName" : "string",
      "prefix" : "string",
      "startIp" : "string"
    },
    "ftpBackupFolder" : "string",
    "ftpCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "ftpPassPhrase" : "string",
    "ftpPort" : 0,
    "license" : "string",
    "logicalSwitches" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "name" : "string",
      "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
      "transportZoneId" : "string"
    } ],
    "multicastRangeBegin" : "string",
    "multicastRangeEnd" : "string",
    "nsxBgpSpec" : {
      "defaultPassword" : "string",
      "localAutonomousSystem" : 0,
      "nsxEdgeBgpSpecs" : [ {
        "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
        "enableGracefulRestart" : true,
        "learnFrom" : [ "string" ],
        "neighbours" : [ {
          "autonomousSystem" : 0,
          "forwardingIp" : "192.168.0.123",
          "holdDownTimeSeconds" : 0,
          "keepAliveTimeSeconds" : 0,
          "neighbourIp" : "192.168.0.123",
          "password" : "string",
          "protocolIp" : "192.168.0.123",
          "weight" : 0
        } ]
      } ],
      "skipBgpValidation" : true
    },
    "nsxControllerVmNamesPrefix" : "string",
    "nsxEdgePassword" : "string",
    "nsxEdgeSpecs" : [ {
      "edgeName" : "string",
      "edgeSize" : "One among:compact, large, quadlarge, xlarge",
      "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
      "poolSpecs" : [ {
        "memberSpecs" : [ {
          "ipAddress" : "string",
          "monitorPort" : 0,
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "shortHostname" : "string",
      "vnics" : [ {
        "attachToLogicalSwitch" : true,
        "disconnected" : true,
        "name" : "string",
        "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
        "primaryIpAddress" : "string",
        "secondaryIpAddresses" : [ "string" ],
        "type" : "One among:uplink, internal",
        "useForDefaultRoute" : true,
        "useForDynamicRouterConfiguration" : true
      } ]
    } ],
    "nsxId" : "string",
    "nsxManagerHostname" : "string",
    "nsxManagerIp" : "string",
    "nsxSegmentRangeBegin" : "string",
    "nsxSegmentRangeEnd" : "string",
    "nsxVxlanSpec" : {
      "excludeIpAddressRanges" : [ "string" ],
      "gateway" : "string",
      "poolEndAddress" : "string",
      "poolStartAddress" : "string",
      "subnetWithCidr" : "string",
      "teamingPolicy" : "FAILOVER_ORDER",
      "vtepVmknicCount" : 0,
      "vxlanCluster" : "string",
      "vxlanDvs" : "string",
      "vxlanMtu" : "string",
      "vxlanPoolName" : "string",
      "vxlanVlanId" : "string"
    },
    "privilegedNsxManagerPassword" : "string",
    "transferProtocol" : "SFTP",
    "transportZones" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "id" : "universal-transport-zone",
      "name" : "string",
      "universal" : true
    } ],
    "universalMulticastRangeBegin" : "string",
    "universalMulticastRangeEnd" : "string",
    "universalSegmentRangeBegin" : "string",
    "universalSegmentRangeEnd" : "string"
  },
  "ntpServers" : [ "string" ],
  "pscLoadBalancerHostname" : "mgmt-psc",
  "pscLoadBalancerIpAddress" : "string",
  "pscSpecs" : [ {
    "adminUserSsoPassword" : "string",
    "automationUserSsoPassword" : "string",
    "automationUserSsoUsername" : "string",
    "pscHostName" : "string",
    "pscId" : "string",
    "pscIp" : "string",
    "pscSsoSpec" : {
      "adDomain" : "string",
      "adPassword" : "string",
      "adUsername" : "string",
      "isJoinSsoDomain" : true,
      "replicationPartner" : "string",
      "ssoDomain" : "string",
      "ssoSiteName" : "string"
    },
    "rootPscPassword" : "string"
  } ],
  "remoteSiteSpec" : {
    "clusterName" : "string",
    "datacenterName" : "string",
    "logicalSwitchNames" : [ "string" ],
    "nsxCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "nsxIp" : "string",
    "placeholderDatastore" : "string",
    "pscAddress" : "string",
    "remoteRegionVmFolders" : {
      "string" : "string"
    },
    "rpoMinutes" : 0,
    "siteName" : "string",
    "srmIp" : "string",
    "vcCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vcMgmtIp" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrRootPassword" : "string",
    "vrliAdminPassword" : "string",
    "vrliLoadBalancerHostname" : "string",
    "vrliNodesAddresses" : [ "string" ],
    "vrliRootPassword" : "string"
  },
  "sddcId" : "sfo01-workflowspec-ems",
  "sddcManagerSpec" : {
    "hostname" : "string",
    "ipAddress" : "string",
    "licenseKey" : "string",
    "netmask" : "string",
    "restApiCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "rootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "secondUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    }
  },
  "selfSignedCertificates" : "string",
  "shouldCleanupVsan" : false,
  "skipEsxThumbprintValidation" : true,
  "smtpSpec" : {
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "isSecureConnection" : true,
    "port" : 0,
    "requiresAuthentication" : true,
    "server" : "string",
    "useTlsEncryption" : true
  },
  "srmSpec" : {
    "dbPassword" : "string",
    "licenseKey" : "string",
    "srmAdminCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmHostname" : "string",
    "srmRootCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmVmAddress" : "string",
    "srmVmName" : "string"
  },
  "taskName" : "string",
  "umdsSpec" : {
    "address" : "string",
    "user" : "string",
    "userPassword" : "string"
  },
  "vcenterSpec" : {
    "licenseFile" : "string",
    "rootVcenterPassword" : "string",
    "vcenterHostname" : "string",
    "vcenterIp" : "string",
    "vcenterNetmask" : "string",
    "vmSize" : "One among:xlarge, large, medium, small, tiny"
  },
  "vrSpec" : {
    "ipPoolName" : "string",
    "rootPassword" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrShortHostName" : "string"
  },
  "vraDeploymentSpec" : {
    "brandingSpec" : {
      "backgroundColor" : "string",
      "companyName" : "string",
      "contactLink" : "string",
      "copyright" : "string",
      "privacyPolicyLink" : "string",
      "productName" : "string",
      "textColor" : "string"
    },
    "enableVroMultiTenancy" : true,
    "fabricGroupNames" : [ "string" ],
    "iaasTemplateName" : "string",
    "localAdministratorPassword" : "string",
    "localDefaultTenantAdmin" : {
      "email" : "string",
      "firstName" : "string",
      "lastName" : "string",
      "password" : "string",
      "username" : "string"
    },
    "msLbHostName" : "string",
    "msLbIpAddress" : "string",
    "msSqlServer" : {
      "address" : "string",
      "databaseName" : "string",
      "hostname" : "string",
      "instanceName" : "string",
      "password" : "string",
      "port" : 0,
      "username" : "string",
      "vmName" : "string"
    },
    "skipWindowsVms" : true,
    "systemAdminPassword" : "string",
    "tenantSpec" : {
      "email" : "string",
      "name" : "string",
      "url" : "string",
      "vraTenantAdministratorSpec" : {
        "email" : "string",
        "firstName" : "string",
        "lastName" : "string",
        "password" : "string",
        "username" : "string"
      }
    },
    "vraEmailProviderSpecs" : [ {
      "acceptSelfSignedCertificates" : true,
      "emailAddress" : "string",
      "inboundDirection" : "One among: INBOUND, OUTBOUND",
      "name" : "string",
      "password" : "string",
      "port" : 0,
      "protocol" : "One among: IMAP, SMTP",
      "serverAddress" : "string",
      "useSsl" : true,
      "username" : "string"
    } ],
    "vraLbHostName" : "string",
    "vraLbIpAddress" : "string",
    "vraNodeLicense" : "string",
    "vraRootPassword" : "string",
    "vraVms" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "isPrimary" : true,
      "name" : "string",
      "type" : "string"
    } ],
    "webLbHostName" : "string",
    "webLbIpAddress" : "string"
  },
  "vrbDeploymentSpec" : {
    "collectorNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "currency" : "string",
    "license" : "string",
    "serverNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "sshPassword" : "string"
  },
  "vrliDeploymentSpec" : {
    "adminEmail" : "string",
    "adminPassword" : "string",
    "archiveLocation" : "string",
    "eventForwardingSiteTag" : "string",
    "license" : "string",
    "loadBalancerHostname" : "string",
    "loadBalancerIpAddress" : "string",
    "networkType" : "string",
    "notificationEmails" : [ "string" ],
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "sshPassword" : "string",
    "vmSize" : "One among:large, medium, small, xsmall",
    "vrliNodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string"
    } ]
  },
  "vropsDeploymentSpec" : {
    "adminPassword" : "string",
    "collectorSize" : "One among:smallrc, largerc",
    "lbHostName" : "string",
    "lbIpAddress" : "string",
    "licenseKey" : "string",
    "nodeSize" : "One among:xsmall, small, medium, large, extra_large",
    "nodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string",
      "vropsNodeType" : "One among:MASTER, REPLICA, DATA, REMOTE_COLLECTOR"
    } ],
    "rebootVmAfterHddExtending" : true,
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "skipHddExtending" : true,
    "snmpReadCommunity" : "string",
    "vropsRootPassword" : "string"
  },
  "vrslcmDeploymentSpec" : {
    "apiPassword" : "string",
    "fqdn" : "vrslcm.vrack.vsphere.local",
    "ipAddress" : "string",
    "sshPassword" : "string"
  },
  "vsanSpec" : {
    "datastoreName" : "string",
    "hclFile" : "string",
    "licenseFile" : "string",
    "vsanDedup" : true,
    "vsanName" : "string"
  },
  "vxManagerSpec" : {
    "defaultAdminUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "defaultRootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vxManagerHostName" : "string"
  },
  "vxRailSpec" : {
    "vxRailObjectNames" : {
      "string" : "string"
    }
  }
}

3.100.8. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 202
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.101. Retrieve all SDDCs

GET /v1/sddcs

3.101.1. Responses

HTTP Code Description Schema

200

Accepted

SddcTask

500

Internal Server Error

Error

3.101.2. Consumes

  • application/json

3.101.3. Produces

  • application/json

3.101.4. Tags

  • SDDC

3.101.5. Security

Type Name

basic

basicAuth

3.101.6. Example HTTP request

Request path
/v1/sddcs

3.101.7. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.102. Validate SDDC specification before creation

POST /v1/sddcs/validations

3.102.1. Description

SDDC specification incorporates all the client inputs regarding VMW component parameters constituting the SDDC: NTP, DNS spec, ESXi, VC, VSAN, NSX spec et al.

3.102.2. Parameters

Type Name Description Schema

Query

redo
optional

redo

boolean

Body

sddcSpec
required

SDDC specification

SddcSpec

3.102.3. Responses

HTTP Code Description Schema

200

Accepted

Validation

202

Success

Validation

403

Forbidden

No Content

404

Not Found

Error

500

Internal Server Error

Error

3.102.4. Consumes

  • application/json

3.102.5. Produces

  • application/json

3.102.6. Tags

  • SDDC

3.102.7. Security

Type Name

basic

basicAuth

3.102.8. Example HTTP request

Request path
/v1/sddcs/validations
Request body
{
  "adSpec" : {
    "childAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "domainControllers" : [ "string" ],
    "groups" : {
      "string" : "string"
    },
    "requireSsl" : true,
    "rootAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "skipJoinEsxi" : true,
    "useSubDomainForUsers" : true,
    "users" : {
      "string" : "<<_sddccredentials>>"
    }
  },
  "ceipEnabled" : true,
  "certificatesPassphrase" : "string",
  "clusterSpec" : {
    "clusterEvcMode" : "string",
    "clusterName" : "string",
    "hostFailuresToTolerate" : 0,
    "hostProfileComplianceCheckHour" : 0,
    "hostProfileComplianceCheckMinute" : 0,
    "hosts" : [ "string" ],
    "resourcePoolSpecs" : [ {
      "cpuLimit" : 0,
      "cpuReservationExpandable" : true,
      "cpuReservationMhz" : 0,
      "cpuReservationPercentage" : 0,
      "cpuSharesLevel" : "custom",
      "cpuSharesValue" : 0,
      "memoryLimit" : 0,
      "memoryReservationExpandable" : true,
      "memoryReservationMb" : 0,
      "memoryReservationPercentage" : 0,
      "memorySharesLevel" : "custom",
      "memorySharesValue" : 0,
      "name" : "string",
      "type" : "management"
    } ],
    "vmFolders" : {
      "string" : "string"
    }
  },
  "deploymentEndpointSpec" : {
    "cluster" : "string",
    "datacenter" : "string",
    "resourcePool" : "string",
    "storage" : "string",
    "vcenter" : {
      "address" : "string",
      "password" : "string",
      "username" : "string"
    },
    "vmFolder" : "string",
    "vmFolders" : {
      "string" : "string"
    }
  },
  "dnsSpec" : {
    "domain" : "vmware.com",
    "nameserver" : "172.0.0.4",
    "secondaryNameserver" : "172.0.0.5",
    "subdomain" : "vcf.vmware.com"
  },
  "dvSwitchVersion" : "One among:6.0.0, 6.5.0",
  "dvsSpecs" : [ {
    "dvsName" : "string",
    "mtu" : 0,
    "networks" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "niocSpecs" : [ {
      "trafficType" : "One among:VSAN, VMOTION, VIRTUALMACHINE, MANAGEMENT, NFS, VDP, HBR, FAULTTOLERANCE, ISCSI",
      "value" : "string"
    } ],
    "vmnics" : [ "string" ]
  } ],
  "esxLicense" : "string",
  "excludedComponents" : "One among:Foundation, VsphereHostProfiles, LogInsight, NSX, VrealizeNetwork, VSAN, VSANCleanup, VROPS, VRA, DRDeployment, DRConfiguration, ConfigurationBackup, VRB, VRSLCM, Inventory, UMDS, EsxThumbprintValidation, AVN, CEIP, Backup",
  "hostSpecs" : [ {
    "association" : "string",
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "hostname" : "esx-1",
    "ipAddressPrivate" : {
      "cidr" : "172.0.0.0/24",
      "gateway" : "192.168.0.1",
      "ipAddress" : "192.168.0.123",
      "subnet" : "255.255.255.252"
    },
    "key" : "string",
    "serverId" : "string",
    "sshThumbprint" : "string",
    "sslThumbprint" : "string",
    "vSwitch" : "string",
    "vmknicSpecs" : [ {
      "ipAddress" : "string",
      "macAddress" : "string",
      "portgroup" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION"
    } ],
    "vswitch" : "string"
  } ],
  "managementPoolName" : "string",
  "networkSpecs" : [ {
    "activeUplinks" : [ "string" ],
    "excludeIpAddressRanges" : [ "string" ],
    "excludeIpaddresses" : [ "string" ],
    "gateway" : "string",
    "includeIpAddress" : [ "string" ],
    "includeIpAddressRanges" : [ {
      "endIpAddress" : "192.168.0.128",
      "startIpAddress" : "192.168.0.123"
    } ],
    "mtu" : "string",
    "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "portGroupKey" : "string",
    "standbyUplinks" : [ "string" ],
    "subnet" : "string",
    "subnetMask" : "string",
    "teamingPolicy" : "One among:loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit, loadbalance_loadbased",
    "vlanId" : "string"
  } ],
  "nfsDatastoreName" : "string",
  "nsxSpec" : {
    "adminNsxControllerPassword" : "string",
    "adminNsxManagerPassword" : "string",
    "backupFtpServerAddress" : "string",
    "controllerIPPoolSpec" : {
      "defaultGateway" : "string",
      "endIp" : "string",
      "poolName" : "string",
      "prefix" : "string",
      "startIp" : "string"
    },
    "ftpBackupFolder" : "string",
    "ftpCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "ftpPassPhrase" : "string",
    "ftpPort" : 0,
    "license" : "string",
    "logicalSwitches" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "name" : "string",
      "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
      "transportZoneId" : "string"
    } ],
    "multicastRangeBegin" : "string",
    "multicastRangeEnd" : "string",
    "nsxBgpSpec" : {
      "defaultPassword" : "string",
      "localAutonomousSystem" : 0,
      "nsxEdgeBgpSpecs" : [ {
        "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
        "enableGracefulRestart" : true,
        "learnFrom" : [ "string" ],
        "neighbours" : [ {
          "autonomousSystem" : 0,
          "forwardingIp" : "192.168.0.123",
          "holdDownTimeSeconds" : 0,
          "keepAliveTimeSeconds" : 0,
          "neighbourIp" : "192.168.0.123",
          "password" : "string",
          "protocolIp" : "192.168.0.123",
          "weight" : 0
        } ]
      } ],
      "skipBgpValidation" : true
    },
    "nsxControllerVmNamesPrefix" : "string",
    "nsxEdgePassword" : "string",
    "nsxEdgeSpecs" : [ {
      "edgeName" : "string",
      "edgeSize" : "One among:compact, large, quadlarge, xlarge",
      "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
      "poolSpecs" : [ {
        "memberSpecs" : [ {
          "ipAddress" : "string",
          "monitorPort" : 0,
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "shortHostname" : "string",
      "vnics" : [ {
        "attachToLogicalSwitch" : true,
        "disconnected" : true,
        "name" : "string",
        "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
        "primaryIpAddress" : "string",
        "secondaryIpAddresses" : [ "string" ],
        "type" : "One among:uplink, internal",
        "useForDefaultRoute" : true,
        "useForDynamicRouterConfiguration" : true
      } ]
    } ],
    "nsxId" : "string",
    "nsxManagerHostname" : "string",
    "nsxManagerIp" : "string",
    "nsxSegmentRangeBegin" : "string",
    "nsxSegmentRangeEnd" : "string",
    "nsxVxlanSpec" : {
      "excludeIpAddressRanges" : [ "string" ],
      "gateway" : "string",
      "poolEndAddress" : "string",
      "poolStartAddress" : "string",
      "subnetWithCidr" : "string",
      "teamingPolicy" : "FAILOVER_ORDER",
      "vtepVmknicCount" : 0,
      "vxlanCluster" : "string",
      "vxlanDvs" : "string",
      "vxlanMtu" : "string",
      "vxlanPoolName" : "string",
      "vxlanVlanId" : "string"
    },
    "privilegedNsxManagerPassword" : "string",
    "transferProtocol" : "SFTP",
    "transportZones" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "id" : "universal-transport-zone",
      "name" : "string",
      "universal" : true
    } ],
    "universalMulticastRangeBegin" : "string",
    "universalMulticastRangeEnd" : "string",
    "universalSegmentRangeBegin" : "string",
    "universalSegmentRangeEnd" : "string"
  },
  "ntpServers" : [ "string" ],
  "pscLoadBalancerHostname" : "mgmt-psc",
  "pscLoadBalancerIpAddress" : "string",
  "pscSpecs" : [ {
    "adminUserSsoPassword" : "string",
    "automationUserSsoPassword" : "string",
    "automationUserSsoUsername" : "string",
    "pscHostName" : "string",
    "pscId" : "string",
    "pscIp" : "string",
    "pscSsoSpec" : {
      "adDomain" : "string",
      "adPassword" : "string",
      "adUsername" : "string",
      "isJoinSsoDomain" : true,
      "replicationPartner" : "string",
      "ssoDomain" : "string",
      "ssoSiteName" : "string"
    },
    "rootPscPassword" : "string"
  } ],
  "remoteSiteSpec" : {
    "clusterName" : "string",
    "datacenterName" : "string",
    "logicalSwitchNames" : [ "string" ],
    "nsxCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "nsxIp" : "string",
    "placeholderDatastore" : "string",
    "pscAddress" : "string",
    "remoteRegionVmFolders" : {
      "string" : "string"
    },
    "rpoMinutes" : 0,
    "siteName" : "string",
    "srmIp" : "string",
    "vcCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vcMgmtIp" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrRootPassword" : "string",
    "vrliAdminPassword" : "string",
    "vrliLoadBalancerHostname" : "string",
    "vrliNodesAddresses" : [ "string" ],
    "vrliRootPassword" : "string"
  },
  "sddcId" : "sfo01-workflowspec-ems",
  "sddcManagerSpec" : {
    "hostname" : "string",
    "ipAddress" : "string",
    "licenseKey" : "string",
    "netmask" : "string",
    "restApiCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "rootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "secondUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    }
  },
  "selfSignedCertificates" : "string",
  "shouldCleanupVsan" : false,
  "skipEsxThumbprintValidation" : true,
  "smtpSpec" : {
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "isSecureConnection" : true,
    "port" : 0,
    "requiresAuthentication" : true,
    "server" : "string",
    "useTlsEncryption" : true
  },
  "srmSpec" : {
    "dbPassword" : "string",
    "licenseKey" : "string",
    "srmAdminCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmHostname" : "string",
    "srmRootCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmVmAddress" : "string",
    "srmVmName" : "string"
  },
  "taskName" : "string",
  "umdsSpec" : {
    "address" : "string",
    "user" : "string",
    "userPassword" : "string"
  },
  "vcenterSpec" : {
    "licenseFile" : "string",
    "rootVcenterPassword" : "string",
    "vcenterHostname" : "string",
    "vcenterIp" : "string",
    "vcenterNetmask" : "string",
    "vmSize" : "One among:xlarge, large, medium, small, tiny"
  },
  "vrSpec" : {
    "ipPoolName" : "string",
    "rootPassword" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrShortHostName" : "string"
  },
  "vraDeploymentSpec" : {
    "brandingSpec" : {
      "backgroundColor" : "string",
      "companyName" : "string",
      "contactLink" : "string",
      "copyright" : "string",
      "privacyPolicyLink" : "string",
      "productName" : "string",
      "textColor" : "string"
    },
    "enableVroMultiTenancy" : true,
    "fabricGroupNames" : [ "string" ],
    "iaasTemplateName" : "string",
    "localAdministratorPassword" : "string",
    "localDefaultTenantAdmin" : {
      "email" : "string",
      "firstName" : "string",
      "lastName" : "string",
      "password" : "string",
      "username" : "string"
    },
    "msLbHostName" : "string",
    "msLbIpAddress" : "string",
    "msSqlServer" : {
      "address" : "string",
      "databaseName" : "string",
      "hostname" : "string",
      "instanceName" : "string",
      "password" : "string",
      "port" : 0,
      "username" : "string",
      "vmName" : "string"
    },
    "skipWindowsVms" : true,
    "systemAdminPassword" : "string",
    "tenantSpec" : {
      "email" : "string",
      "name" : "string",
      "url" : "string",
      "vraTenantAdministratorSpec" : {
        "email" : "string",
        "firstName" : "string",
        "lastName" : "string",
        "password" : "string",
        "username" : "string"
      }
    },
    "vraEmailProviderSpecs" : [ {
      "acceptSelfSignedCertificates" : true,
      "emailAddress" : "string",
      "inboundDirection" : "One among: INBOUND, OUTBOUND",
      "name" : "string",
      "password" : "string",
      "port" : 0,
      "protocol" : "One among: IMAP, SMTP",
      "serverAddress" : "string",
      "useSsl" : true,
      "username" : "string"
    } ],
    "vraLbHostName" : "string",
    "vraLbIpAddress" : "string",
    "vraNodeLicense" : "string",
    "vraRootPassword" : "string",
    "vraVms" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "isPrimary" : true,
      "name" : "string",
      "type" : "string"
    } ],
    "webLbHostName" : "string",
    "webLbIpAddress" : "string"
  },
  "vrbDeploymentSpec" : {
    "collectorNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "currency" : "string",
    "license" : "string",
    "serverNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "sshPassword" : "string"
  },
  "vrliDeploymentSpec" : {
    "adminEmail" : "string",
    "adminPassword" : "string",
    "archiveLocation" : "string",
    "eventForwardingSiteTag" : "string",
    "license" : "string",
    "loadBalancerHostname" : "string",
    "loadBalancerIpAddress" : "string",
    "networkType" : "string",
    "notificationEmails" : [ "string" ],
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "sshPassword" : "string",
    "vmSize" : "One among:large, medium, small, xsmall",
    "vrliNodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string"
    } ]
  },
  "vropsDeploymentSpec" : {
    "adminPassword" : "string",
    "collectorSize" : "One among:smallrc, largerc",
    "lbHostName" : "string",
    "lbIpAddress" : "string",
    "licenseKey" : "string",
    "nodeSize" : "One among:xsmall, small, medium, large, extra_large",
    "nodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string",
      "vropsNodeType" : "One among:MASTER, REPLICA, DATA, REMOTE_COLLECTOR"
    } ],
    "rebootVmAfterHddExtending" : true,
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "skipHddExtending" : true,
    "snmpReadCommunity" : "string",
    "vropsRootPassword" : "string"
  },
  "vrslcmDeploymentSpec" : {
    "apiPassword" : "string",
    "fqdn" : "vrslcm.vrack.vsphere.local",
    "ipAddress" : "string",
    "sshPassword" : "string"
  },
  "vsanSpec" : {
    "datastoreName" : "string",
    "hclFile" : "string",
    "licenseFile" : "string",
    "vsanDedup" : true,
    "vsanName" : "string"
  },
  "vxManagerSpec" : {
    "defaultAdminUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "defaultRootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vxManagerHostName" : "string"
  },
  "vxRailSpec" : {
    "vxRailObjectNames" : {
      "string" : "string"
    }
  }
}

3.102.9. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.103. Get all SDDC specification validations

GET /v1/sddcs/validations

3.103.1. Responses

HTTP Code Description Schema

200

Accepted

< Validation > array

404

Not Found

Error

500

Internal Server Error

Error

501

Not Implemented

Error

3.103.2. Consumes

  • application/json

3.103.3. Produces

  • application/json

3.103.4. Tags

  • SDDC

3.103.5. Security

Type Name

basic

basicAuth

3.103.6. Example HTTP request

Request path
/v1/sddcs/validations

3.103.7. Example HTTP response

Response 200
[ {
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
} ]
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 501
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.104. Get SDDC specification validation status by ID

GET /v1/sddcs/validations/{id}

3.104.1. Parameters

Type Name Description Schema

Path

id
required

SDDC validation ID

string

3.104.2. Responses

HTTP Code Description Schema

200

Accepted

Validation

400

Bad Request

Validation

404

Not Found

Error

500

Internal Server Error

Error

501

Not Implemented

Error

3.104.3. Consumes

  • application/json

3.104.4. Produces

  • application/json

3.104.5. Tags

  • SDDC

3.104.6. Security

Type Name

basic

basicAuth

3.104.7. Example HTTP request

Request path
/v1/sddcs/validations/string

3.104.8. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 501
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.105. Cancel SDDC specification validation

DELETE /v1/sddcs/validations/{id}

3.105.1. Description

Cancel the currently running SDDC specification validation

3.105.2. Parameters

Type Name Description Schema

Path

id
required

SDDC validation ID

string

3.105.3. Responses

HTTP Code Description Schema

200

Accepted

boolean

404

Not Found

Error

500

Internal Server Error

Error

3.105.4. Consumes

  • application/json

3.105.5. Produces

  • */*

3.105.6. Tags

  • SDDC

3.105.7. Security

Type Name

basic

basicAuth

3.105.8. Example HTTP request

Request path
/v1/sddcs/validations/string

3.105.9. Example HTTP response

Response 200
true
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.106. Retry SDDC validation

PATCH /v1/sddcs/validations/{id}

3.106.1. Description

Retry a completed SDDC validation

3.106.2. Parameters

Type Name Description Schema

Path

id
required

SDDC validation ID

string

Body

tests
optional

A list of tests to be retried

< string > array

3.106.3. Responses

HTTP Code Description Schema

200

Completed

Validation

405

Method Not Allowed

No Content

500

Internal Server Error

No Content

3.106.4. Consumes

  • application/json

3.106.5. Produces

  • */*

3.106.6. Tags

  • SDDC

3.106.7. Security

Type Name

basic

basicAuth

3.106.8. Example HTTP request

Request path
/v1/sddcs/validations/string
Request body
[ "string" ]

3.106.9. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}

3.107. Retrieve a SDDC

GET /v1/sddcs/{id}

3.107.1. Parameters

Type Name Description Schema

Path

id
required

SDDC ID

string

3.107.2. Responses

HTTP Code Description Schema

200

Accepted

SddcTask

404

Not Found

Error

500

Internal Server Error

Error

3.107.3. Consumes

  • application/json

3.107.4. Produces

  • application/json

3.107.5. Tags

  • SDDC

3.107.6. Security

Type Name

basic

basicAuth

3.107.7. Example HTTP request

Request path
/v1/sddcs/string

3.107.8. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.108. Retry failed SDDC creation

PATCH /v1/sddcs/{id}

3.108.1. Parameters

Type Name Description Schema

Path

id
required

SDDC ID

string

Body

sddcSpec
optional

sddcSpec

SddcSpec

3.108.2. Responses

HTTP Code Description Schema

200

OK

SddcTask

202

Success

SddcTask

404

Not Found

Error

405

Not allowed

Error

500

Internal Server Error

Error

3.108.3. Consumes

  • application/json

3.108.4. Produces

  • application/json

3.108.5. Tags

  • SDDC

3.108.6. Security

Type Name

basic

basicAuth

3.108.7. Example HTTP request

Request path
/v1/sddcs/string
Request body
{
  "adSpec" : {
    "childAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "domainControllers" : [ "string" ],
    "groups" : {
      "string" : "string"
    },
    "requireSsl" : true,
    "rootAdDetails" : {
      "alias" : "string",
      "baseDnGroups" : "string",
      "baseDnUsers" : "string",
      "globalCatalogPort" : 0,
      "name" : "string",
      "port" : 0,
      "serverUrl" : "string"
    },
    "skipJoinEsxi" : true,
    "useSubDomainForUsers" : true,
    "users" : {
      "string" : "<<_sddccredentials>>"
    }
  },
  "ceipEnabled" : true,
  "certificatesPassphrase" : "string",
  "clusterSpec" : {
    "clusterEvcMode" : "string",
    "clusterName" : "string",
    "hostFailuresToTolerate" : 0,
    "hostProfileComplianceCheckHour" : 0,
    "hostProfileComplianceCheckMinute" : 0,
    "hosts" : [ "string" ],
    "resourcePoolSpecs" : [ {
      "cpuLimit" : 0,
      "cpuReservationExpandable" : true,
      "cpuReservationMhz" : 0,
      "cpuReservationPercentage" : 0,
      "cpuSharesLevel" : "custom",
      "cpuSharesValue" : 0,
      "memoryLimit" : 0,
      "memoryReservationExpandable" : true,
      "memoryReservationMb" : 0,
      "memoryReservationPercentage" : 0,
      "memorySharesLevel" : "custom",
      "memorySharesValue" : 0,
      "name" : "string",
      "type" : "management"
    } ],
    "vmFolders" : {
      "string" : "string"
    }
  },
  "deploymentEndpointSpec" : {
    "cluster" : "string",
    "datacenter" : "string",
    "resourcePool" : "string",
    "storage" : "string",
    "vcenter" : {
      "address" : "string",
      "password" : "string",
      "username" : "string"
    },
    "vmFolder" : "string",
    "vmFolders" : {
      "string" : "string"
    }
  },
  "dnsSpec" : {
    "domain" : "vmware.com",
    "nameserver" : "172.0.0.4",
    "secondaryNameserver" : "172.0.0.5",
    "subdomain" : "vcf.vmware.com"
  },
  "dvSwitchVersion" : "One among:6.0.0, 6.5.0",
  "dvsSpecs" : [ {
    "dvsName" : "string",
    "mtu" : 0,
    "networks" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "niocSpecs" : [ {
      "trafficType" : "One among:VSAN, VMOTION, VIRTUALMACHINE, MANAGEMENT, NFS, VDP, HBR, FAULTTOLERANCE, ISCSI",
      "value" : "string"
    } ],
    "vmnics" : [ "string" ]
  } ],
  "esxLicense" : "string",
  "excludedComponents" : "One among:Foundation, VsphereHostProfiles, LogInsight, NSX, VrealizeNetwork, VSAN, VSANCleanup, VROPS, VRA, DRDeployment, DRConfiguration, ConfigurationBackup, VRB, VRSLCM, Inventory, UMDS, EsxThumbprintValidation, AVN, CEIP, Backup",
  "hostSpecs" : [ {
    "association" : "string",
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "hostname" : "esx-1",
    "ipAddressPrivate" : {
      "cidr" : "172.0.0.0/24",
      "gateway" : "192.168.0.1",
      "ipAddress" : "192.168.0.123",
      "subnet" : "255.255.255.252"
    },
    "key" : "string",
    "serverId" : "string",
    "sshThumbprint" : "string",
    "sslThumbprint" : "string",
    "vSwitch" : "string",
    "vmknicSpecs" : [ {
      "ipAddress" : "string",
      "macAddress" : "string",
      "portgroup" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION"
    } ],
    "vswitch" : "string"
  } ],
  "managementPoolName" : "string",
  "networkSpecs" : [ {
    "activeUplinks" : [ "string" ],
    "excludeIpAddressRanges" : [ "string" ],
    "excludeIpaddresses" : [ "string" ],
    "gateway" : "string",
    "includeIpAddress" : [ "string" ],
    "includeIpAddressRanges" : [ {
      "endIpAddress" : "192.168.0.128",
      "startIpAddress" : "192.168.0.123"
    } ],
    "mtu" : "string",
    "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
    "portGroupKey" : "string",
    "standbyUplinks" : [ "string" ],
    "subnet" : "string",
    "subnetMask" : "string",
    "teamingPolicy" : "One among:loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit, loadbalance_loadbased",
    "vlanId" : "string"
  } ],
  "nfsDatastoreName" : "string",
  "nsxSpec" : {
    "adminNsxControllerPassword" : "string",
    "adminNsxManagerPassword" : "string",
    "backupFtpServerAddress" : "string",
    "controllerIPPoolSpec" : {
      "defaultGateway" : "string",
      "endIp" : "string",
      "poolName" : "string",
      "prefix" : "string",
      "startIp" : "string"
    },
    "ftpBackupFolder" : "string",
    "ftpCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "ftpPassPhrase" : "string",
    "ftpPort" : 0,
    "license" : "string",
    "logicalSwitches" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "name" : "string",
      "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
      "transportZoneId" : "string"
    } ],
    "multicastRangeBegin" : "string",
    "multicastRangeEnd" : "string",
    "nsxBgpSpec" : {
      "defaultPassword" : "string",
      "localAutonomousSystem" : 0,
      "nsxEdgeBgpSpecs" : [ {
        "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
        "enableGracefulRestart" : true,
        "learnFrom" : [ "string" ],
        "neighbours" : [ {
          "autonomousSystem" : 0,
          "forwardingIp" : "192.168.0.123",
          "holdDownTimeSeconds" : 0,
          "keepAliveTimeSeconds" : 0,
          "neighbourIp" : "192.168.0.123",
          "password" : "string",
          "protocolIp" : "192.168.0.123",
          "weight" : 0
        } ]
      } ],
      "skipBgpValidation" : true
    },
    "nsxControllerVmNamesPrefix" : "string",
    "nsxEdgePassword" : "string",
    "nsxEdgeSpecs" : [ {
      "edgeName" : "string",
      "edgeSize" : "One among:compact, large, quadlarge, xlarge",
      "edgeType" : "One among:PSC_LB, MANAGEMENT_LB, ESG, DLR, UDLR",
      "poolSpecs" : [ {
        "memberSpecs" : [ {
          "ipAddress" : "string",
          "monitorPort" : 0,
          "name" : "string"
        } ],
        "name" : "string"
      } ],
      "shortHostname" : "string",
      "vnics" : [ {
        "attachToLogicalSwitch" : true,
        "disconnected" : true,
        "name" : "string",
        "networkType" : "One among:VSAN, VMOTION, PUBLIC, MANAGEMENT, NSX_VTEP, HOSTMANAGEMENT, CLOUD_VENDOR_API, REPLICATION, DATACENTER_NETWORK, NSX_VXLAN, NON_ROUTABLE, CLOUD_VENDOR_API, OOB, CROSS_VPC, UPLINK01, UPLINK02, STORAGE, UDLR, DLR, X_REGION, REGION_SPECIFIC, REMOTE_REGION_SPECIFIC, COMPUTE, MANAGEMENT_VM",
        "primaryIpAddress" : "string",
        "secondaryIpAddresses" : [ "string" ],
        "type" : "One among:uplink, internal",
        "useForDefaultRoute" : true,
        "useForDynamicRouterConfiguration" : true
      } ]
    } ],
    "nsxId" : "string",
    "nsxManagerHostname" : "string",
    "nsxManagerIp" : "string",
    "nsxSegmentRangeBegin" : "string",
    "nsxSegmentRangeEnd" : "string",
    "nsxVxlanSpec" : {
      "excludeIpAddressRanges" : [ "string" ],
      "gateway" : "string",
      "poolEndAddress" : "string",
      "poolStartAddress" : "string",
      "subnetWithCidr" : "string",
      "teamingPolicy" : "FAILOVER_ORDER",
      "vtepVmknicCount" : 0,
      "vxlanCluster" : "string",
      "vxlanDvs" : "string",
      "vxlanMtu" : "string",
      "vxlanPoolName" : "string",
      "vxlanVlanId" : "string"
    },
    "privilegedNsxManagerPassword" : "string",
    "transferProtocol" : "SFTP",
    "transportZones" : [ {
      "controlPlaneMode" : "One among:MULTICAST_MODE, HYBRID_MODE, UNICAST_MODE",
      "id" : "universal-transport-zone",
      "name" : "string",
      "universal" : true
    } ],
    "universalMulticastRangeBegin" : "string",
    "universalMulticastRangeEnd" : "string",
    "universalSegmentRangeBegin" : "string",
    "universalSegmentRangeEnd" : "string"
  },
  "ntpServers" : [ "string" ],
  "pscLoadBalancerHostname" : "mgmt-psc",
  "pscLoadBalancerIpAddress" : "string",
  "pscSpecs" : [ {
    "adminUserSsoPassword" : "string",
    "automationUserSsoPassword" : "string",
    "automationUserSsoUsername" : "string",
    "pscHostName" : "string",
    "pscId" : "string",
    "pscIp" : "string",
    "pscSsoSpec" : {
      "adDomain" : "string",
      "adPassword" : "string",
      "adUsername" : "string",
      "isJoinSsoDomain" : true,
      "replicationPartner" : "string",
      "ssoDomain" : "string",
      "ssoSiteName" : "string"
    },
    "rootPscPassword" : "string"
  } ],
  "remoteSiteSpec" : {
    "clusterName" : "string",
    "datacenterName" : "string",
    "logicalSwitchNames" : [ "string" ],
    "nsxCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "nsxIp" : "string",
    "placeholderDatastore" : "string",
    "pscAddress" : "string",
    "remoteRegionVmFolders" : {
      "string" : "string"
    },
    "rpoMinutes" : 0,
    "siteName" : "string",
    "srmIp" : "string",
    "vcCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vcMgmtIp" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrRootPassword" : "string",
    "vrliAdminPassword" : "string",
    "vrliLoadBalancerHostname" : "string",
    "vrliNodesAddresses" : [ "string" ],
    "vrliRootPassword" : "string"
  },
  "sddcId" : "sfo01-workflowspec-ems",
  "sddcManagerSpec" : {
    "hostname" : "string",
    "ipAddress" : "string",
    "licenseKey" : "string",
    "netmask" : "string",
    "restApiCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "rootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "secondUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    }
  },
  "selfSignedCertificates" : "string",
  "shouldCleanupVsan" : false,
  "skipEsxThumbprintValidation" : true,
  "smtpSpec" : {
    "credentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "isSecureConnection" : true,
    "port" : 0,
    "requiresAuthentication" : true,
    "server" : "string",
    "useTlsEncryption" : true
  },
  "srmSpec" : {
    "dbPassword" : "string",
    "licenseKey" : "string",
    "srmAdminCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmHostname" : "string",
    "srmRootCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "srmVmAddress" : "string",
    "srmVmName" : "string"
  },
  "taskName" : "string",
  "umdsSpec" : {
    "address" : "string",
    "user" : "string",
    "userPassword" : "string"
  },
  "vcenterSpec" : {
    "licenseFile" : "string",
    "rootVcenterPassword" : "string",
    "vcenterHostname" : "string",
    "vcenterIp" : "string",
    "vcenterNetmask" : "string",
    "vmSize" : "One among:xlarge, large, medium, small, tiny"
  },
  "vrSpec" : {
    "ipPoolName" : "string",
    "rootPassword" : "string",
    "vrIp" : "string",
    "vrReplicationIp" : "string",
    "vrShortHostName" : "string"
  },
  "vraDeploymentSpec" : {
    "brandingSpec" : {
      "backgroundColor" : "string",
      "companyName" : "string",
      "contactLink" : "string",
      "copyright" : "string",
      "privacyPolicyLink" : "string",
      "productName" : "string",
      "textColor" : "string"
    },
    "enableVroMultiTenancy" : true,
    "fabricGroupNames" : [ "string" ],
    "iaasTemplateName" : "string",
    "localAdministratorPassword" : "string",
    "localDefaultTenantAdmin" : {
      "email" : "string",
      "firstName" : "string",
      "lastName" : "string",
      "password" : "string",
      "username" : "string"
    },
    "msLbHostName" : "string",
    "msLbIpAddress" : "string",
    "msSqlServer" : {
      "address" : "string",
      "databaseName" : "string",
      "hostname" : "string",
      "instanceName" : "string",
      "password" : "string",
      "port" : 0,
      "username" : "string",
      "vmName" : "string"
    },
    "skipWindowsVms" : true,
    "systemAdminPassword" : "string",
    "tenantSpec" : {
      "email" : "string",
      "name" : "string",
      "url" : "string",
      "vraTenantAdministratorSpec" : {
        "email" : "string",
        "firstName" : "string",
        "lastName" : "string",
        "password" : "string",
        "username" : "string"
      }
    },
    "vraEmailProviderSpecs" : [ {
      "acceptSelfSignedCertificates" : true,
      "emailAddress" : "string",
      "inboundDirection" : "One among: INBOUND, OUTBOUND",
      "name" : "string",
      "password" : "string",
      "port" : 0,
      "protocol" : "One among: IMAP, SMTP",
      "serverAddress" : "string",
      "useSsl" : true,
      "username" : "string"
    } ],
    "vraLbHostName" : "string",
    "vraLbIpAddress" : "string",
    "vraNodeLicense" : "string",
    "vraRootPassword" : "string",
    "vraVms" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "isPrimary" : true,
      "name" : "string",
      "type" : "string"
    } ],
    "webLbHostName" : "string",
    "webLbIpAddress" : "string"
  },
  "vrbDeploymentSpec" : {
    "collectorNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "currency" : "string",
    "license" : "string",
    "serverNode" : {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string"
    },
    "sshPassword" : "string"
  },
  "vrliDeploymentSpec" : {
    "adminEmail" : "string",
    "adminPassword" : "string",
    "archiveLocation" : "string",
    "eventForwardingSiteTag" : "string",
    "license" : "string",
    "loadBalancerHostname" : "string",
    "loadBalancerIpAddress" : "string",
    "networkType" : "string",
    "notificationEmails" : [ "string" ],
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "sshPassword" : "string",
    "vmSize" : "One among:large, medium, small, xsmall",
    "vrliNodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string"
    } ]
  },
  "vropsDeploymentSpec" : {
    "adminPassword" : "string",
    "collectorSize" : "One among:smallrc, largerc",
    "lbHostName" : "string",
    "lbIpAddress" : "string",
    "licenseKey" : "string",
    "nodeSize" : "One among:xsmall, small, medium, large, extra_large",
    "nodeSpecs" : [ {
      "hostname" : "string",
      "ipAddress" : "string",
      "vmName" : "string",
      "vropsNodeType" : "One among:MASTER, REPLICA, DATA, REMOTE_COLLECTOR"
    } ],
    "rebootVmAfterHddExtending" : true,
    "senderSpec" : {
      "email" : "string",
      "name" : "string"
    },
    "skipHddExtending" : true,
    "snmpReadCommunity" : "string",
    "vropsRootPassword" : "string"
  },
  "vrslcmDeploymentSpec" : {
    "apiPassword" : "string",
    "fqdn" : "vrslcm.vrack.vsphere.local",
    "ipAddress" : "string",
    "sshPassword" : "string"
  },
  "vsanSpec" : {
    "datastoreName" : "string",
    "hclFile" : "string",
    "licenseFile" : "string",
    "vsanDedup" : true,
    "vsanName" : "string"
  },
  "vxManagerSpec" : {
    "defaultAdminUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "defaultRootUserCredentials" : {
      "password" : "Admin!23",
      "username" : "root"
    },
    "vxManagerHostName" : "string"
  },
  "vxRailSpec" : {
    "vxRailObjectNames" : {
      "string" : "string"
    }
  }
}

3.108.8. Example HTTP response

Response 200
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 202
{
  "creationTimestamp" : "string",
  "id" : "string",
  "localizableNamePack" : {
    "arguments" : [ "string" ],
    "component" : "string",
    "message" : "string",
    "messageKey" : "string"
  },
  "name" : "string",
  "sddcSubTasks" : [ {
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "localizableDescriptionPack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "localizableNamePack" : {
      "arguments" : [ "string" ],
      "component" : "string",
      "message" : "string",
      "messageKey" : "string"
    },
    "name" : "string",
    "processingStateDescription" : "string",
    "processingStateName" : "string",
    "sddcId" : "123e4567-e89b-42d3-a456-556642440000",
    "status" : "INITIALIZED, COMPLETED_WITH_SUCCESS, COMPLETED_WITH_FAILURE, PREVALIDATION_COMPLETED_WITH_SUCCESS, PREVALIDATION_COMPLETED_WITH_FAILURE, POSTVALIDATION_COMPLETED_WITH_SUCCESS, POSTVALIDATION_COMPLETED_WITH_FAILURE,IN_PROGRESS, PREVALIDATION_IN_PROGRESS, POSTVALIDATION_IN_PROGRESS, INTERNAL_ERROR",
    "updateTimestamp" : "string"
  } ],
  "status" : "One among: IN_PROGRESS, COMPLETED_WITH_SUCCESS, ROLLBACK_SUCCESS, COMPLETED_WITH_FAILURE"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.109. Get backup configuration used to backup NSX and SDDC manager

GET /v1/system/backup-configuration

3.109.1. Responses

HTTP Code Description Schema

200

Ok

BackupConfiguration

400

Bad Request

Error

500

Internal server error

Error

3.109.2. Consumes

  • application/json

3.109.3. Produces

  • application/json

3.109.4. Tags

  • BackupRestore

3.109.5. Security

Type Name

basic

basicAuth

3.109.6. Example HTTP request

Request path
/v1/system/backup-configuration

3.109.7. Example HTTP response

Response 200
{
  "backupLocations" : [ {
    "directoryPath" : "string",
    "password" : "string",
    "port" : 0,
    "protocol" : "SFTP",
    "server" : "string",
    "sshFingerprint" : "string",
    "username" : "string"
  } ],
  "encryption" : {
    "passphrase" : "string"
  },
  "isConfigured" : true
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.110. Configure backup settings to backup NSX and SDDC manager

PUT /v1/system/backup-configuration

3.110.1. Parameters

Type Name Description Schema

Header

privileged-password
required

privileged-password

string

Header

privileged-username
required

privileged-username

string

Body

backupConfigurationSpec
required

backupConfigurationSpec

BackupConfigurationSpec

3.110.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

Error

3.110.3. Consumes

  • application/json

3.110.4. Produces

  • application/json

3.110.5. Tags

  • BackupRestore

3.110.6. Security

Type Name

basic

basicAuth

3.110.7. Example HTTP request

Request path
/v1/system/backup-configuration
Request header
privileged-username:"string"
Request body
{
  "backupLocations" : [ {
    "directoryPath" : "string",
    "password" : "string",
    "port" : 0,
    "protocol" : "SFTP",
    "server" : "string",
    "sshFingerprint" : "string",
    "username" : "string"
  } ],
  "encryption" : {
    "passphrase" : "string"
  }
}

3.110.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.111. Edit backup configuration to backup NSX and SDDC manager

PATCH /v1/system/backup-configuration

3.111.1. Parameters

Type Name Description Schema

Header

privileged-password
required

privileged-password

string

Header

privileged-username
required

privileged-username

string

Body

backupConfigurationSpec
required

backupConfigurationSpec

BackupConfigurationSpec

3.111.2. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal server error

Error

3.111.3. Consumes

  • application/json

3.111.4. Produces

  • application/json

3.111.5. Tags

  • BackupRestore

3.111.6. Security

Type Name

basic

basicAuth

3.111.7. Example HTTP request

Request path
/v1/system/backup-configuration
Request header
privileged-username:"string"
Request body
{
  "backupLocations" : [ {
    "directoryPath" : "string",
    "password" : "string",
    "port" : 0,
    "protocol" : "SFTP",
    "server" : "string",
    "sshFingerprint" : "string",
    "username" : "string"
  } ],
  "encryption" : {
    "passphrase" : "string"
  }
}

3.111.8. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.112. Get CEIP status

GET /v1/system/ceip

3.112.1. Description

Get CEIP status and instance id

3.112.2. Responses

HTTP Code Description Schema

200

Ok

Ceip

500

InternalServerError

Error

3.112.3. Consumes

  • application/json

3.112.4. Produces

  • application/json

3.112.5. Tags

  • CEIP

3.112.6. Security

Type Name

basic

basicAuth

3.112.7. Example HTTP request

Request path
/v1/system/ceip

3.112.8. Example HTTP response

Response 200
{
  "instanceId" : "3f39d4a1-78d2-11e8-af85-f1cf26258cdc",
  "status" : "One among: ENABLED, DISABLED, ENABLING, DISABLING, ENABLING_FAILED, DISABLING_FAILED"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.113. Opt-in or Opt-out of CEIP

PATCH /v1/system/ceip

3.113.1. Description

Opt-in or Opt-out of CEIP

3.113.2. Parameters

Type Name Description Schema

Body

ceipUpdateSpec
required

Required action for CEIP.

CeipUpdateSpec

3.113.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

409

The request could not be completed due to a conflict with the current state

Error

500

InternalServerError

Error

3.113.4. Consumes

  • application/json

3.113.5. Produces

  • application/json

3.113.6. Tags

  • CEIP

3.113.7. Security

Type Name

basic

basicAuth

3.113.8. Example HTTP request

Request path
/v1/system/ceip
Request body
{
  "status" : "One among: ENABLE, DISABLE"
}

3.113.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.114. Precheck System

POST /v1/system/prechecks

3.114.1. Description

Perform precheck of resource(ex: Domain, Cluster). If only resource is specified, all resources/software components under it are included. If resource(Domain, Cluster etc) and specific resources/software components are provided, only those are included in precheck

3.114.2. Parameters

Type Name Description Schema

Body

precheckSpec
required

Precheck System Spec

PrecheckSpec

3.114.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.114.4. Consumes

  • application/json

3.114.5. Produces

  • application/json

3.114.6. Tags

  • SystemPrechecks

3.114.7. Security

Type Name

basic

basicAuth

3.114.8. Example HTTP request

Request path
/v1/system/prechecks
Request body
{
  "bundleId" : "string",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ]
}

3.114.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.115. Get Precheck Task by ID

GET /v1/system/prechecks/tasks/{id}

3.115.1. Description

Monitor the progress of precheck task by the precheck task ID

3.115.2. Parameters

Type Name Description Schema

Path

id
required

Precheck Task ID

string

3.115.3. Responses

HTTP Code Description Schema

200

Ok

Task

404

Precheck Task Not Found

Error

500

Internal Server Error

Error

3.115.4. Consumes

  • application/json

3.115.5. Produces

  • application/json

3.115.6. Tags

  • SystemPrechecks

3.115.7. Security

Type Name

basic

basicAuth

3.115.8. Example HTTP request

Request path
/v1/system/prechecks/tasks/string

3.115.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.116. Get Depot Settings

GET /v1/system/settings/depot

3.116.1. Description

Get the Depot Settings, In a fresh setup, this would be empty

3.116.2. Responses

HTTP Code Description Schema

200

Ok

DepotSettings

500

Internal Server Error

Error

3.116.3. Consumes

  • application/json

3.116.4. Produces

  • application/json

3.116.5. Tags

  • DepotSettings

3.116.6. Security

Type Name

basic

basicAuth

3.116.7. Example HTTP request

Request path
/v1/system/settings/depot

3.116.8. Example HTTP response

Response 200
{
  "vmwareAccount" : {
    "password" : "string",
    "username" : "string"
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.117. Update Depot Settings

PUT /v1/system/settings/depot

3.117.1. Description

Update Depot Settings. Depot Settings can be updated with VMware Depot Account

3.117.2. Parameters

Type Name Description Schema

Body

depotSettings
required

Depot Settings

DepotSettings

3.117.3. Responses

HTTP Code Description Schema

200

Ok

DepotSettings

400

Bad Request

Error

500

Internal Server Error

Error

3.117.4. Consumes

  • application/json

3.117.5. Produces

  • application/json

3.117.6. Tags

  • DepotSettings

3.117.7. Security

Type Name

basic

basicAuth

3.117.8. Example HTTP request

Request path
/v1/system/settings/depot
Request body
{
  "vmwareAccount" : {
    "password" : "string",
    "username" : "string"
  }
}

3.117.9. Example HTTP response

Response 200
{
  "vmwareAccount" : {
    "password" : "string",
    "username" : "string"
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.118. Get Version Alias Configuration

GET /v1/system/settings/version-aliases

3.118.1. Description

Get the Version Alias Configuration.

3.118.2. Responses

HTTP Code Description Schema

200

Ok

PageOfVersionAliasesForBundleComponentType

500

Internal Server Error

Error

3.118.3. Consumes

  • application/json

3.118.4. Produces

  • application/json

3.118.5. Tags

  • VersionAliasesForBundleComponentType

3.118.6. Security

Type Name

basic

basicAuth

3.118.7. Example HTTP request

Request path
/v1/system/settings/version-aliases

3.118.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleComponentType" : "One among: VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE, ",
    "versionAliases" : [ {
      "aliases" : [ "string" ],
      "version" : "string"
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.119. Update Version Alias Configurations

PUT /v1/system/settings/version-aliases

3.119.1. Description

Update Version Alias Configurations.

3.119.2. Parameters

Type Name Description Schema

Body

versionAliasesForBundleComponentTypeSpec
required

Version Alias Configuration Specification

VersionAliasesForBundleComponentTypeSpec

3.119.3. Responses

HTTP Code Description Schema

200

Ok

PageOfVersionAliasesForBundleComponentType

400

Bad Request

Error

500

Internal Server Error

Error

3.119.4. Consumes

  • application/json

3.119.5. Produces

  • application/json

3.119.6. Tags

  • VersionAliasesForBundleComponentType

3.119.7. Security

Type Name

basic

basicAuth

3.119.8. Example HTTP request

Request path
/v1/system/settings/version-aliases
Request body
{
  "forceUpdate" : true,
  "versionAliasesForBundleComponentTypes" : [ {
    "bundleComponentType" : "One among: VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE, ",
    "versionAliases" : [ {
      "aliases" : [ "string" ],
      "version" : "string"
    } ]
  } ]
}

3.119.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleComponentType" : "One among: VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE, ",
    "versionAliases" : [ {
      "aliases" : [ "string" ],
      "version" : "string"
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.120. Delete Version Alias for a bundle component type

DELETE /v1/system/settings/version-aliases/{bundleComponentType}

3.120.1. Description

Delete Version Alias for a bundle component type.

3.120.2. Parameters

Type Name Description Schema

Path

bundleComponentType
required

Bundle Component Type

enum (VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE)

3.120.3. Responses

HTTP Code Description Schema

200

OK

No Content

204

No Content

No Content

400

Bad Request

Error

500

Internal Server Error

Error

3.120.4. Consumes

  • application/json

3.120.5. Produces

  • application/json

3.120.6. Tags

  • VersionAliasesForBundleComponentType

3.120.7. Security

Type Name

basic

basicAuth

3.120.8. Example HTTP request

Request path
/v1/system/settings/version-aliases/VCENTER

3.120.9. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.121. Update Version Alias Configuration

PUT /v1/system/settings/version-aliases/{bundleComponentType}/{version}

3.121.1. Description

Update Version Alias Configuration.

3.121.2. Parameters

Type Name Description Schema

Path

bundleComponentType
required

Bundle Component Type

enum (VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE)

Path

version
required

Version

string

Body

aliasSpec
required

Alias Specification

AliasSpec

3.121.3. Responses

HTTP Code Description Schema

200

Ok

PageOfVersionAliasesForBundleComponentType

400

Bad Request

Error

500

Internal Server Error

Error

3.121.4. Consumes

  • application/json

3.121.5. Produces

  • application/json

3.121.6. Tags

  • VersionAliasesForBundleComponentType

3.121.7. Security

Type Name

basic

basicAuth

3.121.8. Example HTTP request

Request path
/v1/system/settings/version-aliases/VCENTER/string
Request body
{
  "aliases" : [ "string" ],
  "forceUpdate" : true
}

3.121.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleComponentType" : "One among: VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE, ",
    "versionAliases" : [ {
      "aliases" : [ "string" ],
      "version" : "string"
    } ]
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.122. Delete Version Alias Configuration

DELETE /v1/system/settings/version-aliases/{bundleComponentType}/{version}

3.122.1. Description

Delete Version Alias Configuration by bundle component type, version, and aliases.

3.122.2. Parameters

Type Name Description Schema

Path

bundleComponentType
required

Bundle Component Type

enum (VCENTER, PSC, NSX_T_MANAGER, NSX_MANAGER, ESX_HOST, VCF_VRA_UPGRADE, VCF_VRLI_UPGRADE, VCF_VROPS_UPGRADE, VCF_VRSLCM_UPGRADE, SDDC_MANAGER_VCF, LCM, SDDC_MANAGER, SDDC_MANAGER_UI, OPERATIONS_MANAGER, COMMON_SERVICES, SOLUTIONS_MANAGER, MULTI_SITE_SERVICE)

Path

version
required

Version

string

Body

aliasVersions
optional

List of alias versions

< string > array

3.122.3. Responses

HTTP Code Description Schema

200

OK

No Content

204

No Content

No Content

400

Bad Request

Error

500

Internal Server Error

Error

3.122.4. Consumes

  • application/json

3.122.5. Produces

  • */*

3.122.6. Tags

  • VersionAliasesForBundleComponentType

3.122.7. Security

Type Name

basic

basicAuth

3.122.8. Example HTTP request

Request path
/v1/system/settings/version-aliases/VCENTER/string
Request body
[ "string" ]

3.122.9. Example HTTP response

Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.123. Get the Upgradables

GET /v1/system/upgradables

3.123.1. Description

Fetches the list of Upgradables in the System. Only one Upgradable becomes AVAILABLE for Upgrade. The Upgradables provides information that can be use for Precheck API and also in the actual Upgrade API call.

3.123.2. Responses

HTTP Code Description Schema

200

Ok

PageOfUpgradable

500

Internal Server Error

Error

3.123.3. Consumes

  • application/json

3.123.4. Produces

  • application/json

3.123.5. Tags

  • Upgradables

3.123.6. Security

Type Name

basic

basicAuth

3.123.7. Example HTTP request

Request path
/v1/system/upgradables

3.123.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleId" : "string",
    "bundleType" : "string",
    "resource" : {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    },
    "softwareComponents" : [ {
      "id" : "string",
      "type" : "string"
    } ],
    "status" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.124. Get the Tasks

GET /v1/tasks

3.124.1. Description

Get the Tasks

3.124.2. Parameters

Type Name Description Schema

Query

limit
optional

The number of elements to be returned in the result

integer (int32)

Query

resourceId
optional

resourceId

string

Query

resourceType
optional

resourceType

string

Query

taskStatus
optional

taskStatus

string

Query

taskType
optional

taskType

string

3.124.3. Responses

HTTP Code Description Schema

200

Returns the list of tasks.

PageOfTask

500

Unexpected error

Error

3.124.4. Consumes

  • application/json

3.124.5. Produces

  • application/json

3.124.6. Tags

  • Tasks

3.124.7. Security

Type Name

basic

basicAuth

3.124.8. Example HTTP request

Request path
/v1/tasks

3.124.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "id" : "string",
    "isCancellable" : true,
    "name" : "string",
    "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
    "subTasks" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "errors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "name" : "string",
      "resources" : [ {
        "fqdn" : "string",
        "name" : "string",
        "resourceId" : "string",
        "type" : "string"
      } ],
      "stages" : [ {
        "completionTimestamp" : "string",
        "creationTimestamp" : "string",
        "description" : "string",
        "name" : "string",
        "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
        "type" : "string"
      } ],
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.125. Get a Task

GET /v1/tasks/{id}

3.125.1. Description

Get a Task by ID, if it exists

3.125.2. Parameters

Type Name Description Schema

Path

id
required

Task id to retrieve

string

3.125.3. Responses

HTTP Code Description Schema

200

A task object.

Task

404

Task not found

Error

500

Unexpected error

Error

3.125.4. Consumes

  • application/json

3.125.5. Produces

  • application/json

3.125.6. Tags

  • Tasks

3.125.7. Security

Type Name

basic

basicAuth

3.125.8. Example HTTP request

Request path
/v1/tasks/string

3.125.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.126. Cancel a Task

DELETE /v1/tasks/{id}

3.126.1. Description

Cancel a Task by ID, if it exists

3.126.2. Parameters

Type Name Description Schema

Path

id
required

Task id for cancelling

string

3.126.3. Responses

HTTP Code Description Schema

200

Task was cancelled successfully.

No Content

404

Task not found

Error

409

Task can not be cancelled. Only a IN_PROGRESS task can be cancelled.

Error

500

Unexpected error

Error

3.126.4. Consumes

  • application/json

3.126.5. Produces

  • */*

3.126.6. Tags

  • Tasks

3.126.7. Security

Type Name

basic

basicAuth

3.126.8. Example HTTP request

Request path
/v1/tasks/string

3.126.9. Example HTTP response

Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.127. Retry a Task

PATCH /v1/tasks/{id}

3.127.1. Description

Retry a failed Task by ID, if it exists

3.127.2. Parameters

Type Name Description Schema

Path

id
required

Task id retry

string

3.127.3. Responses

HTTP Code Description Schema

200

Task was retried successfully.

No Content

404

Task not found

Error

409

Task can not be retried. Only a failed Task can be retried.

Error

500

Unexpected error

Error

3.127.4. Consumes

  • application/json

3.127.5. Produces

  • */*

3.127.6. Tags

  • Tasks

3.127.7. Security

Type Name

basic

basicAuth

3.127.8. Example HTTP request

Request path
/v1/tasks/string

3.127.9. Example HTTP response

Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.128. Get NSX-T upgradable resources

GET /v1/upgradables/domains/{domainId}/nsxt

3.128.1. Description

Get the list NSX-T upgradable reosurce with resource metadata info

3.128.2. Parameters

Type Name Description Schema

Path

domainId
required

Domain ID

string

Query

bundleId
optional

bundle Id of the upgrade bundle applicable on the domain

string

3.128.3. Responses

HTTP Code Description Schema

200

Ok

NsxtResources

404

Bundle not found

Error

500

Internal Server Error

Error

3.128.4. Consumes

  • application/json

3.128.5. Produces

  • application/json

3.128.6. Tags

  • Upgradables

3.128.7. Security

Type Name

basic

basicAuth

3.128.8. Example HTTP request

Request path
/v1/upgradables/domains/string/nsxt

3.128.9. Example HTTP response

Response 200
{
  "bundleId" : "string",
  "domainId" : "string",
  "nsxtEdgeClusters" : [ {
    "id" : "string",
    "name" : "string",
    "resourceHealth" : "string",
    "upgradeStatus" : "string",
    "version" : "string"
  } ],
  "nsxtHostClusters" : [ {
    "domainId" : "string",
    "id" : "string",
    "name" : "string",
    "resourceHealth" : "string",
    "totalUnits" : 0,
    "upgradeStatus" : "string",
    "upgradedUnits" : 0,
    "version" : "string"
  } ],
  "nsxtManagerCluster" : {
    "id" : "string",
    "name" : "string",
    "resourceHealth" : "string",
    "upgradeStatus" : "string",
    "version" : "string"
  },
  "nsxtUpgradeCoordinator" : {
    "enabledOn" : "string",
    "id" : "string",
    "resourceHealth" : "string",
    "upgradeStatus" : "string",
    "version" : "string"
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.129. Perform Upgrade

POST /v1/upgrades

3.129.1. Description

Schedule/Trigger Upgrade of a Resource. Ex: Resource can be DOMAIN, CLUSTER, UNMANAGED_HOST etc. Performing upgrades are supported on VMware Cloud Foundation 3.5 BOM resources and above.

3.129.2. Parameters

Type Name Description Schema

Body

upgradeSpec
required

Upgrade Specification

UpgradeSpec

3.129.3. Responses

HTTP Code Description Schema

200

OK

Task

202

Accepted

Task

400

Bad Request

Error

500

Internal Server Error

Error

3.129.4. Consumes

  • application/json

3.129.5. Produces

  • application/json

3.129.6. Tags

  • Upgrades

3.129.7. Security

Type Name

basic

basicAuth

3.129.8. Example HTTP request

Request path
/v1/upgrades
Request body
{
  "bundleId" : "string",
  "nsxtUpgradeUserInputSpecs" : [ {
    "nsxtEdgeClusterUpgradeSpecs" : [ {
      "edgeClusterId" : "string",
      "edgeParallelUpgrade" : true
    } ],
    "nsxtHostClusterUpgradeSpecs" : [ {
      "hostClusterId" : "string",
      "hostParallelUpgrade" : true,
      "liveUpgrade" : true
    } ],
    "nsxtId" : "string",
    "nsxtUpgradeOptions" : {
      "isEdgeClustersUpgradeParallel" : true,
      "isEdgeOnlyUpgrade" : true,
      "isHostClustersUpgradeParallel" : true
    }
  } ],
  "parallelUpgrade" : true,
  "resourceType" : "One among: DOMAIN, CLUSTER, UNASSIGNED_HOST",
  "resourceUpgradeSpecs" : [ {
    "resourceId" : "string",
    "scheduledTimestamp" : "string",
    "shutdownVms" : true,
    "toVersion" : "string",
    "upgradeNow" : true
  } ]
}

3.129.9. Example HTTP response

Response 200
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.130. Get Upgrades

GET /v1/upgrades

3.130.1. Description

Get Upgrades

3.130.2. Parameters

Type Name Description Schema

Query

bundleId
optional

Bundle Id for the upgrade

string

Query

status
optional

Status of the upgrades you want to retrieve

string

3.130.3. Responses

HTTP Code Description Schema

200

OK

PageOfUpgrade

404

Upgrade not found

Error

500

Internal Server Error

Error

3.130.4. Consumes

  • application/json

3.130.5. Produces

  • application/json

3.130.6. Tags

  • Upgrades

3.130.7. Security

Type Name

basic

basicAuth

3.130.8. Example HTTP request

Request path
/v1/upgrades

3.130.9. Example HTTP response

Response 200
{
  "elements" : [ {
    "bundleId" : "string",
    "id" : "string",
    "nsxtUpgradeUserInputSpec" : {
      "nsxtEdgeClusterUpgradeSpecs" : [ {
        "edgeClusterId" : "string",
        "edgeParallelUpgrade" : true
      } ],
      "nsxtHostClusterUpgradeSpecs" : [ {
        "hostClusterId" : "string",
        "hostParallelUpgrade" : true,
        "liveUpgrade" : true
      } ],
      "nsxtId" : "string",
      "nsxtUpgradeOptions" : {
        "isEdgeClustersUpgradeParallel" : true,
        "isEdgeOnlyUpgrade" : true,
        "isHostClustersUpgradeParallel" : true
      }
    },
    "parallelUpgrade" : true,
    "resourceType" : "One among: DOMAIN, CLUSTER, UNASSIGNED_HOST",
    "resourceUpgradeSpecs" : [ {
      "resourceId" : "string",
      "scheduledTimestamp" : "string",
      "shutdownVms" : true,
      "toVersion" : "string",
      "upgradeNow" : true
    } ],
    "status" : "string",
    "taskId" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.131. Get Upgrade By Id

GET /v1/upgrades/{upgradeId}

3.131.1. Description

Get Upgrade By Id

3.131.2. Parameters

Type Name Description Schema

Path

upgradeId
required

upgradeId

string

3.131.3. Responses

HTTP Code Description Schema

200

OK

Upgrade

404

Upgrade not found

Error

500

Internal Server Error

Error

3.131.4. Consumes

  • application/json

3.131.5. Produces

  • application/json

3.131.6. Tags

  • Upgrades

3.131.7. Security

Type Name

basic

basicAuth

3.131.8. Example HTTP request

Request path
/v1/upgrades/string

3.131.9. Example HTTP response

Response 200
{
  "bundleId" : "string",
  "id" : "string",
  "nsxtUpgradeUserInputSpec" : {
    "nsxtEdgeClusterUpgradeSpecs" : [ {
      "edgeClusterId" : "string",
      "edgeParallelUpgrade" : true
    } ],
    "nsxtHostClusterUpgradeSpecs" : [ {
      "hostClusterId" : "string",
      "hostParallelUpgrade" : true,
      "liveUpgrade" : true
    } ],
    "nsxtId" : "string",
    "nsxtUpgradeOptions" : {
      "isEdgeClustersUpgradeParallel" : true,
      "isEdgeOnlyUpgrade" : true,
      "isHostClustersUpgradeParallel" : true
    }
  },
  "parallelUpgrade" : true,
  "resourceType" : "One among: DOMAIN, CLUSTER, UNASSIGNED_HOST",
  "resourceUpgradeSpecs" : [ {
    "resourceId" : "string",
    "scheduledTimestamp" : "string",
    "shutdownVms" : true,
    "toVersion" : "string",
    "upgradeNow" : true
  } ],
  "status" : "string",
  "taskId" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.132. Get vCenters

GET /v1/vcenters

3.132.1. Parameters

Type Name Description Schema

Query

domainId
optional

ID of the domain

string

3.132.2. Responses

HTTP Code Description Schema

200

Ok

Vcenter

400

Bad Request

Error

500

InternalServerError

Error

3.132.3. Consumes

  • application/json

3.132.4. Produces

  • application/json

3.132.5. Tags

  • vCenters

3.132.6. Security

Type Name

basic

basicAuth

3.132.7. Example HTTP request

Request path
/v1/vcenters

3.132.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.133. Get a vCenter

GET /v1/vcenters/{id}

3.133.1. Parameters

Type Name Description Schema

Path

id
required

vCenter ID

string

3.133.2. Responses

HTTP Code Description Schema

200

Ok

Vcenter

404

vCenter not found

Error

500

InternalServerError

Error

3.133.3. Consumes

  • application/json

3.133.4. Produces

  • application/json

3.133.5. Tags

  • vCenters

3.133.6. Security

Type Name

basic

basicAuth

3.133.7. Example HTTP request

Request path
/v1/vcenters/string

3.133.8. Example HTTP response

Response 200
{
  "domain" : {
    "id" : "string"
  },
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.134. Get the VcfServices

GET /v1/vcf-services

3.134.1. Responses

HTTP Code Description Schema

200

Ok

VcfService

400

Bad Request

Error

500

InternalServerError

Error

3.134.2. Consumes

  • application/json

3.134.3. Produces

  • application/json

3.134.4. Tags

  • VcfServices

3.134.5. Security

Type Name

basic

basicAuth

3.134.6. Example HTTP request

Request path
/v1/vcf-services

3.134.7. Example HTTP response

Response 200
{
  "id" : "string",
  "name" : "string",
  "version" : "string"
}
Response 400
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.135. Get a VcfService

GET /v1/vcf-services/{id}

3.135.1. Parameters

Type Name Description Schema

Path

id
required

VcfService ID

string

3.135.2. Responses

HTTP Code Description Schema

200

Ok

VcfService

404

VcfService not found

Error

500

InternalServerError

Error

3.135.3. Consumes

  • application/json

3.135.4. Produces

  • application/json

3.135.5. Tags

  • VcfServices

3.135.6. Security

Type Name

basic

basicAuth

3.135.7. Example HTTP request

Request path
/v1/vcf-services/string

3.135.8. Example HTTP response

Response 200
{
  "id" : "string",
  "name" : "string",
  "version" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.136. Get the existing vRealize Log Insight

GET /v1/vrli

3.136.1. Description

Gets the complete information about the existing vRealize Log Insight instance.

3.136.2. Responses

HTTP Code Description Schema

200

OK

Vrli

404

Not Found

No Content

500

Internal Server Error

Error

3.136.3. Consumes

  • application/json

3.136.4. Produces

  • application/json

3.136.5. Tags

  • vRLI

3.136.6. Security

Type Name

basic

basicAuth

3.136.7. Example HTTP request

Request path
/v1/vrli

3.136.8. Example HTTP response

Response 200
{
  "id" : "string",
  "loadBalancerFqdn" : "load-balancer.vrack.vsphere.local",
  "loadBalancerIpAddress" : "10.0.0.15",
  "nodeSize" : "SMALL, MEDIUM, LARGE",
  "nodes" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER"
  } ],
  "status" : "ACTIVE, ERROR",
  "version" : "4.8.0-13036238",
  "workloadDomainConnection" : true
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.137. Connects vRealize Log Insight with workload domains

PATCH /v1/vrli

3.137.1. Description

Connects vRealize Log Insight with workload domains

3.137.2. Parameters

Type Name Description Schema

Body

vrli
required

vrli

Vrli

3.137.3. Responses

HTTP Code Description Schema

202

Accepted

Vrli

405

Not Allowed

No Content

500

Internal Server Error

Error

3.137.4. Consumes

  • application/json

3.137.5. Produces

  • application/json

3.137.6. Tags

  • vRLI

3.137.7. Security

Type Name

basic

basicAuth

3.137.8. Example HTTP request

Request path
/v1/vrli
Request body
{
  "id" : "string",
  "loadBalancerFqdn" : "load-balancer.vrack.vsphere.local",
  "loadBalancerIpAddress" : "10.0.0.15",
  "nodeSize" : "SMALL, MEDIUM, LARGE",
  "nodes" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER"
  } ],
  "status" : "ACTIVE, ERROR",
  "version" : "4.8.0-13036238",
  "workloadDomainConnection" : true
}

3.137.9. Example HTTP response

Response 202
{
  "id" : "string",
  "loadBalancerFqdn" : "load-balancer.vrack.vsphere.local",
  "loadBalancerIpAddress" : "10.0.0.15",
  "nodeSize" : "SMALL, MEDIUM, LARGE",
  "nodes" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER"
  } ],
  "status" : "ACTIVE, ERROR",
  "version" : "4.8.0-13036238",
  "workloadDomainConnection" : true
}
Response 500
{
  "arguments" : [ "string" ],
  "causes" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.138. Get all existing vRealize Log Insight instances

GET /v1/vrlis

3.138.1. Responses

HTTP Code Description Schema

200

OK

PageOfVrli

3.138.2. Consumes

  • application/json

3.138.3. Produces

  • application/json

3.138.4. Tags

  • vRLI

3.138.5. Security

Type Name

basic

basicAuth

3.138.6. Example HTTP request

Request path
/v1/vrlis

3.138.7. Example HTTP response

Response 200
{
  "elements" : [ {
    "id" : "string",
    "loadBalancerFqdn" : "load-balancer.vrack.vsphere.local",
    "loadBalancerIpAddress" : "10.0.0.15",
    "nodeSize" : "SMALL, MEDIUM, LARGE",
    "nodes" : [ {
      "fqdn" : "vrops.vrack.vsphere.local",
      "id" : "string",
      "ipAddress" : "10.0.0.17",
      "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER"
    } ],
    "status" : "ACTIVE, ERROR",
    "version" : "4.8.0-13036238",
    "workloadDomainConnection" : true
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}

3.139. Get the existing vRealize Operations

GET /v1/vrops

3.139.1. Description

Gets the complete information about the existing vRealize Operations instance.

3.139.2. Responses

HTTP Code Description Schema

200

OK

Vrops

404

Not Found

No Content

500

Internal Server Error

ErrorResponse

3.139.3. Consumes

  • application/json

3.139.4. Produces

  • application/json

3.139.5. Tags

  • vROPs

3.139.6. Security

Type Name

basic

basicAuth

3.139.7. Example HTTP request

Request path
/v1/vrops

3.139.8. Example HTTP response

Response 200
{
  "id" : "string",
  "loadBalancerFqdn" : "string",
  "loadBalancerIp" : "string",
  "nodeSize" : "string",
  "nodes" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "password" : "string",
    "status" : "ACTIVE",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
    "username" : "user"
  } ],
  "status" : "string",
  "version" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.140. Rollback vRealize Operations

DELETE /v1/vrops

3.140.1. Description

Triggers the vRealize Operations rollback operation and returns an URL in the headers to track the operation status.

3.140.2. Responses

HTTP Code Description Schema

202

Accepted

Task

405

Method Not Allowed

ErrorResponse

500

Internal Server Error

ErrorResponse

3.140.3. Consumes

  • application/json

3.140.4. Produces

  • application/json

3.140.5. Tags

  • vROPs

3.140.6. Security

Type Name

basic

basicAuth

3.140.7. Example HTTP request

Request path
/v1/vrops

3.140.8. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.141. Get vRealize Operations connection to Workload domains

GET /v1/vrops/domains

3.141.1. Description

Retrieves all the existing workload domains and their connection status with vRealize Operations.

3.141.2. Responses

HTTP Code Description Schema

200

OK

PageOfDomainIntegration

3.141.3. Consumes

  • application/json

3.141.4. Produces

  • application/json

3.141.5. Tags

  • vROPs

3.141.6. Security

Type Name

basic

basicAuth

3.141.7. Example HTTP request

Request path
/v1/vrops/domains

3.141.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "domainId" : "string",
    "status" : "ENABLED, DISABLED, IN_PROGRESS"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}

3.142. Connect/disconnect workload domains with vRealize Operations

PUT /v1/vrops/domains

3.142.1. Description

Connects/disconnects a workload domains with vRealize Operations

3.142.2. Parameters

Type Name Description Schema

Body

domainIntegration
required

Domain Integration Specification

DomainIntegration

3.142.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

500

Internal Server Error

ErrorResponse

3.142.4. Consumes

  • application/json

3.142.5. Produces

  • application/json

3.142.6. Tags

  • vROPs

3.142.7. Security

Type Name

basic

basicAuth

3.142.8. Example HTTP request

Request path
/v1/vrops/domains
Request body
{
  "domainId" : "string",
  "status" : "ENABLED, DISABLED, IN_PROGRESS"
}

3.142.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.143. Expand vRealize Operations by adding a new DATA node

POST /v1/vrops/nodes

3.143.1. Description

Triggers the vRealize Operations expansion operation and adds a new DATA node to the existing vRealize Operations cluster.

3.143.2. Parameters

Type Name Description Schema

Body

vropsNode
required

vRealize Operations Expansion Specification

VropsNode

3.143.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

405

Method Not Allowed

ErrorResponse

500

Internal Server Error

ErrorResponse

3.143.4. Consumes

  • application/json

3.143.5. Produces

  • application/json

3.143.6. Tags

  • vROPs

3.143.7. Security

Type Name

basic

basicAuth

3.143.8. Example HTTP request

Request path
/v1/vrops/nodes
Request body
{
  "fqdn" : "vrops.vrack.vsphere.local",
  "id" : "string",
  "ipAddress" : "10.0.0.17",
  "password" : "string",
  "status" : "ACTIVE",
  "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
  "username" : "user"
}

3.143.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.144. Get all vRealize Operations nodes

GET /v1/vrops/nodes

3.144.1. Description

Retrieves all the existing vRealize Operations nodes

3.144.2. Responses

HTTP Code Description Schema

200

OK

PageOfVropsNode

3.144.3. Consumes

  • application/json

3.144.4. Produces

  • application/json

3.144.5. Tags

  • vROPs

3.144.6. Security

Type Name

basic

basicAuth

3.144.7. Example HTTP request

Request path
/v1/vrops/nodes

3.144.8. Example HTTP response

Response 200
{
  "elements" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "password" : "string",
    "status" : "ACTIVE",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
    "username" : "user"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}

3.145. Rollback after failed vRealize Operations expansion

DELETE /v1/vrops/nodes/{id}

3.145.1. Description

Triggers the vRealize Operations rollback operation after the failed expansion workflow. The operation is available only if the expansion with the new node through the vRealize Suite Lifecycle Manager is not completed successfully. In order for the rollback to succeed, the vRealize Operation Cluster must be in a healthy state.

3.145.2. Parameters

Type Name Description Schema

Path

id
required

id

string

3.145.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

409

Conflict

ErrorResponse

500

Internal Server Error

ErrorResponse

3.145.4. Consumes

  • application/json

3.145.5. Produces

  • application/json

3.145.6. Tags

  • vROPs

3.145.7. Security

Type Name

basic

basicAuth

3.145.8. Example HTTP request

Request path
/v1/vrops/nodes/string

3.145.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 409
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.146. Deploy vRealize Operations

POST /v1/vropses

3.146.1. Description

Triggers the vRealize Operations deployment operation and returns an URL in the headers to track the operation status.

3.146.2. Parameters

Type Name Description Schema

Body

vropsDeploymentSpec
required

vRealize Operations Deployment Specification

VropsDeploymentSpec

3.146.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

405

Method Not Allowed

ErrorResponse

500

Internal Server Error

ErrorResponse

3.146.4. Consumes

  • application/json

3.146.5. Produces

  • application/json

3.146.6. Tags

  • vROPs

3.146.7. Security

Type Name

basic

basicAuth

3.146.8. Example HTTP request

Request path
/v1/vropses
Request body
{
  "apiPassword" : "string",
  "enableHa" : true,
  "licenseKey" : "string",
  "loadBalancerFqdn" : "vrealize-lb.vrack.vsphere.local",
  "nodeSize" : "MEDIUM",
  "nodes" : [ {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "password" : "string",
    "status" : "ACTIVE",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
    "username" : "user"
  } ],
  "vrealizeEdgeFqdn" : "vrealize-edge.vrack.vsphere.local"
}

3.146.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.147. Get all existing vRealize Operations instances

GET /v1/vropses

3.147.1. Responses

HTTP Code Description Schema

200

OK

PageOfVrops

3.147.2. Consumes

  • application/json

3.147.3. Produces

  • application/json

3.147.4. Tags

  • vROPs

3.147.5. Security

Type Name

basic

basicAuth

3.147.6. Example HTTP request

Request path
/v1/vropses

3.147.7. Example HTTP response

Response 200
{
  "elements" : [ {
    "id" : "string",
    "loadBalancerFqdn" : "string",
    "loadBalancerIp" : "string",
    "nodeSize" : "string",
    "nodes" : [ {
      "fqdn" : "vrops.vrack.vsphere.local",
      "id" : "string",
      "ipAddress" : "10.0.0.17",
      "password" : "string",
      "status" : "ACTIVE",
      "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
      "username" : "user"
    } ],
    "status" : "string",
    "version" : "string"
  } ],
  "pageMetadata" : {
    "pageNumber" : 0,
    "pageSize" : 0,
    "totalElements" : 0,
    "totalPages" : 0
  }
}

3.148. Validate vRealize Operations Input Specification

POST /v1/vropses/validations

3.148.1. Description

Triggers input spec validation for various vRealize Operations worflows

3.148.2. Parameters

Type Name Description Schema

Body

vropsOperationSpec
required

vRealize Operations Validation Specification

VropsOperationSpecValidation

3.148.3. Responses

HTTP Code Description Schema

200

OK

Validation

202

Accepted

Validation

400

Bad Request

ErrorResponse

3.148.4. Consumes

  • application/json

3.148.5. Produces

  • application/json

3.148.6. Tags

  • vROPs

3.148.7. Security

Type Name

basic

basicAuth

3.148.8. Example HTTP request

Request path
/v1/vropses/validations
Request body
{
  "vropsDeploymentSpec" : {
    "apiPassword" : "string",
    "enableHa" : true,
    "licenseKey" : "string",
    "loadBalancerFqdn" : "vrealize-lb.vrack.vsphere.local",
    "nodeSize" : "MEDIUM",
    "nodes" : [ {
      "fqdn" : "vrops.vrack.vsphere.local",
      "id" : "string",
      "ipAddress" : "10.0.0.17",
      "password" : "string",
      "status" : "ACTIVE",
      "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
      "username" : "user"
    } ],
    "vrealizeEdgeFqdn" : "vrealize-edge.vrack.vsphere.local"
  },
  "vropsExpansionSpec" : {
    "fqdn" : "vrops.vrack.vsphere.local",
    "id" : "string",
    "ipAddress" : "10.0.0.17",
    "password" : "string",
    "status" : "ACTIVE",
    "type" : "MASTER, REPLICA, DATA, REMOTE_COLLECTOR, WORKER",
    "username" : "user"
  }
}

3.148.9. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.149. Get the status of the validations for vRealize Operations

GET /v1/vropses/validations/{id}

3.149.1. Description

Gets the status of given vRealize Operations validation workflow by given validation id

3.149.2. Parameters

Type Name Description Schema

Path

id
required

vRealize validation id

string

3.149.3. Responses

HTTP Code Description Schema

200

OK

Validation

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

3.149.4. Consumes

  • application/json

3.149.5. Produces

  • application/json

3.149.6. Tags

  • vROPs

3.149.7. Security

Type Name

basic

basicAuth

3.149.8. Example HTTP request

Request path
/v1/vropses/validations/string

3.149.9. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.150. Get the existing vRealize Suite Lifecycle Manager

GET /v1/vrslcm

3.150.1. Description

Gets the complete information about the existing vRealize Suite Lifecycle Manager instance.

3.150.2. Responses

HTTP Code Description Schema

200

OK

Vrslcm

404

Not Found

No Content

3.150.3. Consumes

  • application/json

3.150.4. Produces

  • application/json

3.150.5. Tags

  • vRSLCM

3.150.6. Security

Type Name

basic

basicAuth

3.150.7. Example HTTP request

Request path
/v1/vrslcm

3.150.8. Example HTTP response

Response 200
{
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "status" : "string",
  "version" : "string"
}

3.151. Rollback vRealize Suite Lifecycle Manager after unsuccessful deployment

DELETE /v1/vrslcm

3.151.1. Description

Triggers the vRealize Suite Lifecycle Manager rollback operation and returns an URL in the headers to track the operation status.

3.151.2. Responses

HTTP Code Description Schema

202

Accepted

Task

405

Method Not Allowed

ErrorResponse

3.151.3. Consumes

  • application/json

3.151.4. Produces

  • application/json

3.151.5. Tags

  • vRSLCM

3.151.6. Security

Type Name

basic

basicAuth

3.151.7. Example HTTP request

Request path
/v1/vrslcm

3.151.8. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.152. Redeploy vRealize Suite Lifecycle Manager

PATCH /v1/vrslcm

3.152.1. Description

Triggers the vRealize Suite Lifecycle Manager redeployment operation and returns an URL in the headers to track the operation status.

3.152.2. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

405

Method Not Allowed

ErrorResponse

3.152.3. Consumes

  • application/json

3.152.4. Produces

  • application/json

3.152.5. Tags

  • vRSLCM

3.152.6. Security

Type Name

basic

basicAuth

3.152.7. Example HTTP request

Request path
/v1/vrslcm

3.152.8. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.153. Get vRealize Suite Lifecycle Manager environments

GET /v1/vrslcm/environments

3.153.1. Description

Gets all the vRealize products and the corresponding vRealize Suite Lifecycle Manager environments that are managed by VMware Cloud Foundation.

3.153.2. Responses

HTTP Code Description Schema

200

OK

< VrealizeEnvironment > array

400

Bad Request

ErrorResponse

3.153.3. Consumes

  • application/json

3.153.4. Produces

  • application/json

3.153.5. Tags

  • vRSLCM

3.153.6. Security

Type Name

basic

basicAuth

3.153.7. Example HTTP request

Request path
/v1/vrslcm/environments

3.153.8. Example HTTP response

Response 200
[ {
  "environment" : "string",
  "product" : "string"
} ]
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.154. Update the vRealize Suite Lifecycle Manager environments

PUT /v1/vrslcm/environments

3.154.1. Description

Triggers the update operation of the vRealize Suite Lifecycle Manager for the specific vRealize products or for all of them if none are specified. The allowed values for the products are the following: VRLI, VRA, VROPS.

3.154.2. Parameters

Type Name Description Schema

Query

products
optional

products

< string > array(multi)

3.154.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

405

Method Not Allowed

ErrorResponse

3.154.4. Consumes

  • application/json

3.154.5. Produces

  • application/json

3.154.6. Tags

  • vRSLCM

3.154.7. Security

Type Name

basic

basicAuth

3.154.8. Example HTTP request

Request path
/v1/vrslcm/environments

3.154.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.155. Deploy vRealize Suite Lifecycle Manager

POST /v1/vrslcms

3.155.1. Description

Triggers the vRealize Suite Lifecycle Manager deployment operation and returns an URL in the headers to track the operation status.

3.155.2. Parameters

Type Name Description Schema

Body

vrslcmPublicDeploymentSpec
required

vRealize Suite Lifecycle Manager Deployment Specification

VrslcmDeploymentSpec

3.155.3. Responses

HTTP Code Description Schema

202

Accepted

Task

400

Bad Request

ErrorResponse

405

Method Not Allowed

ErrorResponse

500

Internal Server Error

ErrorResponse

3.155.4. Consumes

  • application/json

3.155.5. Produces

  • application/json

3.155.6. Tags

  • vRSLCM

3.155.7. Security

Type Name

basic

basicAuth

3.155.8. Example HTTP request

Request path
/v1/vrslcms
Request body
{
  "apiPassword" : "string",
  "fqdn" : "vrslcm.vrack.vsphere.local",
  "networkSpec" : {
    "gateway" : "10.0.1.250",
    "subnetMask" : "255.255.252.0",
    "vlanId" : "2042"
  },
  "sshPassword" : "string"
}

3.155.9. Example HTTP response

Response 202
{
  "completionTimestamp" : "string",
  "creationTimestamp" : "string",
  "errors" : [ {
    "arguments" : [ "string" ],
    "causes" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "id" : "string",
  "isCancellable" : true,
  "name" : "string",
  "resolutionStatus" : "Can have only one of the two values: RESOLVED or UNRESOLVED",
  "resources" : [ {
    "fqdn" : "string",
    "name" : "string",
    "resourceId" : "string",
    "type" : "string"
  } ],
  "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED",
  "subTasks" : [ {
    "completionTimestamp" : "string",
    "creationTimestamp" : "string",
    "description" : "string",
    "errors" : [ {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ "..." ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    } ],
    "name" : "string",
    "resources" : [ {
      "fqdn" : "string",
      "name" : "string",
      "resourceId" : "string",
      "type" : "string"
    } ],
    "stages" : [ {
      "completionTimestamp" : "string",
      "creationTimestamp" : "string",
      "description" : "string",
      "name" : "string",
      "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
      "type" : "string"
    } ],
    "status" : "One among: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED",
    "type" : "string"
  } ],
  "type" : "Sample values: HOST_COMMISSION, HOST_DECOMMISSION"
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 405
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 500
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.156. Get all existing vRealize Suite Lifecycle Manager instances

GET /v1/vrslcms

3.156.1. Responses

HTTP Code Description Schema

200

OK

Vrslcm

3.156.2. Consumes

  • application/json

3.156.3. Produces

  • application/json

3.156.4. Tags

  • vRSLCM

3.156.5. Security

Type Name

basic

basicAuth

3.156.6. Example HTTP request

Request path
/v1/vrslcms

3.156.7. Example HTTP response

Response 200
{
  "fqdn" : "string",
  "id" : "string",
  "ipAddress" : "string",
  "status" : "string",
  "version" : "string"
}

3.157. Validate the input specification for vRealize Suite Lifecycle Manager deployment

POST /v1/vrslcms/validations

3.157.1. Description

Triggers vRealize Suite Lifecycle Manager deployment specification validation workflow

3.157.2. Parameters

Type Name Description Schema

Body

vrslcmPublicDeploymentSpec
required

vRealize Suite Lifecycle Manager Deployment Specification

VrslcmDeploymentSpec

3.157.3. Responses

HTTP Code Description Schema

202

Accepted

Validation

400

Bad Request

ErrorResponse

3.157.4. Consumes

  • application/json

3.157.5. Produces

  • application/json

3.157.6. Tags

  • vRSLCM

3.157.7. Security

Type Name

basic

basicAuth

3.157.8. Example HTTP request

Request path
/v1/vrslcms/validations
Request body
{
  "apiPassword" : "string",
  "fqdn" : "vrslcm.vrack.vsphere.local",
  "networkSpec" : {
    "gateway" : "10.0.1.250",
    "subnetMask" : "255.255.252.0",
    "vlanId" : "2042"
  },
  "sshPassword" : "string"
}

3.157.9. Example HTTP response

Response 202
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}

3.158. Get the status of the validations for vRealize Lifecycle Manager deployment

GET /v1/vrslcms/validations/{id}

3.158.1. Description

Gets the status of given vRealize Suite Lifecycle Manager validation workflow by given validation id

3.158.2. Parameters

Type Name Description Schema

Path

id
required

vRealize validation id

string

3.158.3. Responses

HTTP Code Description Schema

200

OK

Validation

400

Bad Request

ErrorResponse

404

Not Found

ErrorResponse

3.158.4. Consumes

  • application/json

3.158.5. Produces

  • application/json

3.158.6. Tags

  • vRSLCM

3.158.7. Security

Type Name

basic

basicAuth

3.158.8. Example HTTP request

Request path
/v1/vrslcms/validations/string

3.158.9. Example HTTP response

Response 200
{
  "description" : "string",
  "executionStatus" : "One among: IN_PROGRESS, FAILED, COMPLETED, SKIPPED, CANCELLED",
  "id" : "string",
  "resultStatus" : "One among: SUCCEEDED, FAILED, FAILED_WITH_WARNINGS",
  "validationChecks" : [ {
    "description" : "string",
    "errorResponse" : {
      "arguments" : [ "string" ],
      "causes" : [ {
        "message" : "string",
        "type" : "string"
      } ],
      "context" : {
        "string" : "string"
      },
      "errorCode" : "string",
      "message" : "string",
      "nestedErrors" : [ {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      } ],
      "referenceToken" : "string",
      "remediationMessage" : "string"
    },
    "nestedValidationChecks" : [ {
      "description" : "string",
      "errorResponse" : {
        "arguments" : [ "string" ],
        "causes" : [ {
          "message" : "string",
          "type" : "string"
        } ],
        "context" : {
          "string" : "string"
        },
        "errorCode" : "string",
        "message" : "string",
        "nestedErrors" : [ "..." ],
        "referenceToken" : "string",
        "remediationMessage" : "string"
      },
      "nestedValidationChecks" : [ "..." ],
      "resultStatus" : "One among: SUCCEEDED, FAILED",
      "severity" : "One among: WARNING, ERROR, INFO"
    } ],
    "resultStatus" : "One among: SUCCEEDED, FAILED",
    "severity" : "One among: WARNING, ERROR, INFO"
  } ]
}
Response 400
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}
Response 404
{
  "arguments" : [ "string" ],
  "cause" : [ {
    "message" : "string",
    "type" : "string"
  } ],
  "context" : {
    "string" : "string"
  },
  "errorCode" : "string",
  "message" : "string",
  "nestedErrors" : [ {
    "arguments" : [ "string" ],
    "cause" : [ {
      "message" : "string",
      "type" : "string"
    } ],
    "context" : {
      "string" : "string"
    },
    "errorCode" : "string",
    "message" : "string",
    "nestedErrors" : [ "..." ],
    "referenceToken" : "string",
    "remediationMessage" : "string"
  } ],
  "referenceToken" : "string",
  "remediationMessage" : "string"
}