Skip to content
Last updated

Delete vCenter Job

Overview

Use this job to delete a VMware vCenter external service connection.

Job Template IDResource TypeJob Parameters
3f06fd6b-dfb1-4bad-bd04-939951797e97compute-ops-mgmt/external-serviceSee Job Parameters section

Job parameters marked with a * are required.

Create Job

A job can be created by issuing a POST to the /compute-ops-mgmt/v1/jobs endpoint with the correct payload for the job.

The following properties are used when creating a job:

PropertyJSON TypeDescriptionRequired?
jobTemplatestring (id)The durable Template ID of the jobYes
resourceTypestring (type)The TYPE of the resource the job will operate onYes
resourceIdstring (id)The ID of the resource the job will operate onYes
jobParamsobjectAny additional data required by the jobNo

If the job was created successfully, a 201 Created response is returned. The response includes the job resource which has a job resourceUri that you can use to track the progress of the job.

Job Parameters

This table summarizes the supported properties in data.

PropertyJSON TypeDescriptionRequired?
vCenterUrl*stringThe URL or IP address of the vCenter serverYes
associatedGatewayUri*string (uri)The URI of the associated gateway applianceYes
externalServiceId*string (uuid)The ID of the external service to deleteYes
vCenterUuid*string (uuid)The UUID of the vCenter serverYes

Parameter properties

  • vCenterUrl: This required property specifies the URL or IP address of the vCenter server to be deleted.

  • associatedGatewayUri: This required property is the URI of the gateway appliance associated with the vCenter connection.

    • Example: /compute-ops-mgmt/v1beta1/appliances/gateway+eace0910-8007-4e1d-b1b4-0ed10c004d4e
  • externalServiceId: This required property is the UUID of the external service representing the vCenter connection.

  • vCenterUuid: This required property is the UUID of the vCenter server as known by VMware.

Example

The following example shows a request payload for creating this job.

Example 1

Delete a vCenter external service.

{
  "jobTemplate": "3f06fd6b-dfb1-4bad-bd04-939951797e97",
  "resourceId": "edee6027-f210-4546-bbee-9d5847e39bef",
  "jobParams": {
    "vCenterUrl": "192.0.2.50",
    "associatedGatewayUri": "/compute-ops-mgmt/v1beta1/appliances/gateway+eace0910-8007-4e1d-b1b4-0ed10c004d4e",
    "externalServiceId": "edee6027-f210-4546-bbee-9d5847e39bef",
    "vCenterUuid": "6c62c4f8-c4f2-470c-a6aa-9e5c18bd5355"
  }
}