プライマリ・コンテンツに移動
Oracle® Enterprise Manager Cloud管理ガイド
13cリリース1
E70373-02
  目次へ移動
目次		 索引へ移動
索引
前
前 		 次
次		  

41 クラウドのリソース・モデル

この章では、REST APIで操作するリソースの表現について説明します。内容は次のとおりです。

41.1 Enterprise Managerクラウド・リソース・モデル10001

このバージョンのクラウド・リソース・モデルはCloud Service PortalプラグインのXaaS実装を結集させたものであり、追加のサービス・タイプを使用してサービス・インスタンスの作成およびライフサイクル管理をサポートできます。

Enterprise Manager Cloud ControlのCloud Service Portalプラグインのこのリリースでは、クライアントが/em/cloudにアクセスする場合、10001がデフォルト・バージョンです。特に、クライアントはHTTPヘッダーでx-specification-version: 10001を指定して、リソースでバージョン10001がサポートされるかどうかを確認できます。1つのリクエストに異なるバージョンのリソース・タイプを混在させることはできないことに注意してください。たとえば、コンテンツがリソースの10000バージョンの形をしている場合、10001はリクエストを拒否することがあります。

次の表で、最上位レベルのリソースについて説明します。

表41-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

サービス・ファミリのコンテキストにおける割当て制限情報を表します。

41.2 クラウドのリソースの概要

クラウドのリソース表現は、それぞれに名前と値があるフィールドで構成され、JavaScript Object Notation (JSON)ディクショナリを使用してエンコードされます。値には、RFC 4627に従ったJSON形式のリスト、ディクショナリ、数値または文字列リテラルを指定できます。

各クラウド・リソース・タイプは、それぞれ独自のインターネット・メディア・タイプを持ちます。メディア・タイプはapplication/oracle.com.cloud.common.Xxxxxxxx+jsonというパターンにする必要があり、各リソース・モデル固有のメディア・タイプが対応するセクション・ヘッダーに角カッコで囲まれて含められます。

クラウドのリソースは現在、共通サービス・エンティティで編成されており、特定のサービス(Infrastructure as a Serviceなど)が共通サービス・エンティティを拡張するリソースを提供しています(該当する場合)。次の図は、共通リソースとInfrastructure as a Service固有のリソースとのリソース・モデル関係を示しています。

図41-1 クラウドのリソース・モデル

クラウドのリソース・モデル

41.3 リソースのデータ・モデル

次の項では、様々なクラウド・リソースのデータ・モデルについて詳しく説明します。

41.3.1 クラウド[application/oracle.com.cloud.common.Cloud+json]

クラウドは、アクセス可能なすべてのリソースのユーザーの開始ビューを表します。次の表では、クラウドのデータ・モデルについて説明します。

表41-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

41.3.2 ServiceTemplate [application/oracle.com.cloud.common.ServiceTemplate+json]

ServiceTemplateは、デプロイ可能なサービスの定義を表します。ユーザーにとって、ServiceTemplateはデプロイ可能なサービスの定義を表します。ユーザーはServiceTemplateのURIと相互作用して、クラウドのリソースを作成できます。クラウドは、リソースとその構成をServiceTemplateの定義で指定されているとおりにインスタンス化する必要があります。

VMTemplateはServiceTemplateリソースのサブクラスであるため、VMTemplateのURIからServiceTemplateを取得できます。次の表に、ServiceTemplateデータ・モデルを示します。

表41-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

次の表に、デプロイメント・パラメータの構造を示します。

表41-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。

41.3.3 ゾーン[application/oracle.com.cloud.common.Zone+json]

ゾーンは、リソースを配置できる論理境界を表します。ゾーンはヨーロッパ・ゾーン、北米ゾーン、東アジア・ゾーンなど、特定の地理的な場所を表すことができます。ゾーンは高帯域幅ネットワークや保護されたDMZなどの特性を表すこともできます。さらに、ゾーンを財務部門ゾーン、テスト・ゾーン、開発ゾーンなどの組織にすることもできます。

特に定めのないかぎり、ゾーンの基礎となるインフラストラクチャの排他性を想定することはできません。たとえば、ゾーンAとゾーンBは、2つの異なる部門にサービスを提供する同じ物理ネットワーク上に配置できますが、その物理インフラストラクチャ設定はクラウド・ユーザーには見えません。

表41-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

41.3.4 サービス・ファミリ・タイプ[application/oracle.com.cloud.common.ServiceFamilyType+json]

サービス・ファミリ・タイプは、クラウドによって提供されるサービスのカテゴリです。たとえば、IaaSはインフラストラクチャ・サービスをカプセル化するカテゴリです。Mwaasはミドルウェア・サービスをカプセル化するカテゴリです。これらのカテゴリは事前定義されています。

次の表で、ServiceFamilyTypeデータ・モデルについて説明します

表41-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

41.3.5 サービス・インスタンス・タイプ[application/oracle.com.cloud.common.InstanceType+json]

サービス・インスタンス・タイプは、タイプのサービス・インスタンスの共有メタデータを示します。タイプのサービス・インスタンスがクラスのインスタンス化であるクラスに例えることができます。

次の表で、ServiceFamilyTypeデータ・モデルについて説明します。

表41-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

41.3.6 メトリック[application/oracle.com.cloud.common.Metric+json]

このリソースは、パフォーマンスまたは構成に関連する時系列データを表します。たとえば、CPU使用率はVMリソースのメトリック、表領域使用率はデータベース・リソースのメトリックです。

次の表で、メトリック・データ・モデルについて説明します。

