この章では、REST APIで操作するリソースの表現について説明します。内容は次のとおりです。
このバージョンのクラウド・リソース・モデルはCloud Service PortalプラグインのXaaS実装を結集させたものであり、追加のサービス・タイプを使用してサービス・インスタンスの作成およびライフサイクル管理をサポートできます。
Enterprise Manager Cloud ControlのCloud Service Portalプラグインのこのリリースでは、クライアントが/em/cloudにアクセスする場合、10001がデフォルト・バージョンです。特に、クライアントはHTTPヘッダーでx-specification-version: 10001を指定して、リソースでバージョン10001がサポートされるかどうかを確認できます。1つのリクエストに異なるバージョンのリソース・タイプを混在させることはできないことに注意してください。たとえば、コンテンツがリソースの10000バージョンの形をしている場合、10001はリクエストを拒否することがあります。
次の表で、最上位レベルのリソースについて説明します。
表46-1 最上位レベルのリソースの説明
リソース | 説明 |
---|---|
application/oracle.com.cloud.common |
このメディア・タイプ・ネームスペースには、XaaS実装のリソース・タイプに固有でない共通リソースが含まれます。XaaS実装では通常、accept/content-typeがベース・タイプのリクエストに応答することで、共通リソース・タイプを拡張します。これは、いつでもベース・クラスを実装クラスにタイプキャストできるJavaのクラスの型付けと似ています。 |
Cloud |
これは、クライアントがクラウド全体の上位レベル・ビューを取得できる、エントリ・ポイント/em/cloudの最上位レベルのメディア・タイプです。 |
ServiceTemplate |
これは、各XaaSがサービス・インスタンスを作成するために拡張できるサービス・テンプレートを表す、共通メディア・タイプです。 |
ServiceInstance |
サービス・インスタンスを表す、共通メディア・タイプです。各XaaSはこのメディア・タイプを拡張して、サポートするサービス・インスタンスを表します。 |
ServiceFamilyType |
XaaSまたはサービス・ファミリを表します。 |
InstanceType |
サービス・インスタンスのタイプを表します。たとえば、VMはServiceInstanceを拡張するメディア・タイプで、VMインスタンスに含まれる内容を示す対応するInstanceType?があります。 |
Metric |
リソースのメトリックを表します。たとえば、CPU使用率およびネットワーク使用率などのパフォーマンス・メトリックは、VMインスタンスのメトリックです。パフォーマンス・メトリックのみに制限する必要はありません。測定可能または監視可能な時系列データすべて、メトリックとして表すことができます。 |
MultipartMetric |
メトリックを拡張しますが、多次元の監視を表します。 |
CloudInteractions |
クラウドでサポートされる相互作用のコレクションを表します。このリソースのデータは、プロトコルに依存します。たとえば、HTTPプロトコルでは、データはサポートされているHTTPリクエストの3つのセット(requestメソッド、acceptタイプ、コンテンツ・タイプ)で構成されます。 |
QuotaUsage |
サービス・ファミリのコンテキストにおける割当て制限情報を表します。 |
クラウドのリソース表現は、それぞれに名前と値があるフィールドで構成され、JavaScript Object Notation (JSON)ディクショナリを使用してエンコードされます。値には、RFC 4627に従ったJSON形式のリスト、ディクショナリ、数値または文字列リテラルを指定できます。
各クラウド・リソース・タイプは、それぞれ独自のインターネット・メディア・タイプを持ちます。メディア・タイプはapplication/oracle.com.cloud.common.Xxxxxxxx+jsonというパターンにする必要があり、各リソース・モデル固有のメディア・タイプが対応するセクション・ヘッダーに角カッコで囲まれて含められます。
クラウドのリソースは現在、共通サービス・エンティティで編成されており、特定のサービス(Infrastructure as a Serviceなど)が共通サービス・エンティティを拡張するリソースを提供しています(該当する場合)。次の図は、共通リソースとInfrastructure as a Service固有のリソースとのリソース・モデル関係を示しています。
次の項では、様々なクラウド・リソースのデータ・モデルについて詳しく説明します。
クラウドは、アクセス可能なすべてのリソースのユーザーの開始ビューを表します。次の表では、クラウドのデータ・モデルについて説明します。
表46-2 クラウドのデータ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。 |
12.1.0.1 |
name |
文字列 |
1 |
ユーザー用の名前。様々な言語をサポートするUNICODE文字列です。 |
12.1.0.1 |
description |
文字列 |
0..1 |
簡単な説明。様々な言語をサポートするUNICODE文字列です。 |
12.1.0.1 |
service_templates |
コレクション<ServiceTemplates> |
0..1 |
ユーザーがアクセス可能なサービス・テンプレートのリスト。 |
12.1.0.4 |
service_family_types |
コレクション<ServiceFamilyType> |
0..1 |
クラウドでサポートされるサービス・ファミリ・タイプのリスト。 |
12.1.0.4 |
zones |
コレクション<ゾーン> |
0..1 |
クラウドでサポートされる、ユーザーがアクセス可能なゾーンのリスト。 |
12.1.0.2 |
resource_state |
ResourceState |
0..1 |
実行中のオンラインのクラウドの状態はREADYです。このフィールドが返されない場合、クライアントはクラウドがREADYであると想定できます。返されたフィールドの状態がREADYでない場合、クライアントはクラウドへのその後の相互作用の実行可能性を想定できません。 |
12.1.0.1 |
media_type |
文字列 |
1 |
このメディア・タイプのペイロード形式の値。例: application/oracle.com.cloud.common.Cloud+json。 |
12.1.0.4 |
ServiceTemplateは、デプロイ可能なサービスの定義を表します。ユーザーにとって、ServiceTemplateはデプロイ可能なサービスの定義を表します。ユーザーはServiceTemplateのURIと相互作用して、クラウドのリソースを作成できます。クラウドは、リソースとその構成をServiceTemplateの定義で指定されているとおりにインスタンス化する必要があります。
VMTemplateはServiceTemplateリソースのサブクラスであるため、VMTemplateのURIからServiceTemplateを取得できます。次の表に、ServiceTemplateデータ・モデルを示します。
表46-3 ServiceTemplateデータ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するServiceTemplate定義のクライアント表現がリフレッシュされます。 |
12.1.0.4 |
name |
文字列 |
1 |
ServiceTemplateのユーザー用の名前。様々な言語をサポートするUNICODE文字列です。 |
12.1.0.4 |
description |
文字列 |
0..1 |
ServiceTemplateの簡単な説明。様々な言語をサポートするUNICODE文字列です。 |
12.1.0.4 |
type |
文字列 |
1 |
サービス・テンプレートのタイプを示す文字列。 |
12.1.0.4 |
created |
Timestamp |
1 |
ServiceTemplateが作成された日付と時刻(ISO 8601形式)。 |
12.1.0.4 |
service_family_type |
文字列 |
0..1 |
このサービス・テンプレートを分類するサービス・ファミリ・タイプの名前。 |
12.1.0.4 |
default_instance_media_type |
文字列 |
0..1 |
このテンプレートを使用して作成できるサービス・インスタンスのデフォルト・メディア・タイプ。 たとえば、VMTemplateでこの属性をVMに指定して、VMTemplateをVMサービス・インスタンスにデプロイ可能なことを示します。 |
12.1.0.4 |
resource_state |
ResourceState |
1 |
READY状態のサービス・テンプレートのみデプロイできます。 |
12.1.0.4 |
deployment_params |
デプロイメント・パラメータのリスト |
0..1 |
デプロイメント・パラメータのデータ構造のリストが含まれ、このテンプレートを使用してサービス・インスタンスのデプロイ時に指定できるパラメータを示します |
12.1.0.4 |
zones |
ゾーンのリスト |
0..1 |
このサービス・テンプレートを使用してサービス・インスタンスを作成できるゾーン・リソースのリストが含まれます |
12.1.0.4 |
service_instances |
コレクション<?> |
0..1 |
このテンプレートで作成されるサービス・インスタンスのリストが含まれます。 |
12.1.0.4 |
次の表に、デプロイメント・パラメータの構造を示します。
表46-4 デプロイメント・パラメータの構造
フィールド | タイプ | 発生 | 説明 |
---|---|---|---|
name |
文字列 |
1 |
デプロイ時に指定する必要のあるパラメータの名前。 |
description |
文字列 |
0..1 |
デプロイメント・パラメータの簡単な説明。 |
type |
文字列 |
1 |
デプロイメント・パラメータのタイプ。値STRING、INTEGER、NUMBERおよびLISTの列挙です。 |
default_value |
文字列 |
0..1 |
このパラメータのデフォルト値。 |
required |
Boolean |
1 |
このパラメータが必須の場合はTRUE、そうでない場合はFALSE。 |
sensitive |
Boolean |
1 |
このパラメータがパスワードを指す場合はTRUE。そうでない場合はFALSE。 |
ゾーンは、リソースを配置できる論理境界を表します。ゾーンはヨーロッパ・ゾーン、北米ゾーン、東アジア・ゾーンなど、特定の地理的な場所を表すことができます。ゾーンは高帯域幅ネットワークや保護されたDMZなどの特性を表すこともできます。さらに、ゾーンを財務部門ゾーン、テスト・ゾーン、開発ゾーンなどの組織にすることもできます。
特に定めのないかぎり、ゾーンの基礎となるインフラストラクチャの排他性を想定することはできません。たとえば、ゾーンAとゾーンBは、2つの異なる部門にサービスを提供する同じ物理ネットワーク上に配置できますが、その物理インフラストラクチャ設定はクラウド・ユーザーには見えません。
表46-5 ゾーンのデータ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するゾーン定義のクライアント表現がリフレッシュされます。 |
12.1.0.1 |
name |
文字列 |
1 |
ゾーンの名前。 |
12.1.0.1 |
description |
文字列 |
0..1 |
ゾーンのユーザー用の説明。様々な言語をサポートするUNICODE文字列です。 |
12.1.0.1 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.4 |
resource_state |
ResourceState |
0..1 |
リソースのリソース状態。 |
12.1.0.1 |
service_family_type |
文字列 |
0..1 |
このゾーンが関連付けられているサービス・ファミリ・タイプの名前。 各ゾーンはサービス・ファミリ・タイプのコンテキストに当てはめられます。 |
12.1.0.4 |
service_templates |
コレクション<ServiceTemplate> |
0..1 |
このゾーンがサポートする、このゾーンをデプロイ可能なサービス・テンプレートのコレクション。 |
12.1.0.4 |
service_instances |
コレクション<ServiceInstance> |
0..1 |
このゾーン内にあるサービス・インスタンスのコレクション。 |
12.1.0.4 |
サービス・ファミリ・タイプは、クラウドによって提供されるサービスのカテゴリです。たとえば、IaaSはインフラストラクチャ・サービスをカプセル化するカテゴリです。Mwaasはミドルウェア・サービスをカプセル化するカテゴリです。これらのカテゴリは事前定義されています。
次の表で、ServiceFamilyTypeデータ・モデルについて説明します
表46-6 サービス・ファミリ・タイプ
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するServiceFamilyType定義のクライアント表現がリフレッシュされます。 |
12.1.0.4 |
name |
文字列 |
1 |
ServiceFamilyTypeの名前。 |
12.1.0.4 |
description |
文字列 |
0..1 |
サービス・ファミリ・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.4 |
resource_state |
ResourceState |
0..1 |
リソースのリソース状態。 |
12.1.0.4 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.4 |
service_templates |
コレクション<ServiceTemplate> |
0..1 |
このサービス・ファミリ・タイプのサービス・テンプレートのコレクション。 |
12.1.0.4 |
zones |
コレクション<ゾーン> |
0..1 |
このサービス・ファミリ・タイプのサービス・インスタンスをサポートするゾーンのコレクション。 |
12.1.0.4 |
instance_types |
コレクション<InstanceType> |
0..1 |
このサービス・ファミリ・タイプによってサポートされるインスタンス・タイプのコレクション。 |
12.1.0.4 |
quota_usages |
コレクション<QuotaUsage> |
0..1 |
認証済ユーザーのパースペクティブ・ファミリ・タイプの割当て制限使用量のコレクション。 |
12.1.0.5 |
quota_def |
Jsonオブジェクト |
0..1 |
ファミリ・タイプ固有の割当て制限メタデータ情報で、いくつかの権限情報が含まれることがあります。 このオブジェクトの構造は、パースペクティブ・ファミリ・タイプ・リソース・モデルで文書化されます。 |
12.1.0.5 |
サービス・インスタンス・タイプは、タイプのサービス・インスタンスの共有メタデータを示します。タイプのサービス・インスタンスがクラスのインスタンス化であるクラスに例えることができます。
次の表で、ServiceFamilyTypeデータ・モデルについて説明します。
表46-7 サービス・インスタンス・タイプ
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するServiceInstanceType定義のクライアント表現がリフレッシュされます。 |
12.1.0.4 |
name |
文字列 |
1 |
ServiceInstanceTypeの名前。 |
12.1.0.4 |
description |
文字列 |
0..1 |
サービス・インスタンス・タイプのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.4 |
resource_state |
ResourceState |
0..1 |
リソースのリソース状態。 |
12.1.0.4 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.4 |
instance_media_type |
文字列 |
0..1 |
このタイプのインスタンスのメディア・タイプ。 |
12.1.0.4 |
metrics |
リスト<リスト<文字列>> |
0..1 |
インスタンス・タイプでサポートされるメトリックのリスト。各リスト要素は、メトリックの名前、説明、タイプの3つのセットを表します。 |
12.1.0.4 |
このリソースは、パフォーマンスまたは構成に関連する時系列データを表します。たとえば、CPU使用率はVMリソースのメトリック、表領域使用率はデータベース・リソースのメトリックです。
次の表で、メトリック・データ・モデルについて説明します。
表46-8 メトリック・データ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するメトリック定義のクライアント表現がリフレッシュされます。 |
12.1.0.4 |
name |
文字列 |
1 |
メトリックの名前。 |
12.1.0.4 |
description |
文字列 |
0..1 |
メトリックのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.4 |
resource_state |
ResourceState |
0..1 |
リソースのリソース状態。 |
12.1.0.4 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.4 |
type |
文字列 |
1 |
メトリック値のタイプ。STRING、INTEGER、PERCENTAGE、NUMBER、MIXの列挙です。 |
12.1.0.4 |
current_value |
文字列 |
0..1 |
メトリックの最新の既知の値 |
12.1.0.4 |
current_time |
ISO 8601日付 |
0..1 |
current_valueが最後に確認されたUTC時間 |
12.1.0.4 |
time_range |
2つのISO 8601日付のリスト |
0..1 |
最初の日付が開始日で、次の日付が終了日です。この範囲により、"values"属性の時系列ウィンドウが決定されます |
12.1.0.4 |
rollup_unit |
文字列 |
0..1 |
時系列データのロールアップ単位。DAY、DAILY、DAYLY、HOUR、HOURLY、RAWのいずれかを指定できます |
12.1.0.4 |
values |
オブジェクトのリスト |
0..1 |
rollup_unit = RAWの場合、これは時間指定された監視を示す、それぞれに"time_utc"および"value"属性を含むオブジェクトのリストです。 他のすべてのrollup_unitの場合、これはサポートされている集計された監視を示す、それぞれに"time_utc"、"average"、"min"、"max"、"std"属性を含むオブジェクトのリストです。 |
12.1.0.4 |
time_range_epoch |
2つの数値のリスト |
0..1 |
time_rangeと同じですが、Epoch時間形式です。 |
12.1.0.4 |
サービス・インスタンスは、サービス・インスタンスのいくつかの共有メタデータを示します。これは抽象メディア・タイプで、実際の実装は各XaaSサービスによって提供されます。拡張リソースは、この抽象メディア・タイプのGETリクエストに適合すると予想されます。
次の表で、サービス・インスタンス・データ・モデルについて説明します。
表46-9 サービス・インスタンス・データ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、このユーザーに対するServiceInstance定義のクライアント表現がリフレッシュされます。 |
12.1.0.4 |
name |
文字列 |
1 |
ServiceInstanceの名前。 |
12.1.0.4 |
description |
文字列 |
0..1 |
サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.4 |
resource_state |
ResourceState |
1 |
リソースのリソース状態。 |
12.1.0.4 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.4 |
metrics |
コレクション<メトリック> |
0..1 |
リソースで監視されるメトリックのコレクション。 |
12.1.0.4 |
service_family_type |
文字列 |
1 |
このサービス・インスタンスのコンテキストであるServiceFamilyTypeの名前。 |
12.1.0.4 |
status |
文字列 |
0..1 |
サービス・インスタンスによって表されるエンティティのステータス。たとえば、サービス・インスタンスVMの場合、値はSTARTED、STOPPEDまたはVMに適したその他の値になります。各拡張リソースは、適用可能なステータスの列挙を示します。 |
12.1.0.4 |
created |
ISO 8601日付 |
0..1 |
サービス・インスタンスが作成された日付。 |
12.1.0.4 |
割当て制限使用量は、サービス・ファミリ・タイプのコンテキストで使用される認証によって使用されるいくつかのリソースの量を説明します。たとえば、IaaSでは、CPU、メモリー、サーバー数に割当て制限が定義され、それぞれの使用量は割当て制限使用量リソースにカプセル化されています。
次の表では、割当て制限使用量のデータ・モデルについて説明します。
表46-10 QuotaUsageデータ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、QuotaUsageのクライアント表現がリフレッシュされます。 |
12.1.0.5 |
name |
文字列 |
1 |
QuotaUsageの名前。 |
12.1.0.5 |
description |
文字列 |
0..1 |
サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.5 |
media_type |
文字列 |
1 |
リソースのメディア・タイプ。 |
12.1.0.5 |
id |
文字列 |
1 |
リソースのID表現。 |
12.1.0.5 |
type |
文字列 |
1 |
リソースのサービス・ファミリ・タイプ。 |
12.1.0.5 |
used |
Number |
1 |
使用されるリソースの量。タイプは、unit属性によって表現されます。 |
12.1.0.5 |
maxAllowed |
Number |
0..1 |
認証済ユーザーが使用する可能性があるリソースの最大量。 |
12.1.0.5 |
unit |
文字列 |
1 |
リソースの単位。 |
12.1.0.5 |
サービス・テンプレート検索は、検索基準が指定されたクラウド全体でサービス・テンプレートを検索およびフィルタリングするリソースです。各サービス・ファミリ・タイプでは、サポート範囲が文書化されます(フィルタ属性のリストなど)。
次の表では、サービス・テンプレート検索のデータ・モデルについて説明します。
表46-11 ServiceTemplateFindsデータ・モデル
フィールド | タイプ | 発生 | 説明 | 開始 |
---|---|---|---|---|
uri |
URI |
1 |
このURIに対してGETを実行すると、ServiceTemplateFindsのクライアント表現がリフレッシュされます。 検索条件に合うサービス・テンプレートが追加/削除された場合、リンクをリフレッシュすると変更が反映されます。 |
12.1.0.5 |
name |
文字列 |
1 |
ServiceTemplateFindsの名前。 |
12.1.0.5 |
description |
文字列 |
0..1 |
サービス・インスタンスのユーザー用の説明。様々な言語をサポートするUNICODE文字列になります。 |
12.1.0.5 |
filters |
Jsonオブジェクト |
1 |
フィルタ条件を示すキー値のペアのマップ。 |
12.1.0.5 |
finds |
コレクション<*> |
1 |
フィルタ基準を満たすエンティティのコレクション(サービス・テンプレートのサブ・タイプになることがあります)。 |
12.1.0.5 |
次の表では、フィルタでサポートされる属性について説明します。
次の各項では、Enterprise Manager Cloud Control 12.1.0.2と12.1.0.5 Cloud Service Portalプラグインとの異なる相互作用の例を示します。これらの例では、様々なリソースの構造を示しています。このバージョンでは、デフォルトのx-specification-versionは10001と想定されます。
最上位の/em/cloudを使用してクラウド・リソースをイントロスペクトします。次の表では、GETメソッド機能について説明します。
表46-13 クラウド・リソースのGETメソッド
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI =X-specification-Version: 10001 |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
次により、クラウド・リソースが返されます。
{ "uri" : "/em/cloud" , "name" : "Oracle Cloud by Enterprise Manager" , "description" : "This represents the Cloud resource of the Oracle Enterprise Manager Cloud Management solution" , "resource_state" : { "state" : "READY" } , "media_type" : "application/oracle.com.cloud.common.Cloud+json" , "zones" : { "media_type" : "application/oracle.com.cloud.common.Zone+json" , "total" : "3" , "elements" : [ { "uri" : "/em/cloud/jaas/zone/450121204B4703131FC0FDD72E7BF494" , "name" : "PaaS_Zone_Middleware" , "media_type" : "application/oracle.com.cloud.jaas.Zone+json" , "service_family_type" : "jaas" } , { "uri" : "/em/cloud/opc/opczone" , "name" : "OPC Zone" , "media_type" : "application/oracle.com.cloud.opc.OpcZone+json" , "service_family_type" : "opc" , "type" : "opc" } , { "uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" , "name" : "cloud_zone" , "media_type" : "application/oracle.com.cloud.iaas.Zone+json" , "service_family_type" : "iaas" , "type" : "VM_ZONE" } ] } , "service_templates" : { "media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" , "total" : "7" , "elements" : [ { "uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" , "name" : "template_sanity" , "media_type" : "application/oracle.com.cloud.common.VMTemplate+json" , "service_family_type" : "iaas" , "type" : "Template" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" , "name" : "sidb_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" , "name" : "wls_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" , "name" : "fmw_venkat" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" , "name" : "fmw_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" , "name" : "sidbasmA_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" , "name" : "WLS_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "service_family_type" : "iaas" , "type" : "Assembly" } ] } , "service_family_types" : { "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "total" : "4" , "elements" : [ { "uri" : "/em/cloud/service_family_type/jaas" , "name" : "jaas" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "jaas" } , { "uri" : "/em/cloud/service_family_type/dbaas" , "name" : "dbaas" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "dbaas" } , { "uri" : "/em/cloud/service_family_type/opc" , "name" : "opc" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "opc" } , { "uri" : "/em/cloud/service_family_type/iaas" , "name" : "iaas" , "media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" , "type" : "iaas" } ] } }
注意: 許容タイプは指定されていませんが、Webサービスによりクラウド・リソースが"/em/cloud"アドレスとして明確に返されます。このアドレスは、クラウドを返されるデフォルト・リソースとして一意に識別します。 |
次の表では、特定の属性を選択するクラウド・リソースを示します。
表46-14 クラウド・リソースのGETメソッド
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud?service_family_types,name |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
選択的属性を次に示します。
{ "name" : "Oracle Cloud by Enterprise Manager" , "service_family_types" : { "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "total" : "4" , "elements" : [ { "uri" : "/em/cloud/service_family_type/jaas" , "name" : "jaas" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "jaas" } , { "uri" : "/em/cloud/service_family_type/dbaas" , "name" : "dbaas" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "dbaas" } , { "uri" : "/em/cloud/service_family_type/opc" , "name" : "opc" , "media_type" : "application/oracle.com.cloud.common.ServiceFamilyType+json" , "type" : "opc" } , { "uri" : "/em/cloud/service_family_type/iaas" , "name" : "iaas" , "media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" , "type" : "iaas" } ] } }
この機能は、選択的属性のみが収集されてクライアントに返される、すべての共通リソースでサポートされます。
次の表では、サービス・ファミリ・タイプ・リソースの機能を示します。
表46-15 サービス・ファミリ・タイプ・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/service_family_type/iaas |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
この相互作用で返されるヘッダーとコンテンツは次のとおりです。
X-specification-version: 10001 Content-Type: application/oracle.com.cloud.iaas.IaasServiceFamilyType+json; charset=ISO-8859-1 { "uri" : "/em/cloud/service_family_type/iaas" , "name" : "iaas" , "resource_state" : { "state" : "READY" } , "media_type" : "application/oracle.com.cloud.iaas.IaasServiceFamilyType+json" , "type" : "iaas" , "service_templates" : { "media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" , "total" : "7" , "elements" : [ { "uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" , "name" : "template_sanity" , "media_type" : "application/oracle.com.cloud.common.VMTemplate+json" , "type" : "Template" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" , "name" : "sidb_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" , "name" : "wls_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" , "name" : "fmw_venkat" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" , "name" : "fmw_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" , "name" : "sidbasmA_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" , "name" : "WLS_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } ] } , "zones" : { "media_type" : "application/oracle.com.cloud.common.Zone+json" , "total" : "1" , "elements" : [ { "uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" , "name" : "cloud_zone" , "media_type" : "application/oracle.com.cloud.iaas.Zone+json" , "service_family_type" : "iaas" , "type" : "VM_ZONE" } ] } , "instance_types" : { "media_type" : "application/oracle.com.cloud.common.InstanceType+json" , "total" : "2" , "elements" : [ { "uri" : "/em/cloud/instance_type/vm%40iaas" , "name" : "vm" , "media_type" : "application/oracle.com.cloud.common.InstanceType+json" , "instance_media_type" : "application/oracle.com.cloud.common.VM+json" } , { "uri" : "/em/cloud/instance_type/assembly%40iaas" , "name" : "assembly" , "media_type" : "application/oracle.com.cloud.common.InstanceType+json" , "instance_media_type" : "application/oracle.com.cloud.common.AssemblyInstance+json" } ] } , "quota_usages" : { "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "total" : "6" , "elements" : [ { "uri" : "/em/cloud/quota_usage/iaas_3" , "name" : "Local Storage Quota" , "description" : "Local Storage Quota" , "context_id" : "3" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "10240" , "maxAllowed" : "2000" , "unit" : "GB" } , { "uri" : "/em/cloud/quota_usage/iaas_2" , "name" : "RAM Quota" , "description" : "RAM Quota" , "context_id" : "2" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "512" , "maxAllowed" : "600000" , "unit" : "MB" } , { "uri" : "/em/cloud/quota_usage/iaas_1" , "name" : "CPU Quota" , "description" : "CPU Quota" , "context_id" : "1" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "1" , "maxAllowed" : "100" , "unit" : "COUNT" } , { "uri" : "/em/cloud/quota_usage/iaas_6" , "name" : "Servers Quota" , "description" : "Servers Quota" , "context_id" : "6" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "1" , "maxAllowed" : "20" , "unit" : "COUNT" } , { "uri" : "/em/cloud/quota_usage/iaas_5" , "name" : "SWLIB Storage Quota" , "description" : "SWLIB Storage Quota" , "context_id" : "5" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "0" , "maxAllowed" : "-1" , "unit" : "GB" } , { "uri" : "/em/cloud/quota_usage/iaas_4" , "name" : "Extra Storage Quota" , "description" : "Extra Storage Quota" , "context_id" : "4" , "media_type" : "application/oracle.com.cloud.common.QuotaUsage+json" , "used" : "0" , "maxAllowed" : "-1" , "unit" : "GB" } ] } , "quota_def" : { "uri" : "/em/cloud/iaas/quota" , "name" : "iaas Quota" , "description" : "iaas Quota" , "media_type" : "application/oracle.com.cloud.iaas.Quota+json" } , "instance_options" : [ { "name" : "Medium" , "cpu" : "4" , "memory" : "8192" , "local_storage" : "512000" , "id" : "2" } , { "name" : "Large" , "cpu" : "8" , "memory" : "15360" , "local_storage" : "1024000" , "id" : "3" } , { "name" : "Small" , "cpu" : "2" , "memory" : "4096" , "local_storage" : "256000" , "id" : "1" } ] }
application/oracle.com.cloud.iaas.IaasServiceFamilyType+jsonメディア・タイプが詳細リソースとして自動的に返されます。同様に、共通タイプを受け入れることでシステムと相互作用できます。
表46-16 サービス・ファミリ・タイプ・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/service_family_type/iaas |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI=Accept-Type: application/oracle.com.cloud.common.ServiceFamilyType+json |
メソッド |
GET |
Webサービスによって、前の相互作用で示されたコンテンツが返されます。
次の表では、IaaSサービスの割当て定義をイントロスペクトするためにIaaSサービス・ファミリ・タイプを介して公開される、割当て制限リソースについて説明します。
表46-17 サービス・ファミリ・タイプ・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/iaas/quota |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.5 Cloud Service Portalプラグイン |
次の例では、この相互作用で返されるヘッダーとコンテンツを示します。
X-specification-version: 10001 Content-Type: application/oracle.com.cloud.iaas.Quota+json; charset=ISO-8859-1 { "uri" : "/em/cloud/iaas/quota" , "name" : "iaas Quota" , "description" : "iaas Quota" , "resource_state" : { "state" : "READY" } , "media_type" : "application/oracle.com.cloud.iaas.Quota+json" , "service_family_type" : "iaas" , "allowedSaveToSwlib" : "1" , "allowedSaveToSwlibOnExpiry" : "0" , "resourceQuotas" : { "total" : "6" , "elements" : [ { "name" : "Local Storage Quota" , "description" : "Local Storage Quota" , "maxAllowed" : "2000" , "unit" : "GB" } , { "name" : "RAM Quota" , "description" : "RAM Quota" , "maxAllowed" : "600000" , "unit" : "MB" } , { "name" : "CPU Quota" , "description" : "CPU Quota" , "maxAllowed" : "100" , "unit" : "COUNT" } , { "name" : "Servers Quota" , "description" : "Servers Quota" , "maxAllowed" : "20" , "unit" : "COUNT" } , { "name" : "SWLIB Storage Quota" , "description" : "SWLIB Storage Quota" , "maxAllowed" : "-1" , "unit" : "GB" } , { "name" : "Extra Storage Quota" , "description" : "Extra Storage Quota" , "maxAllowed" : "-1" , "unit" : "GB" } ] } }
これは、特定のサービス・ファミリ・タイプによって提供されるサービスのタイプを説明するリソースです。
表46-18 サービス・インスタンス・タイプ・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/instance_type/vm%40iaas |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
次に、サービス・インスタンス・タイプ・リソースを示します。
{ "uri" : "/em/cloud/instance_type/vm%40iaas" , "name" : "vm" , "description" : "A Virtual Machine represents a computational unit that contains CPU, Memory, Network Instances, and Disks" , "media_type" : "application/oracle.com.cloud.common.InstanceType+json" , "instance_media_type" : "application/oracle.com.cloud.common.VM+json" , "metrics" : [ [ "CPU_Utilization" , "CPU Utilization of the Server" , "GENERIC" ] , [ "Total_Network_Throughput" , "Total Network Throughput of the Server" , "GENERIC" ] , [ "Total_Disk_Throughput" , "Total Disk Throughput of the Server" , "GENERIC" ] , [ "Filesystem_Total_Used" , "Summary of the total file system usage" , "GENERIC" ] ] , "instance_options" : [ { "name" : "Medium" , "cpu" : "4" , "memory" : "8192" , "local_storage" : "512000" , "id" : "2" } , { "name" : "Large" , "cpu" : "8" , "memory" : "15360" , "local_storage" : "1024000" , "id" : "3" } , { "name" : "Small" , "cpu" : "2" , "memory" : "4096" , "local_storage" : "256000" , "id" : "1" } ] }
次の表では、ゾーン・リソースの機能を示します。
表46-19 ZoneResource
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
次に、application/oracle.com.cloud.iaas.Zone+jsonメディア・タイプに自動的にキャストするゾーン・リソースを示します。
{ "uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" , "name" : "cloud_zone" , "resource_state" : { "state" : "READY" } , "context_id" : "D73AF0D42C8459E11419862797D1F37D" , "media_type" : "application/oracle.com.cloud.iaas.Zone+json" , "service_family_type" : "iaas" , "type" : "VM_ZONE" , "service_templates" : { "media_type" : "application/oracle.com.cloud.common.ServiceTemplate+json" , "total" : "7" , "elements" : [ { "uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" , "name" : "template_sanity" , "media_type" : "application/oracle.com.cloud.common.VMTemplate+json" , "type" : "Template" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC75E88B04D7FEDEDE040578CDA810E49%3A0.1" , "name" : "sidb_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC77122B0A916D95CE040578CDA814854%3A0.1" , "name" : "sidbasmA_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC769B1F361529309E040578CDA813D57%3A0.1" , "name" : "wls_assembly" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C144A4A245B62E040578CDA8163B9%3A0.1" , "name" : "fmw_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76C8792DE2A0937E040578CDA81795E%3A0.1" , "name" : "WLS_abby" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } , { "uri" : "/em/cloud/iaas/servicetemplate/assembly/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3AAssembly%3AC76F733BC7A41AF7E040578CDA812CDC%3A0.1" , "name" : "fmw_venkat" , "media_type" : "application/oracle.com.cloud.common.AssemblyTemplate+json" , "type" : "Assembly" } ] } , "service_instances" : { "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" , "total" : "0" , "elements" : [ ] } , "vnets" : { "media_type" : "application/oracle.com.cloud.common.VNet+json" , "total" : "3" , "elements" : [ { "uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC76CEADBBBE6B23FE040578CDA817FB1" , "context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1" , "media_type" : "application/oracle.com.cloud.common.VNet+json" , "id" : "oracle:defaultService:em:provisioning:1:netConfig:C76CEADBBBE6B23FE040578CDA817FB1" } , { "uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC77076C8FDEC6BD7E040578CDA813B2B" , "context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B" , "media_type" : "application/oracle.com.cloud.common.VNet+json" , "id" : "oracle:defaultService:em:provisioning:1:netConfig:C77076C8FDEC6BD7E040578CDA813B2B" } , { "uri" : "/em/cloud/iaas/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3AnetConfig%3AC76F741AFD7EB760E040578CDA812CD8" , "context_id" : "oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8" , "media_type" : "application/oracle.com.cloud.common.VNet+json" , "id" : "oracle:defaultService:em:provisioning:1:netConfig:C76F741AFD7EB760E040578CDA812CD8" } ] } , "delegated_credentials" : { "media_type" : "application/oracle.com.cloud.iaas.ExalogicZoneCredential+json" , "total" : "0" , "elements" : [ ] } }
前の例で示したように、リソース・タイプを明確に指定するために、表示されたコレクションのすべての要素にmedia_typeが属性として付けられています。次の表では、サービス・テンプレート・リソースの機能を示します。
表46-20 サービス・テンプレート・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1 |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
次に、完全なVMTemplateリソースとして返されるリソースを示します。
{ "uri" : "/em/cloud/iaas/servicetemplate/vm/oracle%3AdefaultService%3Aem%3Aprovisioning%3A1%3Acmp%3AVirtualization%3ATemplate%3AC76CEB5563EA5E13E040578CDA817FAF%3A0.1" , "name" : "template_sanity" , "description" : "test template" , "resource_state" : { "state" : "READY" } , "context_id" : "oracle:defaultService:em:provisioning:1:cmp:Virtualization:Template:C76CEB5563EA5E13E040578CDA817FAF:0.1" , "media_type" : "application/oracle.com.cloud.common.VMTemplate+json" , "type" : "Template" , "created" : "2012-08-17T11:53:26+0000" , "default_instance_media_type" : "application/oracle.com.cloud.common.VM+json" , "zones" : { "media_type" : "application/oracle.com.cloud.iaas.Zone+json" , "total" : "1" , "elements" : [ { "uri" : "/em/cloud/iaas/zone/D73AF0D42C8459E11419862797D1F37D" , "name" : "cloud_zone" , "media_type" : "application/oracle.com.cloud.iaas.Zone+json" , "service_family_type" : "iaas" , "type" : "VM_ZONE" } ] } , "service_instances" : { "media_type" : "application/oracle.com.cloud.common.ServiceInstance+json" , "total" : "0" , "elements" : [ ] } , "deployment_params" : [ { "name" : "zone" , "description" : "'zone' attribute is the URI of the zone that the 'application/oracle.com.cloud.common.VM' resource is to be created in" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "based_on" , "description" : "'based_on' attribute is the URI of the service template or format String of the originated source which the deployed 'application/oracle.com.cloud.common.VM' resource is to be followed" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "cpu" , "description" : "The information that determined how much 'CPU' is to be allocated to the deployed resource" , "type" : "LIST" , "require" : "false" , "sensitive" : "false" } , { "name" : "memory" , "description" : "The information that determined how much 'MEMORY' is to be allocated to the deployed resource" , "type" : "NUMBER" , "require" : "false" , "sensitive" : "false" } , { "name" : "disks" , "description" : "The list of disks to be included in the deployed resource" , "type" : "LIST" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.domain_type" , "description" : "The domain type of the Virtual Machine" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.network_profile" , "description" : "The identifier of the network profile to be used for the network instances of the Virtual Machine" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.server_prefix" , "description" : "The server prefix to be specified for the Virtual Machine" , "type" : "STRING" , "require" : "true" , "sensitive" : "false" } , { "name" : "params.server_size" , "description" : "The name of the server instance size" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.request_name" , "description" : "The request name to be tracked for the Virtual Machine creation" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.request_description" , "description" : "The request description to be tracked for the Virtual Machine creation" , "type" : "STRING" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.vnc_password" , "description" : "The VNC password for the Virtual Machine" , "type" : "STRING" , "require" : "true" , "sensitive" : "true" } , { "name" : "params.root_password" , "description" : "The Root password for the Virtual Machine" , "type" : "STRING" , "require" : "true" , "sensitive" : "true" } , { "name" : "params.start_vm" , "description" : "Whether or not the Virtual Machine should be started after creation" , "type" : "STRING" , "defaultValue" : "YES" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.ha_enabled" , "description" : "Whether or not the Virtual Machine should be HA enabled" , "type" : "STRING" , "defaultValue" : "NO" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.disks_overwrite" , "description" : "Whether or not the default Virtual Machine disks should be overwritten" , "type" : "STRING" , "defaultValue" : "NO" , "require" : "false" , "sensitive" : "false" } , { "name" : "params.networks" , "description" : "Whether or not the default Virtual Machine disks should be overwritten" , "type" : "LIST" , "require" : "false" , "sensitive" : "false" } ] , "directory" : "COMP_Components" , "updated" : "2012-08-17T11:53:26+0000" , "creator" : "DMBHAT1" , "last_modified_by" : "DMBHAT1" , "componenttype" : "Virtualization" , "oracle_owned" : "false" }
メトリックには時系列情報が含まれ、メトリックのタイプに応じてロールアップ情報を取得することもできます。次に例を示します
表46-21 サービス・テンプレート・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
Webサービスからのレスポンスは次のとおりです。
{ "uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" , "name" : "CPU_Utilization" , "media_type" : "application/oracle.com.cloud.common.Metric+json" , "resource_state" : { "state" : "READY" } , "type" : "NUMBER" , "current_value" : "52.53868103027344" , "current_time" : "2012-08-22T01:28:14+0000" , "time_range" : [ "2012-08-22T01:18:14+0000" , "2012-08-22T01:28:14+0000" ] , "time_range_epoch" : [ "1345598294965" , "1345598894965" ] , "rollup_unit" : "RAW" , "values" : [ { "time_utc" : "2012-08-22T01:21:44+0000" , "value" : "52.53868103027344" } ] , "key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD" }
デフォルトの時間範囲は10分です。時間範囲を変更するために、問合せパラメータを使用して時間範囲を指定できます。たとえば、次の例では、最後の50分のメトリック・データが取得されます。
表46-22 サービス・テンプレート・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD?time_range_epoch=1345595894965~1345598894965 |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
問合せパラメータtime_range_epochには"~"で区切られた2つの数値が含まれ、FROM時間からTO時間までを示しています。レスポンスは次のとおりです。
{ "uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" , "name" : "CPU_Utilization" , "media_type" : "application/oracle.com.cloud.common.Metric+json" , "resource_state" : { "state" : "READY" } , "type" : "NUMBER" , "current_value" : "52.53868103027344" , "current_time" : "2012-08-22T01:29:19+0000" , "time_range" : [ "2012-08-22T00:38:14+0000" , "2012-08-22T01:28:14+0000" ] , "time_range_epoch" : [ "1345595894965" , "1345598894965" ] , "rollup_unit" : "RAW" , "values" : [ { "time_utc" : "2012-08-22T01:21:44+0000" , "value" : "52.53868103027344" } , { "time_utc" : "2012-08-22T01:16:44+0000" , "value" : "52.67461395263672" } , { "time_utc" : "2012-08-22T01:11:44+0000" , "value" : "51.93536376953125" } , { "time_utc" : "2012-08-22T01:06:44+0000" , "value" : "52.61101531982422" } , { "time_utc" : "2012-08-22T01:01:44+0000" , "value" : "52.30859375" } , { "time_utc" : "2012-08-22T00:56:44+0000" , "value" : "52.778690338134766" } , { "time_utc" : "2012-08-22T00:51:44+0000" , "value" : "52.08208084106445" } , { "time_utc" : "2012-08-22T00:46:44+0000" , "value" : "52.42387771606445" } , { "time_utc" : "2012-08-22T00:41:44+0000" , "value" : "52.2672004699707" } ] , "key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD" }
同様に、別のロールアップ単位を指定するために、次の相互作用では最後の7時間のHOURLYロールアップを示しています。
表46-23 サービス・テンプレート・リソース
機能 | 説明 |
---|---|
URL |
https://example.oracle.com/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD?time_range_epoch=1345571178252~1345611178252&rollup_unit=HOURLY |
ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
メソッド |
GET |
開始 |
12.1.0.4 Cloud Service Portalプラグイン |
集計情報についてのWebサービスからのレスポンスは次のとおりです。
{ "uri" : "/em/cloud/metric/iaas%3Avm%3ACPU_Utilization%3A523CAE80A305928C9C5BE8A67A4181FD" , "name" : "CPU_Utilization" , "media_type" : "application/oracle.com.cloud.common.Metric+json" , "resource_state" : { "state" : "READY" } , "type" : "NUMBER" , "current_value" : "52.37758255004883" , "current_time" : "2012-08-22T04:55:13+0000" , "time_range" : [ "2012-08-21T17:46:18+0000" , "2012-08-22T04:52:58+0000" ] , "time_range_epoch" : [ "1345571178252" , "1345611178252" ] , "rollup_unit" : "HOUR" , "values" : [ { "time_utc" : "2012-08-21T23:00:00+0000" , "average" : "52.6733585993448905" , "min" : "52.130245208740234" , "max" : "53.29022216796875" , "std" : "3.55263697371071501307481053785512321532E-01" } , { "time_utc" : "2012-08-21T22:00:00+0000" , "average" : "5.24303614298502599166666666666666666667E01" , "min" : "51.621360778808594" , "max" : "52.85725402832031" , "std" : "3.63521555326025399658498002900543252046E-01" } , { "time_utc" : "2012-08-21T21:00:00+0000" , "average" : "52.6410032908121745" , "min" : "52.04186248779297" , "max" : "53.23821258544922" , "std" : "3.21552680564547999623645642115362106482E-01" } , { "time_utc" : "2012-08-21T20:00:00+0000" , "average" : "7.60534032185872416666666666666666666667E00" , "min" : "0" , "max" : "52.8489990234375" , "std" : "1.80268512452981440717409537961069439254E01" } , { "time_utc" : "2012-08-21T19:00:00+0000" , "average" : "0" , "min" : "0" , "max" : "0" , "std" : "0" } , { "time_utc" : "2012-08-21T18:00:00+0000" , "average" : "0" , "min" : "0" , "max" : "0" , "std" : "0" } ] , "key" : "iaas:vm:CPU_Utilization:523CAE80A305928C9C5BE8A67A4181FD" }
この項では、DBaaSおよびMWaaSのサービス・リクエストを再スケジュールしたり削除する次のREST APIを説明します。
表46-24 サービス・リクエストに対してサポートされるメソッド
メソッド | 問合せパラメータ | リクエスト・ペイロード | レスポンス・ペイロード | 正規のリンク | 説明 |
---|---|---|---|---|---|
PUT |
該当せず |
{"newdate": "8/23/2013 4:46:12 AM"} |
ステータス・メッセージ(Jsonペイロード) |
em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<id> |
サービス・リクエストをIDおよび属性に基づいて再スケジュールします。 日時は、yyyy-MM-dd'T'HH:mm:ss'Zの形式で指定する必要があります。 |
DELETE |
該当せず |
なし |
なし |
em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/<service-request-id> |
GETで指定したServiceRequestを取り消します。 |
GET |
該当せず |
該当せず |
jsonペイロードとしてのリクエストのリスト |
em/websvcs/restful/extws/cloudservices/ssa/cfw/v1/servicerequests/ |
すべてのサービス・リクエストのリストを取得します。 |
ServiceRequestCollectionは、すべてのアクセス可能なサービス・リクエスト・リソース(取消しまたは再スケジュールが可能)のクラウド管理者ビューを表すコレクション・リソースです。次の表で、ServiceRequestCollectionデータ・モデルについて説明します。
表46-25 ServiceRequestCollectionデータ・モデル
フィールド | タイプ | 発生 | 説明 |
---|---|---|---|
name |
文字列 |
1 |
このコレクション・リソースの名称が表示されます。 |
type |
文字列 |
1 |
コレクション・リソースのタイプが表示されます。 |
hasMore |
Boolean |
1 |
コレクションに他の要素があるかどうかを示します。 |
count |
整数 |
1 |
コレクション・リソースの要素数です。 |
items |
コレクション<リクエスト> |
1 |
ServiceRequestリソースのリストです。インスタンスがない場合、このリストは空白です。 |
totalCount |
整数 |
1 |
リクエストの合計数。 |
canonicalLink |
URI |
1 |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
selfLink |
URI |
1 |
これを含む要素と同等のリソースを参照します。 |