ページの先頭行へ戻る
Systemwalker Software Configuration Manager V14g リファレンスガイド API編
Systemwalker
第4章 CFMG APIリファレンス > 4.6 仮想システムの操作 > 4.6.5 GetVSYSConfiguration
前次

4.6.5 GetVSYSConfiguration

システムの構成情報を取得します。

リクエストパラメーター

パラメーター名

項目

項目説明

Version

説明

CFMG APIのバージョンID

型

string ASCII

設定内容

固定。「1.0」を指定してください。

Locale

説明

CFMG APIと通信するための言語。ISO 639で規定されている言語コードを指定します。

型

string ASCII

設定内容

以下から選択します。
・「ja」: 日本語
・「en」: 英語

Action

説明

実行するCFMG APIの名称

型

string ASCII

設定内容

固定。「GetVSYSConfiguration」を指定してください。

userId

説明

CFMG APIを実行するユーザーID

型

string ASCII

設定内容

31文字以内

orgId

説明

CFMG APIを実行するユーザーの組織ID

型

string ASCII

設定内容

8文字以内

vsysId

説明

システムID

型

string ASCII

設定内容

32文字以内


レスポンス

《ステータスコード》

正常に終了した場合に「200 OK」を返します。


《XML》

<?xml version="1.0" encoding="UTF-8"?> 
<GetVSYSConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>[メッセージ]</responseMessage>
  <responseStatus>[ステータス]</responseStatus>
  <vsys>
    <baseDescriptor>[システムの元になったシステムテンプレートID]</baseDescriptor>
    <creator>[システム作成者の組織ID]</creator>
    <description>[システムの説明]</description>
    <vnets>
      <vnet>
        <networkId>[VNETのID]</networkId>
        <networkCategory>[ネットワーク種別]</networkCategory>
      </vnet>
    </vnets>
    <vservers>
      <vserver>
        <creator>[仮想マシン作成者の組織ID]</creator>
        <diskimageId>[ディスクイメージID]</diskimageId>
        <vdisks>
          <vdisk>
            <attachedTo>[増設ディスクが取り付けられている仮想マシンID]</attachedTo>
            <creator>[増設ディスクの作成者の組織ID]</creator>
            <size>[増設ディスクサイズ]</size>
            <vdiskId>[増設ディスクID]</vdiskId>
            <vdiskName>[増設ディスク名]</vdiskName>
            <shared>[共有ディスク属性]</shared>
            <storagePool>[ストレージプールのリソース名]</storagePool>
          </vdisk>
        </vdisks>
        <vnics>
          <vnic>
            <networkId>[ネットワークID]</networkId>
            <nicNo>[NIC連番]</nicNo>
            <privateIp>[IPアドレス]</privateIp>
            <management>[制御NIC]</management>
          </vnic>
        </vnics>
        <vserverId>[仮想マシンID]</vserverId>
        <vserverName>[仮想マシン名]</vserverName>
        <vmType>[VM種別]</vmType>
        <vmPool>[VMプールのリソース名]</vmPool>
        <storagePool>[ストレージプールのリソース名]</storagePool>
        <cpuPerf>[CPU性能]</cpuPerf>
        <numOfCpu>[CPU数]</numOfCpu>
        <memorySize>[メモリ量]</memorySize>
        <vserverType>[仮想マシンのタイプ]</vserverType>
      </vserver>
    </vservers>
    <vsysId>[システムID]</vsysId>
    <vsysName>[システム名]</vsysName>
  </vsys>
</GetVSYSConfigurationResponse>

《要素》

要素名

項目

項目説明

GetVSYSConfigurationResponse

説明

レスポンスの情報を持つ要素

型

なし

出現回数

1

responseMessage

説明

メッセージ。リクエストが正しく処理されたかどうかを表します。メッセージの詳細については、「付録A メッセージ」を参照してください。

型

string UTF-8

出現回数

1

responseStatus

説明

ステータス。リクエストが正常に処理されたかどうかを表します。正常に処理された場合は "SUCCESS" が返却されます。それ以外の場合はエラーコードが返却されます。
エラーコードの詳細については、「付録B レスポンスステータス・エラーコード一覧」を参照してください。

型

string ASCII

出現回数

1

vsys

説明

システム情報のレスポンス情報を持つ要素

型

なし

出現回数

0または1

baseDescriptor

説明

システムの元になったテンプレートID

