CopyImage
GET /?Action=CopyImage
Description
Copies an Outscale machine image (OMI) to your account, from an account in the same Region.
To do so, the owner of the source OMI must share it with your account. For more information about how to share an OMI with another account, see ModifyImageAttribute.
The copy of the source OMI is independent and belongs to you.
Note
|
To copy an OMI between accounts in different Regions, the owner of the source OMI must export it to an Object Storage Unit (OSU) bucket using the CreateImageExportTask method, and then you need to import it using the RegisterImage method. For more information, see CreateImageExportTask and RegisterImage. |
Body parameter
Required: false
Name: CopyImageRequest
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
Description |
A description of the new OMI. |
false |
string |
||
DryRun |
If set to |
false |
boolean |
||
Name |
The name of the new OMI. This name must be unique for your account. |
false |
string |
||
SourceImageId |
The ID of the OMI you want to copy. |
true |
string |
||
SourceRegion |
The name of the source Region, which must be the same as the Region of your account. |
true |
string |
Responses
HTTP Code 200
HTTP Code | Description | Schema |
---|---|---|
200 |
CopyImageResult |
Response 200
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
imageId |
The ID of the new OMI. |
false |
string |
||
requestId |
The ID of the request. |
false |
string |