本文へジャンプします。

ニフクラ ユーザーガイド

DescribeInstanceAttribute

処理概要

指定したサーバーの詳細情報を取得します。1回のリクエストで、1つのサーバーの1つの詳細情報を取得できます。

サーバーを指定するためには、サーバー名が必要です。

指定するパラメーター

パラメーター 説明 必須
InstanceId string サーバー名
Attribute string 取得する情報の項目名
値:
  • instanceType (サーバータイプを取得)
  • disableApiTermination (APIからのサーバー削除可否を取得)
  • blockDeviceMapping (接続しているディスクの情報を取得)
  • accountingType (利用料金タイプを取得)
  • nextMonthAccountingType (次月の利用料金タイプを取得)
  • loadbalancing (適用しているロードバランサー情報を取得)
  • copyInfo (コピー元サーバーの情報を取得)
  • autoscaling (オートスケール情報を取得)
  • ipType (グローバルIPアドレスの情報を取得)
  • niftyPrivateIpType (プライベートIPアドレス情報を取得)
  • groupId (ファイアウォール情報を取得)
  • description (メモ情報を取得)
  • networkInterfaceSet (ネットワークインターフェース情報を取得)
  • elasticloadbalancing (適用しているマルチロードバランサー情報を取得)

応答フィールド

フィールド (項目) 説明
DescribeInstanceAttributeResponse - DescribeInstanceAttributeレスポンス
requestId string リクエスト識別子
instanceId string サーバー名
instanceUniqueId string サーバーユニークID
instanceType - サーバータイプの情報
value string サーバータイプ
値:
  • e-mini
  • mini
  • c-small
  • e-small
  • small
  • c-small2
  • e-small2
  • small2
  • c-small4
  • e-small4
  • small4
  • e-small8
  • small8
  • e-small16
  • small16
  • c-medium
  • e-medium
  • medium
  • c-medium4
  • e-medium4
  • medium4
  • c-medium8
  • e-medium8
  • medium8
  • e-medium16
  • medium16
  • e-medium24
  • medium24
  • c-large
  • e-large
  • large
  • c-large8
  • e-large8
  • large8
  • e-large16
  • large16
  • e-large24
  • large24
  • e-large32
  • large32
  • e-extra-large8
  • extra-large8
  • e-extra-large16
  • extra-large16
  • e-extra-large24
  • extra-large24
  • e-extra-large32
  • extra-large32
  • e-extra-large48
  • extra-large48
  • e-double-large16
  • double-large16
  • e-double-large24
  • double-large24
  • e-double-large32
  • double-large32
  • e-double-large48
  • double-large48
  • e-double-large64
  • double-large64
  • e-double-large96
  • double-large96
  • triple-large32
  • triple-large48
  • triple-large64
  • triple-large96
  • triple-large128
  • quad-large64
  • quad-large96
  • quad-large128
  • quad-large256
  • septa-large128
  • septa-large256
  • octa-large256
  • octa-large384
  • octa-large512
disableApiTermination - APIからのサーバー削除可否の情報
value boolean APIからのサーバー削除可否
値:
  • true(削除不可)
  • false(削除可)
blockDeviceMapping - 接続しているディスクの情報セット
item - 接続しているディスクの情報
deviceName string ディスクの接続デバイス
値:
  • SCSI(xx:xx)
ebs - ディスクの詳細情報
volumeId string ディスク名
status string ディスクの接続ステータス
値:
  • attached(接続済み)
attachTime timestamp ディスク接続日時
値:
  • yyyy-mm-ddThh:mi:ssZ
deleteOnTermination boolean サーバー削除時のディスク消去
値:
  • true(消去)
  • false(消去しない)
accountingType - 利用料金タイプの情報
value string 利用料金タイプ
値:
  • 1(月額課金)
  • 2(従量課金)
nextMonthAccountingType - 次月の利用料金タイプの情報
value string 次月の利用料金タイプ
値:
  • 1(月額課金)
  • 2(従量課金)
loadbalancing - 適用しているロードバランサー情報
item - ロードバランサー情報
loadBalancerName string ロードバランサー名
loadBalancerPort integer 待ち受けポート
instancePort integer 宛先ポート
State string ヘルスステータス
値:
  • InService(正常)
  • OutService(応答なし)
