Todos os produtos
Search
Central de documentação

Elastic Compute Service:ReInitDisk

Última atualização: Oct 09, 2026

Reinicializa um disco para seu estado inicial na criação.

Descrição da operação

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

  • O disco deve estar no estado Em uso (In_use), e a instância ECS à qual o disco está anexado deve estar no estado Parada (Stopped).

  • Você não pode reinicializar um disco anexado a uma instância antes que a instância seja iniciada pela primeira vez.

  • Você não pode reinicializar um disco para o qual existam snapshots locais.

  • Para um disco do sistema, o disco é reinicializado para o estado inicial da imagem. Se a imagem de origem a partir da qual o disco foi criado for excluída, o disco não poderá ser reinicializado.

  • Para um disco de dados criado diretamente, o disco é reinicializado para um estado vazio. Para um disco de dados criado a partir de um snapshot, o disco é reinicializado para o estado do snapshot. Se o snapshot de origem for excluído, o disco não poderá ser reinicializado e um erro será retornado.

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

update

*Disco.

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

  • ecs:PasswordCustomized
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DiskId

string

Sim

O ID do disco a ser reinicializado. A instância à qual o disco está anexado deve ter sido iniciada pelo menos uma vez e deve estar no estado Parada.

d-bp67acfmxazb4ph****

Password

string

Não

Especifica se a senha de logon da instância ECS deve ser redefinida ao reinicializar o disco do sistema. A senha deve ter de 8 a 30 caracteres e deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os caracteres especiais podem ser:

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

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

Nota

Se você especificar o parâmetro Password, use HTTPS para enviar solicitações e evitar vazamentos de senha.

EcsV587!

KeyPairName

string

Não

O nome do par de chaves.

Nota

Este parâmetro é aplicável apenas a instâncias Linux. Ao reinicializar o disco do sistema, você pode vincular um par de chaves SSH à instância ECS como uma credencial de logon. Após o uso de um par de chaves SSH, o método de logon por senha é desativado.

testKeyPairName

AutoStartInstance

boolean

Não

Especifica se a instância deve ser iniciada automaticamente após a reinicialização do disco. Valores válidos:

  • true: Inicia a instância automaticamente.

  • false: Não inicia a instância automaticamente.

Valor padrão: false.

true

SecurityEnhancementStrategy

string

Não

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

  • Active: Usa o Security Center. Este valor é suportado apenas para imagens públicas.

  • Deactive: Não usa o Security Center. Este valor é suportado para todas as imagens.

Valor padrão: Deactive.

Active

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 LoginAsNonRoot.ImageNotSupport The specified image does not support login as non-root. Esta imagem não oferece suporte a login não root.
400 DiskHasSnapshotsWithInstantAccessEnabled.OperationNotSupported The operation is not supported to the specified disk that have snapshots with InstantAccess enabled.
400 InvalidPassword.Malformed The specified parameter "Password" is not valid. O parâmetro Password especificado é inválido.
400 InvalidKeyPairName.NotFound The specified KeyPairName does not exist. O KeyPairName especificado não existe.
400 DependencyViolation.IoOptimize The specified parameter InstanceId is not valid. O ID da instância especificado é inválido ou a configuração de otimização de E/S da instância especificada é inválida.
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.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 LoginAsNonRoot.RegionNotSupport The specified region does not support login as non-root.
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 InvalidSnapshot.TooOld The disk was created from a snapshot taken before 2013-07-15 and can no longer be reinitialized.
403 OperationDenied The snapshot which is used to create the specified disk has been deleted.
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet.
403 SharedImageDeleted The specified image by others shared is deleted.
403 DependencyViolation.WindowsInstance The instance runs Windows and does not support SSH key pair login.
403 InvalidDisk.DiskFromClonedNotSupport The specified disk %s was cloned from source disk %s. Reinitialization is not supported for cloned disks.
403 UserNotInTheWhiteList The user is not in volume white list.
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 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. A operação não é permitida porque a instância não atende aos requisitos para ativar a opção de hibernação.
403 InvalidOperation.MultiAttachDisk Multi attach disk does not support this operation. Discos com multi-attach ativado não suportam esta operação.
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 InvalidSourceSnapshot The source snapshot of the disk has been deleted and cannot support the current operation. O snapshot de origem do disco especificado foi excluído. O disco não pode ser reinicializado.
403 InvalidOperation.ReInitUnsupported The specified disk does not support reInit. O disco especificado não oferece suporte à reinicialização.
404 InvalidDiskId.NotFound The specified disk does not exist. O disco especificado não existe. Verifique se o ID do disco está correto.
404 InvalidImageId.NotFound The specified ImageId does not exist. A imagem especificada não existe nesta conta. Verifique se o ID da imagem está correto.
404 InvalidDiskId.OperationNotSupported The operation is not supported due to image not exist. A imagem especificada não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.