Todos os produtos
Search
Central de documentação

:ReInitDisk

Última atualização: Jul 03, 2026

Use esta operação para reinicializar um disco e restaurá-lo ao estado de criação.

Descrição

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

  • O disco a ser reinicializado deve estar no estado In Use (In_use) e a instância associada deve estar no estado Stopped (Stopped).

  • Não é possível reinicializar discos anexados a uma instância que nunca foi iniciada desde a criação.

  • A reinicialização não é permitida se houver um snapshot local criado para o disco.

  • Ao reinicializar um disco de sistema, ele retorna ao estado da imagem usada na criação. Se a imagem de source tiver sido excluída, a reinicialização do disco de sistema falhará.

  • Um disco de dados criado separadamente volta a ser um disco vazio após a reinicialização.

  • Para discos de dados originados de um snapshot, a reinicialização restaura o estado desse snapshot de source.

Nota

Se o snapshot de source for excluído, a reinicialização do disco não poderá ser concluída e um erro será retornado.

Depuração

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

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimReInitDisk

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

DiskIdStringSimd-bp67acfmxazb4ph****

O ID do disco.

PasswordStringNãoEcsV587!

Define se a senha da instância deve ser redefinida durante a reinicialização do disco de sistema. A senha deve ter entre 8 e 30 caracteres e incluir pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os caracteres especiais incluem:


( ) ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? /
                                

Em instâncias Windows, a senha não pode começar com uma barra (/).

Nota Caso o parâmetro Password seja especificado, recomendamos enviar solicitações via HTTPS para proteger sua senha.
KeyPairNameStringNãotestKeyPairName

O nome do par de chaves.

Nota Este parâmetro aplica-se apenas a instâncias Linux. É possível vincular um par de chaves ssh à instância como credencial de login ao reinicializar o disco de sistema. Após a vinculação, o método de login por usuário e senha fica desabilitado para essa instância.
AutoStartInstanceBooleanNãotrue

Indica se a instância deve ser iniciada automaticamente após a reinicialização do disco.

Valor padrão: false.

SecurityEnhancementStrategyStringNãoActive

Define se o Security Center deve ser usado gratuitamente após a reinicialização do disco de sistema. Valores válidos:

  • Active: O Security Center é disponibilizado gratuitamente após a substituição do disco de sistema. Este valor aplica-se apenas a imagens públicas.
  • Deactive: O uso gratuito do Security Center não é ativado após a substituição do disco de sistema. Este valor aplica-se a todas as imagens.

Valor padrão: Deactive.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=ReInitDisk
&DiskId=d-bp67acfmxazb4ph****
&KeyPairName=testKeyPairName
&AutoStartInstance=true
&SecurityEnhancementStrategy=Active
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ReInitDiskResponse>
      <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReInitDiskResponse>

Formato JSON

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

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.

403

IncorrectDiskStatus

The current disk status does not support this operation.

Mensagem retornada porque a operação não é suportada no estado atual do disco. Certifique-se de que o disco está disponível e que não há pagamentos pendentes em sua conta.

403

IncorrectInstanceStatus

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

Mensagem retornada porque a operação não é suportada no estado atual do recurso.

403

InstanceLockedForSecurity

The instance is locked due to security.

Mensagem retornada porque a operação não é suportada enquanto a instância estiver bloqueada por motivos de segurança.

403

InvalidSnapshot.TooOld

The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time.

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

403

OperationDenied

The snapshot which is used to create the specified disk has been deleted.

Mensagem retornada porque o snapshot usado para crie o disco especificado não existe mais.

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 subscription expirou. Renove a instância primeiro.

403

DiskCreatingSnapshot

The operation is denied due to a snapshot of the specified disk is not completed yet.

Mensagem retornada porque um snapshot do disco especificado ainda está sendo criado.

403

InvalidSourceSnapshot

The snapshot which is used to create the specified disk has been deleted.

Mensagem retornada porque o snapshot utilizado na criação do disco especificado foi excluído.

404

InvalidImageId.NotFound

The specified ImageId does not exist.

Mensagem retornada porque a imagem especificada não existe nesta conta. Verifique se o ID da imagem está correto.

403

SharedImageDeleted

The specified image by others shared is deleted.

Mensagem retornada porque a imagem compartilhada especificada foi excluída.

400

InvalidPassword.Malformed

The specified parameter "Password" is not valid.

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

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 suporta esta operação.

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist.

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

400

DependencyViolation.IoOptimize

The specified parameter InstanceId is not valid.

Mensagem retornada porque a otimização de E/S da instância é inválida.

403

UserNotInTheWhiteList

The user is not in volume white list.

Mensagem retornada porque você não está na lista de permissões do Shared Block Storage. Abra um ticket para solicitar a permissão.

400

InvalidRegionId.MalFormed

The specified RegionId is not valid

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

404

InvalidDiskId.OperationNotSupported

The operation is not supported due to image not exist.

Mensagem retornada porque a imagem especificada não existe.

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.

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.