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

2.3.3. Get

get メソッドは、単一のオブジェクトの表現を取得します。

次の例では、識別子が 123 の仮想マシンの表現を見つけて取得します。 

# Find the service that manages the virtual machine:
vms_service = system_service.vms_service
vm_service = vms_service.vm_service('123')

# Retrieve the representation of the virtual machine:
vm = vm_service.get
Copy to Clipboard Toggle word wrap

結果は、対応するタイプのインスタンスになります。この場合、結果は Ruby クラス Vm のインスタンスになります。

一部のサービスの get メソッドは、オブジェクトの表現を取得する方法や、複数の表現がある場合にどの表現を取得するかを制御する追加のパラメーターをサポートします。

たとえば、起動後に仮想マシンの将来の状態を取得したい場合があります。仮想マシンを管理するサービスの get メソッドは、next_run ブール値パラメーターをサポートします。

仮想マシンの next_run 状態の取得

# Retrieve the representation of the virtual machine; not the
# current one, but the one that will be used after the next
# boot:
vm = vm_service.get(next_run: true)
Copy to Clipboard Toggle word wrap

詳細については、ソフトウェア開発キットの リファレンス ドキュメントを参照してください。

オブジェクトを取得できない場合、ソフトウェア開発キットはエラーの詳細を含む エラー 例外を発生させます。これは、存在しないオブジェクトを取得しようとした場合に発生します。

注記

service locator メソッドはサーバーにリクエストを送信しないため、オブジェクトが存在しない場合でも、service locator メソッドの呼び出しが失敗することはありません。

次の例では、service locator メソッドは成功しますが、get メソッドは例外を発生させます。

存在しない仮想マシンのサービスの検索: エラーなし

# Find the service that manages a virtual machine that does
# not exist. This will succeed.
vm_service = vms_service.vm_service('non_existent_VM')
Copy to Clipboard Toggle word wrap

存在しない仮想マシンサービスの取得: エラー

# Retrieve the virtual machine. This will raise an exception.
vm = vm_service.get
Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat