CopyImage - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Copia uma imagem personalizada de uma região para outra região. Você pode usar esta operação para implantar instâncias ECS entre regiões ou replicar instâncias ECS entre regiões.

Descrição da operação

Você pode usar a imagem copiada na região de destino para criar instâncias ECS (RunInstances) ou substituir o disco do sistema de uma instância (ReplaceSystemDisk).

Ao chamar esta operação, observe os seguintes itens:

A imagem personalizada deve estar no estado Available.
Se a imagem for uma imagem personalizada da sua conta, você poderá copiá-la entre regiões. Se a imagem for compartilhada com você por outra conta, você poderá copiá-la apenas dentro da mesma região.
Durante o processo de cópia da imagem, você não pode excluir diretamente (DeleteImage) a imagem que está sendo copiada. No entanto, você pode cancelar a tarefa de cópia (CancelCopyImage) para excluir a imagem que está sendo copiada.
No máximo cinco tarefas de cópia de imagem podem ser executadas simultaneamente em uma única região. Tarefas adicionais são enfileiradas e executadas em ordem após a conclusão de qualquer uma das tarefas em execução.
Você pode usar o parâmetro ResourceGroupId para especificar o grupo de recursos ao qual a imagem copiada pertence. Se você não definir o parâmetro ResourceGroupId, a imagem copiada pertencerá ao grupo de recursos padrão.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:CopyImage

update

*Imagem.

