Data Migration

Create a Migration

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

post/storage/migrations

Request

  • Base URL: https://api.telnyx.com/v2
  • URL: https://api.telnyx.com/v2/storage/migrations
  • Auth: HTTP bearer

Request body

idstring

Unique identifier for the data migration.

source_idstring required

ID of the Migration Source from which to migrate data.

target_bucket_namestring required

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

target_regionstring required

Telnyx Cloud Storage region to migrate the data to.

refreshboolean

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

last_copystring date-time

Time when data migration was last copied from the source.

status'pending' | 'checking' | 'migrating' | 'complete' | 'error' | 'stopped'

Status of the migration.

bytes_to_migrateinteger

Total amount of data found in source bucket to migrate.

bytes_migratedinteger

Total amount of data that has been succesfully migrated.

speedinteger

Current speed of the migration.

etastring date-time

Estimated time the migration will complete.

created_atstring date-time

Time when data migration was created

Example request

{
  "last_copy": "2020-01-01T00:00:00Z",
  "eta": "2020-01-01T00:00:00Z",
  "created_at": "2020-01-01T00:00:00Z"
}

Response

Create Migration Response

Example response

{
  "data": {
    "last_copy": "2020-01-01T00:00:00Z",
    "eta": "2020-01-01T00:00:00Z",
    "created_at": "2020-01-01T00:00:00Z"
  }
}

Changes

No operation changes recorded.