イメージのインポート操作のスケジュール
POST
/rhp-restapi/rhp/images
このリクエストの本体で指定されたソフトウェア・ホームからゴールド・イメージを作成します。Oracle Database、Grid Infrastructureまたはその他のソフトウェア・ホームを使用できます。
リクエスト
サポートされるメディア・タイプ
- application/json
ヘッダー・パラメータ
- Authorization: string
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。詳細は、高速ホーム・プロビジョニングの認証を参照してください。
ルート・スキーマ: ImportImageBody
タイプ:
ソースの表示
object
- auth(optional): string
認証プラグインを使用してリモート・ノードにアクセスします。
- authArgs(optional): object authArgs
使用可能なその他のプロパティ: additionalProperties選択した認証プラグインの追加プロパティ。
- cc(optional): string
作業用コピーの所有者に加えて、電子メール通知が送信されるユーザーのリスト。
- client(optional): string
クライアント・クラスタ名。
- host(optional): string
GIAASホスト名。
- imageName(optional): string
イメージの名前
- imageType(optional): string
ソフトウェア・タイプ。(Oracle Databaseソフトウェアの場合は"ORACLEDBSOFTWARE" (デフォルト)、Oracle Grid Infrastructureソフトウェアの場合は"ORACLEGISOFTWARE"、Oracle GoldenGateソフトウェアの場合はORACLEGGSOFTWARE、linux Opearting System ISOの場合は"LINUXOS"、その他のすべてのソフトウェアの場合は"SOFTWARE"です。カスタム・イメージ・タイプの場合はイメージ・タイプ名を使用します。)
- notify(optional): boolean
デフォルト値:
false
電子メール通知を送信します。 - patches(optional): string
カンマ区切りのバグ番号またはNFSダウンロード済zipの場所(あるいはその両方の組合せ)。
- path(optional): string
インポートするソフトウェア・ホームの絶対パスの場所(データベース・イメージの場合、これはORACLE_HOMEになります)。
- pathOwner(optional): string
指定したパスの下のファイルへの読取りアクセス権を持つユーザー。
- port(optional): string
1024から65536の範囲のポート番号。
- psu(optional): string
バグ番号またはダウンロードしたzipの場所またはリリースされたPSU/BP。
- root(optional): boolean
デフォルト値:
false
ルート資格証明を使用してリモート・ノードにアクセスします。 - schedule(optional): string
ISO-8601形式の操作を実行する優先時間。例: 2016-12-21T19:13:17+05.
- state(optional): string
指定できる値:
[ "TESTABLE", "RESTRICTED", "PUBLISHED" ]
状態名。 - sudoPath(optional): string
sudoバイナリの場所。
- sudoUser(optional): string
sudoユーザー名としてスーパーユーザー操作を実行します。
- superUserPasswd(optional): string
スーパーユーザー・アカウントのパスワード。
- targetnode(optional): string
操作を実行する必要があるノード。
- useractiondata(optional): string
useractionスクリプトのuseractiondataパラメータに渡される値。
- version(optional): string
GIAASのOracle Databaseのバージョン、ODAPATCHSOFTWAREのODAパッチバンドル・バージョン。
- zip(optional): string
インポートする圧縮ソフトウェア・ホームの絶対パス(ZIPまたはTARファイル)。
セキュリティ
- 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
で指定したpath
のソフトウェア・ホームからゴールド・イメージをインポートする方法を示しています。
curl -u restUser -X POST -H "Content-Type: application/json" -d "@body.json" "https://RHP_node_name:8894/rhp-restapi/rhp/images"
HTTPステータス・コードとレスポンス・ヘッダー
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 202
Location: https://rhpNodeName: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 GM
リクエスト本体(body.json)
{
"imageName": "DB_Image1",
"path": "/oracle/dbwc1"
}
レスポンス本体
{
"links": [{
"uri": "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1",
"rel": "self"
}],
"jobId": "1",
"output": { }
}