表41-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

41.3.7 サービス・インスタンス[application/oracle.com.cloud.common.ServiceInstance+json]

サービス・インスタンスは、サービス・インスタンスのいくつかの共有メタデータを示します。これは抽象メディア・タイプで、実際の実装は各XaaSサービスによって提供されます。拡張リソースは、この抽象メディア・タイプのGETリクエストに適合すると予想されます。

次の表で、サービス・インスタンス・データ・モデルについて説明します。

表41-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

41.3.8 割当て制限使用量[application/oracle.com.cloud.common.QuotaUsage+json]

割当て制限使用量は、サービス・ファミリ・タイプのコンテキストで使用される認証によって使用されるいくつかのリソースの量を説明します。たとえば、IaaSでは、CPU、メモリー、サーバー数に割当て制限が定義され、それぞれの使用量は割当て制限使用量リソースにカプセル化されています。

次の表では、割当て制限使用量のデータ・モデルについて説明します。

表41-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

41.3.9 サービス・テンプレート検索[application/oracle.com.cloud.common.ServiceTemplateFinds+json]

サービス・テンプレート検索は、検索基準が指定されたクラウド全体でサービス・テンプレートを検索およびフィルタリングするリソースです。各サービス・ファミリ・タイプでは、サポート範囲が文書化されます(フィルタ属性のリストなど)。

次の表では、サービス・テンプレート検索のデータ・モデルについて説明します。

表41-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

次の表では、フィルタでサポートされる属性について説明します。

表41-12 フィルタ属性

属性 説明 開始

media_type

検索する特定のサービス・テンプレート・メディア。これは、メディア・タイプの完全一致になります。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

name

名前に指定の文字列が含まれる場合は、サービス・テンプレートが返されます。大文字と小文字は区別されないため、OELとoelは同じ結果を返します。

12.1.0.5 Cloud Service Portalプラグイン(IaaSサービス・ファミリ・タイプのみ)

41.4 クラウドREST APIの例

次の各項では、Enterprise Manager Cloud Control 12.1.0.2と12.1.0.5 Cloud Service Portalプラグインとの異なる相互作用の例を示します。これらの例では、様々なリソースの構造を示しています。このバージョンでは、デフォルトのx-specification-versionは10001と想定されます。

41.4.1 クラウド・リソース

最上位の/em/cloudを使用してクラウド・リソースをイントロスペクトします。次の表では、GETメソッド機能について説明します。

表41-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"アドレスとして明確に返されます。このアドレスは、クラウドを返されるデフォルト・リソースとして一意に識別します。

次の表では、特定の属性を選択するクラウド・リソースを示します。

表41-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"
          }
      ]
    }
}

この機能は、選択的属性のみが収集されてクライアントに返される、すべての共通リソースでサポートされます。

41.4.2 サービス・ファミリ・タイプ・リソース

次の表では、サービス・ファミリ・タイプ・リソースの機能を示します。

表41-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メディア・タイプが詳細リソースとして自動的に返されます。同様に、共通タイプを受け入れることでシステムと相互作用できます。

表41-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サービスによって、前の相互作用で示されたコンテンツが返されます。

41.4.3 割当て制限リソース

次の表では、IaaSサービスの割当て定義をイントロスペクトするためにIaaSサービス・ファミリ・タイプを介して公開される、割当て制限リソースについて説明します。

表41-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"
          }
      ]
    }
}

41.4.4 サービス・インスタンス・タイプ・リソース

これは、特定のサービス・ファミリ・タイプによって提供されるサービスのタイプを説明するリソースです。

表41-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"
      }
  ]
}

41.4.5 ゾーン・リソース

次の表では、ゾーン・リソースの機能を示します。

表41-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" : 
      [      ]
    }
}

41.4.6 サービス・テンプレート・リソース

前の例で示したように、リソース・タイプを明確に指定するために、表示されたコレクションのすべての要素にmedia_typeが属性として付けられています。次の表では、サービス・テンプレート・リソースの機能を示します。

表41-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"
}

41.4.7 メトリック・リソース

メトリックには時系列情報が含まれ、メトリックのタイプに応じてロールアップ情報を取得することもできます。次に例を示します

表41-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分のメトリック・データが取得されます。

表41-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ロールアップを示しています。

表41-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"
}

41.5 サービス・リクエストREST API

この項では、DBaaSおよびMWaaSのサービス・リクエストを再スケジュールしたり削除する次のREST APIを説明します。

表41-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/

すべてのサービス・リクエストのリストを取得します。

41.6 サービス・リクエスト・コレクション

ServiceRequestCollectionは、すべてのアクセス可能なサービス・リクエスト・リソース(取消しまたは再スケジュールが可能)のクラウド管理者ビューを表すコレクション・リソースです。次の表で、ServiceRequestCollectionデータ・モデルについて説明します。

表41-25 ServiceRequestCollectionデータ・モデル

フィールド タイプ 発生 説明

name

文字列

1

このコレクション・リソースの名称が表示されます。

type

文字列

1

コレクション・リソースのタイプが表示されます。

hasMore

Boolean

1

コレクションに他の要素があるかどうかを示します。

count

整数

1

コレクション・リソースの要素数です。

items

コレクション<リクエスト>

1

ServiceRequestリソースのリストです。インスタンスがない場合、このリストは空白です。

totalCount

整数

1

リクエストの合計数。

canonicalLink

URI

1

このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。

selfLink

URI

1

これを含む要素と同等のリソースを参照します。

  前
前 		 次
次
  目次へ移動
目次		 索引へ移動
索引