型

string ASCII

出現回数

0または1

creator

説明

システム作成者の組織ID

型

string ASCII

出現回数

0または1

description

説明

システムの説明

型

string UTF-8

出現回数

0または1

vnets

説明

ネットワーク情報のレスポンス情報を持つ要素

型

なし

出現回数

0または1

vnet

説明

ネットワーク情報の一式

型

なし

出現回数

0以上

networkId

説明

ネットワークID

型

string ASCII

出現回数

vnetの数分(それぞれに対して0または1)

networkCategory

説明

ネットワーク種別。管理LANの場合は「MANAGEMENT」、業務LANの場合は「BUSINESS」です。登録されていない場合は空文字になります。

型

string ASCII

出現回数

vnetの数分(それぞれに対して0または1)

vservers

説明

仮想マシン情報のレスポンス情報を持つ要素

型

なし

出現回数

0または1

vserver

説明

仮想マシン情報の一式

型

なし

出現回数

0以上

creator

説明

仮想マシン作成者の組織ID

型

string ASCII

出現回数

vserverの数分(それぞれに対して0または1)

diskimageId

説明

ディスクイメージID

型

string ASCII

出現回数

vserverの数分(それぞれに対して0または1)

vdisks

説明

増設ディスク情報のレスポンス情報を持つ要素

型

なし

出現回数

0または1

vdisk

説明

増設ディスク情報の一式

型

なし

出現回数

0以上

attachedTo

説明

増設ディスクが取り付けられている仮想マシンID

型

string ASCII

出現回数

vdiskの数分(それぞれに対して0または1)

creator

説明

増設ディスク作成者の組織ID

型

string ASCII

出現回数

vdiskの数分(それぞれに対して0または1)

size

説明

増設ディスクサイズ。「GB」単位で指定します。

型

decimal

出現回数

vdiskの数分(それぞれに対して0または1)

vdiskId

説明

増設ディスクID

型

string ASCII

出現回数

vdiskの数分(それぞれに対して0または1)

vdiskName

説明

増設ディスク名

型

string UTF-8

出現回数

vdiskの数分(それぞれに対して0または1)

shared

説明

ディスク共有属性。以下のどちらかになります。
・「true」: 共有ディスクの場合
・「false」: 共有ディスクではない場合または表示されない場合

型

string ASCII

出現回数

vdiskの数分(それぞれに対して0または1)

storagePool

説明

ストレージプールのリソース名

型

string ASCII

出現回数

vdiskの数分(それぞれに対して0または1)

vnics

説明

VNIC情報のレスポンス情報を持つ要素

型

なし

出現回数

vdiskの数分(それぞれに対して0または1)

vnic

説明

VNIC情報の一式

型

なし

出現回数

0以上

networkId

説明

ネットワークID

型

string ASCII

出現回数

vnicの数分(それぞれに対して0または1)

nicNo

説明

NIC連番

型

int

出現回数

vnicの数分(それぞれに対して0または1)

privateIp

説明

IPアドレス

型

string ASCII

出現回数

vnicの数分(それぞれに対して0または1)

management

説明

制御NIC。制御NICの場合は1、そうでない場合は0になります。

型

int

出現回数

vnicの数分(それぞれに対して0または1)

vserverId

説明

仮想マシンID

型

string ASCII

出現回数

vserverの数分(それぞれに対して0または1)

vserverName

説明

仮想マシン名

型

string UTF-8

出現回数

vserverの数分(それぞれに対して0または1)

vmType

説明

VM種別。以下のどれかになります。
・「VMware」:VMware
・「RHEL-Xen」: RHEL-Xen
・「Hyper-V」:Hyper-V

型

string ASCII

出現回数

vserverの数分(それぞれに対して0または1)

vmPool

説明

VMプールのリソース名

型

string UTF-8

出現回数

vserverの数分(それぞれに対して0または1)

storagePool

説明

ストレージプールのリソース名

型

string UTF-8

出現回数

vserverの数分(それぞれに対して0または1)

cpuPerf

説明

CPU性能

型

decimal

出現回数

vserverの数分(それぞれに対して0または1)

numOfCpu

説明

CPU数

型

int

出現回数

vserverの数分(それぞれに対して0または1)

memorySize

説明

メモリ量

型

decimal

出現回数

vserverの数分(それぞれに対して0または1)

vserverType

説明

