AttachDBInstances - Anexar instâncias do ApsaraDB RDS a um grupo de scaling - Auto Scaling: Central de Documentação do Alibaba Cloud

Observações de uso

Antes de associar uma instância do ApsaraDB RDS a um grupo de dimensionamento, verifique se os seguintes requisitos são atendidos:

A instância do ApsaraDB RDS e o grupo de dimensionamento pertencem à mesma conta da Alibaba Cloud.
A instância do ApsaraDB RDS está desbloqueada. Para mais informações sobre a política de bloqueio, consulte Observações de uso do ApsaraDB RDS.
A instância do ApsaraDB RDS está no estado Running.
Se o grupo de dimensionamento já tiver uma instância do ApsaraDB RDS associada e você tentar associar a mesma instância novamente, o número de instâncias do ApsaraDB RDS vinculadas ao grupo permanecerá inalterado. Nesse caso, o Auto Scaling adiciona automaticamente os endereços IP privados de todas as instâncias do Elastic Compute Service (ECS) no grupo de dimensionamento à lista de permissões de endereços IP da instância do ApsaraDB RDS.

Nota

Após associar uma instância do ApsaraDB RDS ao grupo de dimensionamento, a lista de permissões de endereços IP padrão da instância do ApsaraDB RDS pode conter no máximo 1.000 endereços IP. Para mais informações, consulte Configurar listas de permissões de endereços IP para a instância RDS.

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âmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AttachDBInstances	Operação a ser executada. Defina o valor como AttachDBInstances.
ScalingGroupId	String	Sim	asg-bp1avr6ensitts3w****	ID do grupo de dimensionamento.
ForceAttach	Boolean	Não	false	Define se os endereços IP privados das instâncias no grupo de dimensionamento devem ser adicionados à lista de permissões de endereços IP da instância do ApsaraDB RDS durante a associação. Valores válidos: true false Valor padrão: false.
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas garanta que ele seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para mais informações, consulte Garantir idempotência.
DBInstance.N	String	Não	rm-bp12cy3****	ID da instância N do ApsaraDB RDS a ser associada ao grupo de dimensionamento. Valores válidos de N: 1 a 5.
RegionId	String	Não	cn-qingdao	ID da região do grupo de dimensionamento.
AttachMode	String	Não	SecurityIp	Método de associação do banco de dados ao grupo de dimensionamento. Valores válidos: SecurityIp: o Auto Scaling adiciona os endereços IP privados das instâncias expandidas à lista de permissões de endereços IP do banco de dados. Defina o valor como SecurityIp somente se o banco de dados a ser associado for uma instância do ApsaraDB RDS. SecurityGroup: o Auto Scaling adiciona o grupo de segurança da configuração de dimensionamento efetiva à lista de permissões de grupos de segurança do banco de dados, permitindo o acesso seguro das instâncias no grupo de dimensionamento ao banco de dados. Valor padrão: SecurityIp.
Type	String	Não	RDS	Tipo do banco de dados. Valores válidos: RDS: instância do ApsaraDB RDS. Redis: instância do ApsaraDB for Redis. MongoDB: instância do ApsaraDB for MongoDB. Valor padrão: RDS.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=AttachDBInstances
&ScalingGroupId=asg-bp1avr6ensitts3w****
&ForceAttach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&DBInstance=["rm-bp12cy3****"]
&RegionId=cn-qingdao
&AttachMode=SecurityIp
&Type=RDS
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AttachDBInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachDBInstancesResponse>

Formato JSON

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

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

Códigos de erro

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.

Código de status HTTP	Código de erro	Descrição	Descrição
404	InvalidScalingGroupId.NotFound	O grupo de dimensionamento especificado não existe.	O grupo de dimensionamento especificado não existe na sua conta da Alibaba Cloud.
400	QuotaExceeded.RDS	Cota de "RDS" excedida.	O número máximo de instâncias do ApsaraDB RDS que podem ser associadas ao grupo de dimensionamento foi atingido.
400	InvalidDBInstanceId.NotFound	O valor especificado do parâmetro "%s" não é válido.	A instância do ApsaraDB RDS especificada não existe.
400	IncorrectDBInstanceStatus	O status atual da instância de banco de dados "%s" não oferece suporte a esta ação.	A operação não é suportada quando a instância do ApsaraDB RDS está no estado atual.
400	QuotaExceeded.DBInstanceSecurityIP	Cota de IP de segurança excedida na instância de banco de dados "%s".	O número máximo de endereços IP na lista de permissões de endereços IP da instância do ApsaraDB RDS foi atingido.
400	InvalidInstanceIds.PrivateIpNotFound	Não é possível encontrar todos os IPs privados das instâncias no grupo de dimensionamento específico.	Não foi possível obter o endereço IP privado de uma instância no grupo de dimensionamento.