Skip to main content

Create a Migration

POST 
/storage/migrations

Initiate a migration of data from an external provider into Telnyx Cloud Storage. Currently, only S3 is supported.

Request​

Body

    source_id stringrequired

    ID of the Migration Source from which to migrate data.

    target_bucket_name stringrequired

    Bucket name to migrate the data into. Will default to the same name as the source_bucket_name.

    target_region stringrequired

    Telnyx Cloud Storage region to migrate the data to.

    refresh boolean

    If true, will continue to poll the source bucket to ensure new data is continually migrated over.

Responses​

200: Create Migration Response

Schema

    data

    object

    id string

    Unique identifier for the data migration.

    source_id stringrequired

    ID of the Migration Source from which to migrate data.

    target_bucket_name stringrequired

    Bucket name to migrate the data into. Will default to the same name as the source_bucket_name.

    target_region stringrequired

    Telnyx Cloud Storage region to migrate the data to.

    refresh boolean

    If true, will continue to poll the source bucket to ensure new data is continually migrated over.

    last_copy date-time

    Time when data migration was last copied from the source.

    status string

    Possible values: [pending, checking, migrating, complete, error, stopped]

    Status of the migration.

    bytes_to_migrate integer

    Total amount of data found in source bucket to migrate.

    bytes_migrated integer

    Total amount of data that has been succesfully migrated.

    speed integer

    Current speed of the migration.

    eta date-time

    Estimated time the migration will complete.

    created_at date-time

    Time when data migration was created

Request samples

curl -L 'https://api.telnyx.com/v2/storage/migrations' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
  "source_id": "string",
  "target_bucket_name": "string",
  "target_region": "string",
  "refresh": true
}'

Response samples

{
  "data": {
    "id": "string",
    "source_id": "string",
    "target_bucket_name": "string",
    "target_region": "string",
    "refresh": true,
    "last_copy": "2020-01-01T00:00:00Z",
    "status": "pending",
    "bytes_to_migrate": 0,
    "bytes_migrated": 0,
    "speed": 0,
    "eta": "2020-01-01T00:00:00Z",
    "created_at": "2020-01-01T00:00:00Z"
  }
}