デフォルトのOracleホームでの新しいDBCAジョブの作成
POST
/environment/dbca/jobs/
$ORACLE_HOME環境変数によって指定されたOracleホームでデータベースをCREATEまたはDELETEするための新しいDatabase Configuration Assistant (DBCA)ジョブ・リクエストを発行します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。クライアントは、このサービスを起動するにはシステム管理者ロールが必要です。
リクエスト
この操作にはリクエスト・パラメータはありません。
先頭に戻るレスポンス
201レスポンス
新しいDBCAジョブの説明。
例
次の例は、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/"
}
]
}