Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

15.6. サブコレクション

15.6.1. ディスクのサブコレクション
リンクのコピー

15.6.1.1. ディスクのサブコレクション
リンクのコピー

disks サブコレクションは、仮想マシン上のすべての仮想ハードディスクデバイスを表します。disk 表現には次のような要素が含まれます。
Expand
表15.2 仮想マシンディスクの要素
要素タイプ説明プロパティー
link rel="statistics"リレーションシップ仮想マシンのディスクの統計を確認するための statistics サブコレクションへのリンク
link rel="permissions"リレーションシップpermissions サブコレクションへのリンク
alias文字列ディスクの一意識別子。name ではなく alias を使用します。
image_id文字列定義されたストレージドメインに格納されている仮想マシンイメージへの参照
storage_domains複合型そのディスクと関連付けられたストレージドメイン。storage_domain 要素には 関連付けられたストレージドメインの GUID を示す id 属性が含まれます。データストレージドメイン間でのライブマイグレーションを実行するには、POST でこの要素を更新します。 [a]
size整数ディスクサイズ (バイト単位)。非推奨となり、provisioned_size に置き換えられます。
provisioned_size整数プロビジョニングされたディスクのサイズ (バイト単位)
actual_size整数ディスクの実際のサイズ (バイト単位)
statusillegal、invalid、locked、ok のいずれかディスクデバイスのステータス。 これらのステータスは capabilities の下の disk_states に記載されています。
interface列挙型ディスクデバイスへの接続に使用するインターフェースドライバーのタイプ。使用できる列挙値の一覧は capabilities に記載されています。 
format列挙型下層のストレージのフォーマット。列挙値の一覧は capabilities に記載されています。Copy On Write (COW) により、最小限のパフォーマンスオーバーヘッドでスナップショットを作成することができます。Raw ではスナップショットは作成できませんが、パフォーマンスが向上します。
sparseブール値: true または falsetrue: 物理ストレージの場合に指定します。ディスクを事前割り当てすべきではないためです。
bootableブール値: true または falsetrue: ディスクがブート可能とマークされている場合に指定します。 
shareableブール値: true または falsetrue: 複数の仮想マシンで共有する場合に指定します。 
wipe_after_deleteブール値: true または falsetrue: ディスクが削除される時に下層の物理ストレージがゼロ処理される必要がある場合に指定します。これにより、セキュリティーが強化されますが、より負荷の高い操作であるため、削除に要する時間が伸びる可能性があります。 
propagate_errorsブール値: true または falsetrue: ディスクエラーによって仮想マシンが一時停止せず、代わりにディスクエラーがゲスト OS に伝達される必要がある場合に指定します。 
vm id=GUID格納している仮想マシンの ID
quota id=GUIDディスククォータを設定します。 
lun_storage複合型ストレージの使用状況を確認するための直接 LUN マッピングへの参照。iSCSI または FCP デバイスの詳細情報が含む logical_unit 要素が必要。
activeブール値仮想マシンにディスクが接続されているかどうかを定義します。
read_onlyブール値ディスクが読み取り専用かどうかを定義します。
link rel="disk_profile"リレーションシップdisk_profile サブコレクションへのリンク
[a] この要素は、仮想マシンから作成されていないディスクを仮想マシンに追加する場合のみ必要です。

例15.11 ディスクデバイスの XML 表現

<disk id="ed7feafe-9aaf-458c-809a-ed789cdbd5b4"
  href="/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
  ed7feafe-9aaf-458c-809a-ed789cdbd5b4">
    <link rel="statistics"
      href="/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
      ed7feafe-9aaf-458c-809a-ed789cdbd5b4/statistics"/>
    <link rel="permissions"
      href="/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
      ed7feafe-9aaf-458c-809a-ed789cdbd5b4/permissions"/>
    <vm id="082c794b-771f-452f-83c9-b2b5a19c0399"
      href="/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399"/> 
    <alias>Classic_VM</alias>
    <image_id>cac69a29-ccff-49d4-8a26-e4cdacd83e34</image_id> 
    <storage_domains>
        <storage_domain id="fabe0451-701f-4235-8f7e-e20e458819ed"/>
    </storage_domains> 
    <size>12884901888</size>
    <provisioned_size>12884901888</provisioned_size>
    <actual_size>1073741824</actual_size>
    <type>system</type>
    <status>
        <state>ok</state>
    </status>
    <interface>virtio</interface>
    <format>raw</format>
    <bootable>true</bootable>
    <shareable>true</shareable>
    <wipe_after_disk>true</wipe_after_disk>
    <propagate_errors>false</propagate_errors>
    <active>true</active>
    <read_only>false</read_only>
    <disk_profile id="23fb2e0d-3062-4819-8165-3be88f2f587e"
      href="/api/diskprofiles/23fb2e0d-3062-4819-8165-3be88f2f587e"/>
    <lun_storage>
        <logical_unit id="lun1">
                ...
        </logical_unit>
    </lun_storage>
</disk>
Copy to Clipboard Toggle word wrap
新規の仮想ディスクを追加します。新しい内部ディスクを追加する場合は、provisioned_size 要素が必要です。storage_domains 要素を使用して、どのストレージドメインにディスクを作成するかを指定します。異なるストレージドメインには、同じ仮想マシンに対して複数のディスクを配置することができます。

例15.12 仮想マシン上での新規ディスクデバイスの作成

POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <storage_domains>
        <storage_domain id="fabe0451-701f-4235-8f7e-e20e458819ed"/>
    </storage_domains>        
    <provisioned_size>8589934592</provisioned_size>
    <type>system</type>
    <interface>virtio</interface>
    <format>cow</format>
    <bootable>true</bootable>
</disk>
Copy to Clipboard Toggle word wrap
新しい外部 (直接 LUN) ディスクを仮想マシンに追加します。この方法には、lun_storage 要素と、iSCSI または FCP デバイスの詳細情報を含む logical_unit 要素が必要です。

例15.13 仮想マシン上での新規外部 LUN ディスクデバイスの作成

POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml
		
<disk>
    <interface>virtio</interface>
    <lun_storage>
        <type>iscsi</type>
        <logical_unit id="lun1">
            <address>iscsi.example.com</address>
            <port>3260</port>
            <target>iqn.2010.05.com.example:iscsi.targetX</target>
        </logical_unit>
    </lun_storage>
</disk>
Copy to Clipboard Toggle word wrap
alias、description、storage_domains、provisioned_size、interface、bootable、shareable、wipe_after_delete、propagate_errors の要素は、作成後に更新可能です。
仮想ディスクは、1 台または複数の仮想マシンにより使用されている最中でも、仮想マシンを一時停止、休止、リブートせずにサイズの変更が可能です。

例15.14 仮想マシンディスクの更新

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <bootable>false</bootable>
    <shareable>false</shareable>
</disk>
Copy to Clipboard Toggle word wrap

例15.15 仮想マシンディスクのサイズを 20 GB に更新

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <provisioned_size>21474836480</provisioned_size>
</disk>
Copy to Clipboard Toggle word wrap

注記

上記の例のディスクサイズは、以下の計算式でバイト単位に換算します。
20480MB * 1024 2 = 21474836480 bytes

例15.16 仮想マシンディスク名の変更

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk>
    <alias>Classic_VM2</alias>
</disk>
Copy to Clipboard Toggle word wrap
仮想マシンディスクを削除するには、DELETE 要求を実行する必要があります。

例15.17 仮想マシンディスクの削除

DELETE /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/disks/ed7feafe-9aaf-458c-809a-ed789cdbd5b4 HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

15.6.1.2. ディスクのクローン作成
リンクのコピー

テンプレートからディスクのクローンを作成するには clone 要素を使用します。仮想マシンの作成時に、disks サブコレクション内の clone 要素を true に設定します。これにより、ベーステンプレートからのディスクのクローンが作成され、仮想マシンにアタッチされます。

例15.18 テンプレートからのディスクのクローン作成

次の例は、仮想マシンの作成中にテンプレートからディスクのクローンを作成します。 
POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
Accept: application/xml
Content-type: application/xml
        
<vm>
    <name>cloned_vm</name>
    <template id="64d4aa08-58c6-4de2-abc4-89f19003b886"/>
    <cluster id="99408929-82cf-4dc7-a532-9d998063fa95"/>
    <disks>
        <clone>true</clone>
        <disk id="4825ffda-a997-4e96-ae27-5503f1851d1b">
            <format>COW</format>
        </disk>
        <disk id="42aef10d-3dd5-4704-aa73-56a023c1464c">
            <format>COW</format>
        </disk>
    </disks>
</vm>
Copy to Clipboard Toggle word wrap

重要

ディスク名に基づいた仮想マシンの検索クエリーには、name ではなく alias 検索パラメーターが必要です。

15.6.1.3. ディスク統計のサブコレクション
リンクのコピー

各仮想マシンのディスクでは、ディスク固有の統計の statistics サブコレクションを公開します。各 statistics には次のような要素が含まれます。
Expand
表15.3 仮想マシンディスク統計の要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
disk id=リレーションシップ格納している disk リソースとのリレーションシップ
次の表には、仮想マシンディスクの統計タイプをまとめています。
Expand
表15.4 仮想マシンのディスク統計タイプ
名前
説明
data.current.read
ディスク読み込み時のデータ転送速度 (バイト/秒)
data.current.write
ディスク書き込み時のデータ転送速度 (バイト/秒)

例15.19 仮想マシンの統計サブコレクションの XML 表現

<statistics>
    <statistic id="33b9212b-f9cb-3fd0-b364-248fb61e1272"
      href="/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/disks/
      f28ec14c-fc85-43e1-818d-96b49d50e27b/statistics/
      33b9212b-f9cb-3fd0-b364-248fb61e1272">
        <name>data.current.read</name>
        <description>Read data rate</description>
        <values type="DECIMAL">
            <value>
                <datum>0</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES_PER_SECOND</unit>
        <disk id="f28ec14c-fc85-43e1-818d-96b49d50e27b" 
          href="/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/
          disks/f28ec14c-fc85-43e1-818d-96b49d50e27b"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

上記の statistics サブコレクションは読み取り専用です。

15.6.1.4. フローティングディスクのアタッチおよびデタッチのアクション
リンクのコピー

メイン rel="disks" コレクションからディスクをアタッチするには、仮想マシンの disks サブコレクションに対して POST 要求を実行します。その際には、アタッチするディスクの id を指定してください。

例15.20 フローティングディスクのアタッチ

POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks HTTP/1.1
Accept: application/xml
Content-type: application/xml

<disk id="d135f1c5-b5e1-4238-9381-b3277f5a3742">
</disk>
Copy to Clipboard Toggle word wrap
仮想マシンの disks サブコレクションからディスクをデタッチするには、ディスクリソースに対して DELETE 要求を実行します。その際には、ディスクが破棄されないように、必ず detach のブール要素を追加してください。

