管理対象外のOracle Databaseソフトウェア・ホームのアップグレード
PUT
/rhp-restapi/rhp/databases/{dbUniqueName}
指定したOracle Databaseソフトウェア・ホーム上のデータベースのアップグレード
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- dbUniqueName(必須): string
プロビジョニングされるデータベースの名前(DB_UNIQUE_NAME)
ヘッダー・パラメータ
- Authorization(必須): string
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。詳細は、「フリート・パッチ適用およびプロビジョニングの認証」を参照してください。
ルート・スキーマ: UpgradeDatabaseBody
タイプ:
ソースの表示
object
- abort: string
進行中の操作を中止します
- auth: string
認証プラグインを使用してリモート・ノードにアクセスします。
- authArgs: object authArgs
使用可能なその他のプロパティ: additionalProperties選択した認証プラグインの追加プロパティ。
- client: string
クライアント・クラスタ名
- dbuaArgs: string
DBUAのオプション引数を含む引用符で囲まれた文字列
- destwc: string
データベースをアップグレードする必要のある宛先作業用コピーの名前
- drainTimeout: string
秒単位で指定されたサービス・ドレイン・タイムアウト
- eval: boolean
デフォルト値:
false
コマンドを実行せずに評価します。 - fra: string
フラッシュ・リカバリ領域の場所。
- grp: string
自動アップグレードでは、データベースのリストアに保証付きリストア・ポイント(GRP)を生成します。デフォルトはYESです。
- ignoreGroupCheck: string
データベースのアップグレード中にOSDBAおよびOSASM以外のグループ・チェックをスキップします
- ignoreMissingPatches: string
ソース・パスまたは作業用コピーに存在する指定のパッチが、宛先パスまたは作業用コピーにない場合でも、移動/アップグレードを続行します
- ignoreprereq: boolean
デフォルト値:
false
CVUの前提条件チェックを無視する場合。 - imageName: string
イメージの名前
- path: string
インポートするソフトウェア・ホームの絶対パスの場所(データベース・イメージの場合、これはORACLE_HOMEになります)。
- preupg: string
指定したデータベースに対してアップグレード前のチェックを実行します。
- revert: string
Oracle Databaseの失敗したアップグレードを元に戻します
- root: boolean
デフォルト値:
false
ルート資格証明を使用してリモート・ノードにアクセスします。 - runUtlrp: string
自動アップグレード・プロセスの一部として無効なオブジェクトの再コンパイルを有効または無効にします。デフォルトはYESです。
- schedule: string
ISO-8601形式の操作を実行する優先時間。たとえば: 2016-12-21T19:13:17+05.
- sourceHome: string
ソースOracleホーム・パス
- sourcewc: string
Oracle Grid Infrastructureホームをアップグレードする必要があるソースの作業用コピーの名前。
- sudoPath: string
sudoバイナリの場所。
- sudoUser: string
sudoユーザー名としてスーパーユーザー操作を実行します。
- superUserPasswd: string
スーパーユーザー・アカウントのパスワード。
- targetNode: string
操作を実行する必要があるノード
- tgtCdbName: string
非CDB OracleデータベースがプラグインされるターゲットCDBのDB_UNIQUE_NAME。
- tgtPdbName: string
非CDBソース・データベースがPDBとしてターゲットCDBにプラグインされたときに割り当てる新しい名前。
- upgTimezone: string
自動アップグレードの一部としてタイムゾーンのアップグレードを有効または無効にします。デフォルトはYESです。
セキュリティ
- basicAuthentication: basic
タイプ:
Basic
レスポンス
サポートされるメディア・タイプ
- application/json
- text/html
202 レスポンス
承認済。進行状況のステータスおよび出力を取得するために承認された操作のジョブ・リソース詳細を含むJSONオブジェクト。
ヘッダー
- Location: string
操作を実行するジョブへのURL
ルート・スキーマ: jobResource
タイプ:
ソースの表示
object
- jobId: string
- links: array links
- operation: string
- output: object jobOutputResource
- status: string
指定できる値:
[ "SCHEDULED", "UNKNOWN", "EXECUTING", "PAUSED", "ABORTED", "TERMINATED", "FAILED", "SUCCEEDED" ]
ネストされたスキーマ: jobOutputResource
タイプ:
ソースの表示
object
- hasMore: boolean
デフォルト値:
false
- limit: integer
- links: array links
- offset: integer
- output: string
ネストされたスキーマ: singleResourceLinks
タイプ:
ソースの表示
object
- href: string
絶対形式で指定された参照ハイパーリンク要素。
- rel: string
指定できる値:
[ "self", "collection", "up", "describedBy" ]
説明されたリソースを持つリンクの関係のタイプを指定します。
ネストされたスキーマ: collectionResourceLinks
タイプ:
ソースの表示
object
- href: string
正しいURLパラメータを持つ絶対形式で指定された参照ハイパーリンク要素。
- rel: string
指定できる値:
[ "next", "prev", "first", "last" ]
説明されたリソースを持つリンクの関係のタイプを指定します。
400 レスポンス
不正なリクエスト。パラメータ値または名前の解析中に見つかった問題のエラー詳細を含むJSONオブジェクト。
ルート・スキーマ: errorResource
タイプ:
ソースの表示
object
- errorCode: string
tittleに表示されるエラー・メッセージに関連する、アプリケーション固有のエラー・コード。
- errorDetails: array errorDetails
複数のエラーがレポートされている場合は、この配列の階層構造に編成できます。
- errorPath: string
エラーの発生場所を示すXPathまたはJSONパス。
- instance: string
エラーに関する詳細を提供するリンクへのURI。
- status: integer
HTTPステータス・コード。
- title: string
要約エラー・メッセージ。
- type: string
HTTPエラー・コード・ページへのリンク。
デフォルト・レスポンス
予期しないエラー操作の実行中の問題のエラー詳細を含むJSONオブジェクト。
ルート・スキーマ: errorResource
タイプ:
ソースの表示
object
- errorCode: string
tittleに表示されるエラー・メッセージに関連する、アプリケーション固有のエラー・コード。
- errorDetails: array errorDetails
複数のエラーがレポートされている場合は、この配列の階層構造に編成できます。
- errorPath: string
エラーの発生場所を示すXPathまたはJSONパス。
- instance: string
エラーに関する詳細を提供するリンクへのURI。
- status: integer
HTTPステータス・コード。
- title: string
要約エラー・メッセージ。
- type: string
HTTPエラー・コード・ページへのリンク。
例
次の例は、cURLを使用してRESTリソースに対するPUTリクエストを発行することによって、指定したOracle Databaseソフトウェア・ホームから宛先作業用コピーへデータベースをアップグレードする方法を示しています。
curl -u restUser -X PUT -H "Content-Type: application/json" -d "@body.json" "https://RHP_node_name:8894/rhp-restapi/rhp/databases/dbwc1"
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)
{
"sourceHome" : "/oracle/database/src/home",
"destwc" : "DB_Wcopy181"
}
レスポンス本体
{
"links": [{
"uri": "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1",
"rel": "self"
}],
"jobId": "1",
"output": { }
}