CopySnapshot - : Central de Documentação do Alibaba Cloud

Observações de uso

Observe os seguintes pontos:

Novos snapshots (cópias de snapshot) não permitem reverter os discos dos quais os snapshots de source foram criados.
Não é possível copiar snapshots locais.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CopySnapshot	Operação a ser executada. Defina o valor como CopySnapshot.
ResourceGroupId	String	Não	rg-bp67acfmxazb4p****	Parâmetro não disponível publicamente.
Tag.N.Key	String	Não	TestKey	Chave da tag N a adicionar ao novo snapshot. Não pode ser uma string vazia, ter mais de 128 caracteres, conter http:// ou https://, nem começar com acs: ou aliyun.
Tag.N.Value	String	Não	TestValue	Valor da tag N a adicionar ao novo snapshot. Pode ser uma string vazia, mas não pode exceder 128 caracteres, conter http:// ou https://, nem começar com acs: ou aliyun.
RegionId	String	Sim	cn-chengdu	ID da região do snapshot de source. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
DestinationRegionId	String	Sim	us-east-1	ID da região de destino para onde copiar o snapshot de source.
SnapshotId	String	Sim	s-bp67acfmxazb4p****	ID do snapshot de source.
DestinationSnapshotName	String	Sim	CopySnapshotDemo	Nome do novo snapshot. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com http:// ou https://. Aceita letras, dígitos, dois pontos (:), sublinhados (_) e hifens (-). Por padrão, este parâmetro está vazio.
DestinationSnapshotDescription	String	Sim	CopySnapshotDemo	Descrição do novo snapshot. Deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://. Por padrão, este parâmetro está vazio.
RetentionDays	Integer	Não	60	Período de retenção do novo snapshot, em dias. O snapshot é liberado automaticamente ao término desse período. Valores válidos: 1 a 65536. Se este parâmetro estiver vazio (padrão), o snapshot não será liberado automaticamente.
Encrypted	Boolean	Não	false	Define se o novo snapshot deve ser criptografado. Valores válidos: true false Valor padrão: false.
KMSKeyId	String	Não	0e478b7a-4262-4802-b8cb-00d3fb40****	ID da chave mestra do cliente (CMK) no Key Management Service (KMS) da região de destino.
Arn.N.RoleType	String	Não	null	Nota Parâmetro não disponível publicamente.
Arn.N.Rolearn	String	Não	null	Nota Parâmetro não disponível publicamente.
Arn.N.AssumeRoleFor	Long	Não	0	Nota Parâmetro não disponível publicamente.
DestinationStorageLocationArn	String	Não	null	Nota Parâmetro não disponível publicamente.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
SnapshotId	String	s-bp17441ohwka0yui****	ID do novo snapshot.
RequestId	String	C8B26B44-0189-443E-9816-D951F596****	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=CopySnapshot
&ResourceGroupId=hide
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&RegionId=cn-chengdu
&DestinationRegionId=us-east-1
&SnapshotId=s-bp67acfmxazb4p****
&DestinationSnapshotName=CopySnapshotDemo
&DestinationSnapshotDescription=CopySnapshotDemo
&RetentionDays=60
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CopySnapshotResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F596****</RequestId>
    <SnapshotId>s-bp17441ohwka0yui****</SnapshotId>
</CopySnapshotResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F596****",
  "SnapshotId" : "s-bp17441ohwka0yui****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor inválido para Tag.N.Key.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor inválido para Tag.N.Value.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Valor inválido para RegionId.
403	InvalidSnapshotId.NotFound	The specified snapshot is not exists.	O snapshot de source especificado não existe.
403	InvalidUser.NotInWhiteList	The user is not in the white list of copying snapshot.	Você não tem permissão para executar esta operação.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Saldo insuficiente na conta. Adicione fundos e tente novamente.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Operação não suportada enquanto o serviço de snapshot não estiver ativado.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.	O snapshot especificado ainda está sendo criado.
403	InvalidSnapshotName.Malformed	The specified SnapshotName is wrongly formed.	O nome do snapshot especificado é inválido.
403	InvalidDescription.Malformed	The specified description is wrongly formed.	Formato inválido para DestinationSnapshotDescription. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.
403	InvalidRetentionDays.Malformed	The specified RetentionDays is not valid.	Valor inválido para RetentionDays. Verifique se o valor de RetentionDays está correto.
403	InvalidRegion.NotSupport	The specified region does not support byok.	A região especificada não suporta o recurso Bring Your Own Key (BYOK).
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	O ID da chave KMS não existe.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	A CMK não está habilitada quando seu ID é especificado para um 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 Elastic Compute Service (ECS) não tem autorização para acessar seus recursos do KMS.
403	QuotaExceed.SnapshotQuota	The quota is insufficient, please contact your channel partner to increase the quota.	Cota insuficiente. Entre em contato com seu parceiro de canal para solicitar um aumento de cota.
403	InvalidSnapshot.EncryptedNotSupported	The current operation does not support the use of encrypted snapshots.	Snapshots criptografados não suportam esta operação.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.