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

Reverte um ou mais discos em nuvem usando um snapshot de instância.

Descrição da operação

Esta operação foi descontinuada. Use ResetDisk para reverter discos em nuvem. Antes de chamar esta operação, certifique-se de que a instância ECS à qual os discos em nuvem a serem revertidos estão anexados esteja no estado Stopped.

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

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
RegionId	string	Sim	O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
DryRun	boolean	Não	Especifica se deve ser realizado um dry run na solicitação. Valores válidos: true: Realiza um dry run sem reverter os discos em nuvem. O sistema verifica se os parâmetros obrigatórios foram especificados, o formato da solicitação e os limites de status do recurso. Se a solicitação falhar na verificação, a mensagem de erro correspondente será retornada. Se a solicitação passar na verificação, o código de erro DryRunOperation será retornado. false: Realiza uma solicitação padrão. Depois que a solicitação passar na verificação, o sistema reverte os discos em nuvem. Valor padrão: false.	false
Disk	array<object>	Sim	A lista de discos em nuvem.
	object	Não
SnapshotId	string	Não	O ID do snapshot que corresponde ao disco em nuvem especificado no snapshot da instância. Valores válidos de N: 1 a 10.	s-j6cdofbycydvg7ey****
DiskId	string	Não	O ID do disco em nuvem a ser revertido. Valores válidos de N: 1 a 10.	d-j6cf7l0ewidb78lq****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	3D66C85C-AA97-4A00-B0ED-2D9A80FE782C
OperationProgressSet	object
OperationProgress	array<object>	A coleção de informações de status da operação ao reverter um ou mais discos em nuvem.
	array<object>
ErrorMsg	string	A mensagem de erro. Um valor vazio é retornado se a reversão for bem-sucedida. Para obter mais informações sobre códigos de erro e mensagens de erro, consulte o Error Center.	testErrorMsg
ErrorCode	string	O código de erro. Um valor vazio é retornado se a reversão for bem-sucedida. Para obter mais informações sobre códigos de erro e mensagens de erro, consulte o Error Center.	400
OperationStatus	string	Indica se a operação foi bem-sucedida. Se a operação for bem-sucedida, Success será retornado. Se a operação falhar, as informações de ErrorCode e ErrorMsg serão retornadas.	Success
RelatedItemSet	object
RelatedItem	array<object>	As informações do recurso.
	object
Name	string	O nome do recurso.	SnapshotId
Value	string	O ID do recurso.	s-j6cdofbycydvg7ey****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "3D66C85C-AA97-4A00-B0ED-2D9A80FE782C",
  "OperationProgressSet": {
    "OperationProgress": [
      {
        "ErrorMsg": "testErrorMsg",
        "ErrorCode": "400",
        "OperationStatus": "Success",
        "RelatedItemSet": {
          "RelatedItem": [
            {
              "Name": "SnapshotId",
              "Value": "s-j6cdofbycydvg7ey****"
            }
          ]
        }
      }
    ]
  }
}

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.
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. Envie 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 especificado possui um snapshot incompleto.
403	InvalidRegion.NotSupport	The specified region does not support resetting disks.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Discos com multi-attach ativado não suportam esta operação.
403	InvalidDisk.ShareVolume	The specified diskId is invalid. The shared volume does not support creating a snapshot group.	O diskId especificado é inválido. Os discos compartilhados não oferecem suporte à criação de grupos consistentes com snapshots.
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.	The specified instance instance does not. Check.[ec2478.desc]O InstanceType parameter is required.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	InvalidSnapshot.NotFound	The SnapshotId provided does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.