Todos os produtos
Search
Central de documentação

Elastic Compute Service:ReplaceSystemDisk

Última atualização: Aug 03, 2026

Substitui o sistema operacional de uma instância ECS substituindo o disco do sistema. Após a substituição, o ID do disco do sistema é alterado e o disco original é liberado.

Descrição da operação

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

update

Disk.

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

Image.

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

  • ecs:IsDiskEncrypted
  • ecs:IsSystemDiskEncrypted
  • ecs:PasswordInherit
  • ecs:PasswordCustomized
  • ecs:IsDiskByokEncrypted
  • ecs:IsSystemDiskByokEncrypted
  • ecs:LoginAsNonRoot
  • ecs:ImagePlatform
Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceId

string

Sim

O ID da instância de destino.

i-bp67acfmxazb4ph****

ImageId

string

Não

O ID da imagem a ser usada para redefinir o sistema. Este parâmetro é obrigatório.

m-bp67acfmxazb4ph****

SystemDisk.Size

integer

Não

A capacidade do novo disco do sistema. Unidade: GiB. Valores válidos:

80

ClientToken

string

Não

O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja exclusivo entre diferentes solicitações. O valor ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.

123e4567-e89b-12d3-a456-426655440000

UseAdditionalService

boolean

Não

Especifica se deve usar a configuração do sistema da máquina virtual fornecida pelo Alibaba Cloud (Windows: NTP e KMS. Linux: NTP e YUM).

true

Password

string

Não

Especifica se deve redefinir o nome de usuário e a senha da instância ECS. A senha deve ter de 8 a 30 caracteres de comprimento e deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os seguintes caracteres especiais são suportados:

EcsV587!

PasswordInherit

boolean

Não

Especifica se deve usar a senha predefinida da imagem.

false

KeyPairName

string

Não

O nome do par de chaves.

testKeyPairName

DiskId

string

Não

Nota

[Deprecated] Este parâmetro foi descontinuado. Para melhorar a compatibilidade, use ImageId em seu lugar.

d-bp67acfmxazb4ph****

Platform

string

Não

Nota

Este parâmetro foi descontinuado.

CentOS

Architecture

string

Não

Nota

Este parâmetro foi descontinuado.

i386

SecurityEnhancementStrategy

string

Não

Especifica se deve usar o serviço gratuito Security Center após a substituição do disco do sistema. Valores válidos:

Active

Encrypted

boolean

Não

Especifica se deve criptografar o disco. Valores válidos:

false

KMSKeyId

string

Não

O ID da chave KMS do disco do sistema.

e522b26d-abf6-4e0d-b5da-04b7******3c

EncryptAlgorithm

string

Não

Nota

Este parâmetro não está disponível publicamente.

hide

Arn

array<object>

Não

Este parâmetro não está disponível publicamente.

object

Não

RoleType

string

Não

Nota

Este parâmetro não está disponível publicamente.

null

Rolearn

string

Não

Nota

Este parâmetro não está disponível publicamente.

null

AssumeRoleFor

integer

Não

Nota

Este parâmetro não está disponível publicamente.

0

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

DiskId

string

O ID do novo disco do sistema.

d-bp67acfmxazb4ph****

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "DiskId": "d-bp67acfmxazb4ph****",
  "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 suporta login sem privilégios de root.
