管理対象外のGrid Infrastructureソフトウェア・ホームへのパッチ適用
PATCH
/rhp-restapi/rhp/gihome/{destWcId}
Oracle Grid Infrastructureをソース・ホーム・パスから宛先作業用コピーに移動します。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- destWcId(必須): string
Oracleソフトウェアを移動する必要がある宛先作業用コピーの名前
ヘッダー・パラメータ
- Authorization(必須): string
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。詳細は、「フリート・パッチ適用およびプロビジョニングの認証」を参照してください。
ルート・スキーマ: MoveGihomeBody
タイプ:
ソースの表示
object
- abort: boolean
デフォルト値:
false
進行中の"move"操作を中断します。 - agpath: string
永続的Oracleホームのパスの読取り/書込みパス。
- aupath: string
永続的Oracleホーム・パスの読取り専用ゴールド・イメージ・パス。
- auth: string
認証プラグインを使用してリモート・ノードにアクセスします。
- authArgs: object authArgs
使用可能なその他のプロパティ: additionalProperties選択した認証プラグインの追加プロパティ。
- auto: boolean
デフォルト値:
false
Grid Infrastructureへのパッチ適用とともに自動的にデータベースにパッチを適用します。 - batches: string
"(nA,nB,...),(...,nY,nZ)"の書式で二重引用符("")で囲んだノードのバッチのカンマ区切りリスト(各バッチがカッコで囲まれたノード名のカンマ区切りリストになる)。
- chainBatches: boolean
デフォルト値:
false
各バッチの後に停止せずに、ユーザーが指定したすべてのバッチで移動操作を次々に実行します - checkDbPatching: boolean
デフォルト値:
false
ターゲット・クラスタ内ですでに進行中の"move database"操作が存在しないことを確認してください - cleanpids: boolean
デフォルト値:
false
Oracle Grid Infrastructureの移動操作中にプロセスをクリーン・アップします。 - continue: boolean
デフォルト値:
false
次のノードのバッチでCRSスタックの再起動を続行します。 - dbhomes: string
ソースおよび宛先作業用コピーのマッピング: "
= ,..., = ". - dblist: string
指定したデータベースのみパッチを適用します。
- disconnect: boolean
デフォルト値:
false
サービスを停止または再配置する前にすべてのセッションを切断します。 - drainTimeout: integer(int32)
秒単位で指定されたサービス・ドレイン・タイムアウト。
- eval: boolean
デフォルト値:
false
コマンドを実行せずに評価します。 - excludedblist: string
指定したデータベースを除くすべてのデータベースにパッチを適用します。
- excludeDbs: string
FPPによる起動対象から除外されたデータベースの名前(DB_UNIQUE_NAME)のカンマ区切りリストを含むファイルのパス
- firstnode: string
非推奨です。
- forceComplete: boolean
デフォルト値:
false
強制的に進行中の移動操作を完了します。 - ignoreCvuPostCheck: boolean
デフォルト値:
false
Oracle Grid Infrastructureのパッチ適用後のCVUチェックを無視します。 - ignoreCvuPreCheck: boolean
デフォルト値:
false
Oracle Grid Infrastructureのパッチ適用前のCVUチェックを無視します。 - ignoreDBStartError: boolean
デフォルト値:
false
Oracle Grid Infrastructureのパッチ適用時のデータベース起動エラーを無視します。 - ignorewcpatches: boolean
デフォルト値:
false
ソースのパスまたは作業用コピーには存在するパッチの一部がパッチ適用済作業用コピー内になくても無視します。 - imageName: string
イメージの名前
- isoRepo: string
ISOイメージ名を指定します
- keepplacement: boolean
デフォルト値:
false
管理者管理のOracle RACデータベースまたはOracle RAC Oneデータベースのサービスが移動操作の前と後で同じインスタンスで実行されるようにします。 - liveUpdate: string
指定できる値:
[ "highcvss", "allcvss", "full" ]
Exadata Databaseノードのライブ・アップデートの実行 - nodatapatch: boolean
デフォルト値:
false
移動中のデータベースに対して"datapatch"を実行しないことを示します。 - noDataPatch: boolean
デフォルト値:
false
移動中のデータベースに対して'datapatch'を実行しないことを示します - noDriverUpdate: boolean
デフォルト値:
false
パッチにドライバ・パッチが含まれる場合、ドライバのパッチ適用をスキップします。 - nonrolling: boolean
デフォルト値:
false
非ローリング・モードでOracleホームを移動します。 - noParallel: string
指定できる値:
[ "YES", "NO" ]
入力バッチのノードを逐次処理し、バッチのすべてのノードが完了したら終了します - patchMgrArgs: string
パッチ・マネージャのオプション引数を含む引用符で囲まれた文字列
- patchMgrLoc: string
パッチ・マネージャの場所
- path: string
宛先作業用コピーの絶対パス。
- revert: boolean
デフォルト値:
false
バッチ移動またはスマート移動の場合、ソースOracleホームまたは作業用コピーに戻ります。 - root: boolean
デフォルト値:
false
ルート資格証明を使用してリモート・ノードにアクセスします。 - saf: string
サービスの可用性ファクタ。移動中にサービスが実行中のままになるインスタンスの最小割合です。
- schedule: string
ISO-8601形式の操作を実行する優先時間。たとえば: 2016-12-21T19:13:17+05.
- skipCvuPostCheck: boolean
デフォルト値:
false
Oracle Grid Infrastructureのパッチ適用後のCVUチェックをスキップします。 - skipCvuPreCheck: boolean
デフォルト値:
false
Oracle Grid Infrastructureのパッチ適用前のCVUチェックをスキップします。 - skipDatapatchChecks: boolean
デフォルト値:
false
データパッチの健全性チェックを実行しません - smartMove: boolean
デフォルト値:
false
ノードのバッチのリストを自動生成し、バッチ順にインスタンスを再起動してデータベースを移動します。 - smtpFrom: string
patchmgr通知の送信元のアドレス
- smtpTo: string
patchmgr通知の送信先のアドレス
- sourceHome: string
ソースOracleホーム・パス
- stopoption: string
指定できる値:
[ "ABORT", "IMMEDIATE", "NORMAL", "TRANSACTIONAL", "TRANSACTIONAL_LOCAL" ]
データベースの停止オプション - sudoPath: string
sudoバイナリの場所。
- sudoUser: string
sudoユーザー名としてスーパーユーザー操作を実行します。
- superUserPasswd: string
スーパーユーザー・アカウントのパスワード。
- targetNode: string
操作を実行する必要があるノード
- tgip: boolean
デフォルト値:
false
Oracle Grid Infrastructureホームの透過的移動を実行します。 - userActionData: string
useractionスクリプトのuseractiondataパラメータに渡される値。
セキュリティ
- 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リソースに対するPATCHリクエストを発行することによって、リクエスト本体body.json
ですべての引数が指定されている、管理対象外のOracle Grid Infrastructureソフトウェア・ホームにパッチを適用する方法を示しています。
curl -u restUser -X PATCH -H "Content-Type: application/json" -d "@body.json" "https://RHP_node_name:8894/rhp-restapi/rhp/gihome/GI_WCopy183"
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/source/home"
}
レスポンス本体
{
"links": [{
"uri": "https://RHP_node_name:8894/rhp-restapi/rhp/jobs/1",
"rel": "self"
}],
"jobId": "1",
"output": { }
}