Oracle Databaseソフトウェアの作成
POST
/rhp-restapi/rhp/workingcopies/{workingCopyId}/databases
管理対象作業用コピーで新しいOracle Databaseをプロビジョニングします。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- workingCopyId: string
作業用コピーの名前。
ヘッダー・パラメータ
- Authorization: string
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。詳細は、高速ホーム・プロビジョニングの認証を参照してください。
ルート・スキーマ: AddDatabaseBody
タイプ:
ソースの表示
object
- auth(optional): string
認証プラグインを使用してリモート・ノードにアクセスします。
- authArgs(optional): object authArgs
使用可能なその他のプロパティ: additionalProperties選択した認証プラグインの追加プロパティ。
- cdb(optional): boolean
デフォルト値:
false
データベースをコンテナ・データベースとして作成する場合 - datafileDestination(optional): string
データ・ファイル宛先場所またはASMディスク・グループ名
- dbtemplate(optional): string
テンプレート・ファイルの絶対ファイル・パス、または高速ホーム・プロビジョニング・サーバー上のイメージ・ホーム・ディレクトリへの相対パス
- dbtype(optional): string
指定できる値:
[ "RAC", "RACONENODE", "SINGLE" ]
データベースのタイプ: Oracle RAC One Node、Oracle RACまたはSingle Instance - eval(optional): boolean
デフォルト値:
false
コマンドを実行せずに評価します。 - newpqpool(optional): string
作成するプールのサーバー・プール名
- numberOfPDBs(optional): integer(int32)
作成するPDBの数
- pdbName(optional): string
1つ以上のPDBを作成する必要がある場合のpdbName接頭辞
- pqcardinality(optional): string
新しいPQプールのカーディナリティ
- pqpool(optional): string
既存のPQプール名
- root(optional): boolean
デフォルト値:
false
ルート資格証明を使用してリモート・ノードにアクセスします。 - schedule(optional): string
ISO-8601形式の操作を実行する優先時間。例: 2016-12-21T19:13:17+05.
- sudoPath(optional): string
sudoバイナリの場所。
- sudoUser(optional): string
sudoユーザー名としてスーパーユーザー操作を実行します。
- superUserPasswd(optional): string
スーパーユーザー・アカウントのパスワード。
- targetnode(optional): string
操作を実行する必要があるノード
- useractiondata(optional): string
useractionスクリプトのuseractiondataパラメータに渡される値
セキュリティ
- basicAuthentication: basic
タイプ:
Basic
レスポンス
サポートされるメディア・タイプ
- application/json
202 レスポンス
承認済。進行状況のステータスおよび出力を取得するために承認された操作のジョブ・リソース詳細を含むJSONオブジェクト。
ヘッダー
- Location: string
操作を実行するジョブへのURL
ネストされたスキーマ: singleResourceLinks
タイプ:
ソースの表示
object
- href(optional): string
絶対形式で指定された参照ハイパーリンク要素。
- rel(optional): string
指定できる値:
[ "self", "collection", "up", "describedBy" ]
説明されたリソースを持つリンクの関係のタイプを指定します。
ネストされたスキーマ: collectionResourceLinks
タイプ:
ソースの表示
object
- href(optional): string
正しいURLパラメータを持つ絶対形式で指定された参照ハイパーリンク要素。
- rel(optional): string
指定できる値:
[ "next", "prev", "first", "last" ]
説明されたリソースを持つリンクの関係のタイプを指定します。
400 レスポンス
不正なリクエスト。パラメータ値または名前の解析中に見つかった問題のエラー詳細を含むJSONオブジェクト。
ルート・スキーマ: errorResource
タイプ:
ソースの表示
object
- errorCode(optional): string
tittleに表示されるエラー・メッセージに関連する、アプリケーション固有のエラー・コード。
- errorDetails(optional): array errorDetails
複数のエラーがレポートされている場合は、この配列の階層構造に編成できます。
- errorPath(optional): string
エラーの発生場所を示すXPathまたはJSONパス。
- instance(optional): string
エラーに関する詳細を提供するリンクへのURI。
- status(optional): integer
HTTPステータス・コード。
- title(optional): string
要約エラー・メッセージ。
- type(optional): string
HTTPエラー・コード・ページへのリンク。
デフォルト・レスポンス
予期しないエラー操作の実行中の問題のエラー詳細を含むJSONオブジェクト。
ルート・スキーマ: errorResource
タイプ:
ソースの表示
object
- errorCode(optional): string
tittleに表示されるエラー・メッセージに関連する、アプリケーション固有のエラー・コード。
- errorDetails(optional): array errorDetails
複数のエラーがレポートされている場合は、この配列の階層構造に編成できます。
- errorPath(optional): string
エラーの発生場所を示すXPathまたはJSONパス。
- instance(optional): string
エラーに関する詳細を提供するリンクへのURI。
- status(optional): integer
HTTPステータス・コード。
- title(optional): string
要約エラー・メッセージ。
- type(optional): string
HTTPエラー・コード・ページへのリンク。
例
次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、リクエスト本体body.json
ですべての引数が指定されている管理対象作業用コピーで新しいOracle Dtabaseインスタンスをプロビジョニングする方法を示しています。
curl -u restUser -X POST -H "Content-Type: application/json" -d "@body.json" "https://RHP_node_name:8894/rhp-restapi/rhp/workingcopies/DB_Wcopy181/databases"
HTTPステータス・コードとレスポンス・ヘッダー
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 202
Location: https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: GET,PUT,POST,DELETE,PATCH,OPTIONS
Access-Control-Allow-Headers: X-Requested-With, Content-Type, Content-Length, Authorization
Connection: keep-alive
Content-Type: application/json
Content-Length: 159
Date: Tue, 19 Jun 2018 14:03:23 GMT
リクエスト本体(body.json)
{
"dbname" : "dbwc1"
}
レスポンス本体
{
"links": [{
"uri": "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1",
"rel": "self"
}],
"jobId": "1",
"output": { }
}