Todos os produtos
Search

Este produto

    :AttachDisk

    Central de documentação

    :AttachDisk

    Última atualização: Jul 03, 2026

    Anexa um disco de dados com pagamento conforme o uso ou um disco do sistema a uma instância. A instância e o disco devem estar na mesma zona.

    Descrição

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

    • O disco deve estar no estado Unattached (Available).

    • Para anexar o disco como disco de dados, considere o seguinte:

      • A instância deve estar no estado Running (Running) ou Stopped (Stopped).

      • Se o disco foi adquirido separadamente, o método de faturamento deve ser pagamento conforme o uso.

      • Se o disco for um disco do sistema desanexado de uma instância, não há restrições quanto ao método de faturamento.

    • Para anexar o disco como disco do sistema, observe os seguintes requisitos:

      • A instância deve ser aquela da qual o disco do sistema foi desanexado originalmente.

      • A instância deve estar no estado Stopped (Stopped).

      • As credenciais de logon devem estar configuradas.

    • Se a resposta à consulta de informações da instância contiver {"OperationLocks": {"LockReason" : "security"}}, a instância estará bloqueada por motivos de segurança e nenhuma operação terá efeito sobre ela.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    ParâmetroTipoObrigatórioExemploDescrição
    ActionStringSimAttachDisk

    Operação a ser executada. Defina o valor como AttachDisk.

    DiskIdStringSimd-bp1j4l5axzdy6ftk****

    ID do disco a ser anexado. O disco especificado pelo parâmetro DiskId e a instância especificada pelo parâmetro InstanceId devem estar na mesma zona.

    Nota Para mais informações sobre as restrições de anexação de discos de dados e discos do sistema, consulte a seção "Descrição".
    InstanceIdStringSimi-bp1dq5lozx5f4pmd****

    ID da instância à qual o disco será anexado.

    DeviceStringNãotestDeviceName

    Nome do disco.

    Nota Este parâmetro será removido futuramente. Recomendamos usar outros parâmetros para garantir compatibilidade futura.
    DeleteWithInstanceBooleanNãofalse

    Especifica se o disco deve ser liberado junto com a instância. Valores válidos:

    • true: o disco é liberado juntamente com a instância.
    • false: o disco não é liberado junto com a instância e é retido como disco de dados com pagamento conforme o uso.

    Valor padrão: false.

    Ao especificar este parâmetro, observe o seguinte:

    • Se OperationLocks de uma instância contiver "LockReason" : "security", a instância estará bloqueada por motivos de segurança. Mesmo que DeleteWithInstance dos discos anexados esteja definido como false, o parâmetro DeleteWithInstance será ignorado e os discos serão liberados junto com a instância.
    • Este parâmetro não está disponível para discos com o recurso multi-attach ativado.
    BootableBooleanNãofalse

    Especifica se o disco deve ser anexado como disco do sistema.

    Valor padrão: false.

    Nota Se o parâmetro Bootable estiver definido como true, a instância deve estar no estado No System Disk.
    PasswordStringNãoEcsV587!

    Senha definida ao anexar o disco do sistema. Aplica-se apenas aos usuários administrador e root. Deve ter entre 8 e 30 caracteres e conter pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os seguintes caracteres especiais são permitidos:

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

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

    Nota Se o parâmetro Password for especificado, recomendamos enviar solicitações via HTTPS para evitar vazamento de senhas.
    KeyPairNameStringNãoKeyPairTestName

    Nome do par de chaves SSH vinculado à instância Linux ao anexar o disco do sistema.

    • Instâncias Windows não suportam logon por par de chaves SSH. O parâmetro Password terá efeito mesmo que o parâmetro KeyPairName seja especificado.
    • Em instâncias Linux, o logon por senha é desativado por padrão.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    RequestId

    String

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID da solicitação.

    Exemplos

    Exemplos de solicitações

    https://ecs.aliyuncs.com/?Action=AttachDisk
