Skip to content
  • Auto
  • Light
  • Dark

Check Status

Check Status of a Droplet Destroy with Associated Resources Request
gpu_droplets.destroy_with_associated_resources.check_status(intdroplet_id) -> DestroyWithAssociatedResourceCheckStatusResponse
get/v2/droplets/{droplet_id}/destroy_with_associated_resources/status

To check on the status of a request to destroy a Droplet with its associated resources, send a GET request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources/status endpoint.

ParametersExpand Collapse
droplet_id: int
ReturnsExpand Collapse
class DestroyWithAssociatedResourceCheckStatusResponse:

An objects containing information about a resources scheduled for deletion.

completed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the requested action was completed.

formatdate-time
droplet: Optional[DestroyedAssociatedResource]

An object containing information about a resource scheduled for deletion.

failures: Optional[int]

A count of the associated resources that failed to be destroyed, if any.

resources: Optional[Resources]

An object containing additional information about resource related to a Droplet requested to be destroyed.

floating_ips: Optional[List[DestroyedAssociatedResource]]
id: Optional[str]

The unique identifier for the resource scheduled for deletion.

destroyed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the resource was destroyed if the request was successful.

formatdate-time
error_message: Optional[str]

A string indicating that the resource was not successfully destroyed and providing additional information.

name: Optional[str]

The name of the resource scheduled for deletion.

reserved_ips: Optional[List[DestroyedAssociatedResource]]
id: Optional[str]

The unique identifier for the resource scheduled for deletion.

destroyed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the resource was destroyed if the request was successful.

formatdate-time
error_message: Optional[str]

A string indicating that the resource was not successfully destroyed and providing additional information.

name: Optional[str]

The name of the resource scheduled for deletion.

snapshots: Optional[List[DestroyedAssociatedResource]]
id: Optional[str]

The unique identifier for the resource scheduled for deletion.

destroyed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the resource was destroyed if the request was successful.

formatdate-time
error_message: Optional[str]

A string indicating that the resource was not successfully destroyed and providing additional information.

name: Optional[str]

The name of the resource scheduled for deletion.

volume_snapshots: Optional[List[DestroyedAssociatedResource]]
id: Optional[str]

The unique identifier for the resource scheduled for deletion.

destroyed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the resource was destroyed if the request was successful.

formatdate-time
error_message: Optional[str]

A string indicating that the resource was not successfully destroyed and providing additional information.

name: Optional[str]

The name of the resource scheduled for deletion.

volumes: Optional[List[DestroyedAssociatedResource]]
id: Optional[str]

The unique identifier for the resource scheduled for deletion.

destroyed_at: Optional[datetime]

A time value given in ISO8601 combined date and time format indicating when the resource was destroyed if the request was successful.

formatdate-time
error_message: Optional[str]

A string indicating that the resource was not successfully destroyed and providing additional information.

name: Optional[str]

The name of the resource scheduled for deletion.

from gradient import Gradient

client = Gradient()
response = client.gpu_droplets.destroy_with_associated_resources.check_status(
    1,
)
print(response.completed_at)
{
  "completed_at": "2020-04-01T18:11:49Z",
  "droplet": {
    "id": "61486916",
    "destroyed_at": "2020-04-01T18:11:49Z",
    "error_message": " ",
    "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
  },
  "failures": 0,
  "resources": {
    "floating_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "reserved_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volume_snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volumes": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ]
  }
}
Returns Examples
{
  "completed_at": "2020-04-01T18:11:49Z",
  "droplet": {
    "id": "61486916",
    "destroyed_at": "2020-04-01T18:11:49Z",
    "error_message": " ",
    "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
  },
  "failures": 0,
  "resources": {
    "floating_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "reserved_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volume_snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volumes": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ]
  }
}