ジャンプ先

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

デフォルトのOracleホームでの新しいデータベースの作成

POST

/environment/databases/

$ORACLE_HOME環境変数によって指定されたOracleホームに新しいデータベースを作成します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。クライアントは、このサービスを起動するにはシステム管理者ロールが必要です。

リクエスト

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

• application/json

本文 ()

データベースを作成するためのペイロード。

ルート・スキーマ: schema

タイプ: object

ソースの表示

• container_configuration(optional): object container_configuration
  このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。
• global_database_name(optional): string
  グローバル・データベース名。
• 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)。

{
    "type":"object",
    "properties":{
        "global_database_name":{
            "type":"string",
            "description":"Global Database Name."
        },
        "template_name":{
            "type":"string",
            "description":"The name of the template file for DBCA to use."
        },
        "response_file":{
            "type":"string",
            "description":"The name of the response file for DBCA to use."
        },
        "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."
        }
    }
}

ネストされたスキーマ : 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

202 レスポンス

新しいデータベースの作成リクエストが受け入れられました。

ヘッダー

• Location: string
  ロケーション・ヘッダーは、リクエストの処理を追跡できるようにDBCAジョブのURIを提供します。

先頭に戻る

例

次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、デフォルトの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/databases/

リクエスト本文の例

ノート:

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

• rest_server_urlはOracle Rest Data Serverが実行されているRESTサーバーです
• URLの残りの部分には、ORDSコンテキスト・ルート、使用するORDSデータベースAPIのバージョン、およびこの操作のパスが含まれます。

次に、デフォルトのOracleホームに2つのプラガブル・データベースを持つコンテナ・データベースを作成するためのリクエスト本体の例を示します。Oracleホームのdbcaテンプレート・ディレクトリのGeneral_Purpose.dbcテンプレート・ファイルが使用されます。コンテナ・データベースを作成することを示すcontainer_configurationプロパティがリクエストに指定されます。このシナリオでは、コンテナ・データベース名はdevcdb1、プラガブル・データベース名はpdbtest1およびpdbtest2です。このリクエストに対するレスポンスは、リクエストを処理するために作成されたDBCAジョブの場所になります。

{
  "global_database_name": "devcdb1",
  "template_name": "General_Purpose.dbc",
  "sys_user_password": "W3lc0m31",
  "system_user_password": "W3lc0m31",
  "container_configuration": {
    "number_of_pdbs": 2,
    "pdb_name": "pdbtest",
    "pdb_administrator_password": "W3lc0m31"
  }
}

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

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

HTTP/1.1 202 Accepted
Date: Fri, 06 Sep 2019 18:17:26 GMT
X-Frame-Options: SAMEORIGIN
Location: https://rest_server_url/ords/_/db-api/stable/environment/dbca/jobs/Cuq5Mm190gZgvXlwJITEIw/
Transfer-Encoding: chunked

レスポンス本文の例

データベース作成リクエストが有効であり受け入れられた場合、レスポンス本文は空です。レスポンス・ヘッダーには、DBCAジョブに必要な情報が含まれます。

先頭に戻る