DB インスタンスのアタッチ - Auto Scaling - Alibaba Cloud ドキュメントセンター

スケーリンググループに ApsaraDB RDS インスタンスをアタッチします。ビジネス要件に基づいて、スケーリンググループにアタッチされている ApsaraDB RDS インスタンスの数を調整して、使用の柔軟性を高めることができます。

使用上の注意

ApsaraDB RDS インスタンスをスケーリンググループにアタッチする前に、以下の要件が満たされていることを確認してください。

ApsaraDB RDS インスタンスとスケーリンググループが同じ Alibaba Cloud アカウントに属していること。
ApsaraDB RDS インスタンスがロック解除されていること。ロックポリシーの詳細については、「ApsaraDB RDS の使用上の注意」をご参照ください。
ApsaraDB RDS インスタンスが実行中状態であること。
スケーリンググループに ApsaraDB RDS インスタンスがアタッチされていて、同じインスタンスをスケーリンググループに再度アタッチする場合、アタッチ後もスケーリンググループにアタッチされている ApsaraDB RDS インスタンスの数は変わりません。代わりに、Auto Scaling は、スケーリンググループ内のすべての Elastic Compute Service (ECS) インスタンスのプライベート IP アドレスを ApsaraDB RDS インスタンスの IP アドレスホワイトリストに自動的に追加します。

説明

ApsaraDB RDS インスタンスがスケーリンググループにアタッチされた後、ApsaraDB RDS インスタンスのデフォルトの IP アドレスホワイトリストには、最大 1,000 個の IP アドレスを含めることができます。詳細については、「RDS インスタンスの IP アドレスホワイトリストを設定する」をご参照ください。

デバッグ

OpenAPI エクスプローラーは署名値を自動的に計算します。便宜上、OpenAPI エクスプローラーでこの操作を呼び出すことをお勧めします。 OpenAPI エクスプローラーは、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター	タイプ	必須	例	説明
Action	String	はい	AttachDBInstances	実行する操作。値を AttachDBInstances に設定します。
ScalingGroupId	String	はい	asg-bp1avr6ensitts3w****	スケーリンググループの ID。
ForceAttach	Boolean	いいえ	false	アタッチ中に、スケーリンググループ内のインスタンスのプライベート IP アドレスを ApsaraDB RDS インスタンスの IP アドレスホワイトリストに追加するかどうかを指定します。有効な値： true false デフォルト値：false。
ClientToken	String	いいえ	123e4567-e89b-12d3-a456-42665544****	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する」をご参照ください。
DBInstance.N	String	いいえ	rm-bp12cy3****	スケーリンググループにアタッチする ApsaraDB RDS インスタンス N の ID。N の有効な値：1 ～ 5。
RegionId	String	いいえ	cn-qingdao	スケーリンググループのリージョン ID。
AttachMode	String	いいえ	SecurityIp	データベースをスケーリンググループに関連付けるために使用するメソッド。有効な値： SecurityIp：Auto Scaling は、スケールアウトされたインスタンスのプライベート IP アドレスをデータベースの IP アドレスホワイトリストに追加します。アタッチするデータベースが ApsaraDB RDS インスタンスの場合にのみ、値を SecurityIp に設定できます。 SecurityGroup：Auto Scaling は、有効なスケーリング設定のセキュリティグループをデータベースのセキュリティグループホワイトリストに追加して、スケーリンググループ内のインスタンスからデータベースへの安全なアクセスを有効にします。デフォルト値：SecurityIp。
Type	String	いいえ	RDS	データベースのタイプ。有効な値： RDS：ApsaraDB RDS インスタンス。 Redis：ApsaraDB for Redis インスタンス。 MongoDB：ApsaraDB for MongoDB インスタンス。デフォルト値：RDS。

レスポンスパラメーター

パラメーター	タイプ	例	説明
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	リクエスト ID。

例

リクエストの例

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
&<共通リクエストパラメーター>

成功レスポンスの例

XML 形式

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

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

JSON 形式

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

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

エラーコード

エラーコードのリストについては、「サービスエラーコード」をご参照ください。

HTTP ステータスコード	エラーコード	説明	説明
404	InvalidScalingGroupId.NotFound	指定されたスケーリンググループが存在しません。	Alibaba Cloud アカウント内に指定されたスケーリンググループが存在しません。
400	QuotaExceeded.RDS	「RDS」クォータを超過しました。	スケーリンググループにアタッチできる ApsaraDB RDS インスタンスの最大数に達しました。
400	InvalidDBInstanceId.NotFound	パラメーター「%s」の指定された値が無効です。	指定された ApsaraDB RDS インスタンスが存在しません。
400	IncorrectDBInstanceStatus	DB インスタンス「%s」の現在のステータスでは、この操作はサポートされていません。	ApsaraDB RDS インスタンスが現在の状態の場合、操作はサポートされていません。
400	QuotaExceeded.DBInstanceSecurityIP	DB インスタンス「%s」のセキュリティ IP クォータを超過しました。	ApsaraDB RDS インスタンスの IP アドレスホワイトリストの IP アドレスの最大数に達しました。
400	InvalidInstanceIds.PrivateIpNotFound	特定のスケーリンググループ内のインスタンスのすべてのプライベート IP が見つかりません。	スケーリンググループ内のインスタンスのプライベート IP アドレスを取得できません。