| Oracle® Enterprise Manager Cloud管理ガイド 12c リリース5 (12.1.0.5) B70509-13 |
|
 前 |
 次 |
この章では、Database as a Service (DBaaS) REST APIの管理者フローのリソース・モデルとそのレスポンスについて説明します。この章の内容は次のとおりです。
次の表に、この章で説明するすべてのDBaaS管理者REST APIをまとめています。
表48-1 管理者DBaaS REST APIのサマリー
| リソース | データ・モデル | GET | POST | PUT | DELETE |
|---|---|---|---|---|---|
|
PaaSゾーン |
|
|
|
|
サポート対象外 |
|
PaaSゾーン |
|
|
サポート対象外 |
サポート対象外 |
|
|
ソフトウェア・プール群 |
|
|
|
|
サポート対象外 |
|
ソフトウェア・プール |
|
|
サポート対象外 |
サポート対象外 |
|
|
DBaaSリクエスト設定 |
|
|
|
サポート対象外 |
サポート対象外 |
|
DBaaS割当て制限 |
|
|
|
|
|
|
サービス・テンプレート群 |
|
|
|
サポート対象外 |
サポート対象外 |
|
サービス・テンプレート |
|
|
サポート対象外 |
サポート対象 |
|
|
注意: この表の「サポート」は、リソースに対してその操作がサポートされていることを示します。ただし、この章には操作の例は含まれません。 |
クラウド管理者は、DBaaS用のクラウド・インフラストラクチャの設定を行います。次の図にDBaaSクラウド設定の手順を示します。
例として、REST APIおよびEM CLI動詞(必要な場合)を使用してDBaaSを作成する段階的なプロセスを表48-2に示します。
|
注意: 次のプロセスでは、可能なかぎり、REST APIに対する参照を示します。ただし、EM CLI動詞を使用して同じ操作を行うことができます。対応するEM CLI動詞を確認するには、第10章「Database as a Service管理者用のEM CLI動詞」を参照してください。 |
表48-2 REST APIを使用したDBaaSの作成
| 手順 | 操作 |
|---|---|
|
1 |
PaaSインフラストラクチャ・ゾーンを作成します。 第48.3.1.3.3項「PaaSゾーンの作成」を参照してください。 注意: 既存のPaaSゾーンを表示するには、GET操作を行います。第48.3.1.3.1項「PaaSゾーン・リソースの詳細の表示」を参照してください。 |
|
2 |
次のデータベース・プールのいずれかを作成します。
注意: 既存のデータベース・プールを表示するには、GET操作を行います。第48.3.2.3.1項「ソフトウェア・プール群リソースの詳細の表示」を参照してください。 |
|
3 |
ユーザー・ロール用のDBaaSリクエスト設定を作成します。第48.3.3.4.2項「データベース・リクエスト設定の作成」を参照してください。 |
|
4 |
ユーザー・ロール用の割当て制限を作成します。第48.3.4.4.2項「ロール用のDBaaS割当て制限の作成」を参照してください。 注意: この手順はオプションです。 |
|
5 |
プロビジョニング用のソース・データベース情報を取得するプロファイルを作成します。第47章「Database as a Service管理者用のEM CLI動詞」を参照してください。 プロファイルは、完全なデータベースまたはアプリケーションを形成する一連の関連するスキーマを表すことができます。 |
|
6 |
選択したデータベース・プールに基づいて、次のいずれかのサービス・テンプレートを作成します。
|
これでDBaaSクラウドの設定は管理可能状態になりました。
この項では、クラウド管理者フロー用のすべてのREST APIについて説明します。この項のREST APIは、次のように分類されています。
この項のREST APIは、PaaSゾーン群REST APIとPaaSゾーンREST APIに分類されます。PaaSゾーンはPaaSインフラストラクチャ・ゾーンを意味しており、一方、PaaSゾーン群は、すべてのアクセス可能な個々のPaaSゾーン・リソースのグループに対するクラウド管理者のビューを意味するコレクション・リソースとなります。
この項の内容は次のとおりです。
PaaSゾーン群は、個々のPaaSゾーン・リソースすべてを集合的に表現したものです。PaaSゾーン群のメディア・タイプはapplication/oracle.com.cloud.common.PaaSZones+jsonです。
次の表に、PaaSゾーン群のデータ・モデルを示します。
表48-3 PaaSゾーン群のデータ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
このコレクション・リソースの名称が表示されます。 |
1 |
|
タイプ |
文字列 |
このコレクション・リソースのタイプ。 |
1 |
|
hasMore |
Boolean |
コレクションに他の要素があるかどうかを示します。 |
1 |
|
Count |
整数 |
返される要素の数。 |
1 |
|
Items |
コレクション<PaaSZone> |
PaaSゾーン・リソースのリストインスタンスが存在しない場合、アイテムは存在しますが空です。 |
1 |
|
totalCount |
整数 |
PaaSゾーン・リソースの総数 |
1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
1 |
|
selfLink |
URI |
これを含む要素と同等のリソースを参照します。 |
1 |
このリソースは、PaaSインフラストラクチャ・ゾーンを表します。PaaSゾーンのメディア・タイプはapplication/oracle.com.cloud.common.PaaSZone+jsonです。
次の表に、PaaSゾーンのデータ・モデルを示します。
表48-5 PaaSゾーンのデータ・モデル
| フィールド | Name | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
PaaSゾーンのユーザー用の名前。このフィールドは編集できません。 |
1 |
|
displayName |
文字列 |
PaaSゾーンの名前を表示します。 |
0..1 |
|
guid |
文字列 |
リソースを識別するPaaSゾーンの一意のGUID。 |
1 |
|
description |
文字列 |
PaaSゾーンの簡単な説明。 |
0..1 |
|
targetType |
文字列 |
作成するPaaSゾーンのターゲット・タイプ。 |
1 |
|
メンバー |
コレクション<members> |
PaaSゾーンのメンバー。これらは、あらかじめEMターゲットとして追加する必要があります。 |
1 |
|
credentials |
コレクション<PaaSzone_Credential> |
PaaSゾーンに関連付けられた資格証明。 |
1 |
|
placementConstraints |
コレクション<EntityValueHolder> |
クラウド管理者がリソース使用率の上限を設定できるようにする、PaaSゾーンの配置制約。 |
0..1 |
|
characteristics |
コレクション<EntityValueHolder> |
PaaSゾーンに関連付けられた特性。 |
1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、PaaSゾーンのクライアント表現がリフレッシュされます。 |
1 |
次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。
問合せパラメータ"type=self_service_zone"を使用してリソース・プロバイダ・リソースに対してGETリクエストを発行すると、そのPaaSゾーン群リソースにすでに存在している個々のPaaSゾーン群すべての詳細が与えられます。
表48-7 PaaSゾーン群リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders?type=self_service_zone |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"name": "Resource Providers",
"type": "Resource Provider",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders"
},
"totalResults": 1,
"cfwItems": [
{
"id": "15",
"name": "pzone1",
"type": "self_service_zone",
"guid": "A3CF2D49CFF3F3E664D073303EA51F8E",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/15"
}
},
{
"id": "16",
"name": "Test Zone 2",
"type": "self_service_zone",
"guid": "EF3830C71CC54B50B963376F9217AB95",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/16"
}
},
{
"id": "17",
"name": "test paas zone",
"type": "self_service_zone",
"guid": "5D7548C1B879A51CFD894CEA8D5FB19B",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/17"
}
},
{
"id": "18",
"name": "Test Zone",
"type": "self_service_zone",
"guid": "34405E0876B271E754B1A829BDFD06B9",
"canonicalLink": {
"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/18"
}
}
]
}
PaasZoneリソースに対してGETリクエストを発行して、その詳細を取得できます。PaaSゾーンに対するGETの構成を次に示します。
表48-8 PaaSゾーン群リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"name": "My Test Zone",
"type": "self_service_zone",
"memberTargetType": "host",
"members": [
"example.com"
],
"credentials": [
{ "name": "normal_credential_guid",
"value": "NC_HOST_2015-10-09-095917"}
],
"placementConstraints": [
{"name": "MAX_CPU_UTILIZATION",
"value": [ "80" ] },
{"name": "MAX_MEMORY_ALLOCATION",
"value": [ "80" ]}
],
"memberConstraints": [],
"characteristics": [
{ "name": "ORACLE.SYSMAN.CFW.SELF_SERVICE_ZONE",
"value": [ "34405E0876B271E754B1A829BDFD06B9" ] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"value": [] },
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"value": [] }
],
"canonicalLink": {"href": "https://example.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23"}
}
PaaSゾーンは、PaaSゾーン群コレクション・リソースへのPOSTリクエストにより作成されます。
PaaSゾーン群に対するPOSTの構成を次に示します。
表48-9 PaaSゾーンを作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{ "useExistingTarget": false,
"name": "My Test Zone",
"type": "self_service_zone",
"credentials": [
{ "name": "normal_credential_guid",
"value": "MY_ZONE_CREDS0afb3e85-f" }
],
"memberTargetType": "host",
"members": [ "example.com" ],
"placementConstraints": [
{ "name": "MAX_CPU_UTILIZATION",
"value": "90" }
] }
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Resource provider with name \"My Test Zone\" and type \"self_service_zone\" created successfully.",
"canonicalLink": {
"href": "https://example.com:44533/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23"
}
}
ペイロードを含むPUTリクエストにより、既存のPaaSインフラストラクチャ・ゾーンが更新されます。
PaaSゾーン群に対するPUTの構成を次に示します。
表48-10 PaaSゾーンを更新するためのPUTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{ "memberTargetType": "host",
"credentials": [
{"name": "normal_credential_guid",
"value": "NC_HOST_2015-10-09-095917" }
],
"placementConstraints": [
{"name": "MAX_CPU_UTILIZATION",
"value": [ "92" ] }
] }
|
|
リクエスト・メソッド |
PUT |
受け取るレスポンスの例を次に示します。
{
"message": "Resource provider with ID \"23\" updated successfully."
}
PaaSゾーンのURIに対してDELETEリクエストを発行して、PaaSゾーン・インスタンスを削除できます。次に、PaaSゾーンで削除するための構成を示します。
表48-11 PaaSゾーンを削除するためのDELETEリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/resourceproviders/23 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
|
本文 |
なし |
|
リクエスト・メソッド |
DELETE |
{
"message": "Resource provider with ID \"23\" deleted successfully."
}
この項の内容は次のとおりです。
ソフトウェア・プール群とは、アクセス可能な個々のソフトウェア・プール・リソースすべてに対するSSA管理者のビューを表すコレクション・リソースのことです。ソフトウェア・プール群のメディア・タイプはapplication/oracle.com.cloud.commom.SoftwarePools+jsonです。
次の表に、ソフトウェア・プール群のデータ・モデルを示します。
表48-12 ソフトウェア・プール群のデータ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
このコレクション・リソースの名称が表示されます。 |
1 |
|
タイプ |
文字列 |
このコレクション・リソースのタイプ。 |
1 |
|
hasMore |
Boolean |
コレクションに他の要素があるかどうかを示します。 |
1 |
|
Count |
整数 |
返される要素の数。 |
1 |
|
Items |
コレクション<PaaSZone> |
PaaSゾーン・リソースのリストインスタンスが存在しない場合、アイテムは存在しますが空です。 |
1 |
|
totalCount |
整数 |
PaaSゾーン・リソースの総数 |
1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
1 |
|
selfLink |
URI |
これを含む要素と同等のリソースを参照します。 |
1 |
ソフトウェア・プール・リソースは、PaaSインフラストラクチャ・ゾーン内のリクエストのサービスに使用される同種のサーバーまたはクラスタのコレクションを表します。ソフトウェア・プール内のすべてのメンバーは同じタイプであり、同じPaaSインフラストラクチャ・ゾーンに属している必要があります。ソフトウェア・プールのメディア・タイプはapplication/oracle.com.cloud.common.SoftwarPool+jsonです。
次の表に、ソフトウェア・プールのデータ・モデルを示します。
表48-14 ソフトウェア・プールのデータ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
ソフトウェア・プールのユーザー用の名前。 |
1 |
|
ID |
文字列 |
リソースを一意に識別するプールGUID。 |
1 |
|
説明 |
文字列 |
ソフトウェア・プールの簡単な説明。 |
0..1 |
|
poolTargetType |
文字列 |
作成するソフトウェア・プールのターゲット・タイプ。例: データベース・プールに対するoracle_cloud_zone、スキーマ・プールに対するschaas_pool、プラガブル・データベース・プールに対するpdbaas_pool。 |
1 |
|
paasZone |
文字列 |
このソフトウェア・プールに関連付けられているPaaSゾーンの名前。 |
1 |
|
メンバー |
コレクション<文字列> |
PaaSゾーンのメンバー。ホスト・メンバーまたはOracle VMゾーン・メンバーにできます。 |
1 |
|
memberType |
文字列 |
PaaSゾーンのメンバーのターゲット・タイプ。ホスト・メンバーの場合は「host」、Oracle VMゾーン・メンバーの場合は「oracle_vm_zone」にできます。 |
1 |
|
Constraints |
コレクション<Entity Value Holder> |
ソフトウェア・プールの配置ポリシー制約を使用することにより、セルフ・サービス管理者は、リソース使用率の上限を設定できます。 |
0..1 |
|
フィルタ |
コレクション<EntityValueHolder> |
設定条件によってソフトウェア・プールへのメンバー・ターゲットの追加を制限する、ソフトウェア・プール上のフィルタ。 |
1 |
|
Properties |
コレクション<文字列> |
特定のプール・ターゲット・タイプで指定する必要がある追加プロパティ。 |
1 |
|
membersToAdd |
コレクション<文字列> |
編集時に既存のソフトウェア・プールに追加するターゲット。 |
0..1 |
|
membersToRemove |
コレクション<文字列> |
編集時に既存のソフトウェア・プールから削除するターゲット。 |
0..1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
1 |
次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。
表48-16 ソフトウェア・プール群リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"name": "Software Pools",
"type": "Software Pool",
"hasMore": false,
"count": 4,
"items": [
{
"name": "SI Databases Zone",
"type": "oracle_cloud_zone",
"id": "EF658526512C5CFEF593EB295D0CFAD5",
"zoneName": "Salt Lake City Zone",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/EF658526512C5CFEF593EB295D0CFAD5"
},
{
"name": "Pluggable Databases Pool",
"type": "pdbaas_pool",
"id": "9FC634F035161C9260CD943970BAC1C8",
"zoneName": "Salt Lake City Zone",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/9FC634F035161C9260CD943970BAC1C8"
},
{
"name": "Primary DB Pool",
"type": "oracle_cloud_zone",
"id": "B1E3A8872D1A503DA1F1756CD18207B4",
"zoneName": "Salt Lake City II",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/B1E3A8872D1A503DA1F1756CD18207B4"
},
{
"name": "Standby DB Pool",
"type": "oracle_cloud_zone",
"id": "A5B6272EC680EFAB1B53842EC4256AAB",
"zoneName": "Salt Lake City II",
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/A5B6272EC680EFAB1B53842EC4256AAB"
}
],
"totalCount": 4,
"canonicalLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools",
"selfLink": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools"
}
ソフトウェア・プールURIに対してGETリクエストを発行して、その詳細を取得できます。
ソフトウェア・プールに対するGETの構成を次に示します。
表48-17 ソフトウェア・プール・リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"name":"DB_POOL",
"description":"Database Pool of Oracle Homes",
"type":"Database Zone",
"id":"E827809080C16F75E040F20A60511EA2",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/constraints",
"numberOfConstraints":"1"
},
"filters":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/properties",
"numberOfPropertiess":"0"
},
"createdOn":"2013-10-07 06:27:17",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2",
"selfLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2"
}
ソフトウェア・プール容量URIに対してGETリクエストを発行して、その詳細を取得できます。
次の表では、ソフトウェア・プール容量を表示するURIは、/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/C0DE0DEB3A8195A4707704360463060B/capacityです。ただし、これを変更して特定の問合せパラメータを追加し、必要な出力を表示できます。問合せパラメータおよびその説明を、次に示します:
showUsageSummary: プール・レベルのリソース使用量データが含まれます。値は、"yes"、"y"または"true"で、すべて大文字と小文字は区別されません。この値が指定されない場合、またはリストされた値ではない値が指定された場合、"usageSummary"はレスポンスで使用できません。
showMemberLevelUsage: プール・メンバー・レベルのリソース使用量データが含まれます。値は、"yes"、"y"または"true"で、すべて大文字と小文字は区別されません。この値が指定されない場合、またはリストされた値ではない値が指定された場合、"memberLevelUsage"はレスポンスで使用できません。
diskGroups: 記憶域計算のASMディスク名のリストを指定します。値が指定されない場合、記憶域値はレスポンスで使用できません。次で指定するリクエストURIの形式を使用すると、複数の値を指定できます:
diskGroups=<Value1>&diskGroups=<Value2>&...
cpuMemAveUtilDays: CPUおよびメモリー使用量の計算のために収集されたメトリックを含む日数を示します。値が指定されない場合、デフォルト値は7日間です。
ソフトウェア・プールに対するGETの構成を次に示します。
表48-18 ソフトウェア・プール容量の詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E284FAAA7FBA6A06F7090115A3E07299/capacity?showMemberLevelUsage=y&showUsageSummary=true&diskGroups=RECOC1&diskGroups=DATAC1&cpuMemAveUtilDays=3 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{"name":"DB Pool 1",
"type":"oracle_cloud_zone",
"poolInfo":
{"poolName":"DB Pool 1",
"poolId":"C0DE0DEB3A8195A4707704360463060B",
"poolDescription":"Exadata hosts Oracle Home",
"dbConfiguration":"Cluster Database",
"dbVersion":"12.1.0.2.0",
"paasZone":"zone1"}, "standByPools" :
[{"poolName":"Standby Pool 1",
"poolId":"6AF0F5A23BE120F4EAEC29236853D6B8",
"poolDescription":"Standby Oracle Home",
"dbConfiguration":"Cluster Database",
"dbVersion":"12.1.0.2.0",
"paasZone":"zone2"}],
"usageSummary":
{"numberOfDbs":"2",
"numberOfHosts":"2",
"cores":
{"total":"64",
"allocated":"8",
"available":"56",
"unit":"cores"},
"memory":
{"total":"504",
"allocated":"3.53",
"available":"500.47",
"unit":"GB"},
"storage":
{"total":"29073.24",
"allocated":"12765.99",
"available":"16307.25",
"unit":"GB"}},
"memberLevelUsage":
[{"host":"MyHost1.example.com",
"oracleHomeLocation":"/u01/app/oracle/product/12.1.0.2/dbhome_1",
"numberOfDbs":"1",
"cores":
{"total":"32",
"allocated":"4",
"available":"28",
"unit":"cores"},
"cpuUtilizationPercentage":"12.77",
"memory":
{"total":"251.99",
"allocated":"1.77",
"available":"250.23",
"unit":"GB"},
"memoryUtilizationPercentage":"59.66"},
{"host":"MyHost2.example.com",
"oracleHomeLocation":"/u01/app/oracle/product/12.1.0.2/dbhome_1",
"numberOfDbs":"1",
"cores":
{"total":"32",
"allocated":"4",
"available":"28",
"unit":"cores"},
"cpuUtilizationPercentage":"9.45",
"memory":
{"total":"251.99",
"allocated":"1.77",
"available":"250 .23",
"unit":"GB"},
"memoryUtilizationPercentage":"66.75"}],
"canonicalLink":"https://MyHost.example.com:4900/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/C0DE0DEB3A8195A4707704360463060B/capacity"}
データベース・プールを作成するには、ソフトウェア・プール・コレクション・リソースに対しPOST操作を発行します。
ソフトウェア・プール群に対するPOSTの構成を次に示します。
表48-19 データベース・プールを作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "DB_POOL",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"paasZone": "SLC01MDR_ZONE",
"members": [
"OraDb11g_home1_2_slc01mdr"
],
"serviceFamily": "DBAAS",
"serviceType": "DBAAS",
"constraints": {
"items": [
{"name": "MAX_INSTANCES",
"value": "10"}
]
},
"filters": {
"items": [
{"name": "CONFIGURATION",
"value": "oracle_database"},
{"name": "VERSION",
"value": "11.2.0.2.0"},
{"name": "PLATFORM",
"value": "226"}
]
},
"properties": {
"items": [
{"name": "host_credential_guid",
"value": "E84E88308E46A725E040F20A605125DD"},
{"name": "root_credential_guid",
"value": "E84E88308E46A725E040F20A605125DD"},
{"name": "standby_pools",
"value": "DB_POOL1| DB_POOL2"}
]
}
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"name":"DB_POOL",
"description":"Database Pool of Oracle Homes",
"type":"Database Zone",
"id":"E827809080C16F75E040F20A60511EA2",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/constraints",
"numberOfConstraints":"1"
},
"filters":{
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2/properties",
"numberOfPropertiess":"0"
},
"createdOn":"2013-10-07 06:27:17",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2",
"selfLink":"https://cloudcompany.com/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2"
}
データベース・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。
ソフトウェア・プール群に対するPUTの構成を次に示します。
表48-20 データベース・プールを更新するためのPUTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "DB_POOL",
"poolTargetType": "oracle_cloud_zone",
"description": "Database Pool of Oracle Homes",
"membersToAdd": [
"OraDb11g_home1_2_abc"],
"membersToRemove": [
"OraDb11g_home1_2_abc"],
"constraints":
{"items": [{"name": "MAX_INSTANCES", "value": "8"}]},
"properties":
{"items": [
{"name": "host_credential_guid", "value": "E84E88308E46A725E040F20A605125DD"},
{"name": "root_credential_guid", "value": "E84E88308E46A725E040F20A605125DD"},
{"name": "standby_pools", "value": "DB_POOL"}
]}
}
注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーが |
|
リクエスト・メソッド |
PUT |
受け取るレスポンスの例を次に示します。
Status 200 OK
Content-Type: application/json
{
message: "Software Pool " DB_POOL" updated successfully."
}
ソフトウェア・プールを作成するには、ソフトウェア・プール・コレクション・リソースに対しPOST操作を発行します。
ソフトウェア・プール群に対するPOSTの構成を次に示します。
表48-21 スキーマ・プールを作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "SCHEMA_POOL",
"poolTargetType": "schaas_pool",
"description": "Schema Service Pool",
"paasZone": "SLC01MDR_ZONE",
"members": ["simple.example.com"],
"serviceFamily":"DBAAS",
"serviceType":"SCHEMA",
"constraints":
{
"items": [
{"name": "MAX_SERVICES", "value": "20"},
{"name": "USE_WORKLOAD", "value": "true"},
{"name": "MAX_CPU_USAGE", "value": "90"},
{"name": "MAX_MEMORY_USAGE", "value": "90"},
{"name": "ENFORCE_CPU", "value": "true"}
]
},
"filters":
{
"items": [
{"name": "TARGET_TYPE","value": "oracle_database"},
{"name": "VERSION","value": "11.2.0.2.0"},
{"name": "PLATFORM","value": "226"}
]
}
}
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
Status 201 Created
Content-Type: application/json
{
"name":"SCHEMA_POOL",
"description":"Schema Service Pool",
"type":"Schema Pool",
"id":"2CFF36A9E92AAD533253871374857D8C",
"zoneName":"SLC01MDR_ZONE",
"members":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/members",
"numberOfPoolMembers":"1"},
"constraints":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/constraints",
"numberOfConstraints":"5"},
"filters":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/filters",
"numberOfFilters":"3"},
"properties":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C/properties",
"numberOfPropertiess":"0"},
"createdOn":"2013-10-07 08:13:48",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C",
"selfLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/2CFF36A9E92AAD533253871374857D8C"
}
ソフトウェア・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。
ソフトウェア・プール群に対するPUTの構成を次に示します。
表48-22 スキーマ・プールを更新するためのPUTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "SCHEMA_POOL",
"poolTargetType": "schaas_pool",
"description": "Schema Service Pool",
"membersToAdd": [
"xyxy.example.com"],
"membersToRemove": [
"simple.us.example.com"],
"constraints":
{
"items": [
{"name": "MAX_SERVICES", "value": "10"},
{"name": "USE_WORKLOAD", "value": "false"},
{"name": "MAX_CPU_USAGE", "value": "90"},
{"name": "MAX_MEMORY_USAGE", "value": "90"},
{"name": "ENFORCE_CPU", "value": "false"}
]
},
}
注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーが |
|
リクエスト・メソッド |
PUT |
受け取るレスポンスの例を次に示します。
Status 200 OK
Content-Type: application/json
{
message: "Software Pool "SCHEMA_POOL" updated successfully.
}
ソフトウェア・プールを作成するには、ソフトウェア・プール群コレクション・リソースに対してPOST操作を発行します。次に、ソフトウェア・プール群にPOSTするための構成を示します。
表48-23 プラガブル・データベース・プールを作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "PDB_POOL",
"poolTargetType": "pdbaas_pool",
"description": "Pluggable Database Pool",
"paasZone": "PDB_ZONE",
"members": ["database"],
"serviceFamily":"DBAAS",
"serviceType":"PDB",
"constraints":
{
"items": [
{"name": "MAX_PDB_SERVICES", "value": "20"},
{"name": "PDBS_USE_WORKLOAD", "value": "true"},
{"name": "MAX_CPU_USAGE_BY_PDBS", "value": "90"},
{"name": "MAX_MEMORY_USAGE_BY_PDBS", "value": "90"},
{"name": "PDBS_ENFORCE_CPU", "value": "true"}
]
},
"filters":
{
"items": [
{"name": "TARGET_TYPE_CDB","value": "oracle_database"},
{"name": "VERSION_CDB","value": "12.1.0.1.0"},
{"name": "PLATFORM_CDB","value": "226"}
]
}
}
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
Status 201 Created
Content-Type: application/json
{
"name":"PDB_POOL",
"description":"Pluggable Database Pool",
"type":"Pdb Pool",
"id":"E82952BD4C94D443E040F20A605114E6",
"zoneName":"PDB_ZONE",
"members":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/members",
"numberOfPoolMembers":"1"
},
"constraints":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/constraints",
"numberOfConstraints":"5"
},
"filters":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/filters",
"numberOfFilters":"3"
},
"properties":{
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6/properties",
"numberOfPropertiess":"0"},
"createdOn":"2013-10-07 08:29:51",
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6",
"selfLink":"https://xyxy.example.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E82952BD4C94D443E040F20A605114E6"
}
ソフトウェア・プールを更新するには、ソフトウェア・プール・コレクション・リソースに対しPUT操作を発行します。
ソフトウェア・プール群に対するPUTの構成を次に示します。
表48-24 プラガブル・データベース・プールを更新するためのPUTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "PDB_POOL",
"poolTargetType": "pdbaas_pool",
"description": "Pluggable Database Pool",
"membersToAdd": [
"simple.us.example.com"],
"membersToRemove": [
"simple1.us.example.com"],
"constraints":
{
"items": [
{"name": "MAX_PDB_SERVICES", "value": "10"},
{"name": "PDBS_USE_WORKLOAD", "value": "false"},
{"name": "MAX_CPU_USAGE_BY_PDBS", "value": "90"},
{"name": "MAX_MEMORY_USAGE_BY_PDBS", "value": "90"},
{"name": "PDBS_ENFORCE_CPU", "value": "false"}
]
},
}
注意: リクエストの発行中に、プールの一部として少なくともメンバーが1つ残るようにしてください。すべてのメンバーが |
|
リクエスト・メソッド |
PUT |
受け取るレスポンスの例を次に示します。
Status 200 OK
Content-Type: application/json
{
message: "Software Pool "PDB_POOL" updated successfully."
}
SoftwarePoolインスタンスを削除するには、データベース・プールのURIに対してDELETEリクエストを発行します。ソフトウェア・プールを削除する構成を次に示します。
表48-25 データベース/スキーマ/プラガブル・データベース・プールを削除するためのDELETEリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/softwarepools/E827809080C16F75E040F20A60511EA2 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
|
本文 |
なし |
|
リクエスト・メソッド |
DELETE |
受け取るレスポンスの例を次に示します。
Status 200 OK
Content-Type: application/json
{
message: "Software Pool " E827809080C16F75E040F20A60511EA2" deleted successfully."
}
この項では、データベース・リクエスト設定のためのRESTリクエスト/レスポンス相互作用について説明します。
|
注意: リクエスト設定REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.7.0以上でのみサポートされます。 |
この項では、次のトピックについて説明します。
クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(データベース・リクエスト設定など)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。データベース・リクエスト設定は、インスタンスの存在しないクラウド・リソースです。次の各項では、データベース・リクエスト設定REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。
Dbaasリクエスト設定はクラウド・リソースを拡張します。サービス・インスタンスに関連するデータベース・リクエスト設定を記述します。Dbaasリクエスト設定のメディア・タイプはapplication/oracle.com.cloud.common.DbaasRequestSettings+jsonです。
次の表に、Dbaasリクエスト設定のデータ・モデルを示します。
表48-26 DBaaSリクエスト設定データ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
uri |
URI |
このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。 |
1 |
|
name |
文字列 |
テンプレートのユーザー用の名前。 |
1 |
|
description |
文字列 |
テンプレートの簡単な説明 |
1 |
|
resource_state |
ResourceState |
リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。 |
1 |
|
media_type |
文字列 |
サービス・テンプレートのメディア・タイプ。 |
1 |
|
service_family_type |
文字列 |
Dbaas |
1 |
|
canonicalLink |
URI |
GETおよびPOSTなどのクラウド相互作用の実行に使用できます。 |
1 |
|
RequestSettings |
文字列 |
現在のデータベース・リクエスト設定。 |
1 |
次の表に、データベース割当て制限サービス・リソースでサポートされるすべての操作を示します。
次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。
次の表に、DBaaSリクエスト設定リソースの詳細を表示するためのREST API構成を示します。
表48-28 DBaaSリクエスト設定リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/requestsettings |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"uri" : "/em/cloud/dbaas/requestsettings" ,
"name" : "Dbaas Request Settings" ,
"description" : "Dbaas Request settings" ,
"resource_state" : {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasRequestSettings+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/requestsettings" ,
"Request Settings" : {
"futureReservationLength" : "No Reservation" ,
"defaultRetirementPeriod" : "No Reservation" ,
"maximumArchiveDuration" : "No Reservation"
}
}
この項では、クラウド・リソースを使用したリクエスト設定の作成方法について説明します。
DbaasRequestSettingsに対するPOSTの構成を次に示します。
表48-29 DBaaSリクエスト設定を作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/requestsettings |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/oracle.com.cloud.common.DbaasRequestSettings+json Accept: application/oracle.com.cloud.common.DbaasRequestSettings+json |
|
本文 |
{
"future_reservation_length" : "2 Months",
"maximum_archive_duration" : "10 Weeks",
"default_retirement_period" : "No Reservation"
}
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"uri" : "/em/cloud/dbaas/requestsettings" ,
"name" : "Dbaas Request Settings" ,
"description" : "Dbaas Request settings" ,
"resource_state" : {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T09:13:03+0000" ,
"text" : "Request settings have been updated."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasRequestSettings+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/requestsettings"
}
この項では、割当て制限を設定するためのRESTリクエスト/レスポンス相互作用について説明します。
|
注意: 割当て制限REST APIは、Oracle Cloud Applicationプラグイン・バージョン12.1.0.7.0以上でのみサポートされます。 |
この項では、次のトピックについて説明します。
クラウドのリソースは、共通サービス・エンティティで編成されており、特定のサービス(データベース割当て制限など)がこれらの共通サービス・エンティティを拡張することでリソースを提供しています。データベース割当て制限は、インスタンスの存在しないクラウド・リソースです。
次の各項では、データベース割当て制限REST APIでサポートされるリソースについて説明し、サポートされる操作の例を示します。
Dbaas割当て制限はクラウド・リソースを拡張します。すべてのロールに対する割当て制限設定を記述します。Dbaas割当て制限のメディア・タイプはapplication/oracle.com.cloud.common.DbaasQuota+jsonです。
次の表に、Dbaas割当て制限のデータ・モデルを示します。
表48-30 Dbaas割当て制限のデータ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
uri |
URI |
このURIに対してGETを実行すると、このユーザーがアクセスできるリソースのクライアント表現がリフレッシュされます。 |
1 |
|
name |
文字列 |
テンプレートのユーザー用の名前。 |
1 |
|
description |
文字列 |
テンプレートの簡単な説明 |
1 |
|
resource_state |
文字列 |
リソース状態がREADYの場合のみ、フィールドのGETに対する有効性が保証される必要があります。そうでない場合、クライアントはフィールドの有効性を想定できません。 |
1 |
|
media_type |
文字列 |
このタイプが表すサービス・テンプレートのメディア・タイプ。 |
1 |
|
service_family_type |
文字列 |
Dbaas |
1 |
|
canonicalLink |
URI |
GETおよびPOSTなどのクラウド相互作用の実行に使用できます。 |
1 |
|
databases |
文字列 |
データベース使用状況レポート。 |
1 |
|
schema_services |
文字列 |
スキーマ・サービス使用状況レポート。 |
1 |
|
pluggable_databases |
文字列 |
プラガブル・データベース使用状況レポート。 |
1 |
|
memory |
文字列 |
メモリー使用状況レポート。 |
1 |
|
storage |
文字列 |
記憶域使用状況レポート。 |
1 |
|
割当て |
文字列 |
ロールに対する割当て設定の詳細。 |
1 |
次の表に、データベース割当て制限リソースでサポートされるすべての操作を示します。
次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。
表48-32 DBaaS割当て制限リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/quota |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" : {
"state" : "READY"
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota" ,
"databases" : {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"schema_services" : {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"pluggable_databases" : {
"quota" : "Unlimited" ,
"used" : "1" ,
"unit" : "Instance"
} ,
"memory" : {
"quota" : "Unlimited" ,
"used" : "0.79" ,
"unit" : "GB"
} ,
"storage" : {
"quota" : "Unlimited" ,
"used" : "3.38" ,
"unit" : "GB"
} ,
"Quotas" :
[
{
"Role Name" : "DBAAS_ROLE" ,
"Memory(GB)" : "99" ,
"Storage(GB)" : "99" ,
"Number of Database Requests" : "99" ,
"Number of Schema Service Requests" : "99" ,
"Number of Pluggable database Service Requests" : "99"
}
]
}
この項では、クラウド・リソースを使用したロールに対する割当ての作成方法および設定方法について説明します。
Dbaas割当て制限のPOSTの構成は次のとおりです。
表48-33 ロール用のDBaaS割当て制限を作成するためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/quota |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/oracle.com.cloud.common.DbaasQuota+json Accept: application/oracle.com.cloud.common.DbaasQuota+json |
|
本文 |
{
"role_name" : "DBAAS_ROLE",
"databases" : "10",
"schema_services" : "21",
"pluggable_databases" : "22",
"storage" : "99",
"memory" : "99"
}
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" : {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T08:58:48+0000" ,
"text" : "Quota for Role DBAAS_ROLE setup successfully."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}
この項では、クラウド・リソースを使用してロールにすでに設定されている割当て制限を更新する方法について説明します。DBaas割当て制限に対するPUTの構成を次の表に示します。
表48-34 ロール用のDBaaS割当て制限を更新するためのPUTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/quota |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/oracle.com.cloud.common.DbaasQuota+json Accept: application/oracle.com.cloud.common.DbaasQuota+json |
|
本文 |
{
"role_name" : "DBAAS_ROLE",
"databases" : "10",
"schema_services" : "21",
"pluggable_databases" : "22",
"storage" : "99",
"memory" : "99"
|
|
リクエスト・メソッド |
PUT |
受け取るレスポンスの例を次に示します。
{
"uri" : "/em/cloud/dbaas/quota" ,
"name" : "Dbaas User Quota" ,
"description" : "User Quota for the user" ,
"resource_state" : {
"state" : "READY" ,
"messages" :
[
{
"date" : "2013-08-27T09:01:56+0000" ,
"text" : "Quota for Role DBAAS_ROLE updated successfully."
}
]
} ,
"media_type" : "application/oracle.com.cloud.common.DbaasQuota+json" ,
"service_family_type" : "dbaas" ,
"canonicalLink" : "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}
この項では、クラウド・リソースを使用してロールに設定されている割当て制限を削除する方法について説明します。DBaas割当て制限に対する削除の構成を次に示します。
表48-35 ロール用のDBaaS割当て制限を削除するためのDELETEリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/cloud/dbaas/quota |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/oracle.com.cloud.common.DbaasQuota+json Accept: application/oracle.com.cloud.common.DbaasQuota+json |
|
本文 |
{
"role_name" : "SSA_USER_ROLE"
}
|
|
リクエスト・メソッド |
DELETE |
受け取るレスポンスの例を次に示します。
{
"uri": "/em/cloud/dbaas/quota",
"name": "Dbaas User Quota",
"description": "User Quota for the user",
"resource_state": {
"state": "READY",
"messages": [
{
"text": "Quota for Role SSA_USER_ROLE deleted successfully.",
"date": "2015-12-08T07:18:08+0000"
}
]
},
"media_type": "application/oracle.com.cloud.common.DbaasQuota+json",
"service_family_type": "dbaas",
"canonicalLink": "/em/websvcs/restful/extws/cloudservices/service/v0/ssa/em/cloud/dbaas/quota"
}
この項の内容は次のとおりです。
サービス・テンプレートは、すべてのアクセス可能なサービス・テンプレート・リソースのクラウド管理者ビューを表すコレクション・リソースです。サービス・テンプレート群のメディア・タイプはapplication/oracle.com.cloud.common.ServiceTemplates+jsonです。
次の表では、サービス・テンプレート群のデータ・モデルについて説明します。
表48-36 サービス・テンプレート・データ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
このコレクション・リソースの名称が表示されます。 |
1 |
|
タイプ |
文字列 |
このコレクション・リソースのタイプ。 |
1 |
|
hasMore |
Boolean |
コレクションに他の要素があるかどうかを示します。 |
1 |
|
Count |
整数 |
返される要素の数。 |
1 |
|
Items |
コレクション<ServiceTemplate> |
このコレクションの要素。 |
1 |
|
totalCount |
整数 |
PaaSゾーン・リソースの総数 |
1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
1 |
|
selfLink |
URI |
これを含む要素と同等のリソースを参照します。 |
1 |
サービス・テンプレートは、セルフ・サービス・ユーザーがサービス・インスタンスをプロビジョニングするときに使用できる、標準化されたサービスの定義です。サービス・テンプレートのメディア・タイプはapplication/oracle.com.cloud.common.ServiceTemplate+jsonです。
次の表では、サービス・テンプレート・データ・モデルについて説明します。
表48-38 サービス・テンプレート・データ・モデル
| フィールド | タイプ | 説明 | 発生 |
|---|---|---|---|
|
Name |
文字列 |
ServiceTemplateのユーザー用の名前。 |
1 |
|
ID |
文字列 |
リソースを一意に識別するサービス・テンプレートID。 |
1 |
|
説明 |
文字列 |
ゾーンの簡単な説明。 |
0..1 |
|
canonicalLink |
URI |
このURIに対してGETを実行すると、このリソースのクライアント表現がリフレッシュされます。 |
1 |
|
serviceFamily |
文字列 |
サービス・ファミリ。 |
1 |
|
serviceType |
文字列 |
サービス・タイプ。 |
1 |
|
ロール |
コレクション<ロール> |
このサービス・テンプレートにアクセスできるSSAロール。 |
0..1 |
|
poolIds |
コレクション<文字列> |
このサービス・テンプレートに関連付けられたソフトウェア・プールID。 |
1 |
|
createdOn |
文字列(日付/時刻) |
リソースが作成された日時。 |
0..1 |
|
createdBy |
文字列 |
リソースを作成したユーザー。 |
1 |
|
modifiedOn |
文字列(日付/時刻) |
リソースが最後に変更された日時。 |
0..1 |
|
rolesToRemove |
コレクション<文字列> |
PaaSゾーンの編集時に削除するSSAロール。 |
0..1 |
次の各項では、Enterprise Manager Cloud Control 12.1.0.3とクラウド・アプリケーション・プラグイン12.1.0.7以上との相互作用の例を示します。次の例について説明します。
GETリクエストの構成を次の表に示します。
表48-40 サービス・テンプレート群リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/ cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"name": "Service Templates",
"type": "Service Template",
"totalResults": 5,
"cfwItems": [
{
"id": "1",
"name": "Database Creation on Individual Hosts",
"guid": "203D5C842C2C17C3E053C075B10A73E3",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/1"
}
},
{
"id": "21",
"name": "Create Databases on 12_1_0_1_x",
"guid": "204E31F679D421E8E053C075B10A409A",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/21"
}
},
{
"id": "81",
"name": "Create Databases on Clusters - Based on DB Template",
"guid": "2068CDF3C0200D7CE053C075B10A7811",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/81"
}
},
{
"id": "61",
"name": "RMAN ST",
"guid": "205046BB4D38762EE053C075B10AF091",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"
}
},
{
"id": "41",
"name": "Database Creation on Cluster",
"guid": "204F067E22C12CFDE053C075B10A8A26",
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/41"
}
}
],
"canonicalLink": {
"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates"
}
}
ServiceTemplate URIに対してGETリクエストを発行して、その詳細を取得できます。次に、ServiceTemplateにGETするための構成を示します。
表48-41 サービス・テンプレート・リソースの詳細を表示するためのGETリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
なし |
|
リクエスト・メソッド |
GET |
受け取るレスポンスの例を次に示します。
{
"id": "61",
"guid": "205046BB4D38762EE053C075B10AF091",
"name": "RMAN ST",
"displayName": "RMAN ST",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"createdOn": "2015-09-22T05:32:07Z",
"createdBy": "SYSMAN",
"modifiedOn": "2015-09-22T05:32:07Z",
"owner": "SYSMAN",
"lastModified": "2015-09-22T05:32:07Z",
"payloads": [
{ "name": "SERVICE_TEMPLATE_PROV_SOURCE",
"value": null,
"required": null},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:204D498A85D42C6AE053C075B10A6B09:0.1",
"required": null},
{"name": "DBDELETE_PRESCRIPT",
"value": null,
"required": null},
{"name": "DBDELETE_POSTSCRIPT",
"value": null,
"required": null}
],
"characteristics": [
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"displayName": "Downtime Contact",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"editable": true,
"visible": true},
{ "name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE",
"displayName": "Provisioning Type",
"values": ["RMAN"],
"required": false,
"editable": false,
"visible": false}
],
"resourceProvider": {
"lookupCharacteristics": [
{
"purposeId": 1,
"characteristics": [
{ "name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"displayName": "oracle.sysman.ssa.oracle_cloud_zone",
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"},
"targets": [
{ "guid": "0CAF930826EDE90D8072E4E3ACA8072A",
"displayName": "RAC Databases Pool _11_2_0_4" }
]
}
]
}
]
},
"configurations": [
{ "name": "ssaUser",
"type": "STRING",
"value": "",
"displayName": "ssaUser",
"required": false,
"secret": false},
{ "name": "STANDBY_WORK_DIR",
"type": "STRING",
"value": "",
"displayName": "STANDBY_WORK_DIR",
"required": false,
"secret": false},
{ "name": "SID_OPTION",
"type": "STRING",
"description": "Database SID Option to be used. values are ssauser/prefix",
"value": "prefix",
"displayName": "Database SID Option",
"required": false,
"secret": false},
{ "name": "PROFILE_VERSION",
"type": "STRING",
"description": "Profile version to use",
"value": "latest",
"displayName": "Profile version",
"required": false,
"secret": false},
{ "name": "DB_TARGET_DISPLAY_NAME",
"type": "STRING",
"value": "",
"displayName": "DB_TARGET_DISPLAY_NAME",
"required": false,
"secret": false},
{ "name": "REF_TGT",
"type": "STRING",
"value": "xxy.example.com",
"displayName": "REF_TGT",
"required": false,
"secret": false},
{ "name": "USER_PRIVILEGES",
"type": "STRING",
"description": "Comma Seperated List of privileges that will be applied on role assigned to the master account.",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY",
"displayName": "User Privileges",
"required": false,
"secret": false},
{ "name": "COMMON_DB_SID",
"type": "STRING",
"description": "Database SID Prefix",
"value": "rmanri",
"displayName": "Database SID Prefix",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_STANDBY_CUSTOM_PRE_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the standby custom post sql script",
"value": "",
"displayName": "URN of the standby pre sql custom script",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_STANDBY_CUSTOM_POST_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the standby custom post sql script",
"value": "",
"displayName": "URN of the standby post sql custom script",
"required": false,
"secret": false},
{ "name": "ssaTargetName",
"type": "STRING",
"value": "",
"displayName": "ssaTargetName",
"required": false,
"secret": false},
{ "name": "DB_USER_NAMES",
"type": "STRING",
"description": "Database users from source",
"value": "",
"displayName": "Database Users from source",
"required": false,
"secret": false},
{ "name": "ssaTargetType",
"type": "STRING",
"value": "",
"displayName": "ssaTargetType",
"required": false,
"secret": false},
{ "name": "RAC_ONE_SERVICE_NAME",
"type": "STRING",
"description": "The name of service for RAC One Node database.",
"value": "",
"displayName": "RAC One Service Name",
"required": false,
"secret": false},
{ "name": "RUN_AS_USER",
"type": "STRING",
"value": "sys",
"displayName": "RUN_AS_USER",
"required": false,
"secret": false},
{ "name": "NONADMIN_SSA_ACC_DB_USER_NAMES",
"type": "STRING",
"description": "Database users from source",
"value": "OUTLN,ORACLE_OCM,APPQOSSYS,WMSYS,EXFSYS,CTXSYS,XDB,ORDSYS,ORDDATA,ORDPLUGINS,SI_INFORMTN_SCHEMA,MDSYS,OLAPSYS,SYSMAN,APEX_030200,FLOWS_FILES,SCOTT,OWBSYS_AUDIT,OWBSYS",
"displayName": "Database Users from source",
"required": false,
"secret": false},
{ "name": "INIT_PARAMS",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "INIT_PARAMS",
"required": false,
"secret": false,
"values": [
"*.db_block_size=8192",
"*.audit_trail='db'",
"*.db_name='mdb00008'",
"*.cpu_count=0",
"myracdb1.__sga_target=1275068416",
"*.diagnostic_dest='/u01/app/emga/11.2.0.4'",
"*.control_files='/oradbnas/mdb00008/controlfile/control01.ctl','/oradbnas//mdb00008/controlfile/control02.ctl'",
"*.audit_file_dest='/u01/app/emga/11.2.0.4/admin/mdb00008/adump'",
"*.pga_aggregate_target=423624704",
"*.processes=150",
"*.db_create_file_dest='/oradbnas/mdb00008'",
"*.db_recovery_file_dest='/oradbnas//mdb00008'",
"*.log_archive_format='%t_%s_%r.dbf'",
"*.compatible='11.2.0.4.0'",
"*.db_recovery_file_dest_size=2097152000",
"*.open_cursors=300",
"*.remote_login_passwordfile='exclusive'",
"*.undo_tablespace='UNDOTBS01'",
"*.db_domain=''"
]},
{ "name": "COMMON_DB_DBSNMP_PASSWORD",
"type": "STRING",
"description": "DBSNMP Account password",
"value": "welcome1",
"displayName": "DBSNMP Account password",
"required": false,
"secret": true},
{ "name": "DB_ADMIN_PASSWORD_SAME",
"type": "STRING",
"description": "Use the same passwords for SYS, SYSTEM and DBSNMP account",
"value": "true",
"displayName": "Use the same passwords for SYS, SYSTEM and DBSNMP account",
"required": false,
"secret": false},
{ "name": "DEFAULT_DATABASE_SIZE",
"type": "STRING",
"value": "",
"displayName": "DEFAULT_DATABASE_SIZE",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_CUSTOM_PRE_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the custom post sql script",
"value": "",
"displayName": "URN of the pre sql custom script",
"required": false,
"secret": false},
{ "name": "RUN_AS_USER_PWD",
"type": "STRING",
"value": "",
"displayName": "RUN_AS_USER_PWD",
"required": false,
"secret": false},
{ "name": "IS_RAC_ONE",
"type": "STRING",
"description": "Boolean value to show RAC One Target Type, (true/false)",
"value": "N",
"displayName": "RAC One Target Type",
"required": false,
"secret": false},
{ "name": "PROFILE_VERSION_URN",
"type": "STRING",
"description": "Profile Version Selected by user for creating database.",
"value": "",
"displayName": "Profile Version Selected",
"required": false,
"secret": false},
{ "name": "HOSTS_FOR_PLACEMENT",
"type": "STRING",
"description": "Comma separated value of the name of hosts which will be used for the custom placement of the requested database instance. This list of hosts should have their database homes present in the selected zone and pool of the service template.",
"value": "",
"displayName": "Host(s) name to be selected in the DB pool for custom placement",
"required": false,
"secret": false},
{ "name": "PROVISIONING_TYPE",
"type": "STRING",
"value": "",
"displayName": "PROVISIONING_TYPE",
"required": false,
"secret": false},
{ "name": "STANDBY_REQUIRED_LOCK",
"type": "STRING",
"value": "",
"displayName": "STANDBY_REQUIRED_LOCK",
"required": false,
"secret": false},
{ "name": "LOCK_DOMAIN_NAME",
"type": "STRING",
"description": "Accepts Database Domain Name from SSA user",
"value": "false",
"displayName": "Accepts the database Domain Name from SSA user ",
"required": false,
"secret": false},
{ "name": "ROLE_NAME",
"type": "STRING",
"description": "Name of the database role which will assigned to the master account.",
"value": "ROLE_Sep_22_2015_11_01_AM",
"displayName": "Database Role Name",
"required": false,
"secret": false},
{ "name": "STANDBY_DATABASE_MASTER",
"type": "STRING",
"value": "",
"displayName": "STANDBY_DATABASE_MASTER",
"required": false,
"secret": false},
{ "name": "ASM_DSKGRP_PREFIX",
"type": "STRING",
"description": "ASM Diskgroup prefix to be used for all the new diskgroups to be created",
"value": "",
"displayName": "ASM Diskgroup Prefix for all new diskgroups",
"required": false,
"secret": false},
{ "name": "DB_USER_PASSWORDS",
"type": "STRING",
"description": "Passwords for Database users from source",
"displayName": "Passwords for Database Users from source",
"required": false,
"secret": true},
{ "name": "ASM_OPTION",
"type": "STRING",
"description": "ASM Diskgroup Option to be used. values are ssauser/prefix",
"value": "",
"displayName": "ASM Diskgroup Option",
"required": false,
"secret": false},
{ "name": "SELECT_ORACLE_HOME_OPTION",
"type": "STRING",
"description": "Option for selecting the DB Oracle Home that includes runtime selection or user selection. Possible values are SELECT_ORACLE_HOME_AT_RUNTIME or SELECT_ORACLE_HOME_FROM_REQUEST",
"value": "SELECT_ORACLE_HOME_AT_RUNTIME",
"displayName": "Option for selecting the DB Oracle home",
"required": false,
"secret": false},
{ "name": "LISTENER_PORT",
"type": "STRING",
"description": "Listener Port (required only for Single Instance Database)",
"value": "1524",
"displayName": "Listener Port",
"required": false,
"secret": false},
{ "name": "STANDBY_DB_MASTER_DETAILS",
"type": "VECTOR",
"displayName": "STANDBY_DB_MASTER_DETAILS",
"required": false,
"secret": false,
"values": []},
{ "name": "COMMON_DOMAIN_NAME",
"type": "STRING",
"description": "Database Domain Name",
"value": "us.example.com",
"displayName": "Database Domain Name",
"required": false,
"secret": false},
{ "name": "WORKLOADS",
"type": "VECTOR",
"displayName": "WORKLOADS",
"required": false,
"secret": false},
{ "name": "STANDBY_COMMON_DB_SID",
"type": "STRING",
"value": "",
"displayName": "STANDBY_COMMON_DB_SID",
"required": false,
"secret": false},
{ "name": "LIVE_CLONE_DATABASE_GUID",
"type": "STRING",
"description": "Database Guid to be cloned",
"value": "",
"displayName": "Database Guid to be cloned",
"required": false,
"secret": false},
{ "name": "COMMON_DB_SYSTEM_PASSWORD",
"type": "STRING",
"description": "SYSTEM Account password",
"value": "welcome1",
"displayName": "SYSTEM Account password",
"required": false,
"secret": true},
{ "name": "USER_INITIATED_BACKUP_LOCATION",
"type": "STRING",
"value": "",
"displayName": "USER_INITIATED_BACKUP_LOCATION",
"required": false,
"secret": false},
{ "name": "ssaRequestId",
"type": "STRING",
"value": "",
"displayName": "ssaRequestId",
"required": false,
"secret": false},
{ "name": "TARGET_PROP_LIST",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "TARGET_PROP_LIST",
"required": false,
"secret": false,
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]},
{ "name": "LIVE_CLONE_TYPE",
"type": "STRING",
"description": "Live Clone Type USE_FULLCLONE/USE_SNAPCLONE",
"value": "",
"displayName": "Type of Live Clone",
"required": false,
"secret": false},
{ "name": "REF_HOST",
"type": "STRING",
"value": "xxy.example.com",
"displayName": "REF_HOST",
"required": false,
"secret": false},
{ "name": "CUSTOM_TARGET_PROP_LIST",
"type": "VECTOR",
"description": "The list of initialization values that are as paramName=paramValue",
"displayName": "CUSTOM_TARGET_PROP_LIST",
"required": false,
"secret": false,
"values": []},
{ "name": "STANDBY_LISTENER_PORT",
"type": "STRING",
"value": "",
"displayName": "STANDBY_LISTENER_PORT",
"required": false,
"secret": false},
{ "name": "CLONE_OR_FULL_DB",
"type": "STRING",
"value": "",
"displayName": "CLONE_OR_FULL_DB",
"required": false,
"secret": false},
{ "name": "DATABASE_TYPE",
"type": "STRING",
"description": "Database Type (oracle_database/rac_database)",
"value": "rac_database",
"displayName": "Database Type",
"required": false,
"secret": false},
{ "name": "PROFILE_COMPONENT_URN",
"type": "STRING",
"description": "URN of the Profile component in software library with which the Database will be created",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:204D498A85D42C6AE053C075B10A6B09:0.1",
"displayName": "URN of the Profile Component to be used for Database Creation",
"required": false,
"secret": false},
{ "name": "VALIDATION_SQL",
"type": "STRING",
"description": "Sql script for primary database validation",
"value": "",
"displayName": "Sql script for primary database validation",
"required": false,
"secret": false},
{ "name": "REFRESH_DATABASE",
"type": "STRING",
"value": "",
"displayName": "REFRESH_DATABASE",
"required": false,
"secret": false},
{ "name": "REF_ZONE",
"type": "STRING",
"value": "Salt Lake City Zone",
"displayName": "REF_ZONE",
"required": false,
"secret": false},
{ "name": "STANDBY_DELAY_DATABASE_MASTER",
"type": "STRING",
"value": "",
"displayName": "STANDBY_DELAY_DATABASE_MASTER",
"required": false,
"secret": false},
{ "name": "zoneTargetName",
"type": "STRING",
"value": "",
"displayName": "zoneTargetName",
"required": false,
"secret": false},
{ "name": "PRIMARY_PROTECTION_MODE",
"type": "STRING",
"value": "",
"displayName": "PRIMARY_PROTECTION_MODE",
"required": false,
"secret": false},
{ "name": "INSTANCE_COUNT",
"type": "STRING",
"description": "Number of RAC Database instances required",
"value": "2",
"displayName": "Number of RAC instances",
"required": false,
"secret": false},
{ "name": "USER_PASSWORD",
"type": "STRING",
"description": "User Password to login to the given User Name database account",
"displayName": "User Password",
"required": true,
"secret": true},
{ "name": "MAX_BACKUPS_ALLOWED",
"type": "STRING",
"description": "The number of backups enabled for the Database",
"value": "",
"displayName": "Number of Backups allowed for the Database",
"required": false,
"secret": false},
{ "name": "ENTITY_TYPE",
"type": "STRING",
"description": "Entity TYpe USE_PROFILE/USE_DATABASE",
"value": "USE_PROFILE",
"displayName": "Entity Type",
"required": false,
"secret": false},
{ "name": "DBCREATE_POST_SQL_SCRIPT",
"type": "STRING",
"value": "",
"displayName": "DBCREATE_POST_SQL_SCRIPT",
"required": false,
"secret": false},
{ "name": "DBAAS_SSA_CUSTOM_POST_SCRIPTS_URN",
"type": "STRING",
"description": "Urn of the software library component which has the custom post sql script",
"value": "",
"displayName": "URN of the post sql custom script",
"required": false,
"secret": false},
{ "name": "USER_NAME",
"type": "STRING",
"description": "User Name (cannot be any of Oracle default accounts) used to login to the requested database",
"value": "",
"displayName": "User Name (cannot be any of Oracle default accounts)",
"required": true,
"secret": false},
{ "name": "DATABASE_SIZES",
"type": "VECTOR",
"displayName": "DATABASE_SIZES",
"required": false,
"secret": false,
"values": []},
{ "name": "ALLOW_BACKUPS",
"type": "STRING",
"description": "Should the backup be enabled for the Database",
"value": "",
"displayName": "Enable Backups for the Database",
"required": false,
"secret": false},
{ "name": "zoneTargetType",
"type": "STRING",
"value": "",
"displayName": "zoneTargetType",
"required": false,
"secret": false},
{ "name": "STANDBY_REQUIRED",
"type": "STRING",
"value": "false",
"displayName": "STANDBY_REQUIRED",
"required": false,
"secret": false},
{ "name": "STANDBY_DB_DETAILS",
"type": "VECTOR",
"displayName": "STANDBY_DB_DETAILS",
"required": false,
"secret": false,
"values": []},
{ "name": "COMMON_DB_SYS_PASSWORD",
"type": "STRING",
"description": "SYS Account password",
"value": "welcome1",
"displayName": "SYS Account password",
"required": false,
"secret": true},
{ "name": "REF_POOL",
"type": "STRING",
"value": "RAC Databases Pool _11_2_0_4",
"displayName": "REF_POOL",
"required": false,
"secret": false}
],
"canonicalLink": {"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"},
"selfLink": {"href": "https://xyz.example.com:4473/em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61"},
"active": true
}
DBCAベースのデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。
表48-42 DBCAベースのデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Create ST for SI Db using DBCA Template - ASM Subh_2",
"description": "Creates Single Instance DB",
"roles": [ "SSA_USER_ROLE" ],
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [ "byRscProvInst" ],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [ "137F74D7A8359A60762ED550341A5F47" ],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [ { "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" } ],
"configurations": [
{ "name": "REF_ZONE", "value": "Salt Lake City Zone" },
{ "name": "REF_POOL", "value": "SI Databases Pool_Oracle_DB_11g" },
{ "name": "REF_HOST", "value": "xyz.example.com" },
{ "name": "REF_TGT", "value": "xyz.example.com" },
{ "name": "DBCA_TEMPLATE:DB_STORAGE_TYPE", "value": "ASM" },
{ "name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES", "value": "Y" },
{ "name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE", "value": "4038" },
{ "name": "DBCA_TEMPLATE:DATA_FILE_LOCATION", "value": "DATA" },
{ "name": "DBCA_TEMPLATE:REDO_FILE_LOCATION", "value": "RECO" },
{ "name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE", "value": "Y" },
{ "name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION", "value": "RECO" },
{ "name": "DATABASE_TYPE", "value": "oracle_database" },
{ "name": "COMMON_DOMAIN_NAME", "value": "us.example.com" },
{ "name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE", "values": [ "DBCA_TEMPLATE" ] },
{ "name": "ENTITY_TYPE", "value": "USE_PROFILE" },
{ "name": "PROFILE_COMPONENT_URN", "value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:269BA6C90E6A5000E053C075B10A51A3:0.1" },
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{ "name": "SID_OPTION", "value": "ssauser" },
{ "name": "SELECT_ORACLE_HOME_OPTION", "value": "SELECT_ORACLE_HOME_AT_RUNTIME"},
{ "name": "COMMON_DB_SYS_PASSWORD", "value": "welcome"},
{ "name": "DB_ADMIN_PASSWORD_SAME", "value": "true" },
{ "name": "INIT_PARAMS", "values": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{ "name": "LISTENER_PORT", "value": "1521" },
{ "name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:xxxx:false:true",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:Testing:false:true",
"Line of Business:null:false:false"
]
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述のREST API bodyで:
これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。 |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"1C39F32393A709C3E053C075B10AEE15\" created successfully."
}
RMANベースの単一インスタンス・データベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。
表48-43 RMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Database Service - RMAN Based with archiving",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "sxy.us.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "CUSTOM_PRE_CREATE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"
},
{
"name": "CUSTOM_POST_CREATE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述のREST API bodyで:
これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。 |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"1C39F32393A709C3E053C075B10AEE15\" created successfully."
}
単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。
表48-44 単一インスタンス・スタンバイを含むRMANベースの単一インスタンス・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Database Service - RMAN Based with archiving with SI Standby",
"description": "This creates Database Archiving log mode.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"1898CF93BD39C19BF032672271BC4B44"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
}
],
"configurations": [
{
"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_FROM_REQUEST"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_ZONE",
"value": "Salt Lake City Zone"
},
{
"name": "zoneTargetName",
"value": "Salt Lake City Zone"
},
{
"name": "REF_POOL",
"value": "Databases Pool"
},
{
"name": "DATABASE_TYPE",
"value": "oracle_database"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "COMMON_DB_SID",
"value": "db"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
},
{
"name": "RMAN.DB_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_STORAGE_TYPE",
"value": "FS"
},
{
"name": "RMAN.FRA_SIZE",
"value": "4038"
},
{
"name": "RMAN.USE_ARCHIVING",
"value": "YES"
},
{
"name": "RMAN.DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"
},
{
"name": "RMAN.REDO_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.RECOVERY_FILE_LOCATION",
"value": "/scratch/emga/app/emga/fast_recovery_area"
},
{
"name": "RMAN.WORK_DIR_LOC",
"value": "/tmp/work"
},
{
"name": "RMAN.DB_ADMIN_PASSWORD_SAME",
"value": "Y"
},
{
"name": "RMAN.DATABASE_PASSWORDS",
"value": "welcome"
},
{
"name": "RMAN.BACKUP_LOCATION",
"value": "/scratch/emga/backups/rman/"
},
{
"name": "RMAN.USE_OFA",
"value": "N"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "STANDBY_DB_DETAILS",
"values": [
"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述のREST API bodyで:
これらのパラメータは必須で、参照ターゲットを識別してデータベースを作成するために必要です。 |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
RMANベースのRAC One Nodeデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。
表48-45 RMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Create Databases on RAC One database",
"description": "Creates Databases on RAC.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "abc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
スタンバイを含むRMANベースのRAC One Nodeデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。
次に示す例には、作成されたスタンバイが2つあります。片方のスタンバイRAC One NodeデータベースはプライマリRAC One Nodeデータベースと同じプールに作成されたNear DR(障害回復)で、もう片方のスタンバイFar DRデータベースは異なるプールに作成されたシングル・インスタンス・データベースです。データ保護のために2つのスタンバイ・データベースが作成される障害回復設定にとって、この設定は不可欠です。次に示すPOST bodyは、1つのスタンバイ・データベース(SIまたはRAC One Node)のみを持つように変更することもできます。
構成は次のとおりです。
表48-46 スタンバイを含むRMANベースのRAC One Nodeデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "RAC One Database Provisioning with RAC One Standby and SI Standby",
"description": "Creates RAC One Databases with RAC One Standby and SI Standby.",
"serviceType": "DB",
"serviceTemplateTypeId": "81",
"rscProvAssocOption": [
"byRscProvInst"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"647E8750A1C3835557165B499B269FB3"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
],
"configurations": [
{"name": "STAGE_LOCATION",
"value": "/scratch/emga/backups/rman/"},
{"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"},
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name": "REF_TGT",
"value": "adc.example.com"},
{"name": "REF_HOST",
"value": "adc.example.com"},
{"name": "REF_ZONE",
"value": "Salt Lake City Zone"},
{"name": "zoneTargetName",
"value": "Salt Lake City Zone"},
{"name": "REF_POOL",
"value": "RAC Databases Pool"},
{"name": "DATABASE_TYPE",
"value": "rac_database"},
{"name": "IS_RAC_ONE",
"value": "Y"},
{"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome"},
{"name": "LISTENER_PORT",
"value": "1521"},
{"name": "PROFILE_VERSION",
"value": "latest"},
{"name": "COMMON_DB_SID",
"value": "db"},
{"name": "TARGET_PROP_LIST",
"values": [
"Contact:9980697299:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:null:false:false",
"Comment:null:false:false",
"Line of Business:null:false:false"
]
},
{"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name": "RMAN:DB_STORAGE_TYPE",
"value": "FS"},
{"name": "RMAN:FRA_SIZE",
"value": "4038"},
{"name": "RMAN:USE_ARCHIVING",
"value": "NO"},
{"name": "RMAN:DATA_FILE_LOCATION",
"value": "/scratch/emga/app/emga/oradata"},
{"name": "RMAN:WORK_DIR_LOC",
"value": "/tmp/work"},
{"name": "RMAN:DB_ADMIN_PASSWORD_SAME",
"value": "Y"},
{"name": "RMAN:DATABASE_PASSWORDS",
"value": "welcome"},
{"name": "RMAN:BACKUP_LOCATION",
"value": "/oradbnas/backups/rman/"},
{"name": "RMAN:USE_OFA",
"value": "N"},
{"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"},
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
スタンバイを含むRMANベースのRACデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。
単一インスタンス・スタンバイ・データベースを含むRACデータベースを作成する構成は、RAC One NodeスタンバイのあるRACデータベースの構成に類似しています。別のスタンバイを作成するためのペイロードの唯一の違いは、構成パラメータSTANDBY_DB_DETAILSにより定義されます。
RAC One Nodeスタンバイを含むRACデータベースの作成で使用するSTANDBY_DB_DETAILSパラメータのサンプル値を次に示します:
"pool=Near RAC DR Pool;databaseSIDPrefix=;databaseType=rac_database;isRACOne=Y;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com
一方、単一インスタンス・スタンバイを含むRACデータベースの作成で使用するSTANDBY_DB_DETAILSパラメータのサンプル値を次に示します:
"pool=Near DR Pool;databaseSIDPrefix=;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
次に示すサンプルのPOST構成は、単一インスタンス・スタンバイを含むRACデータベース用のサービス・テンプレートです。次のサンプルのSTANDBY_DB_DETAILSパラメータに、必要な値を適用します。
表48-47 単一インスタンス・スタンバイを含むRMANベースのRACデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name" : "Create Databases on RAC with SI Standby",
"description" : "Creates Databases on RAC.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "647E8750A1C3835557165B499B269FB3" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"},
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1E4F60D72C912160E053C075B10A29F5:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "adc.us.example.com"},
{"name" : "REF_HOST",
"value" : "adc.us.example.com"},
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"},
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"},
{"name" : "REF_POOL",
"value" : "RAC Databases Pool"},
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"},
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"},
{"name" : "LISTENER_PORT",
"value" : "1521"},
{"name" : "PROFILE_VERSION",
"value" : "latest"},
{"name" : "COMMON_DB_SID",
"value" : "db"},
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]},
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"},
{"name" : "RMAN:DB_STORAGE_TYPE",
"value" : "FS"},
{"name" : "RMAN:FRA_SIZE",
"value" : "4038"},
{"name" : "RMAN:USE_ARCHIVING",
"value" : "NO"},
{"name" : "RMAN:DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"},
{"name" : "RMAN:WORK_DIR_LOC",
"value" : "/tmp/work"},
{"name" : "RMAN:DB_ADMIN_PASSWORD_SAME",
"value" : "Y"},
{"name" : "RMAN:DATABASE_PASSWORDS",
"value" : "welcome"},
{"name" : "RMAN:BACKUP_LOCATION",
"value" : "/oradbnas/backups/rman/"},
{"name" : "RMAN:USE_OFA",
"value" : "N"},
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"},
{"name":"CUSTOM_PRE_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name":"CUSTOM_POST_CREATE_SCRIPTS_URN",
"value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},,
{"name": "STANDBY_REQUIRED",
"value": "true"},
{"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
DBCAテンプレートを使用して、スタンバイを含むRACデータベース・サービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します。
表48-48 DBCAテンプレートを使用したスタンバイを含むRACデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Create RAC Db with Standby using DBCA Template - BofA -ASM",
"description": "Service Template for Non-CDB; 12cR1_2(12.1.0.2); RAC; ASM",
"serviceType": "DB",
"serviceTemplateTypeId": "61",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSAUSERROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values": [
"4C5795E605D71F59BAF9F6AD702E25E1"
],
"targetType": {
"targetType": "oracle_cloud_zone",
"targetTypeName": "Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
}
],
"configurations": [
{
"name": "REF_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_POOL",
"value": "RAC Databases Pool_Oracle_DB_12c"
},
{
"name": "DBCA_TEMPLATE:DB_STORAGE_TYPE",
"value": "ASM"
},
{
"name": "DBCA_TEMPLATE:REC_STORAGE_TYPE_SAME_AS_DB_FILES",
"value": "Y"
},
{
"name": "DBCA_TEMPLATE:ARCHIVE_LOG_MODE",
"value": "N"
},
{
"name": "DBCA_TEMPLATE:FLASH_RECOVERY_AREA_SIZE",
"value": "4038"
},
{
"name": "DBCA_TEMPLATE:DATA_FILE_LOCATION",
"value": "DATA"
},
{
"name": "DBCA_TEMPLATE:REDO_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DBCA_TEMPLATE:RECOVERY_FILE_LOCATION",
"value": "DATA1"
},
{
"name": "DATABASE_TYPE",
"value": "rac_database"
},
{
"name": "INSTANCE_COUNT",
"value": "2"
},
{
"name": "COMMON_DOMAIN_NAME",
"value": "us.example.com"
},
{
"name": "ORACLE.SYSMAN.SSA.PROVISIONING_TYPE",
"values": [
"DBCA_TEMPLATE"
]
},
{
"name": "ENTITY_TYPE",
"value": "USE_PROFILE"
},
{
"name": "REF_TGT",
"value": "xyz.example.com"
},
{
"name": "SID_OPTION",
"value": "prefix"
},
{
"name": "PROFILE_COMPONENT_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246E84D11ED13BD0E050F90AE5852BC8:0.1"
},
{
"name": "PROFILE_VERSION",
"value": "latest"
},
{
"name": "USER_PRIVILEGES",
"value": "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE, CREATE ANY SEQUENCE, CREATE ANY INDEX, CREATE JOB, CREATE ANY MATERIALIZED VIEW, CREATE ANY TABLE, CREATE ANY TRIGGER, CREATE ANY TYPE, CREATE ANY VIEW, CREATE ANY SYNONYM, CREATE ANY DIRECTORY, SELECT ANY DICTIONARY"
},
{
"name": "COMMON_DB_SID",
"value": "RFTDB"
},
{
"name": "INIT_PARAMS",
"subconfigurations": [
"sga_target=1073741824",
"pga_aggregate_target=1073741824"
]
},
{
"name": "SELECT_ORACLE_HOME_OPTION",
"value": "SELECT_ORACLE_HOME_AT_RUNTIME"
},
{
"name": "COMMON_DB_SYS_PASSWORD",
"value": "welcome1"
},
{
"name": "DB_ADMIN_PASSWORD_SAME",
"value": "true"
},
{
"name": "LISTENER_PORT",
"value": "1521"
},
{
"name": "STANDBY_REQUIRED",
"value": "true"
},
{
"name": "STANDBY_DB_DETAILS",
"value": "",
"values": [
"pool=SI Databases Zone - Oracle 11g - Standby;databaseSIDPrefix=st;databaseType=oracle_database;standbyConfigName=Near DR;redoMode=ASYNC;realtimeQuery=false;databaseDelay=60;databaseUniqueName=;standbyStorageType=FS;standbyStorageLocation=;standbyFRAType=FS;standbyFRALocation=;standbyFRASize=;standbyLsnrPort=;domainName=us.example.com"
]
},
{
"name": "DATABASE_SIZES",
"values": [
"Big",
"Small"
]
},
{
"name": "DEFAULT_DATABASE_SIZE",
"value": "Big"
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxxx\" created successfully."
}
DNFSベースのデータベース・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。
サンプルのPOSTの構成を次に示します:
表48-49 DNFSベースのデータベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name" : "DB Clones",
"description" : "This clones a database based on NFS.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "1898CF93BD39C19BF032672271BC4B44" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"}
{"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:1C14BB2B2E127E23E053C075B10AE31F:0.1"}
{"name":"SELECT_ORACLE_HOME_OPTION",
"value":"SELECT_ORACLE_HOME_FROM_REQUEST"},
{"name" : "REF_TGT",
"value" : "abc.example.com"}
{"name" : "REF_HOST",
"value" : "abc.example.com"}
{"name" : "REF_ZONE",
"value" : "Salt Lake City Zone"}
{"name" : "zoneTargetName",
"value" : "Salt Lake City Zone"}
{"name" : "REF_POOL",
"value" : "Databases Pool"}
{"name" : "DATABASE_TYPE",
"value" : "oracle_database"}
{"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"}
{"name" : "LISTENER_PORT",
"value" : "1521"}
{"name" : "PROFILE_VERSION",
"value" : "latest"}
{"name" : "COMMON_DB_SID",
"value" : "db"}
{"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]}
{"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"}
{"name" : "DNFS.DATA_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/oradata"}
{"name" : "DNFS.REDO_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.RECOVERY_FILE_LOCATION",
"value" : "/scratch/emga/app/emga/fast_recovery_area"}
{"name" : "DNFS.FRA_SIZE",
"value" : "4038"}
{"name" : "DNFS.USE_ARCHIVING",
"value" : "YES"}
{"name" : "DNFS.WORK_DIR_LOC",
"value" : "/tmp/work"}
{"name" : "DNFS.DB_ADMIN_PASSWORD_SAME",
"value" : "Y"}
{"name" : "DNFS.BACKUP_LOCATION",
"value" : "/scratch/emga/backups/rman_image/"}
{"name" : "DNFS.USE_OFA",
"value" : "N"}
{"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"} ]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。
サンプルのPOSTの構成を次に示します:
表48-50 スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name" : "Create Snap Database using Snapshots",
"description" : "Creates Databases on SI hosts.",
"serviceType" : "DB",
"serviceTemplateTypeId" : "81",
"rscProvAssocOption" : [ "byRscProvInst" ],
"resourceProvider" : {
"lookupCharacteristics" : [ {
"characteristics" : [ {
"name" : "ORACLE.SYSMAN.SSA.ORACLE_CLOUD_ZONE",
"values" : [ "503073C7912B1C65B66E240C433012A9" ],
"targetType" : {
"targetType" : "oracle_cloud_zone",
"targetTypeName" : "Database Pool",
"parentTargetType" : "self_service_zone",
"parentTargetTypeName" : "PaaS Infrastructure Zone"
}
} ],
"purposeId" : 1
} ]
},
"payloads" : [ {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
} ],
"configurations" : [ {
"name" : "STAGE_LOCATION",
"value" : "/scratch/emga/backups/rman/"
}, {
"name" : "PROFILE_COMPONENT_URN",
"value" : "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:247BF4B378FF253FE053C075B10A794A:0.1"
}, {
"name" : "REF_TGT",
"value" : "xyz.example.com"
}, {
"name" : "REF_HOST",
"value" : "xyz.example.com"
}, {
"name" : "REF_ZONE",
"value" : "Single Instances Zone"
}, {
"name" : "zoneTargetName",
"value" : "Single Instances Zone"
}, {
"name" : "REF_POOL",
"value" : "SI Databases Pool - Version 11_2_0_4"
}, {
"name" : "DATABASE_TYPE",
"value" : "oracle_database"
}, {
"name" : "COMMON_DB_SYS_PASSWORD",
"value" : "welcome"
}, {
"name" : "LISTENER_PORT",
"value" : "1521"
}, {
"name" : "PROFILE_VERSION",
"value" : "latest"
}, {
"name" : "COMMON_DB_SID",
"value" : "db"
}, {
"name" : "TARGET_PROP_LIST",
"values" : [ "Contact:9980697299:false:false", "Location:null:false:false", "LifeCycle Status:null:false:false", "Department:null:false:false", "Comment:null:false:false", "Line of Business:null:false:false" ]
}, {
"name" : "USER_PRIVILEGES",
"value" : "CREATE SESSION, ALTER SESSION, CREATE INDEXTYPE, CREATE ANY OPERATOR, CREATE ANY PROCEDURE"
}, {
"name" : "THIN_PROVISIONING:LISTENER_PORT",
"value" : "1522"
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_GROUP_COUNT",
"value" : "2"
}, {
"name" : "THIN_PROVISIONING:TEMP_TABLESPACE_SIZE",
"value" : "520"
}, {
"name" : "THIN_PROVISIONING:USE_ARCHIVING",
"value" : "YES"
}, {
"name" : "THIN_PROVISIONING:MOUNT_POINT_LIST",
"values" : [ "/hkdb" ]
}, {
"name" : "THIN_PROVISIONING:MOUNT_ADDL_SIZE_LIST",
"values" : [ "5.0" ]
}, {
"name" : "THIN_PROVISIONING:REDO_LOG_FILE_TYPE",
"value" : "Same as source"
}, {
"name" : "INIT_PARAMS",
"values" : [ "sga_target=1073741824", "pga_aggregate_target=1073741824" ]
}, {
"name" : "COMMON_DOMAIN_NAME",
"value" : "us.example.com"
} ]
}
注意:
|
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxx\" created successfully."
}
スナップ・クローン単一インスタンス・データベース用(アーカイブが無効)のサービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。
アーカイブが有効ではないスナップ・クローンのREST APIの構成値はすべて、THIN_PROVISIONING:USE_ARCHIVINGパラメータを除き、アーカイブが有効なスナップ・クローンのREST APIと同じです。スナップ・クローン単一インスタンス・データベース(アーカイブが無効)用のサービス・テンプレートを作成するには、表48-50「スナップ・クローン単一インスタンス・データベース用(アーカイブが有効)のサービス・テンプレートの作成のためのPOSTリクエスト構成」内で示すように、body内の"name" : "THIN_PROVISIONING:USE_ARCHIVING"が"value" : "No"に設定されている必要があります。
スキーマ・サービス・テンプレートを作成するには、サービス・テンプレートのコレクション・リソースに対してPOST操作を発行します。次に、ServiceTemplatesにPOSTするための構成を示します。
表48-51 スキーマ用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name":"TestSchaasTemplate3",
"serviceType":"SCHEMA",
"serviceFamily":"DBAAS",
"description":"This is a test schaas service template 1",
"poolIds":[ "9D3187DE6B1115791D71D2827FB98558" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{ "name":"ROLE_NAME", "value":"SampleRole" },
{ "name":"MAX_NUMBER_OF_SCHEMAS","value":"2" },
{ "name":"ENFORCE_STORAGE_CONSTRAINT","value":"NO_LIMIT" },
{ "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{ "name":"REF_ZONE","value":"ABC_ZONE" },
{ "name":"REF_POOL","value":"SCH_POOL" },
{ "name":"REF_HOST","value":"abc.mycompany.com" },
{ "name":"REF_DB","value":"simple.us.example.com" },
{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{ "name":"SCHAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{ "name":"SCHAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{
"name":"REMAP_TABLESPACE_LIST",
"value":"",
"values":["TBSP1","TBSP2","TBSP3"]
},
{
"name":"REMAP_TABLESPACE_INIT_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_INCR_SIZE_LIST",
"value":"",
"values":["TBSP1:0.1","TBSP2:0.2","TBSP3:0.3"]
},
{
"name":"REMAP_TABLESPACE_MAX_SIZE_LIST",
"value":"",
"values":["TBSP1:50.0","TBSP2:30","TBSP3:20"]
},
{ "name":"CREATE_SCHEMA_OPTION","value":"EMPTY_SCHEMAS" },
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name", "value":"large " },
{ "name":"description", "value":"large workload" },
{ "name":"default", "value":"Y" },
{ "name":"CPU", "value":"6" },
{ "name":"Memory", "value":"4048" },
{ "name":"Storage", "value":"2024" }
]
}
]
}
]
}
}
注意: SCHAAS_CUSTOM_PRE_SCRIPTS_URNおよびSCHAAS_CUSTOM_POST_SCRIPTS_URNのソフトウェア・ライブラリIDを取得するには、 Pre or Post Standby Database Script,0.1,Pre or Post Standby Database Script,Ready,Directives,,Production,ORACLE,,,oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1 |
|
リクエスト・メソッド |
POST |
受け取るレスポンスの例を次に示します。
{
"name": "TestSchaasTemplate3",
"serviceFamily": "DBAAS",
"serviceType": "SCHEMA",
"type": "Service Template",
"description": "This is a test schaas service template 1",
"id": "E87A364660A25B39E040F20A60510FDD",
"pools": [
{
"name": "SCH_POOL",
"id": "9D3187DE6B1115791D71D2827FB98558",
"type": "schaas_pool",
"zone": {
"id": "2F1E72A95EC21F8F666451B5413FF99A",
"name": "ABC_ZONE"
}
}
],
"roles": [
{
"name": "SSA_USER_ROLE1",
"description": null
}
],
"serviceExecutableMeta": {
"type": "CDP",
"configurations": [
{
"id": "targets",
"name": "targets",
"value": ""
},
{
"id": "ssaRequestId",
"name": "ssaRequestId",
"value": ""
},
{
"id": "ssaUser",
"name": "ssaUser",
"value": ""
},
{
"id": "ssaTargetName",
"name": "ssaTargetName",
"value": ""
},
{
"id": "ssaTargetType",
"name": "ssaTargetType",
"value": ""
},
{
"id": "zoneTargetName",
"name": "zoneTargetName",
"value": ""
},
{
"id": "zoneTargetType",
"name": "zoneTargetType",
"value": ""
},
{
"id": "REQUEST_NAME",
"name": "REQUEST_NAME",
"value": ""
},
{
"id": "SERV_TEMPLATE_GUID",
"name": "SERV_TEMPLATE_GUID",
"value": ""
},
{
"id": "CREATE_SCHEMA_OPTION",
"name": "Option for creating user schemas",
"value": "EMPTY_SCHEMAS"
},
{
"id": "MAX_NUMBER_OF_SCHEMAS",
"name": "Maximum number of schemas permissible",
"value": "2"
},
{
"id": "DB_PROFILE_URN",
"name": "Database Profile Component's URN",
"value": ""
},
{
"id": "REMAP_SCHEMA_LIST",
"name": "Schema list",
"value": "",
"values": []
},
{
"id": "MASTER_ACCOUNT",
"name": "Master Account",
"value": ""
},
{
"id": "ROLE_NAME",
"name": "Database Role Name",
"value": "TestSchaasTemplate3_Oct_11_"
},
{
"id": "SCHEMA_PRIVILEGES",
"name": "Schema Privileges",
"value": "",
"values": [
"CREATE TYPE",
"CREATE SEQUENCE",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE SESSION",
"CREATE SYNONYM",
"CREATE OPERATOR",
"CREATE VIEW",
"CREATE TABLE",
"CREATE TRIGGER",
"CREATE PROCEDURE"
]
},
{
"id": "ENFORCE_STORAGE_CONSTRAINT",
"name": "Enforces Storage Constraint",
"value": "false"
},
{
"id": "INITIAL_BLOCK_SIZE",
"name": "Initial Storage Size",
"value": ""
},
{
"id": "AUTO_EXTEND_BLOCK_SIZE",
"name": "Auto extend block size",
"value": ""
},
{
"id": "TABLESPACE_ENCRYPTION_ALGORITHM",
"name": "Tablespace Encryption",
"value": ""
},
{
"id": "SHARED_STAGE_LOCATION",
"name": "Staging Location",
"value": ""
},
{
"id": "WORKING_DIRECTORY",
"name": "Working Directory",
"value": ""
},
{
"id": "SCHAAS_CUSTOM_PRE_SCRIPTS_URN",
"name": "Pre-script",
"value": ""
},
{
"id": "SCHAAS_CUSTOM_POST_SCRIPTS_URN",
"name": "Post-script",
"value": ""
},
{
"id": "SCHEMA_PASSWORD_LIST",
"name": "Schema password list",
"value": "",
"values": []
},
{
"id": "CUSTOM_USER_SELECTED_SCRIPT_URN",
"name": "Custom Script URN",
"value": "",
"values": []
},
{
"id": "DBSERVICE_NAME",
"name": "Database Service Name",
"value": ""
}
]
},
"createdOn": null,
"createdBy": null,
"modifiedOn": null,
"modifiedBy": null,
"owner": "SYSMAN",
"etag": null,
"lastModified": null,
"canonicalLink": "https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD",
"selfLink": "https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD"
}
プラガブル・データベースのサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、ServiceTemplatesにPOSTするための構成を示します。
表48-52 プラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name":"TestPDbTemplate1",
"serviceType":"PDB",
"serviceFamily":"DBAAS",
"description":"This is a test pluggable database service template 1",
"poolIds":[ "FF394120842D8C71CC92BE6A4D5A488E" ],
"roles":[
{ "name":"SSA_USER_ROLE1" }
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{
"name":"TABLESPACE_ENCRYPTION_ALGORITHM",
"subconfigurations":[
{ "name":"name", "value":"NONE" }
]
},
{ "name":"MAX_TABLESPACE_ALLOWED", "value":"2" },
{ "name":"PDB_SID_PREFIX", "value":"mypdb" },
{ "name":"ENFORCE_STORAGE_CONSTRAINT", "value":"NO_LIMIT" },
{ "name":"AUTO_EXTEND_BLOCK_SIZE","value":"1024" },
{ "name":"REF_DATA_ZONE", "value":"PDB_Zone" },
{ "name":"REF_DATA_TARGET", "value":"database" },
{ "name":"REF_DATA_TARGET_TYPE", "value":"oracle_database" },
{ "name":"REF_DATA_POOL","value":"PDB_POOL" },
{ "name":"REF_DATA_HOST", "value":"abc.mycompany.com" },
{ "name":"SELECT_TARGET_OPTION", "value":"SELECT_TARGET_FROM_REQUEST" },
{ "name":"CREATE_PDB_OPTION", "value":"EMPTY_PDB" },
{"name":"PDBAAS_CUSTOM_PRE_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{"name":"PDBAAS_CUSTOM_POST_SCRIPTS_URN","value":"oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:01AB6F25F31B7671E0537850B10A9B85:0.1"},
{ "name":"PRIVILEGES",
"value":"",
"values":["CREATE TYPE","CREATE VIEW","CREATE DIMENSION","CREATE SESSION","CREATE TRIGGER","CREATE OPERATOR","CREATE SYNONYM","CREATE TABLE","CREATE PROCEDURE","CREATE INDEXTYPE","CREATE SEQUENCE"]
},
{ "name":"ROLE_OPTION","value":"CUSTOM_NEW_ROLE" },
{
"name":"INIT_PARAMS",
"subconfigurations":[
{ "name":"INIT_PARAMS:1", "value":"*.cursor_sharing=EXACT" },
{ "name":"INIT_PARAMS:2", "value":"*.open_cursors=200" }
]
},
{
"name":"WORKLOADS",
"subconfigurations":[
{
"name":"WORK_LOADS:1",
"subconfigurations":[
{ "name":"name", "value":"SmallPdb" },
{ "name":"description", "value":"small workload" },
{ "name":"default", "value":"N" },
{ "name":"CPU", "value":"2" },
{ "name":"Memory", "value":"2048" },
{ "name":"Storage", "value":"1024" },
{ "name":"Sessions", "value":"100" }
]
}
]
}
]
}
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PDBに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。 |
受け取るレスポンスの例を次に示します。
{
"name":"TestPDbTemplate1",
"serviceFamily":"DBAAS",
"serviceType":"PDB",
"type":"Service Template",
"description":"This is a test pluggable database service template 1",
"id":"E8887DEEE424BEAEE040F20A605118CE",
"pools":[
{
"name":"PDB_POOL",
"id":"FF394120842D8C71CC92BE6A4D5A488E",
"type":"pdbaas_pool",
"zone":{"id":"B60C4DA1398F41BEBC862D5A10A0C713",
"name":"PDB_Zone"}
}
],
"roles":[
{"name":"SSA_USER_ROLE1","description":null}
],
"serviceExecutableMeta":{
"type":"CDP",
"configurations":[
{"id":"CREATE_PDB_OPTION","name":"Option for creating Pluggable Database","value":"EMPTY_PDB"},
{"id":"PROFILE_URN","name":"Profile Component's URN","value":""},
{"id":"MAX_TABLESPACE_ALLOWED","name":"Maximum number of Tablespaces","value":"2"},
{"id":"ENFORCE_STORAGE_CONSTRAINT","name":"Enforce Storage Constraint","value":"false"},
{"id":"TABLESPACE_ENCRYPTION_ALGORITHM","name":"Tablespace Encryption","value":"","values":["NONE"]},
{"id":"TABLESPACE_SIZE","name":"Tablespace Size","value":"","values":[]},
{"id":"SHARED_STAGE_LOCATION","name":"Staging Location","value":""},
{"id":"WORKING_DIRECTORY","name":"Working Directory","value":""},
{"id":"PDBAAS_CUSTOM_PRE_SCRIPTS_URN","name":"URN of the pre sql custom script","value":""},
{"id":"PDBAAS_CUSTOM_POST_SCRIPTS_URN","name":"URN of the post sql custom script","value":""},
{"id":"PDB_SID_PREFIX","name":"Pluggable Database SID Prefix","value":"mypdb"},
{"id":"PDB_ADMIN_USER_NAME","name":"Pluggable Database Administrator","value":""},
{"id":"PDB_ADMIN_PASSWORD","name":"Pluggable Administrator Password"},
{"id":"PDB_SERVICE_NAME_PREFIX","name":"Pluggable Database Service Name Prefix","value":""},
{"id":"PDBSERVICE_NAME","name":"Pluggable Database Service Name","value":""},
{"id":"ROLE_OPTION","name":"Role Option Custom New Role/ Existing Roles","value":"CUSTOM_NEW_ROLE"},
{"id":"INIT_PARAMS","name":"Initialization parameter values passed as list","value":"","values":["*.open_cursors=200","*.cursor_sharing=EXACT"]},
{"id":"CUSTOM_ROLE_NAME","name":"Database Role Name","value":"PDBAAS_OCT_12_2013_02_13_AM"},
{"id":"CUSTOM_ROLE_DESC","name":"Database Role Description","value":"New db role to be assigned to pluggable database administrator."},
{"id":"PRIVILEGES","name":"Custom Role Privileges","value":"","values":["CREATE ANY SYNONYM","CREATE ANY OPERATOR","CREATE SESSION","CREATE JOB","CREATE ANY TYPE","CREATE INDEXTYPE","SELECT ANY DICTIONARY","CREATE ANY SEQUENCE","CREATE DIMENSION","CREATE ANY DIRECTORY","CREATE ANY INDEX","CREATE ANY TABLE","CREATE ANY PROCEDURE","ALTER SESSION","CREATE ANY MATERIALIZED VIEW","CREATE ANY TRIGGER","CREATE ANY VIEW"]},
{"id":"ROLES","name":"List of roles selected from reference database","value":"","values":[]}
]
},
"createdOn":null,
"createdBy":null,
"modifiedOn":null,
"modifiedBy":null,
"owner":"SYSMAN",
"etag":null,
"lastModified":null,
"canonicalLink":"https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E8887DEEE424BEAEE040F20A605118CE",
"selfLink":"https://abc.mycompany.com:11180/em/websvcs/restful/extws/cloudservices/admin/cfw/v1/servicetemplates/E8887DEEE424BEAEE040F20A605118CE"
}
空のプラガブル・データベースを使用して、RACプラガブル・データベース用のサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します:
表48-53 空のプラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Create RAC PDBs using empty PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"value": "Development",
"required": true,
"editable": false,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": "Bangalore",
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "PRIVILEGES",
"type": "VECTOR",
"description": "List of privileges of custom new role that will be applied on pluggable database administrator.",
"displayName": "PRIVILEGES",
"required": false,
"secret": false,
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},
{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CREATE_PDB_OPTION",
"value": "EMPTY_PDB"
},{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。 |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxxx\" created successfully."
}
プロファイル・プラガブル・データベースを使用して、RACプラガブル・データベース用のサービス・テンプレートを作成するには、ServiceTemplatesコレクション・リソースに対してPOST操作を発行します。次に、サービス・テンプレートにPOSTするための構成を示します:
表48-54 プロファイル・プラガブル・データベースを使用したRACプラガブル・データベース用のサービス・テンプレートの作成のためのPOSTリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= Content-Type: application/json |
|
本文 |
{
"name": "Create RAC PDBs using Profile PDB option",
"description": "Creates PDBs on cluster.",
"serviceType": "PDB",
"serviceTemplateTypeId": "94",
"rscProvAssocOption": [
"byRscProvInst"
],
"roles": [
"SSA_USER_ROLE"
],
"resourceProvider": {
"lookupCharacteristics": [
{
"characteristics": [
{
"name": "ORACLE.SYSMAN.SSA.PDBAAS_POOL",
"values": [
"DFB8F2A53429AF99EF2020C56E11FEE9"
],
"targetType": {
"targetType": "pdbaas_pool",
"targetTypeName": "Pluggable Database Pool",
"parentTargetType": "self_service_zone",
"parentTargetTypeName": "PaaS Infrastructure Zone"
}
}
],
"purposeId": 1
}
]
},
"payloads": [
{
"name": "DBDELETE_PRESCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D511C1CFFE053C075B10AEF2D:0.1"
},
{
"name": "DBDELETE_POSTSCRIPT",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:246A484D51201CFFE053C075B10AEF2D:0.1"
}
],
"characteristics": [
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_CONTACT",
"displayName": "Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_COST_CENTER",
"displayName": "Cost Center",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DEPARTMENT",
"displayName": "Department",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_DOWNTIME_CONTACT",
"displayName": "Downtime Contact",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LIFECYCLE_STATUS",
"displayName": "Lifecycle Status",
"values": [
"Development",
"MissionCritical",
"Production",
"Stage",
"Test"
],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LINE_OF_BUS",
"displayName": "Line of Business",
"values": [],
"required": false,
"editable": true,
"visible": true
},
{
"name": "ORACLE.SYSMAN.CFW.ORCL_GTP_LOCATION",
"displayName": "Location",
"values": [],
"required": false,
"editable": true,
"visible": true
}
],
"configurations": [
{
"name": "REF_DATA_ZONE",
"value": "Single Instances Zone"
},
{
"name":SELECT_TARGET_OPTION"
"value":SELECT_TARGET_FROM_REQUEST"
},
{
"name": "TARGET_PROP_LIST",
"values": [
"Site:null:false:false",
"Contact:null:false:false",
"Downtime Contact:null:false:false",
"Location:null:false:false",
"LifeCycle Status:null:false:false",
"Department:Development:true:true",
"Comment:This is for testing:false:false",
"Line of Business:null:false:false"
]
},
{
"name": "PDBAAS_CUSTOM_PRE_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7B4E34E053C075B10A74AD:0.2"
},
{
"name": "WORKLOADS",
"subvalues": [
{
"name": "Small",
"subvalues": [
{
"name": "name",
"value": "SmallPdb"
},
{
"name": "description",
"value": "small workload"
},
{
"name": "default",
"value": "N"
},
{
"name": "CPU",
"value": "2"
},
{
"name": "Memory",
"value": "2"
},
{
"name": "Storage",
"value": "5"
},
{
"name": "Sessions",
"value": "100"
}
]
}
]
},
{
"name": "ROLE_OPTION",
"value": "CUSTOM_NEW_ROLE"
},
{
"name": "CUSTOM_ROLE_NAME",
"value": "PDBAAS_NOV_13_2015_16_51_PM"
},
{
"name": "CUSTOM_ROLE_DESC",
"value": "New db role to be assigned to pluggable database administrator."
},
{
"name": "PRIVILEGES",
"values": [
"CREATE SESSION",
"ALTER SESSION",
"CREATE DIMENSION",
"CREATE INDEXTYPE",
"CREATE ANY OPERATOR",
"CREATE ANY PROCEDURE",
"CREATE ANY SEQUENCE",
"CREATE ANY INDEX",
"CREATE JOB",
"CREATE ANY MATERIALIZED VIEW",
"CREATE ANY TABLE",
"CREATE ANY TRIGGER",
"CREATE ANY TYPE",
"CREATE ANY VIEW",
"CREATE ANY SYNONYM",
"CREATE ANY DIRECTORY",
"SELECT ANY DICTIONARY",
"SELECT ANY TABLE"
]
},
{
"name": "REF_DATA_TARGET_TYPE",
"value": "rac_database"
},
{
"name": "REF_DATA_ZONE",
"value": "Clusters Zone - Oracle DB 12c"
},
{
"name": "REF_DATA_HOST",
"value": "xyz.example.com"
},
{
"name": "REF_DATA_TARGET",
"value": "cdbfs"
},
{
"name": "REF_DATA_POOL",
"value": "RAC Pluggable DBs"
},
{
"name": "PDBAAS_CUSTOM_POST_SCRIPTS_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Directives:none:2469CA4C8C7F4E34E053C075B10A74AD:0.2"
},
{
"name": "SELECT_TARGET_OPTION",
"value": "SELECT_TARGET_AT_RUNTIME"
},
{
"name": "MAX_TABLESPACE_ALLOWED",
"value": "1"
},
{
"name": "CREATE_PDB_OPTION",
"value": "PDB_FROM_PROFILE"
},
{
"name": "PROFILE_URN",
"value": "oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_DbProfile:246C1E85296C29A1E053C075B10A7DFA:0.1"
},
{
"name": "SHARED_STAGE_LOCATION",
"value": "/u04/app/hhkaur/product/12.1.0/dbhome_2/rdbms/xml/schema"
},
{
"name": "TABLESPACE_SIZE",
"values": [
"0.7715",
"0.6152",
"0.0586",
"0.0049"
]
},
{
"name": "INIT_PARAMS",
"values": [
"*.cursor_sharing=EXACT",
"*.open_cursors=300"
]
},
{
"name": "PDB_SID_PREFIX",
"value": "prp"
}
]
}
注意:
|
|
リクエスト・メソッド |
POST |
|
注意: 前述の表では、SELECT_TARGET_OPTIONパラメータは、SSAユーザーが、PBDに対してリクエスト発行中にコンテナ・データベース(CDB)を選択するオプションを持つかどうかを定義します。パラメータの値が、SELECT_TARGET_FROM_REQUESTに設定された場合、SSAユーザーにはCDBを選択するオプションがあります。値が定義されない、または値がSELECT_TARGET_AT_RUNTIMEに設定されている場合、配置アルゴリズムはCDBを選択します。 |
受け取るレスポンスの例を次に示します。
{
"message": "Service template with ID \"xxxxx\" created successfully."
}
ServiceTemplateのURIでDELETEリクエストを発行して、ServiceTemplateインスタンスを削除できます。ServiceTemplateの削除の構成を次に示します。
表48-55 データベース/スキーマ/プラガブル・データベース・サービス・テンプレートを削除するためのDELETEリクエスト構成
| 機能 | 説明 |
|---|---|
|
URI |
/em/websvcs/restful/extws/ cloudservices/admin/cfw/v1/servicetemplates/E87A364660A25B39E040F20A60510FDD 注意: データベース・サービス・テンプレートのURI: em/websvcs/restful/extws/cloudservices/admin/cfw/v2/servicetemplates/61 |
|
リクエスト・ヘッダー |
Authorization: basic ZGVtb3VzZXI6ZGVtb3VzZXI= |
|
本文 |
なし |
|
リクエスト・メソッド |
DELETE |
受け取るレスポンスの例を次に示します。
{
"message": "Service Template \"E87A364660A25B39E040F20A60510FDD\" deleted successfully."
}
