Delete Cloud Region

Details

API Details
Name

Delete Cloud Region

Description

Effective 4.7.0: You can delete cloud regions – even after jobs have been run on this region.

  • You can now delete Cloud Regions even after the CCO has been registered.

  • Cloud owners can delete regions if there are no running deployments and no association of the region in a Deployment Environment – If there are any, remove them first before trying this operation.

  • Ensure that all the jobs submitted in this region have already been terminated.

MethodDELETE
URI

v1/tenants/tenantId/clouds/cloudId/regions/cloudRegionId

CloudCenter Release

Introduced in CloudCenter 4.2.

Notes
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
  • Admins can delete a Cloud region if a CCO was not registered for this region.
  • CloudCenter 4.6.x and Earlier Releases: As other resources (for example, obs or accounts or users) are already associated with an activated cloud region, you cannot perform the following tasks:

    • You cannot delete activated cloud regions. You can only delete a cloud region if it is not activated.

    • You cannot de-activate an activated cloud region.

  • Effective CloudCenter 4.7.0: You can delete cloud regions – even after jobs have been run on this region.

ESB Headeraction: delete.tenants.tenantId.clouds.cloudId.regions.cloudRegionId

Example

curl -k -X DELETE -H "Accept: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/1/clouds/2/regions/3"

Response

The server responds with the HTTP Response code 204 No Content if the deletion of the cloud region is successful.

Request Attributes

tenantId
  • DescriptionUnique, system-generated identifier for the tenant organization. A tenant admin must belong to this tenant to invoke any APIs for this tenant. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.

  • Type: String

Required

cloudId
  • Description: Unique, system-generated identifier for a cloud representation (see View Deployment Environments for additional details)

  • Type: String

Required

cloudRegionId
  • Description: Unique, system-generated identifier for a cloud region
  • Type: String

Required

Response Attributes

None