例15.21 仮想マシンからのディスクのデタッチ

DELETE /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/
  d135f1c5-b5e1-4238-9381-b3277f5a3742 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action>
    <detach>true</detach>
</action>
Copy to Clipboard Toggle word wrap

15.6.1.5. ディスクのアクティブ化および非アクティブ化のアクション
リンクのコピー

各仮想マシンのディスクは、仮想マシンにディスクを追加/削除するための activate および deactivate アクションセットを提供します。

例15.22 仮想マシンディスクをアクティブ化するアクション

POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/a42ada0e-1d69-410d-a392-a6980d873e5d/activate HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action/>
Copy to Clipboard Toggle word wrap

例15.23 仮想マシンディスクを非アクティブ化するアクション

POST /api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/disks/a42ada0e-1d69-410d-a392-a6980d873e5d/deactivate HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action/>
Copy to Clipboard Toggle word wrap
これらのアクションを使用して、ディスクを仮想マシンにホットプラグし、新たにアタッチしたフローティングディスクをアクティブ化します。

重要

ホットプラグ機能は、VirtIO ディスクならびにホットプラグ操作対応の仮想マシンオペレーティングシステムのみをサポートしています。これには、以下のようなオペレーティングシステムが含まれます。
  • Red Hat Enterprise Linux 6
  • Red Hat Enterprise Linux 5
  • Windows Server 2008
  • Windows Server 2003

15.6.2. ネットワークインターフェースのサブコレクション
リンクのコピー

15.6.2.1. ネットワークインターフェースのサブコレクション
リンクのコピー

nics サブコレクションは、仮想マシン上のすべてのネットワークインターフェースデバイスを表します。nics 表現には次の要素が含まれます。
Expand
表15.5 仮想マシンのネットワークインターフェースの要素
要素タイプ説明プロパティー
link rel="statistics"リレーションシップ仮想マシンのネットワークインターフェース統計の statistics サブコレクションへのリンク
network id=GUIDインターフェースを接続すべきネットワークへの参照。ネットワーク ID は空白にすることが可能。
interface列挙型ネットワークインターフェースカードに使用するドライバーのタイプ。列挙値の一覧は capabilities にあります。 
mac address=文字列インターフェースの MAC アドレス
port_mirroring複合型NIC がミラーリングされたトラフィックを受信するかどうかを定義します。network id= 参照を使用して networks 要素を定義します。
pluggedブール値NIC が仮想マシンに結線されるかどうかを定義します。
linkedブール値NIC が仮想マシンにリンクされるかどうかを定義します。

例15.24 ネットワークインターフェースの XML 表現

<nic id="7a3cff5e-3cc4-47c2-8388-9adf16341f5e" 
  ref="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
  7a3cff5e-3cc4-47c2-8388-9adf16341f5e">
    <link rel="statistics"
      href="/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/nics/
      7a3cff5e-3cc4-47c2-8388-9adf16341f5e/statistics"/>   
    <name>nic1</name>
    <interface>virtio</interface>
    <mac address="00:1a:4a:16:84:07"/>
    <network id="00000000-0000-0000-0000-000000000009"
      href="/api/networks/00000000-0000-0000-0000-000000000009"/>
    <vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
      href="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
    <port_mirroring>
        <networks>
            <network id="56087282-d7a6-11e1-af44-001a4a400e0c"
              href="/api/networks/56087282-d7a6-11e1-af44-001a4a400e0c"/>
        </networks>
    </port_mirroring>
</nic>
Copy to Clipboard Toggle word wrap
新規のネットワークインタフェースを追加する際には、name および network の要素が必要です。network 要素は id 属性または name 要素で特定します。

例15.25 仮想マシン NIC の作成

POST /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics HTTP/1.1
Accept: application/xml
Content-type: application/xml

<nic>
    <name>nic1</name>
    <network id="00000000-0000-0000-0000-000000000009"/>
</nic>
Copy to Clipboard Toggle word wrap
ネットワークインターフェースを変更するには、PUT 要求を使用します。

例15.26 仮想マシン NIC の更新

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1
Accept: application/xml
Content-type: application/xml

<nic>
    <name>nic2</name>
    <network id="00000000-0000-0000-0000-000000000010"/>
    <type>e1000</type>
</nic>
Copy to Clipboard Toggle word wrap
ネットワークインターフェースの削除は DELETE 要求で行います。

例15.27 仮想マシン NIC の削除

DELETE /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

重要

ホットプラグ機能は、ホットプラグ操作対応の仮想マシンオペレーティングシステムのみをサポートしています。これには、以下のようなオペレーティングシステムが含まれます。
  • Red Hat Enterprise Linux 6
  • Red Hat Enterprise Linux 5
  • Windows Server 2008
  • Windows Server 2003

15.6.2.2. ネットワークインターフェース統計のサブコレクション
リンクのコピー

各仮想マシンのネットワークインターフェースは、ネットワークインターフェースの統計の statistics サブコレクションを公開します。各 statistic には、次の要素が含まれます。
Expand
表15.6 仮想マシンのネットワークインターフェース統計の要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
nic id=リレーションシップ格納している nic リソースとのリレーションシップ
以下の表には、仮想マシン上のネットワークインターフェースの統計タイプをまとめています。
Expand
表15.7 仮想マシンの NIC の統計タイプ
名前
説明
data.current.rx
データの受信速度 (ビット毎秒)
data.current.tx
データの送信速度 (ビット毎秒)
errors.total.rx
データ受信でのエラーの合計数
errors.total.tx
データ送信でのエラーの合計数

