ジャンプ先

• リクエスト
• レスポンス
• 例

デフォルトのOracleホームでの新しいDBCAジョブの作成

POST

/environment/dbca/jobs/

$ORACLE_HOME環境変数によって指定されたOracleホームでデータベースをCREATEまたはDELETEするための新しいDatabase Configuration Assistant (DBCA)ジョブ・リクエストを発行します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。

リクエスト

サポートされるメディア・タイプ

• application/json

本文 ()

DBCAジョブを作成するためのペイロード。

ルート・スキーマ: schema

タイプ: object

ソースの表示

• container_configuration(optional): object container_configuration
  このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。
• global_database_name: string
  作成または削除するデータベースを識別するためのグローバル・データベース名
• operation: string
  指定できる値: [ "CREATE", "DELETE" ]

  実行するDBCA操作。
• password(optional): string
  データベースの削除にDBCAが使用するSYSDBAロールを持つアカウントのパスワードを指定します。DELETE操作にのみ必要です。
• response_file(optional): string
  データベースの作成時に使用するDBCAのレスポンス・ファイルの名前。
• sys_user_password(optional): string
  新しいデータベースのsysユーザーのパスワード。
• system_user_password(optional): string
  新しいデータベースのシステム・ユーザーのパスワード。
• template_name(optional): string
  データベースの作成時に使用するDBCAのテンプレート・ファイルの名前。
• total_memory(optional): integer
  新しいデータベースが使用できる物理メモリーの合計量(MB)。
• username(optional): string
  データベースの削除にDBCAが使用するSYSDBAロールを持つアカウントを指定します。DELETE操作にのみ必要です。

{
    "type":"object",
    "required":[
        "operation",
        "global_database_name"
    ],
    "properties":{
        "operation":{
            "type":"string",
            "description":"The DBCA operation to perform.",
            "enum":[
                "CREATE",
                "DELETE"
            ]
        },
        "global_database_name":{
            "type":"string",
            "description":"Global Database Name to identify the database to create or delete"
        },
        "template_name":{
            "type":"string",
            "description":"The name of the template file for DBCA to use when creating a database."
        },
        "response_file":{
            "type":"string",
            "description":"The name of the response file for DBCA to use when creating a database."
        },
        "system_user_password":{
            "type":"string",
            "description":"The password for the system user in the new database."
        },
        "sys_user_password":{
            "type":"string",
            "description":"The password for the sys user in the new database."
        },
        "container_configuration":{
            "type":"object",
            "description":"This object specifies that a Container Database is to be created with the PDB settings provided.",
            "items":{
                "type":"object",
                "required":[
                    "number_of_pdbs",
                    "pdb_administrator_password",
                    "pdb_name"
                ],
                "properties":{
                    "number_of_pdbs":{
                        "type":"integer",
                        "description":"The number of Pluggable Databases to create."
                    },
                    "pdb_administrator_password":{
                        "type":"string",
                        "description":"The password for the PDBADMIN user created in each Pluggable Database."
                    },
                    "pdb_name":{
                        "type":"string",
                        "description":"The name prefix to use for each Pluggable Database created."
                    }
                }
            }
        },
        "total_memory":{
            "type":"integer",
            "description":"Total amount of physical memory, in megabytes, that can be used by the new database."
        },
        "username":{
            "type":"string",
            "description":"Specifies the account with SYSDBA role which DBCA will use to delete the database. Only required for DELETE operations."
        },
        "password":{
            "type":"string",
            "description":"Specifies the password for the account with SYSDBA role which DBCA will use to delete the database. Only required for DELETE operations."
        }
    }
}

ネストされたスキーマ : container_configuration

タイプ: object

このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。

ソースの表示

• 配列: オブジェクト items

{
    "type":"object",
    "description":"This object specifies that a Container Database is to be created with the PDB settings provided.",
    "items":{
        "type":"object",
        "required":[
            "number_of_pdbs",
            "pdb_administrator_password",
            "pdb_name"
        ],
        "properties":{
            "number_of_pdbs":{
                "type":"integer",
                "description":"The number of Pluggable Databases to create."
            },
            "pdb_administrator_password":{
                "type":"string",
                "description":"The password for the PDBADMIN user created in each Pluggable Database."
            },
            "pdb_name":{
                "type":"string",
                "description":"The name prefix to use for each Pluggable Database created."
            }
        }
    }
}

ネストされたスキーマ: items

タイプ: object

ソースの表示

• number_of_pdbs: integer
  作成するプラガブル・データベースの数。
• pdb_administrator_password: string
  各プラガブル・データベースに作成されるPDBADMINユーザーのパスワード。
• pdb_name: string
  作成される各プラガブル・データベースに使用する名前接頭辞。

{
    "type":"object",
    "required":[
        "number_of_pdbs",
        "pdb_administrator_password",
        "pdb_name"
    ],
    "properties":{
        "number_of_pdbs":{
            "type":"integer",
            "description":"The number of Pluggable Databases to create."
        },
        "pdb_administrator_password":{
            "type":"string",
            "description":"The password for the PDBADMIN user created in each Pluggable Database."
        },
        "pdb_name":{
            "type":"string",
            "description":"The name prefix to use for each Pluggable Database created."
        }
    }
}

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

201レスポンス

新しいDBCAジョブの説明。

本文 ()

ルート・スキーマ: ResourceItem

タイプ: object

使用可能なその他のプロパティ: true

ソースの表示

• links(optional): array links

{
    "type":"object",
    "additionalProperties":true,
    "properties":{
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/LinkRelation"
            }
        }
    }
}

ネストされたスキーマ: links

タイプ: array

ソースの表示

• 配列: オブジェクト LinkRelation

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/LinkRelation"
    }
}

ネストされたスキーマ: LinkRelation

タイプ: object

ソースの表示

• href: string
• rel: string

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string"
        },
        "href":{
            "type":"string"
        }
    },
    "required":[
        "rel",
        "href"
    ]
}

先頭に戻る

例

次の例は、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/"
    }
  ]
}

先頭に戻る