&DiskId=d-bp1j4l5axzdy6ftk****
&InstanceId=i-bp1dq5lozx5f4pmd****
&DeleteWithInstance=false
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

    <AttachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachDiskResponse>

    Formato JSON

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

    InvalidDevice.Malformed

    The specified device is not valid.

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

    400

    IncorrectInstanceStatus

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

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

    400

    InvalidParameter

    The input parameter is mandatory for processing this request is empty.

    Mensagem retornada porque um parâmetro obrigatório não foi especificado.

    400

    InvalidRegionId.MalFormed

    The specified RegionId is not valid

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

    400

    InvalidOperation.InstanceTypeNotSupport

    The instance type of the specified instance does not support hot attach disk.

    Mensagem retornada porque a instância à qual o disco está sendo anexado não suporta troca de discos a quente.

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

    400

    InvalidOperation.InstanceTypeNotSupport

    The specified disk which has kms key should only attach to ioOptimized instance.

    Mensagem retornada porque a instância especificada não é suportada. Chaves do Key Management Service (KMS) só podem ser definidas para instâncias otimizadas para E/S.

    400

    InvalidParameter.AllEmpty

    %s

    Mensagem retornada porque os parâmetros obrigatórios não foram especificados.

    403

    InstanceDiskLimitExceeded

    The amount of the disk on instance in question reach its limits.

    Mensagem retornada porque o número máximo de discos que podem ser anexados à instância especificada foi atingido.

    403

    InvalidDevice.InUse

    The specified device has been occupied.

    Mensagem retornada porque o dispositivo especificado já possui um disco anexado.

    403

    DiskNotPortable

    The specified disk is not a portable disk.

    Mensagem retornada porque o disco especificado não é removível.

    403

    InstanceLockedForSecurity

    The instance is locked due to security.

    Mensagem retornada porque a operação não é suportada enquanto o recurso está bloqueado por motivos de segurança.

    403

    ResourcesNotInSameZone

    The specified instance and disk are not in the same zone.

    Mensagem retornada porque a instância e o disco especificados não estão na mesma zona.

    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 por assinatura expirou. Renove a instância e tente novamente.

    403

    DiskInArrears

    The specified operation is denied as your disk owing fee.

    Mensagem retornada porque existem pagamentos pendentes para o disco.

    403

    DiskError

    IncorrectDiskStatus.

    Mensagem retornada porque o estado do disco especificado é inválido.

    403

    DiskId.ValueNotSupported

    The specified parameter diskid is not supported.

    Mensagem retornada porque a categoria do dispositivo Elastic Block Storage (EBS) especificado não suporta esta operação.

    403

    DiskId.StatusNotSupported

    The specified disk status is not supported.

    Mensagem retornada porque esta operação não é suportada enquanto o disco está no estado atual.

    403

    IncorrectDiskStatus

    The operation is not supported in this status.

    Mensagem retornada porque a operação não é suportada enquanto o disco está no estado atual. Verifique se o disco está disponível e se não há pagamentos pendentes.

    403

    UserNotInTheWhiteList

    The user is not in disk white list.

    Mensagem retornada porque você não tem autorização para gerenciar 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á ativada quando um ID de chave KMS é especificado para um disco. Você pode chamar 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 Elastic Compute Service (ECS) não tem autorização para acessar seus recursos do KMS.

    403

    InvalidInstanceType.NotSupportDiskCategory

    The instanceType of the specified instance does not support this disk category.

    Mensagem retornada porque o tipo de instância especificado pelo parâmetro InstanceType não suporta a categoria de disco da instância. Tente outro tipo de instância. Para informações sobre as categorias de disco suportadas pelos tipos de instância, consulte a documentação da família de instâncias.

    403

    InvalidInstanceType.NvmeRequired

    The instanceType of the specified instance requires nvme protocol.

    Mensagem retornada porque o tipo da instância especificada não utiliza o protocolo NVMe.

    403

    InvalidInstanceType.NvmeUnsupported

    The instanceType of the specified instance does not support nvme protocol.

    Mensagem retornada porque o tipo da instância especificada não suporta o protocolo NVMe.

    403

    InvalidInstanceType.NotSupportMultiAttachDisk

    The instanceType of the specified instance does not support multi attach disk.

    Mensagem retornada porque discos com o recurso multi-attach ativado não podem ser anexados a instâncias do tipo especificado.

    403

    DiskAttachedNumberExceeded

    The attaching times of the specified disk exceeded.

    Mensagem retornada porque o número máximo de instâncias às quais o disco especificado pode ser anexado foi atingido.

    403

    InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk

    Multi attach disk can not be attached as system disk.

    Mensagem retornada porque discos com o recurso multi-attach ativado não podem ser anexados como discos do sistema.

    403

    DeleteWithInstance.Conflict

    Multi attach disk cannot be set to DeleteWithInstance attribute.

    Mensagem retornada porque o atributo DeleteWithInstance é inválido para discos com o recurso multi-attach ativado.

    404

    InvalidInstanceId.NotFound

    The specified InstanceId does not exist.

    Mensagem retornada porque o parâmetro InstanceId especificado não existe. Verifique se o ID da instância está correto.

    404

    InvalidDiskId.NotFound

    The specified disk does not exist.

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

    404

    InvalidDisk.InUse

    The specified disk has been occupied.

    Mensagem retornada porque o disco especificado está em uso.

    500

    InternalError

    The request processing has failed due to some unknown error.

    Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.

    500

    InternalError

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

    Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.

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