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

Chama CopySnapshot para copiar um snapshot entre zonas de borda.

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

ens:CopySnapshot

create

*Todos os recursos.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SnapshotId	string	Sim	O ID do snapshot de origem.	sp-bp1c0doj0taqyzzl****
DestinationRegionIds	array	Sim	A lista de IDs das zonas de borda de destino.
	string	Sim	O ID da zona de borda de destino.	cn-hangzhou-26,cn-hangzhou-27
DestinationSnapshotName	string	Não	O nome de exibição do snapshot. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês e não pode começar com `http://` ou `https://`. Pode conter dígitos, dois pontos (:), sublinhados (_) ou hifens (-).	testSnapshotName
DestinationSnapshotDescription	string	Não	A descrição do snapshot. A descrição deve ter de 2 a 256 caracteres e não pode começar com `http://` ou `https://`.	testDescription
InstanceBillingCycle	string	Não	O ciclo de faturamento da instância. Valores válidos: Hour Day Month Valores válidos: Month : mês. Hour : Hora. Day : Dia.	Hour

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	EA3758E0-8899-17D3-9526-5F62CF33A586
AllocationId	array<object>	A lista de snapshots criados com sucesso.
	object
EnsRegionId	string	O ID da zona de borda onde o snapshot reside.	cn-hangzhou-27
InstanceId	array	O array de IDs de instâncias.
	string	O array de IDs de instâncias.	e426409223
BizStatusCode	string	O código de status que indica sucesso. Valores válidos: PartSuccess: Parcialmente bem-sucedido. AllSuccess: Totalmente bem-sucedido.	PartSuccess
UnAllocationId	array<object>	A lista de zonas de borda onde a criação do snapshot falhou.
	object
EnsRegionId	string	O ID da zona de borda onde o snapshot reside.	cn-chengdu-26

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EA3758E0-8899-17D3-9526-5F62CF33A586",
  "AllocationId": [
    {
      "EnsRegionId": "cn-hangzhou-27",
      "InstanceId": [
        "e426409223"
      ]
    }
  ],
  "BizStatusCode": "PartSuccess",
  "UnAllocationId": [
    {
      "EnsRegionId": "cn-chengdu-26"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	SaleControl.VerificationFailed	You did not pass the salecontrol verification.Please contact the product.
400	Invalid%s	The specified parameter %s is invalid.
400	ENS_SERVICE_ARREARAGE	用户欠费
400	Order.CreateFailed	Failed to create order. Please check your parameters and try it again.
400	ens.interface.error	Failed to call API.
400	NoPermission	Permission denied.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.