Copia uma imagem personalizada de uma região para outra. Use a cópia de imagens personalizadas para implantar ou replicar instâncias do Elastic Compute Service (ECS) entre regiões.
Observações de uso
Após copiar uma imagem personalizada para a região de destino, use a nova imagem para criar instâncias ECS por meio da operação RunInstances ou substituir os discos do sistema das instâncias com a operação ReplaceSystemDisk na região de destino.
Observe os seguintes pontos:
Somente imagens personalizadas com status Available podem ser copiadas.
As imagens personalizadas devem pertencer à sua conta Alibaba Cloud ou ter sido compartilhadas com você por outros usuários. Não é possível copiar imagens entre contas diferentes.
Durante a cópia, não é permitido excluir a imagem pela operação DeleteImage. No entanto, você pode cancelar a tarefa de cópia em andamento chamando a operação CancelCopyImage.
Cada região permite apenas uma tarefa de cópia de imagem ativa por vez. Tarefas adicionais entram em fila e são executadas sequencialmente após a conclusão da tarefa atual.
Configure o parâmetro ResourceGroupId para definir o grupo de recursos da nova imagem. Se esse parâmetro não for configurado, a imagem será atribuída ao grupo de recursos padrão.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Sim | CopyImage | Operação a ser executada. Defina o valor como CopyImage. |
| DestinationImageName | String | Não | YourImageName | Nome da nova imagem. Deve ter entre 2 e 128 caracteres, começar com uma letra e não pode iniciar com |
| DestinationDescription | String | Não | This is a description example. | Descrição da nova imagem. O texto deve ter de 2 a 256 caracteres e não pode começar com |
| ImageId | String | Sim | m-bp1h46wfpjsjastc**** | ID da imagem personalizada de origem. |
| RegionId | String | Sim | cn-hangzhou | ID da região da imagem personalizada de origem. Chame a operação DescribeRegions para obter a lista mais recente de regiões. |
| DestinationRegionId | String | Não | cn-shanghai | ID da região de destino para onde a imagem personalizada de origem será copiada. |
| Encrypted | Boolean | Não | false | Define se a nova imagem deve ser criptografada.
Valor padrão: false. |
| KMSKeyId | String | Não | e522b26d-abf6-4e0d-b5da-04b7******3c | ID da chave usada para criptografar a nova imagem. |
| EncryptAlgorithm | String | Não | hide | Nota Este parâmetro não está disponível publicamente. |
| ResourceGroupId | String | Não | rg-bp67acfmxazb4p**** | ID do grupo de recursos da nova imagem. Se este parâmetro não for especificado, a imagem será vinculada ao grupo de recursos padrão. Nota Se você chamar a operação CopyImage como um usuário do Resource Access Management (RAM) sem autorização para gerenciar o grupo de recursos padrão e não especificar o parâmetro ResourceGroupId, a mensagem de erro Forbbiden: User not authorized to operate on the specified resource será retornada. Especifique o ID de um grupo de recursos que o usuário RAM tenha permissão para gerenciar ou conceda ao usuário RAM autorização para gerenciar o grupo de recursos padrão antes de chamar a operação CopyImage novamente. |
| Tag.N.Key | String | Não | TestKey | Chave da tag N a ser adicionada à nova imagem. Valores válidos para N: 1 a 20. A chave da tag não pode ser uma string vazia, deve ter no máximo 128 caracteres e não pode conter |
| Tag.N.Value | String | Não | TestValue | Valor da tag N a ser adicionada à nova imagem. Valores válidos para N: 1 a 20. O valor da tag pode ser uma string vazia, ter até 128 caracteres e não pode conter |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
ImageId |
String |
m-bp1h46wfpjsjastd**** |
ID da nova imagem. |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
ID da solicitação. |
Exemplos
Exemplos de solicitações
http(s)://ecs.aliyuncs.com/?Action=CopyImage
&ImageId=m-bp1h46wfpjsjastc****
&RegionId=cn-hangzhou
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CopyImageResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<ImageId>m-bp1h46wfpjsjastd****</ImageId>
</CopyImageResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
"ImageId" : "m-bp1h46wfpjsjastd****"
}Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|
400 |
InvalidDescription.Malformed |
The specified destination description is wrongly formed. |
Valor inválido para DestinationDescription. A descrição deve ter entre 2 e 256 caracteres e não pode começar com http:// ou https://. |
|
400 |
SourceRegion.NotFound |
The source region not found. |
A região de origem especificada não foi encontrada. |
|
400 |
DestinationRegion.NotFound |
The destination region not found. |
A região de destino não foi encontrada. |
|
400 |
IncorrectImageStatus |
The image not available. |
A imagem especificada está indisponível. |
|
400 |
InvalidSnapshotId.NotFound |
The specified SnapshotId does not exist. |
O snapshot especificado não existe. Verifique se o ID da imagem está correto. |
|
400 |
InvalidImageName.Duplicated |
The destination image is exist. |
Já existe uma imagem com este nome. |
|
400 |
InvalidParameter.EncryptedIllegal |
The specified parameter Encrypted must be true when kmsKeyId is not empty. |
O recurso de criptografia deve ser ativado quando um ID de chave do Key Management Service (KMS) for especificado. |
|
400 |
OperationDenied.CommunityImage |
Community image does not support copy. |
Imagens da comunidade não suportam cópia. |
|
400 |
InvalidImageName.Malformed |
The specified destination image name is wrongly formed. |
Valor inválido para DestinationImageName. Consulte a descrição do parâmetro DestinationImageName para mais detalhes. |
|
400 |
InvalidParameter.KmsNotEnabled |
The specified operation need enable KMS. |
É necessário ativar o KMS. |
|
403 |
Forbbiden |
User not authorized to operate on the specified resource. |
Você não tem autorização para executar operações neste recurso. |
|
403 |
QuotaExceed.Image |
The Image Quota exceeds. |
A cota de imagens personalizadas foi atingida. |
|
403 |
QuotaExceed.Snapshot |
The snapshot quota exceeds. |
O número máximo de snapshots foi excedido. Exclua snapshots desnecessários para criar novos. |
|
403 |
OperationDenied.ImageCopying |
The Image are coping. |
A imagem está sendo copiada. Tente novamente mais tarde. |
|
403 |
RegionNotSupportCopy |
The region not support copy. |
A região de origem ou de destino especificada não suporta a cópia de imagens. |
|
403 |
InvalidSnapshot.TooOld |
This operation is denied because the specified snapshot is created before 2013-07-15. |
Operação negada porque o snapshot especificado foi criado antes de 15 de julho de 2013. |
|
403 |
OperationDenied |
The specified snapshot is not allowed to create image. |
O snapshot especificado não pode ser usado para criar imagens. |
|
403 |
IncorrectDestinationRegion |
The destination region is not equal the target region. |
A região de origem deve ser diferente da região de destino ao copiar uma imagem entre regiões. |
|
403 |
SizeExceed.Image |
The image exceeds the maximum size. Please open a ticket to add the account to the white list. |
O tamanho máximo da imagem foi excedido. |
|
403 |
OperationDeined.EncryptedSnapshot |
The image contains encrypted snapshots, which do not support copying. |
A imagem especificada contém snapshots criptografados e não pode ser copiada. |
|
403 |
OperationDenied.SameRegionOnly |
The image shared from others can not be copied to another region directly. |
Imagens compartilhadas por outras contas Alibaba Cloud não podem ser copiadas diretamente para outra região. |
|
403 |
OperationDenied.NotPublished |
The operation is denied because corresponding marketplace image is not published in destination region. |
Operação negada porque a imagem do Alibaba Cloud Marketplace da qual a imagem especificada deriva não foi lançada na região de destino. |
|
403 |
OperationDeined.EncryptedSnapshot |
The image contains encrypted snapshots, which do not support copying to non-encrypted ones. |
A imagem contém snapshots criptografados e não pode ser copiada para snapshots não criptografados. |
|
403 |
InvalidParameter.KMSKeyId.CMKNotEnabled |
The CMK needs to be enabled. |
A chave mestra do cliente (CMK) não está habilitada, embora um ID de chave KMS tenha sido especificado para o disco. Chame a operação DescribeKey do KMS para consultar informações sobre a CMK especificada. |
|
403 |
InvalidParameter.KMSKeyId.KMSUnauthorized |
ECS service have no right to access your KMS. |
O ECS não tem autorização para acessar seus recursos do KMS. |
|
403 |
InvalidRegion.NotSupport |
The specified region does not support byok. |
O recurso Bring Your Own Key (BYOK) não é suportado na região especificada. |
|
403 |
UserNotInTheWhiteList |
The user is not in byok white list. |
Você não tem autorização para usar o recurso BYOK. Tente novamente após obter a autorização necessária. |
|
403 |
OperationDenied.KmsServiceUnauthorized |
The account is not authorized to kms service, please authorize it. |
Sua conta não tem autorização para acessar o KMS. Solicite as permissões necessárias para acessar o serviço. |
|
404 |
InvalidImageId.NotFound |
The specified ImageId does not exist. |
A imagem especificada não existe nesta conta. Verifique se o ID da imagem está correto. |
|
404 |
InvalidParameter.KMSKeyId.NotFound |
The specified KMSKeyId does not exist. |
O ID da chave KMS especificado não foi encontrado. |
|
404 |
InvalidResourceGroup.NotFound |
The ResourceGroup provided does not exist in our records. |
O grupo de recursos não foi encontrado. |
|
500 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Ocorreu um erro interno. Tente novamente mais tarde. |
Para obter uma lista completa de códigos de erro, consulte Códigos de erro do serviço.