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

Reverte um disco para um estado anterior utilizando um snapshot de disco.

Descrição da operação

Antes de chamar esta operação, leia Reverter um disco usando snapshots.

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

O disco deve estar no estado Em uso (In_use) ou Disponível (Available).
A instância à qual o disco está anexado deve estar no estado Parada (Stopped). Você pode chamar StopInstances para parar uma instância.
O parâmetro SnapshotId especificado deve ser um snapshot histórico criado a partir do disco especificado por DiskId.
Ao chamar DescribeInstances para consultar informações da instância ECS, se a resposta contiver {"OperationLocks": {"LockReason" : "security"}}, todas as operações na instância serão proibidas.

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:ResetDisk

update

*Disco.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DiskId	string	Sim	O ID do disco a ser revertido.	d-bp199lyny9b3****
SnapshotId	string	Sim	O ID do snapshot a ser usado para reverter o disco.	s-bp199lyny9b3****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run sem reverter o disco de fato. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se as restrições de status do recurso são atendidas. Se a verificação falhar, a mensagem de erro correspondente será retornada. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false: realiza um dry run e envia a solicitação. Se a verificação for bem-sucedida, a operação de reversão do disco será iniciada. Valor padrão: false.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	F3CD6886-D8D0-4FEE-B93E-1B732396****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category.	O tipo de disco atual não oferece suporte a esta operação.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A verificação DryRun foi aprovada. Sua solicitação foi validada.
400	InternalError	The requested services is not available now. Please try again later.	Ocorreu um erro interno. Tente novamente.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The instance is locked due to security.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403	InvalidParameter.Mismatch	The specified snapshot is not created from the specified disk.
403	InvalidSnapshot.TooOld	The snapshot was created before 2013-07-15 and cannot be restored since the disk was first detached.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	OperationDenied	The specified snapshot dees not support ResetDisk.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	O serviço de snapshot não está ativado. A operação não pode ser realizada.
403	Operation.Conflict	The operation may conflict with others. Please retry later.
403	UserNotInTheWhiteList	The user is not in disk 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	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	IncorrectDiskStatus.HasUnfinishedSnapshot	The current disk has unfinished snapshot.	O disco atual possui um snapshot incompleto.
403	InvalidOperation.DiskResetInProgress	The operation cannot be performed because the disk has an ongoing reset task. Please try again later.
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	InvalidDiskId.NotFound	The specified disk does not exist.	O disco especificado não existe. Verifique se o ID do disco está correto.
404	Disk.NotFound	The specified disk does not exist.	O disco especificado não existe. Verifique se o disco está correto.
404	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.