ジャンプ先

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

指定したOracleホームでの新しいデータベースの作成

POST

/environment/homes/{homeName}/databases/

Oracleホームで新しいデータベースを作成します。このOracleホームは、Oracle REST Data Servicesサーバー・インスタンスと同じホスト上にある必要があります。クライアントは、このサービスを起動するにはシステム管理者ロールが必要です。

リクエスト

パス・パラメータ

• homeName(required): string
  Oracleホームの名前。

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

• application/json

リクエスト本文 - application/json ()

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

ルート・スキーマ: schema

タイプ: object

ソースの表示

• container_configuration: object container_configuration
  このオブジェクトは、指定されたPDB設定を使用してコンテナ・データベースを作成することを指定します。
• global_database_name: string
  グローバル・データベース名。
• response_file: string
  使用するDBCAのレスポンス・ファイルの名前。
• sys_user_password: string
  新しいデータベースのsysユーザーのパスワード。
• system_user_password: string
  新しいデータベースのシステム・ユーザーのパスワード。
• template_name: string
  使用するDBCAのテンプレート・ファイルの名前。
• total_memory: 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(required): integer
  作成するプラガブル・データベースの数。
• pdb_administrator_password(required): string
  各プラガブル・データベースに作成されるPDBADMINユーザーのパスワード。
• pdb_name(required): 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."
        }
    }
}

例

例の選択 create_cdb create_noncdb

先頭に戻る

レスポンス

202 レスポンス

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

ヘッダー

• Location(required):
  ロケーション・ヘッダーは、リクエストの処理を追跡できるように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/homes/OraDB18Home1/databases/

リクエスト本文の例

ノート:

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

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

次に、非コンテナ・データベースを作成するためのリクエスト本文の例を示します。非コンテナ・データベースはGeneral_Purpose.dbcテンプレートに基づいてdevdb1と呼ばれ、追加の構成プロパティの設定に事前定義レスポンス・ファイルが使用されます。このリクエストに対するレスポンスは、リクエストを処理するために作成されたDBCAジョブの場所になります。

{
  "global_database_name": "devdb1",
  "template_name": "General_Purpose.dbc",
  "sys_user_password": "W3lc0m31",
  "system_user_password": "W3lc0m31",
  "response_file": "/disk1/oracle/install_oracle_for_dev.rsp"
}

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

次の例に、レスポンス・ヘッダーを示します。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/Buq5Mm395gZgvXlwPFRSJv/
Transfer-Encoding: chunked

レスポンス本文の例

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

先頭に戻る