API
Snapshots
Transfer snapshot

Transfer a Snapshot to Another Region

  • Name
    post
    Type
    /v1/snapshots/:id
    Description

    Send a POST request to transfer a snapshot.

Request

Set the "action" attribute to transfer and set region attribute to the slug name of the region where the snapshot image will be transferred.

Required Attributes

  • Name
    action
    Type
    string
    Description

    Action performed on a snapshot image (transfer, rename) in this case transfer.

  • Name
    region
    Type
    string
    Description

    Slug name for the region which the snapshot image will be transferred to.

Example

curl -X GET "https://api.simplystack.com/v1/snapshots" \
  -H "Content-Type: application/json" \
  -H "Authorization: Token d359ad9cc9422b5ff07aede0cd2707da4ff82be0" \
  -d '{"action": "transfer", "region": "dal"}'

Response

JSON object with a key named snapshot which is an array of the following attributes associated with the snapshot image:

Attributes

See snapshot model.

Example

json
{
  "snapshot": {
    "created_at": "2021-02-07T12:38:51.357354Z",
    "disk_size": 26843545600,
    "id": 11,
    "name": "test-1602074180",
    "regions": [
        'fra'
    ],
    "size": 1270026240,
    "size_gigabytes": 1.2,
    "stacklet": {...},
    "task": {
      "id": 2,
      "name": "transfer",
      "description": {
          "progress": "Snapshot is transferring.",
          "completed": "Snapshot was transferred."
      }
    }
  }
}
Retrieve snapshotRename snapshot