例15.28 仮想マシンの NIC 統計サブコレクションの XML 表現

<statistics>
    <statistic id="ecd0559f-e88f-3330-94b4-1f091b0ffdf7"
      href="/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/nics/
      6cd08e76-57c0-41ba-a728-7eba46ae1e36/statistics/
      ecd0559f-e88f-3330-94b4-1f091b0ffdf7">
        <name>data.current.rx</name>
        <description>Receive data rate</description>
        <values type="DECIMAL">
            <value>
                <datum>0</datum>
            </value>
        </values>
        <type>GAUGE</type>
        <unit>BYTES_PER_SECOND</unit>
        <nic id="6cd08e76-57c0-41ba-a728-7eba46ae1e36"
          href="/api/vms/3a42530e-3bc5-4094-829d-489257894c2a/
          nics/6cd08e76-57c0-41ba-a728-7eba46ae1e36"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

上記の statistics サブコレクションは読み取り専用です。

15.6.3. 仮想 NUMA ノードのサブコレクション
リンクのコピー

numanodes サブコレクションは、仮想マシン上の全仮想 NUMA ノードを表します。vm_numa_node 表現には次のような要素が含まれます。
Expand
表15.8 仮想 NUMA ノードの要素
要素タイプ説明プロパティー
index整数仮想 NUMA ノードの指数
memory整数仮想 NUMA ノードに割り当てられたメモリーの容量 (MB 単位)
cpu複合型この仮想 NUMA ノードに割り当てられた CPU トポロジー。各 core の要素には、コアの指数が割り当てられた index 属性が含まれます。
vm id=GUID格納している仮想マシンの ID
numa_node_pins複合型仮想 NUMA ノードをホストの NUMA ノードに固定します。各 numa_node_pin 要素には、pinned="true" ブール値とホストの NUMA ノードの index 数が含まれます。 

例15.29 仮想 NUMA ノードの XML 表現

<vm_numa_node href="/api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes/3290b973-ed3e-4f0b-bbf5-9be10d229e50" id="3290b973-ed3e-4f0b-bbf5-9be10d229e50">
        <index>0</index>
        <memory>1024</memory>
        <cpu>
            <cores>
                <core index="0"/>
            </cores>
        </cpu>
        <vm href="/api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b" id="c7ecd2dc-dbd3-4419-956f-1249651c0f2b"/>
        <numa_node_pins>
            <numa_node_pin pinned="true" index="0">
                <host_numa_node id="417cdefb-8c47-4838-87f3-dd0498fdf6c7"/>
            </numa_node_pin>
        </numa_node_pins>
</vm_numa_node>
Copy to Clipboard Toggle word wrap
新規仮想 NUMA ノードを追加する場合は、index、memory、cpu の要素が必要です。

例15.30 新規 NUMA ノードの仮想マシンへの追加

POST /api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes HTTP/1.1
Accept: application/xml
Content-type: application/xml

<vm_numa_node>
  <index>0</index>
  <memory>1024</memory>
  <cpu>
    <cores>
      <core index="0"/>
    </cores>
  </cpu>
</vm_numa_nodes>
Copy to Clipboard Toggle word wrap
仮想 NUMA ノードは PUT 要求で更新します。PUT 要求を使用して、仮想 NUMA ノードをホスト上の物理 NUMA ノードに固定することができます。

例15.31 仮想 NUMA ノードの更新

PUT /api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes/3290b973-ed3e-4f0b-bbf5-9be10d229e50 HTTP/1.1
Accept: application/xml
Content-type: application/xml

<vm_numa_node>
  <numa_node_pins>
    <numa_node_pin pinned="true" index="0">
      <host_numa_node id="417cdefb-8c47-4838-87f3-dd0498fdf6c7"/>
    </numa_node_pin>
  </numa_node_pins>
</vm_numa_node>
Copy to Clipboard Toggle word wrap
DELETE 要求で仮想 NUMA ノードを削除します。

例15.32 仮想 NUMA ノードの削除

DELETE /api/vms/c7ecd2dc-dbd3-4419-956f-1249651c0f2b/numanodes/3290b973-ed3e-4f0b-bbf5-9be10d229e50 HTTP/1.1

HTTP/1.1 204 No Content
Copy to Clipboard Toggle word wrap

15.6.4. CD-ROM のサブコレクション
リンクのコピー

cdroms サブコレクションは、仮想マシン上の CD-ROM デバイスを表します。cdrom 表現には次のエレメントが含まれます。
Expand
表15.9 仮想マシンの CD-ROM の要素
要素タイプ説明プロパティー
file id=文字列/ファイル名ISO イメージへの参照 

例15.33 CD-ROM デバイスの XML 表現

<cdrom id="00000000-0000-0000-0000-000000000000"
  href="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/
  00000000-0000-0000-0000-000000000000">
    <file id="rhel-server-6.0-x86_64-dvd.iso"/>
    <vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
      href="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
</cdrom>
Copy to Clipboard Toggle word wrap
新しい CD-ROM リソースを追加するには、PUT 要求を file id 要素とともに送信します。

例15.34 新規 CD-ROM ファイルの追加

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
      
<cdrom>
    <file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
Copy to Clipboard Toggle word wrap
API は、PUT 要求を使用して CD-ROM を変更します。

例15.35 CD-ROM ファイルの変更

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
      
<cdrom>
    <file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
Copy to Clipboard Toggle word wrap
PUT 要求に current URI 引数を追加して使用すると、API は現行セッションの CD-ROM を変更します。