仮想マシンのタイプ

型

string ASCII

出現回数

vserverの数分(それぞれに対して0または1)

vsysId

説明

システムID

型

string ASCII

出現回数

0または1

vsysName

説明

システム名

型

string UTF-8

出現回数

0または1


サンプルレスポンス

<?xml version="1.0" encoding="UTF-8"?>
<GetVSYSConfigurationResponse xmlns="http://cfmg.systemwalker.jp.fujitsu.com">
  <responseMessage>PAPI00000 Processing was completed.</responseMessage>
  <responseStatus>SUCCESS</responseStatus>
  <vsys>
    <baseDescriptor>testTemplate000</baseDescriptor>
    <creator>testorg</creator>
    <description>Linux2階層</description>
    <vnets>
      <vnet>
        <networkCategory>INTRANET</networkCategory>
        <networkId>testorg-vsys-3-N-INTRANET</networkId>
      </vnet>
      <vnet>
        <networkCategory>INTRANET</networkCategory>
        <networkId>testorg-vsys-3-N-INTERNET</networkId>
      </vnet>
    </vnets>
    <vservers>
      <vserver>
        <cpuPerf>1.3</cpuPerf>
        <creator>testorg</creator>
        <diskimageId>image_id_1</diskimageId>
        <memorySize>8.9</memorySize>
        <numOfCpu>2</numOfCpu>
        <storagePool>/sp_3</storagePool>
        <vdisks>
          <vdisk>
            <attachedTo>testorg-vsys-3-S-0001</attachedTo>
            <creator>testorg</creator>
            <size>12.2</size>
            <storagePool>/sp_3</storagePool>
            <vdiskId>testorg-vsys-3-D-0001</vdiskId>
            <vdiskName>DISK1</vdiskName>
          </vdisk>
          <vdisk>
            <attachedTo>testorg-vsys-3-S-0001</attachedTo>
            <creator>testorg</creator>
            <size>15.5</size>
            <storagePool>/sp_6</storagePool>
            <vdiskId>testorg-vsys-3-D-0002</vdiskId>
            <vdiskName>DISK2</vdiskName>
          </vdisk>
        </vdisks>
        <vmPool>/vp_3</vmPool>
        <vmType>RHEL-Xen</vmType>
        <vnics>
          <vnic>
            <management>0</management>
            <networkId>testorg-vsys-3-N-INTRANET</networkId>
            <nicNo>1</nicNo>
            <privateIp>10.xx.xx.xx</privateIp>
          </vnic>
          <vnic>
            <management>0</management>
            <networkId>testorg-vsys-3-N-INTRANET</networkId>
            <nicNo>2</nicNo>
            <privateIp>10.xx.xx.xx</privateIp>
          </vnic>
        </vnics>
        <vserverId>testorg-vsys-3-S-0001</vserverId>
        <vserverName>ap2</vserverName>
        <vserverType>island12_100</vserverType>
      </vserver>
      <vserver>
        <cpuPerf>1.6</cpuPerf>
        <creator>testorg</creator>
        <diskimageId>ROR-manager_382</diskimageId>
        <memorySize>4.1</memorySize>
        <numOfCpu>4</numOfCpu>
        <storagePool>/sp_6</storagePool>
        <vdisks>
          <vdisk>
            <attachedTo>testorg-vsys-3-S-0002</attachedTo>
            <creator>testorg</creator>
            <size>16.6</size>
            <storagePool>/sp_7</storagePool>
            <vdiskId>testorg-vsys-3-D-0003</vdiskId>
            <vdiskName>DISK3</vdiskName>
          </vdisk>
        </vdisks>
        <vmPool>/vp_6</vmPool>
        <vmType>RHEL-Xen</vmType>
        <vnics>
          <vnic>
            <management>0</management>
            <networkId>testorg-vsys-3-N-INTRANET</networkId>
            <nicNo>1</nicNo>
            <privateIp>10.xx.xx.xx</privateIp>
          </vnic>
        </vnics>
        <vserverId>testorg-vsys-3-S-0002</vserverId>
        <vserverName>ap1</vserverName>
        <vserverType>island12_100</vserverType>
      </vserver>
    </vservers>
    <vsysId>testorg-vsys-3</vsysId>
    <vsysName>正常</vsysName>
  </vsys>
</GetVSYSConfigurationResponse>

前次
Copyright 2011 FUJITSU LIMITED