作業用コピーの作成
POST
/workingcopies
既存のゴールド・イメージを使用して新しい作業用コピーを作成します
リクエスト
サポートされるメディア・タイプ
- application/json
ヘッダー・パラメータ
- Authorization: string
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。詳細は、「フリート・パッチ適用およびプロビジョニングの認証」を参照してください。
ルート・スキーマ: AddWorkingCopyBody
タイプ:
ソースの表示
object
- agpath(optional): string
永続的Oracleホームのパスの読取り/書込みパス。
- asmClientData(optional): string
ASMクライアント・データを含むファイル。
- aupath(optional): string
永続的Oracleホーム・パスの読取り専用ゴールド・イメージ・パス。
- auth(optional): string
認証プラグインを使用してリモート・ノードにアクセスします。
- authArgs(optional): object authArgs
使用可能なその他のプロパティ: additionalProperties選択した認証プラグインの追加プロパティ。
- cardinality(optional): string
新しいサーバー・プールのカーディナリティ。
- cdb(optional): boolean
デフォルト値:
false
データベースをコンテナ・データベースとして作成する場合。 - client(optional): string
クライアント・クラスタ名
- clusterManifest(optional): string
クラスタ・マニフェスト・ファイルの場所。
- clusterNodes(optional): string
Oracle Clusterwareがプロビジョニングされるノード情報のカンマ区切りリスト。
- datafileDestination(optional): string
データ・ファイル宛先場所またはASMディスク・グループ名。
- dbname(optional): string
プロビジョニングされるデータベースの名前(DB_UNIQUE_NAME)
- dbTemplate(optional): string
テンプレート・ファイルの絶対ファイル・パス、または高速ホーム・プロビジョニング・サーバー上のイメージ・ホーム・ディレクトリへの相対パス。
- dbType(optional): string
指定できる値:
[ "RAC", "RACONENODE", "SINGLE" ]
データベースのタイプ: Oracle RAC One Node、Oracle RACまたはSingle Instance - eval(optional): boolean
デフォルト値:
false
コマンドを実行せずに評価します。 - fixup(optional): boolean
デフォルト値:
false
修正スクリプトを実行します。Grid Infrastructureのプロビジョニングでのみ有効です。 - gnsClientData(optional): string
GNSクライアント・データを含むファイル。
- groups(optional): string
作業用コピーに対して構成されるOracleグループのカンマ区切りのリスト。OSDBA、OSOPER、OSASM、OSBACKUP、OSDG、OSKM、OSRACなど、値が有効なグループ名に相当する有効なキーを指定します。
- ignorePrereq(optional): boolean
デフォルト値:
false
CVUの前提条件チェックを無視する場合。 - imageName(optional): string
構成済イメージのイメージ名
- inventory(optional): string
Oracle Inventoryの場所
- newpool(optional): string
作成するプールのサーバー・プール名。
- node(optional): string
データベースが作成されるノードのカンマ区切りリスト
- numberOfPDBs(optional): integer(int32)
作成するPDBの数。
- oracleBase(optional): string
Oracle DatabaseホームまたはOracle Grid InfrastructureホームをプロビジョニングするためのORACLE_BASEパス。
- path(optional): string
インポートするソフトウェア・ホームの絶対パスの場所(データベース・イメージの場合、これはORACLE_HOMEになります)。
- pDBName(optional): string
1つ以上のPDBを作成する必要がある場合のpDBName接頭辞。
- precheckonly(optional): boolean
パッチ適用前チェック操作のみを実行します
- responsefile(optional): string
Oracle Grid Infrastructureプロビジョニングの実行に使用されるレスポンス・ファイル
- root(optional): boolean
デフォルト値:
false
ルート資格証明を使用してリモート・ノードにアクセスします。 - schedule(optional): string
ISO-8601形式の操作を実行する優先時間。例: 2016-12-21T19:13:17+05.
- serverpool(optional): string
既存のサーバー・プール名のカンマ区切りリスト。
- setupSSH(optional): boolean
デフォルト値:
false
プロビジョニング・ユーザーのために、リモート・ノード上にパスワードなしのSSHユーザー等価を設定します。 - softwareOnly(optional): string
デフォルト値:
false
Grid Infrastructureソフトウェアのみのプロビジョニングを実行します。 - storagetype(optional): string
指定できる値:
[ "NFS", "LOCAL", "RHP_MANAGED" ]
ホームの記憶域のタイプ。 - sudoPath(optional): string
sudoバイナリの場所。
- sudoUser(optional): string
sudoユーザー名としてスーパーユーザー操作を実行します。
- superUserPasswd(optional): string
スーパーユーザー・アカウントのパスワード。
- targetNode(optional): string
操作を実行する必要があるノード
- user(optional): string
ソフトウェア・ホームをプロビジョニングしているユーザーの名前。
- workingcopy(optional): string
作業用コピーの名前
セキュリティ
- 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
で指定された既存のゴールド・イメージを使用して作業用コピーを作成する方法を示しています。
curl -u restUser -X POST -H "Content-Type: application/json" -d "@body.json" "https://RHP_node_name:8894/rhp-restapi/rhp/workingcopies"
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)
{
"path" : "/oracle/database/home",
"oracleBase" : "/oracle/database/base",
"storagetype" : "LOCAL",
"imageName" : "DB_Image1",
"workingcopy" : "DB_Wcopy1"
}
レスポンス本体
{
"links": [{
"uri": "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1",
"rel": "self"
}],
"jobId": "1",
"output": { }
}