IPアドレス許可リストの変更 - - Alibaba Cloud ドキュメントセンター

IPアドレス許可リストには、インスタンスへのアクセスが許可されているIPアドレスとCIDRブロックが含まれています。 IPアドレス許可リストを設定する方法の詳細については、「ApsaraDB RDSインスタンスのIPアドレス許可リストの設定」をご参照ください。

説明この操作を呼び出す前に、インスタンスが [実行中] 状態であることを確認してください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター


項目	データ型	必須／任意	例:	説明
操作	String	必須	ModifySecurityIps	実行する操作です。値をModifySecurityIpsに設定します。
DBInstanceId	String	必須	pgm-bp18n0c8zt45 ****	インスタンスの ID です。
SecurityIps	String	必須	10.23.XX.XX	IPアドレス許可リストに含めるIPアドレスとCIDRブロック。 IPアドレス許可リストに複数のIPアドレスまたはCIDRブロックが含まれている場合は、これらのIPアドレスとCIDRブロックをコンマ (,) で区切ります。 IPアドレス許可リストの各IPアドレスまたはCIDRブロックは一意である必要があります。詳細については、「ApsaraDB RDSインスタンスのIPアドレス許可リストの設定」をご参照ください。 IPアドレス許可リストのエントリは、次のいずれかの形式である必要があります。 10.23.XX.XXなどのIPアドレス。 CIDRブロック (10.23.XX.XX/24など) この例では、24は、IPアドレス許可リスト内の各IPアドレスのプレフィックスが24ビット長であることを示す。 24を1から32の範囲内の値に置き換えることができます。説明インスタンスごとに最大1,000個のIPアドレスとCIDRブロックを設定できます。多数のIPアドレスを追加する場合は、それらをCIDRブロック (10.23.XX.XX/24など) にマージすることを推奨します。
DBInstanceIPArrayName	String	任意	test	変更するIPアドレス許可リストの名前。デフォルト値: Default。説明インスタンスごとに最大200個のIPアドレス許可リストを設定できます。
DBInstanceIPArrayAttribute	String	任意	hidden	IPアドレスallowlistの属性。デフォルトでは、このパラメーターは空です。説明非表示属性を持つIPアドレス許可リストは、ApsaraDB RDSコンソールに表示されません。これらのIPアドレス許可リストは、Data Transmission Service (DTS) などのAlibaba Cloudサービスへのアクセスに使用されます。
SecurityIPType	String	任意	IPv4	IPアドレス許可リストのIPアドレスのタイプ。値はIPv4として固定されています。
WhitelistNetworkType	String	任意	Classic	IPアドレスallowlistのネットワークタイプ。有効な値：クラシック: 拡張許可リストモードのクラシックネットワーク VPC: 拡張許可リストモードの仮想プライベートクラウド (VPC) ネットワークタイプ。 MIX: 標準の許可リストモード。デフォルト値: MIX。説明標準の許可リストモードでは、IPアドレスとCIDRブロックはデフォルトのIPアドレス許可リストにのみ追加されます。拡張許可リストモードでは、IPアドレスとCIDRブロックがクラシックネットワークタイプとVPCネットワークタイプのIPアドレス許可リストに追加されます。
ModifyMode	String	任意	カバー	IPアドレス許可リストを変更するために使用されるメソッド。有効な値： Cover: SecurityIpsパラメーターで指定されたIPアドレスとCIDRブロックを使用して、IPアドレス許可リストの既存のIPアドレスとCIDRブロックを上書きします。追加: SecurityIpsパラメーターで指定されたIPアドレスとCIDRブロックをIPアドレス許可リストに追加します。削除: SecurityIpsパラメーターで指定されているIPアドレスとCIDRブロックをIPアドレス許可リストから削除します。少なくとも1つのIPアドレスまたはCIDRブロックを保持する必要があります。デフォルト値: Cover。
FreshWhiteListReadins	String	任意	pgr-bp17yuz4dn3d **,pgr-bp1vn2ph54u1 **	IPアドレス許可リストを同期する読み取り専用インスタンス。このパラメーターは、ApsaraDB RDS for PostgreSQLインスタンスにのみ適用されます。インスタンスに読み取り専用インスタンスがアタッチされている場合、このパラメーターを使用して、IPアドレス許可リストを読み取り専用インスタンスに同期できます。インスタンスに複数の読み取り専用インスタンスがアタッチされている場合、読み取り専用インスタンスはコンマ (,) で区切る必要があります。インスタンスに読み取り専用インスタンスがアタッチされていない場合、このパラメーターは空です。

レスポンスパラメーター


項目	データ型	例:	説明
TaskId	String	115855279	タスクのID。
RequestId	String	1AD222E9-E606-4A42-BF6D-8A4442913CEF	リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ModifySecurityIps
&DBInstanceId=pgm-bp18n0c8zt45 ****
&SecurityIps=10.23.12.24
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

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

<ModifySecurityIpsResponse>
<RequestId> 1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
<TaskId>115855279</TaskId>
</ModifySecurityIpsResponse>

JSON 形式

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

{
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF" 、
  "TaskId" : 115855279
}

エラーコード


HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidWhitelistNetType.Malformed	指定されたWhitelistNetTypeは無効です。	WhitelistNetworkTypeパラメーターの値が無効な場合に返されるエラーメッセージ。有効な値を入力してください。
400	InvalidIPArrayAttribute.Format	IP属性の形式が無効です。	DBInstanceIPArrayAttributeパラメーターの値が無効な形式の場合に返されるエラーメッセージ。有効な形式で値を入力し、もう一度お試しください。 IPアドレス許可リストに複数のIPアドレスまたはCIDRブロックが含まれている場合は、IPアドレスとCIDRブロックが一意で、コンマ (,) で区切られていることを確認してください。 IPアドレス許可リストのエントリは、次のいずれかの形式である必要があります。10.23.12.24などのIPアドレス。 CIDRブロック (10.23.12.0/24など) 。この場合、24は、各IPアドレスのプレフィックスが24ビット長であることを示す。 24を1から32の範囲内の値に置き換えることができます。
400	InvalidSecurityIPList.Duplicate	指定されたセキュリティ IP リストは無効です。リスト内の IP アドレスが重複しています。	指定されたIPアドレスまたはCIDRブロックが無効な場合に返されるエラーメッセージ。指定されたIPアドレスまたはCIDRブロックが重複しています。
400	SecurityIPList.Format	指定されたSecurityIPListは無効です。	指定されたIPアドレスまたはCIDRブロックが無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。