例15.36 現行セッション中の CD-ROM ファイル変更

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000;current=true HTTP/1.1
Accept: application/xml
Content-type: application/xml
      
<cdrom>
    <file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>
Copy to Clipboard Toggle word wrap
一時的に CD-ROM を取り出すには 仮想マシンの cdroms サブコレクションに PUT 要求を送信して、current=true マトリックスパラメーターを追加します。

例15.37 現行セッション中の CD-ROM ファイルの取り出し

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000;current=true HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
  <file id=""/>
</cdrom>
Copy to Clipboard Toggle word wrap

注記

仮想マシンをリブートすると、再度 CD-ROM が接続されます。
CD-ROM を完全に取り出すには 仮想マシンの cdroms サブコレクションに PUT 要求を送信します。

例15.38 CD-ROM ファイルの完全取り出し

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
<cdrom>
  <file id=""/>
</cdrom>
Copy to Clipboard Toggle word wrap

注記

1 台の仮想マシンに含まれる CD-ROM デバイスは 1 つのみです。

15.6.5. スナップショットのサブコレクション
リンクのコピー

15.6.5.1. スナップショットのサブコレクション
リンクのコピー

仮想マシンは、ディスクの状態を複数のスナップショットとして保存/復元します。これらのスナップショットは、rel="snapshot" サブコレクションで表現/管理されます。このサブコレクションは、他のコレクションと同様に動作します。
各仮想マシンスナップショットは、以下のサブ要素を含む各 snapshot 要素で表されます。
Expand
表15.10 仮想マシンのスナップショットの要素
要素タイプ説明プロパティー
vm id=GUIDそのスナップショットの作成元である仮想マシンの ID と URI
link rel="restore"リレーションシップその仮想マシンのスナップショットを復元するためののリンク
link rel="prev"リレーションシップその仮想マシンの前のスナップショットへのリンク
type文字列active または regular などのスナップショットの種類
datexsd:dateTime の形式: YYYY-MM-DDThh:mm:ssそのスナップショットが作成された日付と時刻
snapshot_status文字列スナップショットの現在のステータス
persist_memorystateブール値スナップショットを作成する際の仮想マシンメモリーのステータスをスナップショットに含めるかどうかを定義します。

注記

スナップショットの要素の変更には PUT を使用できません。

例15.39 仮想マシンのスナップショットの XML 表現

<snapshot id="00000000-0000-0000-0000-000000000000"
  href="/api/vms/00000000-0000-0000-0000-000000000000/snapshots/
  00000000-0000-0000-0000-000000000000">
    <actions>
      <link rel="restore"
      href="/api/vms/00000000-0000-0000-0000-000000000000/snapshots/
      00000000-0000-0000-0000-000000000000/restore"/>
    <link rel="prev"
      href="/api/vms/00000000-0000-0000-0000-000000000000/snapshots/
    </actions>
    <vm id="00000000-0000-0000-0000-000000000000"
      href="/api/vms/00000000-0000-0000-0000-000000000000"/>
    <description>Virtual Machine 1 - Snapshot A</description>
    <type>active</type>
    <date>2010-08-16T14:24:29</date>
    <snapshot_status>ok</snapshot_status>
    <persist_memorystate>false</persist_memorystate>
</snapshot>
Copy to Clipboard Toggle word wrap
仮想マシンスナップショットの GET 要求で All-Content: true ヘッダーを使用して、スナップショットの表現に追加の OVF データを含めます。
Accept ヘッダーを空欄にした場合には、デフォルトで application/xml となり、XML タグに影響しないようにデータは HTML エンティティーで表現されます。Accept: application/json ヘッダーを指定すると、データは標準の XML タグで返されます。以下の表現の例は、標準のブロックフォーマットを編集して、より読みやすい書式で示しています。

例15.40 スナップショットの追加の OVF データの XML 表現

GET /api/vms/42ec2621-7ad6-4ca2-bd68-973a44b2562e/snapshots HTTP/1.1
All-Content: true
	