acs:ecs:{#regionId}:{#accountId}:image/*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DestinationImageName	string	Não	O nome da imagem copiada. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Pode conter dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-).	SeuNomeDeImagem
DestinationDescription	string	Não	A descrição da imagem copiada. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.	Este é um exemplo de descrição
ImageId	string	Sim	O ID da imagem personalizada de origem.	m-bp1h46wfpjsjastc****
RegionId	string	Sim	O ID da região da imagem personalizada de origem. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
DestinationRegionId	string	Não	O ID da região de destino.	cn-shanghai
Encrypted	boolean	Não	Especifica se a imagem copiada deve ser criptografada. true: criptografa a imagem copiada. false: não criptografa a imagem copiada. Não especificado: depende da lógica de back-end. Para mais informações, consulte a descrição suplementar abaixo. Valor padrão: não especificado.	false
KMSKeyId	string	Não	O ID da chave usada para criptografar a imagem.	e522b26d-abf6-4e0d-b5da-04b7******3c
EncryptAlgorithm	string	Não	Nota Este parâmetro não está disponível publicamente.	hide
ResourceGroupId	string	Não	O ID do grupo de recursos da imagem replicada. Se você não definir este parâmetro, a imagem replicada pertencerá ao grupo de recursos padrão. Nota Se você estiver usando um usuário do Resource Access Management (RAM) para invocar esta operação e o parâmetro `ResourceGroupId` for deixado vazio, observe o seguinte: se o usuário RAM não tiver permissões no grupo de recursos padrão, a invocação retornará a mensagem de erro `Forbidden: User not authorized to operate on the specified resource`. Defina o parâmetro `ResourceGroupId` como um ID de grupo de recursos no qual o usuário RAM tenha permissões, ou conceda ao usuário RAM permissões no grupo de recursos padrão usando a conta Alibaba Cloud correspondente e, em seguida, invoque esta operação novamente.	rg-bp67acfmxazb4p****
Tag	array<object>	Não	As tags.
	object	Não	As tags.
Key	string	Não	A chave da tag da imagem copiada. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	ChaveTeste
Value	string	Não	O valor da tag da imagem copiada. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode começar com `acs:`. Não pode conter `http://` ou `https://`.	ValorTeste
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: realiza apenas um dry run. O sistema verifica a solicitação quanto a possíveis problemas, incluindo o par de AccessKey, a autorização do usuário do Resource Access Management (RAM) e se os parâmetros obrigatórios foram especificados. Se a solicitação falhar no dry run, a mensagem de erro correspondente será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false: realiza um dry run e envia a solicitação Normal. Se a solicitação passar no dry run, um código de status HTTP 2XX será retornado e a operação será executada. Valor padrão: false.	false
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000

Cenário	Status da imagem de origem	Parâmetro Encrypted	Parâmetro KMSKeyId	Se a criptografia padrão no nível da conta EBS está configurada na região de destino	Resultado da imagem de destino	Descrição
1	Imagem não criptografada	False ou não especificado	Não especificado	Não configurada	Imagem não criptografada	A imagem não é criptografada e permanece inalterada.
2	Imagem não criptografada	True	Não especificado	Qualquer	Imagem totalmente criptografada	O usuário solicita explicitamente a criptografia. Se a criptografia padrão no nível da conta EBS estiver configurada, a chave padrão configurada será a criptografia de chave secreta. Caso contrário, a chave de serviço será a criptografia de chave secreta.
3	Imagem não criptografada	True	Especificado	Qualquer	Imagem totalmente criptografada	O usuário solicita explicitamente a criptografia. O KMSKeyId especificado será a criptografia de chave secreta.
4	Imagem não criptografada	Não especificado	Não especificado	Configurada	Imagem totalmente criptografada	A chave configurada para a criptografia padrão no nível da conta EBS será a criptografia de chave secreta.
5	Imagem criptografada	Não especificado	Não especificado	Não configurada	Imagem criptografada	O formato original é preservado. Snapshots não criptografados permanecem não criptografados, e snapshots criptografados são criptografados com a chave de serviço.
6	Imagem criptografada	Não especificado ou True	Não especificado	Configurada	Imagem totalmente criptografada	A chave configurada para a criptografia padrão no nível da conta EBS será a criptografia de chave secreta.
7	Imagem criptografada	True	Não especificado	Não configurada	Imagem totalmente criptografada	A chave de serviço será a criptografia de chave secreta.
8	Imagem criptografada	True	Não especificado	Configurada	Imagem totalmente criptografada	A chave configurada para a criptografia padrão no nível da conta EBS será a criptografia de chave secreta.
9	Imagem criptografada	True	Especificado	Qualquer	Imagem totalmente criptografada	O usuário solicita explicitamente a criptografia. O KMSKeyId especificado será a criptografia de chave secreta.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
ImageId	string	O ID da imagem copiada.	m-bp1h46wfpjsjastd****
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "ImageId": "m-bp1h46wfpjsjastd****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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.	O formato da descrição do recurso especificado é inválido. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
400	SourceRegion.NotFound	The source region not found.
400	DestinationRegion.NotFound	The destination region not found.	A região de destino especificada não existe.
400	IncorrectImageStatus	The image not available.	A cópia da imagem falhou.
400	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	O snapshot especificado não existe. Verifique se o snapshot está correto.
400	InvalidImageName.Duplicated	The specified image name is already in use in the target region. Please try a different one.	O nome da imagem já existe.
400	InvalidParameter.EncryptedIllegal	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	InvalidEncrypted.NotMatchEncryptAlgorithm	The Encrypted parameter must be set to true when EncryptAlgorithm is specified. Please adjust the parameters and try again.
400	InvalidEncryptAlgorithm	The specified EncryptAlgorithm is not valid. Ensure the value is a supported encryption algorithm such as AES-256.
400	InvalidEncrypted.NotMatchKmsKeyId	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
400	OperationDenied.CommunityImage	Community image does not support copy.	As imagens da comunidade não oferecem suporte à cópia.
400	InvalidImageName.Malformed	The specified destination image name is wrongly formed.	O nome da imagem é inválido. Para obter mais informações sobre as convenções de nomenclatura, consulte a descrição do parâmetro DestinationImageName.
400	InvalidParameter.KmsNotEnabled	The specified operation need enable KMS.	A operação atual requer que o Key Management Service (KMS) esteja ativado.
400	OperationDenied.ImageCopyConflict	The same image cannot be copied concurrently. Please wait until the last copy is completed before performing the next operation.	Cópias simultâneas da mesma imagem não são permitidas. Aguarde até que a cópia anterior seja concluída antes de iniciar uma nova.
400	Account.Arrearage	Your account has an outstanding payment.	O saldo da sua conta é insuficiente. Recarregue sua conta antes de prosseguir.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas.
401	InvalidAliUid.IsNull	The aliUid must not be null.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
403	Forbbiden	User not authorized to operate on the specified resource.	O usuário não está autorizado a executar operações no recurso especificado.
403	InvalidOperation.CopyingDataFromThisRegionUnsupported	Data transfer from the current region to other regions is not supported.	A replicação de dados da região atual para outras regiões não é suportada.
403	InvalidOperation.CopyingDataToThisRegionUnsupported	Only Some Regions %s can copy data to this region.	Apenas regiões específicas podem replicar dados para a região atual.
403	QuotaExceed.Image	The number of images exceeds the limit (%s).	A cota de imagens personalizadas foi esgotada.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.
403	OperationDenied.ImageCopying	The image is currently being copied. Please try again later.	A imagem está sendo copiada. Tente novamente mais tarde.
403	RegionNotSupportCopy	The region not support copy.
403	InvalidSnapshot.TooOld	This operation is denied because the specified snapshot is created before 2013-07-15.	O disco especificado não pode ser reinicializado porque seu snapshot de origem foi criado em ou antes de 15 de julho de 2013.
403	OperationDenied	The specified snapshot is not allowed to create image.	O snapshot especificado não permite a criação de volumes de dados.
403	IncorrectDestinationRegion	The destination region is not equal the target region.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support copying.	A imagem contém snapshots criptografados.
403	OperationDenied.SameRegionOnly	The image shared from others can not be copied to another region directly.	Imagens compartilhadas por outros usuários não podem ser copiadas para outra região.
403	OperationDenied.NotPublished	The operation is denied because corresponding marketplace image is not published in destination region.	A operação especificada não pode ser executada. A imagem de origem da imagem é do Alibaba Cloud Marketplace e não foi publicada na região de destino.
403	OperationDenied.NotAuthorized	The operation is denied because corresponding marketplace image is not authorized to current user.
403	OperationDenied.EncryptSnapshotAcrossRegion	The image do not contain encrypted snapshots, which do not support copying to encrypted ones.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	InvalidRegion.NotSupport	The specified region does not support byok.	A região especificada não é suportada.
403	UserNotInTheWhiteList	The user is not in byok white list.	O usuário não está na lista de permissões do Shared Block Storage. Abra um ticket para solicitar a inclusão na lista de permissões.
403	InvalidRegionId.NotSupportEncryptAlgorithm	The current region does not support creating encrypted disks with EncryptAlgorithm.
403	OperationDenied.KmsServiceUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	OperationDenied.NonCompliantDestinationRegion	The copy operation to the destination region is not in compliance with regulations.	A região de destino não atende aos requisitos de conformidade de segurança.
403	InvalidEncrypted.NotMatchDiskDefaultEncryption	The specified parameter Encrypted not match for your account default encryption settings.	Os parâmetros de criptografia não correspondem à configuração de criptografia de disco por padrão da conta atual.
403	InvalidParameter.DataEncryptedKeyCreateFailed	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	SizeExceed.Image	The image exceeds the maximum size. You can use the CopySnapshot API to copy your snapshots of the image and then create a new image from them.	O tamanho da imagem especificada excede o limite. Abra um ticket para solicitar um aumento de limite.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidOperation.VhdImageUnsupported	The specified vhd image is not supported for this operation. Please switch to a raw image and retry.	A imagem no formato VHD não suporta esta operação. Mude para uma imagem no formato RAW e tente novamente.
403	InvalidOperation.CloudBoxImageCopyUnsupported	Copying CloudBox images is not supported.	As imagens do CloudBox não suportam cópia.
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
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. Please verify that the key ID is correct and that the key resides in the current region.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O grupo de recursos não foi encontrado nos registros.
409	InvalidOperation.Conflict	Request was denied due to conflict with a previous request, please try again later.	Esta operação não é permitida devido a um conflito de tarefas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.