copyInfo - コピー元サーバーの情報
value string コピー元サーバー名
autoscaling - スケールアウトサーバー情報
autoScalingGroupName string オートスケール名
expireTime timestamp 有効時間
値:
  • yyyy-mm-ddThh:mi:ssZ
ipType - グローバルIPアドレスの情報
value string グローバルIPアドレスのタイプ
値:
  • static(固定)
  • elastic(付替)
  • dynamic(動的)
  • multiIpAddress(マルチIPアドレス)
  • none(グローバルIPなし)
niftyPrivateIpType - プライベートIPアドレスの情報
value string プライベートIPアドレスのタイプ
値:
  • static(固定)
  • elastic(付替)
groupId - ファイアウォールの設定情報
value string ファイアウォールのグループ名
description - サーバーのメモ情報
value string メモ情報
networkInterfaceSet - ネットワークインターフェース情報セット
item - ネットワークインターフェース
networkInterfaceId string ネットワークインターフェースID
subnetId string ※空を返却
vpcId string ※空を返却
description string ※空を返却
ownerId string ※空を返却
niftyNetworkId string ネットワークユニークID
niftyNetworkName string ネットワーク名
status string ネットワークインターフェースのステータス
値:
  • available(利用可能)
  • in-use(使用中)
  • processing(処理中)
macAddress string ネットワークインターフェースのMACアドレス
privateIpAddress string プライベートIPアドレス or プライベート付替IPアドレス(グローバルで無いときのみ)
privateIpAddressV6 string ※空を返却
プライベートIPアドレス(IPv6)
privateDnsName string ※空を返却
sourceDestCheck string ※空を返却
groupSet string ※空を返却
ファイアウォール情報セット
attachment - ネットワークインターフェースの接続情報
attachmentId string アタッチメントID
※ネットワークインターフェースを使用している場合はネットワークインターフェースのアタッチメントIDを返却する
deviceIndex integer デバイス番号
status string 接続状態
値:
  • attaching(接続中)
  • attached(接続済み)
  • detaching(接続解除中)
  • detached(未接続)
attachTime timestamp サーバーへの接続時刻
※ネットワークインターフェースを使用している場合はネットワークインターフェースのサーバーへの接続時刻を返却する
deleteOnTermination boolean ※インスタンス削除時のネットワークインターフェース削除
値:
  • true(削除)
association - ネットワークインターフェースに関連付けられているパブリックIP(固定グローバルIPアドレス、付替IPアドレス)の情報
publicIp string グローバルIPアドレス or グローバル付替IPアドレス
publicIpV6 string ※空を返却
グローバルIPアドレス(IPv6)
publicDnsName string ※空を返却
ipOwnerId string ※空を返却
privateIpAddressesSet string ※空を返却
multiIpAddressesSet - マルチIPアドレス情報セット
item - マルチIPアドレス情報
ipAddress string IPアドレス
niftyElasticLoadBalancing - 適用しているマルチロードバランサーの情報
item - 適用しているマルチロードバランサーの情報
elasticLoadBalancerId string 適用しているマルチロードバランサーユニークID
elasticLoadBalancerName string 適用しているマルチロードバランサー名
protocol string 適用しているマルチロードバランサーのプロトコル
elasticLoadBalancerPort integer 適用しているマルチロードバランサーの待ち受けポート
instancePort integer 適用しているマルチロードバランサーの宛先ポート

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=DescribeInstanceAttribute
  &InstanceId=server01
  &Attribute=blockDeviceMapping
  &CommonParams

  

応答サンプル

    <DescribeInstanceAttributeResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <instanceId>server01</instanceId>
  <instanceUniqueId>i-efba9876</instanceUniqueId>
  <blockDeviceMapping>
    <item>
      <deviceName>SCSI (0:0)</deviceName>
      <ebs>
        <volumeId>disk01</volumeId>
        <status>attached</status>
        <attachTime>2010-05-17T11:22:33.456+09:00</attachTime>
        <deleteOnTermination>false</deleteOnTermination>
      </ebs>
    </item>
  </blockDeviceMapping>
</DescribeInstanceAttributeResponse>

  

ニフクラ サイト内検索

APIメニュー

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

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