デフォルトのOracleホームでの新しいDBCAジョブの作成
POST
/environment/dbca/jobs/
$ORACLE_HOME環境変数によって指定されたOracleホームでデータベースをCREATEまたはDELETEするための新しいDatabase Configuration Assistant (DBCA)ジョブ・リクエストを発行します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。クライアントは、このサービスを起動するにはシステム管理者ロールが必要です。この実装は、Unixベースのオペレーティング・システムでのみ使用できます。
リクエスト
この操作にはリクエスト・パラメータはありません。
サポートされるメディア・タイプ
- application/json
ルート・スキーマ: schema
タイプ:
ソースの表示
object
-
container_configuration: object container_configuration
このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。
-
global_database_name(required): string
作成または削除するデータベースを識別するためのグローバル・データベース名
-
operation(required): string
指定できる値:
[ "CREATE", "DELETE" ]
実行するDBCA操作。 -
password: string
データベースの削除にDBCAが使用するSYSDBAロールを持つアカウントのパスワードを指定します。DELETE操作にのみ必要です。
-
response_file: string
データベースの作成時に使用するDBCAのレスポンス・ファイルの名前。
-
sys_user_password: string
新しいデータベースのsysユーザーのパスワード。
-
system_user_password: string
新しいデータベースのシステム・ユーザーのパスワード。
-
template_name: string
データベースの作成時に使用するDBCAのテンプレート・ファイルの名前。
-
total_memory: integer
新しいデータベースが使用できる物理メモリーの合計量(MB)。
-
username: string
データベースの削除にDBCAが使用するSYSDBAロールを持つアカウントを指定します。DELETE操作にのみ必要です。
ネストされたスキーマ : container_configuration
タイプ:
object
このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。
ソースの表示
ネストされたスキーマ: items
タイプ:
ソースの表示
object
-
number_of_pdbs(required): integer
作成するプラガブル・データベースの数。
-
pdb_administrator_password(required): string
各プラガブル・データベースに作成されるPDBADMINユーザーのパスワード。
-
pdb_name(required): string
作成される各プラガブル・データベースに使用する名前接頭辞。
例
先頭に戻る
レスポンス
サポートされるメディア・タイプ
- application/json
201レスポンス
新しいDBCAジョブの説明。
ルート・スキーマ: EnvironmentDbcaJobsItem
タイプ:
object
Database Configuration Assistantジョブについて説明します。
ソースの表示
-
dbca_log: array dbca_log
DBCAプロセスの実行時の出力
-
description: string
DBCAジョブの説明。
-
finished: string
DBCAジョブ・リクエストが完了した時点のタイムスタンプ
-
job_id: string
OracleホームでのDBCAジョブの一意の識別子
-
job_request: object job_request
DBCAジョブ・リクエストについて説明する
-
links: array links
-
status: string
DBCAジョブのステータス。
-
submitted: string
DBCAジョブ・リクエストが発行された時点のタイムスタンプ
ネストされたスキーマ: job_request
タイプ:
object
DBCAジョブ・リクエストについて説明する
ソースの表示
-
container_configuration: object container_configuration
このオブジェクトは、CDBのコンテナ構成詳細を表します。
-
database_system_identifier: string
データベース識別子。
-
global_database_name: string
グローバル・データベース名。
-
operation: string
実行するDBCA操作。CREATEまたはDELETE。
-
response_file: string
データベース作成時に使用する、DBCAのレスポンス・ファイルのパス
-
template_name: string
データベース作成時に使用する、DBCAのデータベース・テンプレートのパス
-
total_memory: string
データベース作成時にDBCAに指定する合計メモリー・パラメータ
-
username: string
データベース削除時に使用する、DBCAのsysdbaユーザー名
ネストされたスキーマ : container_configuration
タイプ:
object
このオブジェクトは、CDBのコンテナ構成詳細を表します。
ソースの表示
-
number_of_pdbs: string
作成するPDBの数
-
pdb_name: string
各PDBのベース名。number_of_pdbsが1よりも大きい場合は、それぞれの名前に番号が追加される。
例
次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、デフォルトのOracleホームで新しいDBCAジョブを発行する方法を示しています。DBCAジョブは、デフォルトのOracleホームでデータベースを作成または削除するリクエストにできます。
curl -i -X POST -u username:password
-d @request_body.json
-H "Content-Type:application/json" https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/
リクエスト本文の例
ノート:
前述のコマンドで使用されるURL構造
https://rest_server_url/resource-path
には、次の要素があります。
rest_server_url
はOracle Rest Data Serverが実行されているRESTサーバーです- URLの残りの部分には、ORDSコンテキスト・ルート、使用するORDSデータベースAPIのバージョン、およびこの操作のパスが含まれます。
次に、非コンテナ・データベースを作成するDBCAジョブを作成するためのリクエスト本文の例を示します。非コンテナ・データベースはGeneral_Purpose.dbc
テンプレートに基づいてdevdb1
と呼ばれ、新しいデータベースによって使用される物理メモリーの合計量は700MBです。
{
"operation": "CREATE",
"global_database_name": "devdb1",
"template_name": "General_Purpose.dbc",
"sys_user_password": "W3lc0m31",
"system_user_password": "W3lc0m31",
"total_memory": 700
}
レスポンス・ヘッダーの例
次の例に、レスポンス・ヘッダーを示します。Location
ヘッダーは、DBCAジョブのステータスの表示に使用できるURIを返します。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Location: https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/OzQbsGnbUhVV7w7fiYPbJQ/
X-Frame-Options: SAMEORIGIN
Location: https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/OzQbsGnbUhVV7w7fiYPbJQ/
Transfer-Encoding: chunked
レスポンス本文の例
次の例は、JSON形式で返される201のレスポンス本文を示しています。
{
"job_id": "OzQbsGnbUhVV7w7fiYPbJQ",
"description": "Run DBCA to create database",
"status": "RUNNING",
"submitted": "2019-09-06T19:17:23.004Z",
"finished": null,
"job_request": {
"operation": "CREATE",
"container_configuration": null,
"database_system_identifier": null,
"global_database_name": "devdb1",
"response_file": null,
"template_name": "General_Purpose.dbc",
"total_memory": 700,
"username": null
},
"dbca_log": [],
"links": [
{
"rel": "self",
"href": "https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/OzQbsGnbUhVV7w7fiYPbJQ/"
},
{
"rel": "describedby",
"href": "https://rest_server_url/ords/_/db-api/stable/metadata-catalog/"
},
{
"rel": "collection",
"href": "https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/"
}
]
}