Todos os produtos
Search
Central de documentação

:ModifyInstanceAttachmentAttributes

Última atualização: Jul 03, 2026

Modifica os atributos do pool privado de uma instância.

Descrição

A criação de uma garantia de elasticidade ou de uma reserva de capacidade gera um pool privado. Esse pool associa-se às informações das instâncias criadas por meio dele. Ao criar uma instância ECS, configure o uso do pool privado para que a instância corresponda à garantia de elasticidade ou à reserva de capacidade.

  • Após chamar esta operação para modificar os atributos do pool privado de uma instância, não é necessário reiniciá-la.

  • Ao chamar as operações listadas abaixo, o sistema tenta associar novamente a instância aos pools privados. Se a instância já estiver vinculada a um pool específico e a chamada falhar devido à exaustão da capacidade ou à invalidade do pool, chame a operação ModifyInstanceAttachmentAttributes para alterar o modo de correspondência do pool privado para Open.

    • StartInstance

    • ReActivateInstances

    • ModifyInstanceChargeType

    • ModifyPrepayInstanceSpec

    • ReplaceSystemDisk

Depuração

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

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ModifyInstanceAttachmentAttributes

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

RegionId String Sim cn-hangzhou

ID da região do pool privado. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.

InstanceId String Sim i-bp67acfmxazb4****

ID da instância cujos atributos do pool privado serão modificados.

PrivatePoolOptions.MatchCriteria String Sim Open

Modo de correspondência do pool privado. Valores válidos:

  • Open: pool privado aberto. O sistema associa a instância a pools privados abertos.
  • Target: pool privado especificado. Especifique o parâmetro PrivatePoolOptions.Id para indicar o ID de um pool privado.
  • None: sem pool privado. A instância inicia sem utilizar pools privados.
PrivatePoolOptions.Id String Não eap-bp67acfmxazb4****

ID do pool privado. Defina o valor como o ID da garantia de elasticidade ou da reserva de capacidade que gerou o pool privado.

  • Parâmetro obrigatório quando PrivatePoolOptions.MatchCriteria está definido como Target.
  • Deve estar vazio quando PrivatePoolOptions.MatchCriteria está definido como Open ou None.

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=ModifyInstanceAttachmentAttributes
&RegionId=cn-hangzhou
&InstanceId=i-bp67acfmxazb4****
&PrivatePoolOptions.MatchCriteria=Open
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

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

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

MissingParameter.RegionId

The specified RegionId should not be null.

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

400

DedicatedHostNotSupported

DedicatedHost is not supported for PrivatePool.

Mensagem retornada porque pools privados não permitem criar instâncias em hosts dedicados.

400

SpotNotSupported

Spot is not supported for PrivatePool.

Mensagem retornada porque pools privados não permitem criar instâncias preemptíveis.

400

ClassicNetworkNotSupported

Classic network is not supported for PrivatePool.

Mensagem retornada porque pools privados não suportam a criação de instâncias de rede clássica.

400

Invalid.InstanceId

Instance does not exist.

Mensagem retornada porque a instância especificada não existe.

400

Invalid.PrivatePoolOptions.MatchCriteria

Target mode does not support this operation.

Mensagem retornada porque a operação não é compatível com o modo Target do parâmetro PrivatePoolOptions.MatchCriteria.

400

MissingParameter.PrivatePoolOptions.Id

The specified PrivatePoolOptions.Id should not be null.

Mensagem retornada porque o parâmetro PrivatePoolOptions.Id não foi especificado.

400

Invalid.PrivatePoolOptions.Id

The PrivatePool does not exist.

Mensagem retornada porque o pool privado não existe.

400

Invalid.InstanceType

The InstanceType does not match the PrivatePool.

Mensagem retornada porque o tipo de instância especificado não corresponde ao pool privado indicado.

400

Invalid.InstanceChargeType

The InstanceChargeType does not match the PrivatePool.

Mensagem retornada porque o método de faturamento da instância não corresponde ao pool privado especificado.

400

Invalid.ZoneId

The ZoneId does not match the PrivatePool.

Mensagem retornada porque a zona especificada não corresponde ao pool privado indicado.

400

Invalid.PrivatePoolOptions.MatchCriteria

The PrivatePoolOptions.MatchCriteria does not match the PrivatePool.

Mensagem retornada porque o parâmetro PrivatePoolOptions.MatchCriteria especificado não corresponde ao pool privado.

400

InvalidPlatform.ValueNotSupported

The Platform does not match the PrivatePool.

Mensagem retornada porque o parâmetro Platform especificado não corresponde ao pool privado.

400

InvalidAliUid

The PrivatePool does not belong to the user of the Instance.

Mensagem retornada porque o pool privado especificado não pertence ao usuário que tentou criar a instância.

400

Invalid.InstanceId

The Instance dose not attached to a PrivatePool.

Mensagem retornada porque a instância não está associada ao pool privado.

400

Invalid.TooManyPrivatePoolOptions.Ids

Too many PrivatePoolOptions.Ids in this request.

Mensagem retornada porque o número de IDs de garantia de elasticidade especificados excede o limite superior.

400

Invalid.TooManyZoneIds

Too many ZoneIds in the request.

Mensagem retornada porque o número de IDs de zona especificados excede o limite superior.

400

Invalid.TooManyInstanceTypes

Too many InstanceTypes in the request.

Mensagem retornada porque o número de tipos de instância especificados excede o limite superior.

400

Invalid.TooManyUnpaidPrivatePool

Too many PrivatePools create but still unpaid.

Mensagem retornada porque há múltiplos pools privados criados, mas ainda não pagos.

400

Invalid.InstanceCpuCoreCountOrInstanceAmount

Both InstanceCpuCoreCount and InstanceAmount are provided.

Mensagem retornada porque os parâmetros InstanceCpuCoreCount e InstanceAmount não podem ser especificados simultaneamente.

400

Invalid.PrivatePool.Purchase

The PrivatePool has already paid.

Mensagem retornada porque o pool privado já foi pago.

400

Invalid.AssuranceTimes.NotSupported

The value of AssuranceTimes is not supported.

Mensagem retornada porque o valor especificado para o parâmetro AssuranceTimes é inválido.

400

RepeatStartPrivatePool

PrivatePool has already been started.

Mensagem retornada porque o pool privado já foi iniciado.

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, consulte Códigos de erro do serviço.