Todos os produtos
Search

Este produto

    :ResetDisk

    Central de documentação

    :ResetDisk

    Última atualização: Jul 03, 2026

    Restaura um disco a partir de um snapshot dele.

    Descrição

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

    • O disco deve estar no estado In Use (In_Use) ou Unattached (Available).

    • A instância do Elastic Compute Service (ECS) à qual o disco está anexado deve estar no estado Stopped (Stopped). Chame a operação StopInstances para parar uma instância.

    • O snapshot especificado pelo parâmetro SnapshotId deve ter sido criado a partir do disco especificado pelo parâmetro DiskId.

    • Se a resposta da operação DescribeInstances contiver {"OperationLocks": {"LockReason" : "security"}} para uma instância, ela estará bloqueada por motivos de segurança e não será possível executar operações nela.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    ParâmetroTipoObrigatórioExemploDescrição
    ActionStringSimResetDisk

    A operação a ser executada. Defina o valor como ResetDisk.

    DiskIdStringSimd-bp199lyny9b3****

    ID do disco a ser restaurado.

    SnapshotIdStringSims-bp199lyny9b3****

    ID do snapshot a ser usado na restauração do disco.

    DryRunBooleanNãofalse

    Defina se a validade da solicitação deve ser verificada sem executá-la de fato. Valores válidos:

    • true: verifica a validade da solicitação, mas não a executa. A verificação inclui parâmetros obrigatórios, formato da solicitação e limites de estado do recurso. Se a verificação falhar, o sistema retorna a mensagem de erro correspondente. Se for bem-sucedida, retorna o código de erro DryRunOperation.
    • false: verifica a validade da solicitação. Se a verificação for bem-sucedida, o sistema executa a solicitação.

    Valor padrão: false.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    F3CD6886-D8D0-4FEE-B93E-1B732396****

    ID da solicitação.

    Exemplos

    Exemplos de solicitações

    http(s)://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId=d-bp199lyny9b3****
&SnapshotId=s-bp199lyny9b3****
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

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

<ResetDiskResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResetDiskResponse>

    Formato JSON

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

{
  "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

    Mensagem retornada porque a categoria do disco especificado não oferece suporte a esta operação.

    400

    InvalidRegionId.MalFormed

    The specified RegionId is not valid

    Mensagem retornada porque o parâmetro RegionId especificado é inválido.

    400

    DryRunOperation

    Request validation has been passed with DryRun flag set.

    Mensagem retornada porque a solicitação foi considerada válida com o parâmetro DryRun definido como true.

    403

    IncorrectDiskStatus

    The current disk status does not support this operation.

    Mensagem retornada porque o estado atual do disco não oferece suporte a esta operação. Verifique se o disco está utilizável e se não há pagamentos pendentes.

    403

    IncorrectInstanceStatus

    The current status of the resource does not support this operation.

    Mensagem retornada porque o estado atual do recurso não oferece suporte a esta operação.

    403

    InstanceLockedForSecurity

    The instance is locked due to security.

    Mensagem retornada porque a instância está bloqueada por motivos de segurança.

    403

    InvalidParameter.Mismatch

    The specified snapshot is not created from the specified disk.

    Mensagem retornada porque um snapshot criptografado não pode restaurar um disco não criptografado.

    403

    InvalidSnapshot.TooOld

    The snapshotId is created before 2013-07-15, it cannot be restored since the first time the disk detached.

    Mensagem retornada porque snapshots criados antes de 15 de julho de 2013 não oferecem suporte a esta operação.

    403

    InstanceExpiredOrInArrears

    The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

    Mensagem retornada porque a instância de assinatura expirou. Renove a instância e tente novamente.

    403

    OperationDenied

    The specified snapshot dees not support ResetDisk.

    Mensagem retornada porque o snapshot especificado não oferece suporte a esta operação.

    403

    InvalidSnapshotId.NotReady

    The specified snapshot has not completed yet.

    Mensagem retornada porque a criação do snapshot especificado ainda não foi concluída.

    403

    InvalidAccountStatus.NotEnoughBalance

    Your account does not have enough balance.

    Mensagem retornada porque o saldo da conta é insuficiente. Adicione fundos à conta e tente novamente.

    403

    InvalidAccountStatus.SnapshotServiceUnavailable

    Snapshot service has not been opened yet.

    Mensagem retornada porque o serviço de snapshot não está ativado.

    403

    Operation.Conflict

    The operation may conflicts with others.

    Mensagem retornada porque a operação entra em conflito com outras operações.

    403

    UserNotInTheWhiteList

    The user is not in disk white list.

    Mensagem retornada porque você não tem autorização para gerencie o disco. Tente novamente após obter a autorização necessária.

    403

    InvalidParameter.KMSKeyId.CMKNotEnabled

    The CMK needs to be enabled.

    Mensagem retornada porque a chave mestra do cliente (CMK) não está habilitada quando um ID de chave do Key Management Service (KMS) é especificado para o 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.

    Mensagem retornada porque o ECS não tem autorização para acessar seus recursos do KMS.

    404

    InvalidParameter.KMSKeyId.NotFound

    The specified KMSKeyId does not exist.

    Mensagem retornada porque o ID da chave KMS especificado não existe.

    404

    InvalidDiskId.NotFound

    The specified disk does not exist.

    Mensagem retornada porque o parâmetro DiskId especificado não existe. Verifique se o ID do disco está correto.

    404

    Disk.NotFound

    The specified disk does not exist.

    Mensagem retornada porque o parâmetro DiskId especificado não existe. Verifique se o ID do disco está correto.

    404

    InvalidSnapshotId.NotFound

    The specified SnapshotId does not exist.

    Mensagem retornada porque o parâmetro SnapshotId especificado não existe.

    404

    InvalidInstanceId.NotFound

    The specified InstanceId does not exist.

    Mensagem retornada porque a instância especificada não existe. Verifique se o ID da instância está correto.

    500

    InternalError

    The request processing has failed due to some unknown error.

    Mensagem retornada devido a um erro interno. Tente novamente mais tarde.

    500

    InternalError

    The request processing has failed due to some unknown error, exception or failure.

    Mensagem retornada devido a um erro interno. Tente novamente mais tarde.

    Para obter uma lista de códigos de erro, visite o API Error Center.