400 InvalidSystemDiskSize.ValueNotSupported The specified parameter SystemDisk.Size is invalid.
400 InvalidParameter.Conflict The specified image does not support the specified instance type. A operação atual não permite que diskId e imageId sejam especificados simultaneamente. Certifique-se de que diskId ou imageId não esteja vazio.
400 InvalidSystemDiskSize.ImageNotSupportResize The specified image does not support resize. A imagem não suporta o tamanho de disco do sistema especificado.
400 InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid.
400 InvalidPassword.Malformed The specified parameter "Password" is not valid. O parâmetro Password especificado é inválido.
400 InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true. Quando PasswdInherit está ativado, o nome de usuário e a senha devem ser definidos como vazios.
400 OperationDenied The specified image contains the snapshot of the data disk. This operation is not supported.
400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid. O tipo de disco do recurso especificado não suporta esta operação.
400 InvalidKeyPairName.NotFound The specified KeyPairName does not exist. O par de chaves não existe.
400 DependencyViolation.IoOptimize The specified parameter InstanceId is not valid. A configuração de otimização de E/S da instância especificada é inválida.
400 MissingParameter.Architecture Architecture should not be null. O parâmetro Architecture não pode estar vazio.
400 InvalidArchitecture.Malformed Architecture is not valid. O parâmetro Architecture especificado é inválido. Verifique se o formato deste parâmetro está correto.
400 MissingParameter.Platform Platform should not be null. O parâmetro Platform não pode estar vazio.
400 InvalidPlatform.Malformed Platform is not valid. A plataforma especificada é inválida.
400 InvalidDiskId.NotFound The specified disk do not exist. O disco especificado não existe.
400 InvalidDatadisk.DiskStatusViolation The operation is not permitted due to status of the Datadisk. O status atual do disco de dados não oferece suporte a esta operação.
400 InvalidDatadisk.DiskCategoryViolation The operation is not permitted due to category of the Datadisk. O tipo de disco de dados não oferece suporte a esta operação.
400 InvalidDatadisk.ChargeTypeViolation The operation is not permitted due to charge type of the Datadisk.
400 MissingParameter The input parameter "ImageId" that is mandatory for processing this request is not supplied.
400 InvalidInstance.NotFoundSystemDisk The specified instance has no system disk. O disco de sistema da instância está ausente.
400 InvalidParameter.DiskType The specified disk type which has kms key can't convert to system disk.
400 DISK_IN_DEDICATED_BLOCK_STORAGE_CLUSTER The disk in dedicated block storage cluster is not allowed to do this operation.
400 IncorrectDiskStatus.ReplicationStatusNotFound Disk replication status not found.
400 IncorrectDiskStatus.InReplication Disk already in replication.
400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the image architecture. A arquitetura de imagem especificada não suporta este tipo de instância.
400 InvalidRegionId.NotSupportReplaceEncryptedSystemDisk The specified region not support replace encrypted system disk.
400 InvalidStorageClusterId.CapacityNotEnough The remaining capacity of the current dedicated storage cluster is less than the size of disk. O cluster de armazenamento em bloco dedicado onde o disco reside não possui capacidade disponível suficiente.
400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s. A capacidade utilizada do tipo de disco especificado excedeu o limite de cota na zona ativa. Acesse o Centro de Cotas para consultar e solicitar um aumento da cota de capacidade de disco.
400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method. Os clientes de migração para nuvem empresarial podem adquirir apenas instâncias ECS pay-as-you-go e não podem adquirir produtos de terceiros, como imagens fornecidas pelo Alibaba Cloud Marketplace. Verifique os parâmetros e tente novamente com parâmetros válidos.
400 InternalError The requested services is not available now. Please try again later. Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
400 InvalidDiskName.Malformed The specified parameter "SyatemDisk.DiskName or DataDisk.n.DiskName" is not valid. O nome do disco especificado no parâmetro DiskName é inválido.
400 InvalidParameter.Encrypted Creating non-encrypted disks with encrypted snapshots is not supported. Não há suporte para a criação de um disco não criptografado a partir de um snapshot criptografado.
500 OperationDenied Internal Error.
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 InvalidSystemDiskStatus.IsTransfering The current status of the resource does not support this operation. The system disk is transferring.
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 está bloqueada por motivos de segurança. Entre em contato com o suporte técnico de segurança.
403 ImageNotSubscribed The specified image has not be subscribed.
403 ImageRemovedInMarket The specified marketplace image is not available. Or the specified user-defined image includes a product code because it is based on an image subscribed from the marketplace; and that marketplace image including the exact same product code has been removed.
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403 ChargeTypeViolation The operation is not permitted due to charge type of the instance.
403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet.
403 IoOptimized.NotSupported The specified image does not support IoOptimized instances.
403 ImageNotSupportInstanceType The specified image don not support the InstanceType instance.
403 QuotaExceed.BuyImage The specified image is from the image market. You have not bought it or your quota has been exceeded.
403 INST_HAS_UNPAID_ORDER The instance has unpaid order.
403 OperationDenied.InstanceCreating The specified instance is creating.
403 DependencyViolation.WindowsInstance The instance runs Windows and does not support SSH key pair login.
403 InvalidParameter.NotMatch %s O tipo de instância especificado suporta apenas imagens específicas. Você pode chamar a operação DescribeImages para consultar as imagens disponíveis.
403 ResourcesNotInSameZone The specified instance and disk are not in the same zone.
403 OperationDenied.UnpaidOrder The specified instance has unpaid order. O ID da instância especificado possui um pedido não pago. Você pode fazer login no console ECS para concluir o pagamento.
403 InvalidHostname.MismatchImage The hostname of the current instance can not be applied to the image you choose.
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. Esta operação não é suportada para discos com o recurso multi-attach ativado.
403 InvalidRegionId.NotSupportEncryptAlgorithm The current region does not support creating encrypted disks with EncryptAlgorithm.
403 InvalidRegionId.NotExists The region not exists.
403 InvalidEncryptAlgorithm The specified parameter EncryptAlgorithm is not valid.
403 InvalidEncrypted.NotMatchKmsKeyId The specified parameter Encrypted must be true when KmsKeyId is not empty.
403 InvalidEncrypted.NotMatchEncryptAlgorithm The specified parameter Encrypted must be true when EncryptAlgorithm is not empty.
403 InvalidParameter.KmsNotEnabled The specified operation need enable KMS.
403 InvalidParameter.DataEncryptedKeyCreateFailed Failed to create the KMS data encryption key. Please verify that the current KMS key has authorized the ECS service to use it. If the issue persists; contact KMS Technical Support.
403 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist.
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 InvalidKMSKeyId.NotSymmetric The specified parameter KmsKeyId must be symmetric.
403 InvalidDiskId.NotSupportReplaceEncryptedSystemDisk The specified diskId not support replace encrypted system disk.
403 NotSupportSnapshotEncrypted.DiskCategory The specified disk category does not support creating encrypted system disks or encrypted data disks from snapshots. Check the DiskCategory or Encrypted parameter; or check your account for default encryption settings.
403 InvalidParameter.AllEmpty The current operation does not allow both diskId and imageId to be empty. Make sure that either diskId or imageId is not empty. password e keyPairName não podem estar vazios para esta operação. Certifique-se de que pelo menos um entre password ou keyPairName seja especificado.
403 InvalidParameter.Conflict The current operation does not allow both diskId and imageId to be set. Make sure that either diskId or imageId is not empty. A operação atual não permite que diskId e imageId sejam especificados simultaneamente. Certifique-se de que diskId ou imageId não esteja vazio.
403 OperationDenied The current region does not support changing the image type. O EIP especificado está indisponível ou não autorizado.
403 OperationDenied.ImageNotValid The specified Image is disabled or deleted. Please check the status of the image.
403 OperationDenied.DiskNoStock The requested disk category is sold out in the specified zone. Please try a different disk category or another zone. O tipo de disco solicitado está esgotado na zona especificada. Tente um tipo de disco diferente ou uma zona diferente.
403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK (Customer Master Key) must be in an active state. A chave mestra do cliente (CMK) deve estar no estado ativo.
403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK(Customer Master Key) lacks authorization to add tags to the ECS service. O ECS não tem permissão para criptografar ou descriptografar sua CMK.
403 InvalidEncrypted.NotMatchSnapshot The specified parameter Encrypted must be set to true when creating disks with encrypted snapshots. Ao criar um disco a partir de um snapshot criptografado, o parâmetro Encrypted deve ser definido como true.
403 InvalidEncrypted.NotMatchDiskDefaultEncryption Enabling disk default encryption prevents the creation of non-encrypted disks. Após a ativação da criptografia padrão de disco no nível da conta, não é possível criar discos não criptografados.
403 InvalidPayMethod.SyncPaymentNotSupport Synchronous payment is not supported. Use another payment method. O pagamento síncrono não é suportado. Selecione outro método de pagamento.
403 InvalidOperation.ImageSecureBootUnsupported The image does not support secure boot. A imagem não suporta Secure Boot.
403 InvalidDiskCategory.NotSupported The disk category is not supported in the current zone. Please call DescribeAvailableResource to check supported categories.
403 OperationDenied.KMSKeyUnauthorized The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. O ID da instância especificado é inválido.
404 InvalidImageId.NotFound The specified ImageId does not exist. A imagem especificada não foi encontrada. Certifique-se de que a imagem existe na região atual e seu status está disponível.
404 InvalidSystemDiskSize.MoreThanMaxSize The specified SystemDisk.Size parameter exceeds the maximum size.
404 InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size.
404 InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size.
404 NoSuchResource The specified resource is not found. O recurso especificado 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.