getPublicIpInstanceList

Prev Next

VPC環境で利用できます。

概要

グローバルIPインスタンスリストを照会します。

リクエスト

リクエストパラメータ

パラメータ名 必須の有無 タイプ 制約事項 説明
regionCode No String リージョンコード
グローバルIPインスタンスのリストが照会されるリージョン(Region)を決定できます。
regionCodeはgetRegionListアクションを通じて取得できます。
Default:getRegionList照会結果の最初のリージョンを選択
publicIpInstanceNoList.N No List<String> グローバルIPインスタンス番号リスト
グローバルIPインスタンス番号でフィルタリングして検索できます。
publicIpInstanceNoはgetPublicIpInstanceListアクションを通じて取得できます。
ex)--publicIpInstanceNoList 1234 2345
publicIp No String グローバルIPアドレス
グローバルIPアドレスでフィルタリングして検索できます。
privateIp No String プライベートIPアドレス
グローバルIPインスタンスが割り当てられたサーバインスタンスのeth0プライベートIPアドレスでフィルタリングして検索できます。
isAssociated No Boolean 割り当ての有無
サーバインスタンスに割り当てられたグローバルIPと、割り当てられていないグローバルIPでフィルタリングして検索できます。
Options : true | false
serverName No String サーバ名
グローバルIPインスタンスが割り当てられたサーバ名でフィルタリングして検索できます。
publicIpInstanceStatusCode No String グローバルIPインスタンスのステータスコード
グローバルIPインスタンスのステータスコードでフィルタリングして検索できます。
Options : INIT | SET | RUN | TERMTING
pageNo No Integer ページングされた結果のページ番号
結果値をpageNo、pageSizeを利用してページング処理できます。
pageSize Conditional Integer ページングする時に表示する各ページのサイズ
結果値をpageNo、pageSizeを利用してページング処理できます。
pageNoを入力する時に必ず入力しなければなりません。
vpcNo No String VPC番号
VPC番号でフィルタリングして検索できます。
vpcNoはgetVpcListアクションを通じて取得できます。
responseFormatType No String レスポンス結果のフォーマットタイプ
Options : xml | json
Default : xml

レスポンス

レスポンスデータタイプ

  • PublicIpInstanceListタイプ
PublicIpInstanceList extends CommonResponse
private Integer totalRows;
private List<PublicIpInstance> publicIpInstanceList = new ArrayList<>();
PublicIpInstance
private String publicIpInstanceNo;
private String publicIp;
private String publicIpDescription;
private Date createDate;
private String publicIpInstanceStatusName;
private CommonCode publicIpInstanceStatus;
private String serverInstanceNo;
private String serverName;
private String privateIp;
private Date lastModifyDate;
private CommonCode publicIpInstanceOperation;

リクエスト例

ncloud vserver getPublicIpInstanceList --regionCode KR --publicIpInstanceNoList ***7551 ***7552 --publicIp ***.***.111.215 --privateIp ***.***.1.6 --isAssociated true --serverName test-*** --publicIpInstanceStatusCode RUN --vpcNo ***04

レスポンス例

<getPublicIpInstanceListResponse>
  <requestId>ff28f839-00f2-4d07-bd6b-b172596eebf8</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <publicIpInstanceList>
    <publicIpInstance>
      <publicIpInstanceNo>***7551</publicIpInstanceNo>
      <publicIp>***.***.111.215</publicIp>
      <publicIpDescription></publicIpDescription>
      <createDate>2020-08-19T14:34:41+0900</createDate>
      <publicIpInstanceStatusName>運用中</publicIpInstanceStatusName>
      <publicIpInstanceStatus>
        <code>RUN</code>
        <codeName>run</codeName>
      </publicIpInstanceStatus>
      <serverInstanceNo>***4299</serverInstanceNo>
      <serverName>test-***</serverName>
      <privateIp>***.***.1.6</privateIp>
      <publicIpInstanceOperation>
        <code>NULL</code>
        <codeName>NULL OP</codeName>
      </publicIpInstanceOperation>
    </publicIpInstance>
  </publicIpInstanceList>
</getPublicIpInstanceListResponse>