Oracle REST Data Services API

Oracleホームでの新しいDBCAジョブの作成

POST

/environment/homes/{homeName}/dbca/jobs/

指定されたOracleホームでデータベースをCREATEまたはDELETEするための新しいDBCAジョブ・リクエストを発行します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。クライアントは、このサービスを起動するにはシステム管理者ロールが必要です。

リクエスト

パス・パラメータ

homeName:

Oracleホームの名前。

先頭に戻る

レスポンス

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/homes/OraDB18Home1/dbca/jobs/

リクエスト本文の例

ノート:

前述のコマンドで使用されるURL構造https://rest_server_url/resource-pathには、次の要素があります。

rest_server_urlはOracle Rest Data Serverが実行されているRESTサーバーです
URLの残りの部分には、ORDSコンテキスト・ルート、使用するORDSデータベースAPIのバージョン、およびこの操作のパスが含まれます。OraDB18Home1は、パスのhomeNameパラメータ値として指定されています。すべてのDBCA操作は、Oracleホームで実行されます。

次に、データベースを削除するのDBCAジョブを作成するためのリクエスト本文の例を示します。削除アクションを実行するには、DBCAユーティリティで必要なため、SYSDBAロールを持つデータベース内のユーザーの資格証明を指定する必要があります。

{
  "operation": "DELETE",
  "global_database_name": "devdb1",
  "username": "sys",
  "password": "W3lc0m31"
}

レスポンス・ヘッダーの例

次の例に、レスポンス・ヘッダーを示します。Locationヘッダーは、DBCAジョブのステータスの表示に使用できるURIを返します。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Location: https://rest_server_url/ords/_/db-api/stable/environment/homes/OraDB18Home1/dbca/jobs/RPKlPvbKPKqV7Ap6DN9iRg/
X-Frame-Options: SAMEORIGIN
Location: https://rest_server_url/ords/_/db-api/stable/environment/homes/OraDB18Home1/dbca/jobs/RPKlPvbKPKqV7Ap6DN9iRg/
Transfer-Encoding: chunked

レスポンス本文の例

次の例は、JSON形式で返される201のレスポンス本文を示しています。

{
  "job_id": "RPKlPvbKPKqV7Ap6DN9iRg",
  "description": "Running DBCA to Delete database",
  "status": "RUNNING",
  "submitted": "2019-09-06T19:30:06.981Z",
  "finished": null,
  "job_request": {
    "operation": "DELETE",
    "container_configuration": null,
    "database_system_identifier": null,
    "global_database_name": "devdb1",
    "response_file": null,
    "template_name": null,
    "total_memory": null,
    "username": "sys"
  },
  "dbca_log": [],
  "links": [
    {
      "rel": "self",
      "href": "https://rest_server_url/ords/_/db-api/stable/environment/homes/OraDB18Home1/dbca/jobs/RPKlPvbKPKqV7Ap6DN9iRg/"
    },
    {
      "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/homes/OraDB18Home1/dbca/jobs/"
    }
  ]
}

先頭に戻る