ImportSnapshot
GET /?Action=ImportSnapshot
Description
Imports a snapshot from an Object Storage Unit (OSU) bucket to create a copy of this snapshot in your account.
This method enables you to copy a snapshot from another account that is either within the same Region as the OSU bucket, or in a different one. To copy a snapshot within the same Region, you can also use the CopySnapshot
direct method. For more information, see CopySnapshot.
The copy of the source snapshot is independent and belongs to you.
You can import a snapshot using a pre-signed URL. You do not need any permission for this snapshot, or the bucket in which it is contained. The pre-signed URL is valid for seven days (you can re-generate a new one if needed). For more information about how to export a snapshot an OSU bucket, see CreateSnapshotExportTask.
Body parameter
Required: false
Name: ImportSnapshotRequest
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
description |
The description for the snapshot created in your account. |
false |
string |
||
snapshotLocation |
The pre-signed URL of the snapshot you want to import from the OSU bucket. |
true |
string |
||
snapshotSize |
The size of the snapshot created in your account, in bytes. This size must be exactly the same as the source snapshot one. |
true |
string |
Responses
HTTP Code 200
HTTP Code | Description | Schema |
---|---|---|
200 |
ImportSnapshotResult |
Response 200
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
description |
The description of the snapshot created in your account. |
false |
string |
||
encrypted |
Indicates whether the snapshot is encrypted or not (always |
false |
boolean |
||
id |
The ID of the snapshot created in your account. |
false |
string |
||
owner_alias |
The alias of the owner of the snapshot created in your account. |
false |
string |
||
progress |
The percentage of the task completed. |
false |
string |
||
requestId |
The ID of the request. |
false |
string |
||
start_time |
The date and time at which the import task started. |
false |
string |
||
status |
The state of the snapshot created in your account ( |
false |
string |
||
volume_size |
The size of the snapshot created in your account, in gibibytes (GiB). |
false |
integer |