本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/cp/api/DescribeCustomerGateways.htmへ移行しました。 今後は新ページをご参照ください。

DescribeCustomerGateways

処理概要

指定したカスタマーゲートウェイの情報を取得します。
カスタマーゲートウェイを指定するためには、カスタマーゲートウェイユニークIDまたはカスタマーゲートウェイ名が必要です。
カスタマーゲートウェイを指定しない場合、取得できるすべてのカスタマーゲートウェイ情報を取得します。

絞り込み条件の項目の値「Filter.n.Value.m」を指定する際、ワイルドカード文字(曖昧検索)指定可能です。「∗」は0個以上任意文字、「?」は1個任意文字、「¥」はエスケープ変換文字(「∗niftycloud¥?¥¥」は「∗niftycloud?¥」を検索)となります。

曖昧検索が指定可能な絞り込み条件の項目名は、下記の通りです。

  • ip-address
  • nifty-customer-gateway-name
  • nifty-customer-gateway-description

指定するパラメーター

パラメーター 説明 必須
CustomerGatewayId.n string カスタマーゲートウェイユニークID
NiftyCustomerGatewayName.n string カスタマーゲートウェイ名
Filter.n.Name string 絞り込み条件の項目名
値:
  • customer-gateway-id (カスタマーゲートウェイユニークID)
  • nifty-customer-gateway-name (カスタマーゲートウェイ名)
  • ip-address (カスタマーゲートウェイのインターネット側IPアドレス)
  • state (カスタマーゲートウェイステータス)
  • nifty-customer-gateway-description (カスタマーゲートウェイメモ)
Filter.n.Value.m string 絞り込み条件の値

応答フィールド

フィールド (項目) 説明
DescribeCustomerGatewaysResponse - DescribeCustomerGatewaysレスポンス
requestId string リクエスト識別子
customerGatewaySet - カスタマーゲートウェイ情報セット
item - カスタマーゲートウェイ情報
customerGatewayId string カスタマーゲートウェイユニークID
niftyCustomerGatewayName string カスタマーゲートウェイ名
state string カスタマーゲートウェイステータス
値:
  • pending (処理中)
  • available (起動中)
  • stopped (停止済み)
  • warning (異常あり)
ipAddress string カスタマーゲートウェイのLAN側IPアドレス
niftyLanSideIpAddress string カスタマーゲートウェイのLAN側IPアドレス
niftyLanSideCidrBlock string カスタマゲートウェイ(対向機器)のLAN側IPアドレス帯(CIDR)
tagSet - ※空を返却
リソースに設定されているタグ情報セット
item - リソースに設定されているタグ情報
key string 設定されているタグのキー
value string 設定されているタグの値
niftyCustomerGatewayDescription string メモ(CDATA付)
createdTime timestamp 作成日時

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=DescribeCustomerGateways
  &CustomerGatewayId.1=cgw-8db04f81
  &Filter.1.Name=state
  &Filter.1.Value.1=available
  &CommonParams

  

応答サンプル

    <DescribeCustomerGatewaysResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <customerGatewaySet>
    <item>
      <customerGatewayId>cgw-b4dc3961</customerGatewayId>
      <niftyCustomerGatewayName>cgw1</niftyCustomerGatewayName>
      <state>available</state>
      <ipAddress>192.168.0.1</ipAddress>
      <niftyLanSideIpAddress>192.168.0.1</niftyLanSideIpAddress>
      <niftyLanSideCidrBlock>192.168.0.0/24</niftyLanSideCidrBlock>
      <tagSet/>
      <niftyCustomerGatewayDescription><![CDATA[description]]></niftyCustomerGatewayDescription>
      <createdTime>2020-07-01T13:20:25+09:00</createdTime>
    </item>
  </customerGatewaySet>
</DescribeCustomerGatewaysResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上