<?xml version='1.0' encoding='UTF-8'?>
<ovf:Envelope xmlns:ovf=\"http://schemas.dmtf.org/ovf/envelope/1/\" 
  xmlns:rasd=\"http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData\" 
  xmlns:vssd=\"http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData\" 
  xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" ovf:version=\"3.5.0.0\"> 
  <References>
  <File ovf:href=\"ad353554-f668-46cf-aa3c-e57383de2c92/40456d92-3687-4a85-bab3-87b4cc7af459\" 
    ovf:id=\"40456d92-3687-4a85-bab3-87b4cc7af459\" ovf:size=\"10737418240\" 
    ovf:description=\"Active VM\"/>
  <Nic ovf:id=\"be14bfc8-3dbd-4ac1-ba02-c6dfa7fc707c\"/>
  </References>
  <Section xsi:type=\"ovf:NetworkSection_Type\"> 
    <Info>List of networks</Info><Network ovf:name=\"Network 1\"/>
  </Section>
  <Section 
    xsi:type=\"ovf:DiskSection_Type\"> 
    <Info>List of Virtual Disks</Info>
    <Disk ovf:diskId=\"40456d92-3687-4a85-bab3-87b4cc7af459\" 
    ovf:size=\"10\" ovf:actual_size=\"0\" 
    ovf:vm_snapshot_id=\"a209216d-2909-4802-8886-02aad55dccc8\" 
    ovf:parentRef=\"\" 
    ovf:fileRef=\"ad353554-f668-46cf-aa3c-e57383de2c92/40456d92-3687-4a85-bab3-87b4cc7af459\" 
    ovf:format=\"http://www.vmware.com/specifications/vmdk.html#sparse\" 
    ovf:volume-format=\"RAW\" 
    ovf:volume-type=\"Preallocated\" 
    ovf:disk-interface=\"VirtIO\" 
    ovf:boot=\"true\" 
    ovf:disk-alias=\"VM_01_Disk1\" 
    ovf:wipe-after-delete=\"false\"/>
  </Section>
  <Content 
    ovf:id=\"out\" 
    xsi:type=\"ovf:VirtualSystem_Type\"> 
    <CreationDate>2015/02/09 13:53:53</CreationDate> 
    <ExportDate>2015/02/10 00:39:24</ExportDate> 
    <DeleteProtected>false</DeleteProtected> 
    <SsoMethod>guest_agent</SsoMethod> 
    <IsSmartcardEnabled>false</IsSmartcardEnabled> 
    <TimeZone>Etc/GMT</TimeZone><default_boot_sequence>0</default_boot_sequence> 
    <Generation>1</Generation> 
    <VmType>1</VmType> 
    <MinAllocatedMem>1024</MinAllocatedMem> 
    <IsStateless>false</IsStateless> 
    <IsRunAndPause>false</IsRunAndPause> 
    <AutoStartup>false</AutoStartup> 
    <Priority>1</Priority> 
    <CreatedByUserId>fdfc627c-d875-11e0-90f0-83df133b58cc</CreatedByUserId> 
    <IsBootMenuEnabled>false</IsBootMenuEnabled> 
    <IsSpiceFileTransferEnabled>true</IsSpiceFileTransferEnabled> 
    <IsSpiceCopyPasteEnabled>true</IsSpiceCopyPasteEnabled> 
    <Name>VM_01</Name> 
    <TemplateId>00000000-0000-0000-0000-000000000000</TemplateId> 
    <TemplateName>Blank</TemplateName> 
    <IsInitilized>true</IsInitilized> 
    <Origin>3</Origin> 
    <DefaultDisplayType>1</DefaultDisplayType> 
    <TrustedService>false</TrustedService> 
    <OriginalTemplateId>00000000-0000-0000-0000-000000000000</OriginalTemplateId> 
    <OriginalTemplateName>Blank</OriginalTemplateName> 
    <UseLatestVersion>false</UseLatestVersion>
    <Section ovf:id=\"42ec2621-7ad6-4ca2-bd68-973a44b2562e\" ovf:required=\"false\" xsi:type=\"ovf:OperatingSystemSection_Type\"> 
      <Info>Guest Operating System</Info> 
      <Description>other</Description>
    </Section>
    <Section xsi:type=\"ovf:VirtualHardwareSection_Type\"> 
      <Info>1 CPU, 1024 Memeory</Info> 
      <System>
        <vssd:VirtualSystemType>ENGINE 3.5.0.0</vssd:VirtualSystemType>
      </System> 
      <Item> 
        <rasd:Caption>1 virtual cpu</rasd:Caption> 
        <rasd:Description>Number of virtual CPU</rasd:Description> 
        <rasd:InstanceId>1</rasd:InstanceId> 
        <rasd:ResourceType>3</rasd:ResourceType> 
        <rasd:num_of_sockets>1</rasd:num_of_sockets> 
        <rasd:cpu_per_socket>1</rasd:cpu_per_socket>
      </Item> 
      <Item> 
        <rasd:Caption>1024 MB of memory</rasd:Caption> 
        <rasd:Description>Memory Size</rasd:Description> 
        <rasd:InstanceId>2</rasd:InstanceId> 
        <rasd:ResourceType>4</rasd:ResourceType> 
        <rasd:AllocationUnits>MegaBytes</rasd:AllocationUnits> 
        <rasd:VirtualQuantity>1024</rasd:VirtualQuantity>
      </Item> 
      <Item> 
        <rasd:Caption>VM_01_Disk1</rasd:Caption> 
        <rasd:InstanceId>40456d92-3687-4a85-bab3-87b4cc7af459</rasd:InstanceId> 
        <rasd:ResourceType>17</rasd:ResourceType> 
        <rasd:HostResource>ad353554-f668-46cf-aa3c-e57383de2c92/40456d92-3687-4a85-bab3-87b4cc7af459</rasd:HostResource> 
        <rasd:Parent>00000000-0000-0000-0000-000000000000</rasd:Parent> 
        <rasd:Template>00000000-0000-0000-0000-000000000000</rasd:Template> 
        <rasd:ApplicationList></rasd:ApplicationList> 
        <rasd:StoragePoolId>00000002-0002-0002-0002-000000000255</rasd:StoragePoolId> 
        <rasd:CreationDate>2015/02/09 13:54:41</rasd:CreationDate> 
        <rasd:LastModified>1970/01/01 00:00:00</rasd:LastModified> 
        <rasd:last_modified_date>2015/02/10 00:39:22</rasd:last_modified_date> 
        <Type>disk</Type> 
        <Device>disk</Device> 
        <rasd:Address>{slot=0x06, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>1</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>virtio-disk0</Alias>
      </Item> 
      <Item> 
        <rasd:Caption>Ethernet adapter on ovirtmgmt</rasd:Caption> 
        <rasd:InstanceId>be14bfc8-3dbd-4ac1-ba02-c6dfa7fc707c</rasd:InstanceId> 
        <rasd:ResourceType>10</rasd:ResourceType> 
        <rasd:OtherResourceType>ovirtmgmt</rasd:OtherResourceType> 
        <rasd:ResourceSubType>3</rasd:ResourceSubType> 
        <rasd:Connection>ovirtmgmt</rasd:Connection> 
        <rasd:Linked>true</rasd:Linked> 
        <rasd:Name>nic1</rasd:Name> 
        <rasd:MACAddress>00:1a:4a:87:cb:00</rasd:MACAddress> 
        <rasd:speed>1000</rasd:speed> 
        <Type>interface</Type> 
        <Device>bridge</Device> 
        <rasd:Address>{slot=0x03, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>net0</Alias>
      </Item> 
      <Item> 
        <rasd:Caption>USB Controller</rasd:Caption> 
        <rasd:InstanceId>3</rasd:InstanceId> 
        <rasd:ResourceType>23</rasd:ResourceType> 
        <rasd:UsbPolicy>DISABLED</rasd:UsbPolicy>
      </Item> 
      <Item> 
        <rasd:Caption>Graphical Controller</rasd:Caption> 
        <rasd:InstanceId>17bbf0db-7cf0-4529-9b53-dee6dee41cfd</rasd:InstanceId> 
        <rasd:ResourceType>20</rasd:ResourceType> 
        <rasd:VirtualQuantity>1</rasd:VirtualQuantity> 
        <rasd:SinglePciQxl>false</rasd:SinglePciQxl> 
        <Type>video</Type> 
        <Device>qxl</Device> 
        <rasd:Address>{slot=0x02, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>true</IsReadOnly> 
        <Alias>video0</Alias> 
        <SpecParams>  
          <vram>32768</vram> 
          <heads>1</heads>
        </SpecParams>
      </Item> 
      <Item> 
        <rasd:Caption>CDROM</rasd:Caption> 
        <rasd:InstanceId>7ce1bd14-d98a-43ba-beee-520bdfd9c698</rasd:InstanceId> 
        <rasd:ResourceType>15</rasd:ResourceType> 
        <Type>disk</Type> 
        <Device>cdrom</Device> 
        <rasd:Address>{bus=1, controller=0, type=drive, target=0, unit=0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>true</IsReadOnly> 
        <Alias>ide0-1-0</Alias></Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>8758c42f-7523-461b-82bb-41d91e46fd36</rasd:InstanceId> 
        <Type>controller</Type> 
        <Device>usb</Device> 
        <rasd:Address>{slot=0x01, bus=0x00, domain=0x0000, type=pci, function=0x2}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>usb0</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>58f1a596-553e-4e95-9331-64b5d8cebe2e</rasd:InstanceId> 
        <Type>controller</Type> 
        <Device>ide</Device> 
        <rasd:Address>{slot=0x01, bus=0x00, domain=0x0000, type=pci, function=0x1}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>ide0</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>2f4f8aa5-25eb-4a31-b841-50dc48fce4a7</rasd:InstanceId> 
        <Type>channel</Type> 
        <Device>unix</Device> 
        <rasd:Address>{bus=0, controller=0, type=virtio-serial, port=1}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>channel0</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>edaac3ed-2ab6-48b1-ae77-cc98f8b45bd8</rasd:InstanceId> 
        <Type>channel</Type> 
        <Device>unix</Device> 
        <rasd:Address>{bus=0, controller=0, type=virtio-serial, port=2}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>channel1</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>8dfed248-5164-41d3-8b6e-46aef9798d84</rasd:InstanceId> 
        <Type>channel</Type> 
        <Device>spicevmc</Device> 
        <rasd:Address>{bus=0, controller=0, type=virtio-serial, port=3}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>channel2</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>d184185e-ee19-442a-88f5-6a48f14164e1</rasd:InstanceId> 
        <Type>controller</Type> 
        <Device>virtio-scsi</Device> 
        <rasd:Address>{slot=0x04, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>scsi0</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>374d219e-e2ff-4755-a544-d537c87e82df</rasd:InstanceId> 
        <Type>controller</Type> 
        <Device>virtio-serial</Device> 
        <rasd:Address>{slot=0x05, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>false</IsReadOnly> 
        <Alias>virtio-serial0</Alias>
      </Item> 
      <Item> 
        <rasd:ResourceType>0</rasd:ResourceType> 
        <rasd:InstanceId>cf3d7121-9db0-4fd1-bd12-50ce4e1ce379</rasd:InstanceId> 
        <Type>balloon</Type> 
        <Device>memballoon</Device> 
        <rasd:Address>{slot=0x07, bus=0x00, domain=0x0000, type=pci, function=0x0}</rasd:Address> 
        <BootOrder>0</BootOrder> 
        <IsPlugged>true</IsPlugged> 
        <IsReadOnly>true</IsReadOnly> 
        <Alias>balloon0</Alias> 
        <SpecParams> 
          <model>virtio</model>
        </SpecParams>
      </Item>
    </Section>
  </Content>
</ovf:Envelope>
Copy to Clipboard Toggle word wrap
POST メソッドを使用して実行中の仮想マシンのスナップショットを作成したり (ライブスナップショット)、シャットダウンしたりできます。

例15.41 仮想マシンのスナップショットの作成

POST /api/vms/00000000-0000-0000-0000-000000000000/snapshots/ HTTP/1.1
Accept: application/xml
Content-type: application/xml

<snapshot>
<description>Snapshot description</description>
</snapshot>
Copy to Clipboard Toggle word wrap

重要

OpenStack Volume (Cinder) ディスクを使用する仮想マシンのライブスナップショットを作成する前に、ゲストのファイルシステムを手動でフリーズして解凍する必要があります。詳しい情報は「仮想マシンのファイルシステムのフリーズアクション」と「仮想マシンのファイルシステムアクション」を参照してください。
スナップショット表現内の rel="restore" アクションリンクを使用して、仮想マシンのスナップショットを復元することができます。

例15.42 仮想マシンのスナップショットの復元

POST /api/vms/00000000-0000-0000-0000-000000000000/snapshots/00000000-0000-0000-0000-000000000000/restore HTTP/1.1
Accept: application/xml
Content-type: application/xml

<action/>
Copy to Clipboard Toggle word wrap

15.6.5.2. スナップショットから仮想マシンのクローンを作成します。
リンクのコピー

API は、以前のマシンのスナップショットから仮想マシンを作成する機能を提供します。API ユーザーは、すべてのスナップショットで元の仮想マシンをそのまま保持しつつ、新しい仮想マシンを作成することができます。
スナップショットから仮想マシンを作成するには、仮想マシンの標準的な表現に snapshots 要素を追加する必要があります。ユーザーはこの要素を POST 要求で vms コレクションに送信します。
snapshots 要素には、仮想マシンのベースとして使用する特定のスナップショットを定義する snapshot id= 要素が含まれます。

例15.43 スナップショットからの仮想マシンのクローン作成

POST /api/vms HTTP/1.1
Accept: application/xml
Content-type: application/xml

<vm>
  ...
  <snapshots>
    <snapshot id="3f68ee63-0016-4f8c-9b8a-11d9f28f7c9e"/>
  </snapshots>
  ...
</vm>
Copy to Clipboard Toggle word wrap

15.6.6. 統計のサブコレクション
リンクのコピー

各仮想マシンのリソースは、仮想マシン固有の統計の statistics サブコレクションを公開します。各 statistic には次の要素が含まれます。
Expand
表15.11 仮想マシン統計の要素
要素タイプ説明
name文字列統計エントリーの一意識別子
description文字列プレーンテキストで記述された統計の説明
unit文字列統計値測定の単位またはレート
typeGAUGE または COUNTER統計測定値のタイプ
values type=INTEGER または DECIMALその後に続く統計値のデータタイプ
value複合型datum を含むデータセット
datumvalues type を参照value に含まれるデータの 1 つ
vm id=リレーションシップ格納している vm リソースとのリレーションシップ
以下の表には、仮想マシンの統計タイプをまとめています。
Expand
表15.12 仮想マシンの統計タイプ
名前
説明
memory.installed
仮想マシンが使用するために割り当てられたメモリー合計 (バイト単位)
memory.used
仮想マシンが現在使用中のメモリー (バイト単位)
cpu.current.guest
ゲストの CPU 使用率
cpu.current.hypervisor
Hypervisor 上の CPU オーバーヘッド (%)
cpu.current.total
現在の CPU 使用率合計

例15.44 仮想マシンの統計サブコレクションの XML 表現

<statistics>
    <statistic id="ef802239-b74a-329f-9955-be8fea6b50a4"
      href="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/
      statistics/ef802239-b74a-329f-9955-be8fea6b50a4">
        <name>memory.installed</name>
        <description>Total memory configured</description>
        <unit>BYTES</unit>
        <type>GUAGE</type>
        <values type="DECIMAL">
            <value>
                <datum>1073741824<datum>
            </value>
        </values>
        <vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
          href="/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
    </statistic>
    ...
</statistics>
Copy to Clipboard Toggle word wrap

注記

仮想マシンの statistics サブコレクションは読み取り専用です。

15.6.7. 仮想マシンのセッション情報の表示
リンクのコピー

仮想マシンに GET 要求を送信し、session サブコレクションを使用して、SPICE コンソールセッションを開始したユーザーと、仮想マシンにログインしたユーザーのセッション情報を表示します。
仮想マシンの session の情報は、サブコレクションとして表示されます。

例15.45 仮想マシンのセッション情報の表示

GET /api/roles/a1a701f1-aa06-4f02-af17-158be31489b3/sessions HTTP/1.1
Accept: application/xml

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

<sessions>
  <session id="37a6259c-c0c1-dae2-99a7-866489dff0bd"
    href= "/api/vms/a1a701f1-aa06-4f02-af17-158be31489b3/sessions/37a6259c-c0c1-dae2-99a7-866489dff0bd">
  <vm href= "/api/vms/a1a701f1-aa06-4f02-af17-158be31489b3" id="a1a701f1-aa06-4f02-af17-158be31489b3"/>
  <ip address="192.0.2.0"/>
  <user href= "/api/users/fdfc627c-d875-11e0-90f0-83df133b58cc" id="fdfc627c-d875-11e0-90f0-83df133b58cc">
    <domain href= "/api/domains/696e7465-726e-616c-696e-7465726e616c" id="696e7465-726e-616c-696e-7465726e616c">
      <name>internal</name>
    </domain>
    <user_name>admin</user_name>
    </user>
    <console_user>true</console_user>
  </session>
  <session id="37a6259c-c0c1-dae2-99a7-866489dff0bd"
    href= "/api/vms/a1a701f1-aa06-4f02-af17-158be31489b3/sessions/37a6259c-c0c1-dae2-99a7-866489dff0bd" >
    <vm href= "/api/vms/a1a701f1-aa06-4f02-af17-158be31489b3" id="a1a701f1-aa06-4f02-af17-158be31489b3"/>
    <user>
      <user_name>root</user_name>
    </user>
  </session>
</sessions>
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat