IPアドレスプール内のCIDRブロックを照会します。

制限事項

必要な権限を持つユーザーのみがElastic IP address (EIP) のIPアドレスプール機能を使用できます。 必要な権限を申請するには、チケットを起票してください。

デバッグ

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

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ListPublicIpAddressPoolCidrBlocks

実行する操作です。 値をListPublicIpAddressPoolCidrBlocksに設定します。

PublicIpAddressPoolId String 必須 pippool-6wetvn6fumkgycssx ****

IPアドレスプールのID。

CidrBlock String 任意 47.0.XX.XX/24

CIDRブロック。

MaxResults Integer いいえ 10

返されるエントリの最大数。 有効な値: 10〜100。 デフォルト値: 10

NextToken String 任意 FFmyTO70tTpLG6I3FmYAXGKPd ****

次のクエリに使用されるトークン。 有効な値：

  • これが最初のクエリである場合、または次のクエリを送信しない場合は、このパラメーターを無視します。
  • 次のクエリを送信する場合は、パラメーターを前回の呼び出しから返されたNextTokenの値に設定します。
DryRun Boolean いいえ false

操作を実行せずにリクエストをチェックするかどうかを指定します。 有効な値：

  • true: 操作を実行せずにリクエストをチェックします。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 要求がチェックに失敗した場合、エラーメッセージが返されます。 リクエストがチェックに合格すると、DryRunOperationエラーコードが返されます。
  • false (デフォルト): リクエストを送信します。 リクエストがチェックに合格すると、2xx HTTPステータスコードが返され、操作が実行されます。
RegionId String 必須 cn-chengdu

CIDRブロックのリージョンID。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

リクエストの ID です。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd ****

次のクエリに使用されるトークン。 有効な値：

  • NextTokenの値が返されない場合、次のクエリは送信されないことを示します。
  • NextTokenの値が返された場合、その値は次のクエリで使用されるトークンです。
MaxResults Integer 10

返されるエントリの最大数。 有効な値: 10〜100。 デフォルト値: 10

TotalCount Integer 10

返されたエントリの総数。

PublicIpPoolCidrBlockList PublicIpPoolCidrBlockの配列

CIDRブロックに関する情報。

PublicIpAddressPoolId String pippool-6wetvn6fumkgycssx ****

IPアドレスプールのID。

CidrBlock String 47.0.XX.XX/24

CIDRブロック。

CreationTime String 2022-05-10T01:37:38Z

CIDRブロックが作成された時刻。 時刻はYYYY-MM-DDThh:mm:ssZ形式で表示されます。

Status String 作成済み

IPアドレスプール内のCIDRブロックのステータス。 有効な値：

  • Created: available
  • Deleting: 削除中
  • Modifying: 変更中
UsedIpNum Integer 20

CIDRブロックで使用可能なIPアドレスの総数。

TotalIpNum Integer 20

CIDRブロック内の占有IPアドレスの総数。

例

リクエストの例

http(s):// [エンドポイント]/? アクション=ListPublicIpAddressPoolCidrBlocks
&PublicIpAddressPoolId=pippool-6wetvn6fumkgycssx ****
&CidrBlock=47.0.XX.XX/24
&MaxResults=10
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd ****
&DryRun=false
&RegionId=cn-chengdu
&共通リクエストパラメータ

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

XML 形式 

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

<ListPublicIpAddressPoolCidrBlocksResponse>
    <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd ****</NextToken>
    <MaxResults>10</MaxResults>
    <TotalCount>10</TotalCount>
    <PublicIpPoolCidrBlockList>
        <PublicIpAddressPoolId>pippool-6wetvn6fumkgycssx ****</PublicIpAddressPoolId>
        <CidrBlock>47.0.XX.XX/24</CidrBlock>
        <CreationTime>2022-05-10T01:37:38Z</CreationTime>
        <Status> 作成 </Status>
        <UsedIpNum>20</UsedIpNum>
        <TotalIpNum>20</TotalIpNum>
    </PublicIpPoolCidrBlockList>
</ListPublicIpAddressPoolCidrBlocksResponse>

JSON 形式 

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

{
  "RequestId" : "4EC47282-1B74-4534-BD0E-403F3EE64CAF" 、
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd ****" 、
  "MaxResults" : 10、
  "TotalCount" : 10、
  "PublicIpPoolCidrBlockList" : [ {
    "PublicIpAddressPoolId" : "pippool-6wetvn6fumkgycssx ****" 、
    "CidrBlock" : "47.0.XX.XX/24" 、
    "CreationTime" : "2022-05-10T01:37:38Z" 、
    "ステータス" : "作成" 、
    "UsedIpNum" : 20、
    "TotalIpNum" : 20
  } ]
}

エラーコード

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