サービス・インスタンス・ライフサイクル操作のステータスの表示
/paas/service/jcs/api/v1.1/instances/{identityDomainId}/status/{requestName}/job/{jobId}
リクエスト
- identityDomainId
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- jobId
型:string
必須:true
ジョブID。- requestName
型:string
必須:true
ステータスを表示するリクエストの名前。 有効な値は次のとおりです。create
: サービス・インスタンス作成操作のステータスを表示します(「サービス・インスタンスの作成」)。delete
: インスタンス削除操作のステータスを表示します(「サービス・インスタンスの削除」)。control
: ライフサイクル状態の制御操作のステータスを表示します(「サービス・インスタンスおよび個々のVMの停止と起動」)。scale
: Coherenceデータ層のスケール操作のステータスを表示します(「Coherenceデータ層のスケーリング」および「Coherenceデータ層クラスタの追加」)。
ヘッダー・パラメータ- X-ID-TENANT-NAME
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
レスポンス
サポートされているメディア・タイプ- application/vnd.com.oracle.oracloud.provisioning.Service+json
200レスポンスOK (操作が完了した場合)。 後述のルート・スキーマを参照してください。202 Response受入れ済(操作が実行中の場合)。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。本文レスポンス本文には、サービス・インスタンスの情報および操作のステータスが含まれます。ルート・スキーマ: lifecyclestatus-responseレスポンス本文には、サービス・インスタンスの情報および操作のステータスが含まれます。- auto_update
-
型:
boolean
メンテナンス中にOracle Cloud Toolsに対する更新が自動的にOracle Java Cloud Serviceインスタンスに適用されるかどうかを指定するフラグ。 Oracle Cloud Toolsは、サービス・インスタンスのライフサイクルの管理に使用されます。 - コンプライアンス・ステータス
-
型:
string
Oracle Cloud Toolsのバージョンがコンプライアンスに準拠しているかどうかを示すステータス。 OracleはOracle Cloud Toolsを使用して、サービス・インスタンスのライフサイクルを管理します。Oracle Cloud Toolsがコンプライアンスに準拠していない場合、この属性は次のステータス値のいずれかに設定されます。
NEW_VERSION
: Oracle Cloud Toolsの新しいバージョンを使用できることを示します。 この更新をできるだけ早く適用することをお薦めします。DEPRECATED
: Oracle Cloud Toolsの現行バージョンは非推奨になっていることを示します。 最新のOracle Cloud Tools更新を適用し、将来のサービスの中断を回避します。UNSUPPORTED
: Oracle Cloud Toolsの現行バージョンはサポートされていないことを示します。 最新のパッチを適用して、通常の操作を再開します。
Oracle Cloud Toolsが最新の場合、この属性は空白になります。
- compliance_status_desc
-
型:
string
Oracle Java Cloudサービス・インスタンスのライフサイクルを管理するために使用されるOracle Cloud Toolsのコンプライアンス・ステータスに関する詳細を提供する説明。 Oracle Cloud Toolsがコンプライアンスに準拠していない場合、この属性は次のステータス値のいずれかになります。Oracle Cloud Toolsがコンプライアンスに準拠していない場合、この属性は次のステータス値のいずれかに設定されます。NEW_VERSION
: Oracle ツールのより新しいバージョンlatestVersion
を使用できます。 この更新には、Oracle Cloud Toolsに対するクリティカルな修正が含まれます。 OracleはCloud Toolsを使用して、サービスのライフサイクルを管理します。 この更新をできるだけ早く適用することをお薦めします。DEPRECATED
: OracleツールのバージョンdeprecatedVersion
は非推奨であるため、このサービスは、現在、非推奨の状態にあります。 このバージョンは将来サポートされなくなる可能性があるため、最新のOracleツールの更新を適用してください。UNSUPPORTED
: Oracleツール・バージョンunsupportedVersion
は廃止されたため、このサービスは現在サポートされていない状態にあります。 最新のパッチを適用して、通常の操作を再開します。
Oracle Cloud Toolsが最新の場合、この属性は空白になります。
- created_by
-
型:
string
Oracle Java Cloud Serviceインスタンスの作成に使用されるユーザー・アカウントの名前。 - creation_time
-
型:
string
Oracle Java Cloud Serviceインスタンスが作成された日付および時間。 - description
-
型:
string
サービス・インスタンスに関する追加情報を提供する自由形式のテキスト。 - error_status_desc
-
型:
string
Oracle Java Cloud Serviceインスタンスがエラー状態にある理由を説明するエラー・ステータス。 次に、説明の例を示します。This service is currently in an erroneous state as the tools are in an inconsistent state. Reason - error details. Apply the latest tools patch to resume normal operations on this service.
- identity_domain
-
型:
string
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- last_modified_time
-
型:
string
Oracle Java Cloud Serviceインスタンスが変更された日付および時間。 - message
-
タイプ:
array
messageサービス・インスタンスのライフサイクル操作中に返されたシステム・メッセージが含まれています。 - service_name
-
型:
string
Oracle Java Cloud Serviceインスタンスの名前。 - service_uri
-
型:
string
Oracle Java Cloud ServiceインスタンスのリソースURL。 - status
-
型:
string
Oracle Java Cloud Serviceインスタンスのステータスを指定するフラグ。 有効な値は、「Running
」、「In Progress
」、「Maintenance
」、「Stopped
」、「Terminating
」および「Failed
」です。 - version
-
型:
string
Oracle Fusion Middleware ソフトウェア・バージョン。 例:12cRelease212
、12cRelease2
、12cR3
および11g
。 - wlsVersion
-
型:
string
Oracle WebLogic Serverのソフトウェア・バージョン。 例:12.2.1.2.0
、12.2.1.0.x
、12.1.3.0.x
および10.3.6.0.x
。
ネストされたスキーマ: message例
次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによってOracle Java Cloud Serviceインスタンス操作のステータスを表示する方法を示しています。 サービス・インスタンス・リクエストを発行すると、LocationヘッダーでRESTリソースURIが返されます。
注意: この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。
cURLコマンド
次のコマンドにより、サービス・インスタンスのcreate操作のステータスが返されます。 他の操作はdelete、scaleおよびcontrolです。
curl -i -X GET -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/status/create/job/7495
レスポンス・ヘッダーの例
完了したcreate操作のレスポンス・ヘッダーの例を次に示します。
HTTP/1.1 200 OK Date: Thu, 25 Aug 2016 22:52:41 GMT Transfer-Encoding: chunked Content-Type: application/vnd.com.oracle.oracloud.provisioning.Service+json Service-URI: https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/Exampleinstance
レスポンス本文の例
create操作のレスポンスのコンテンツの例を次に示します。 レスポンスの出力は操作タイプによって異なります。
{ "service_name": "ExampleInstance", "version": "12cR3", "wlsVersion": "12.1.3.0.160419", "status": "In Progress", "error_status_desc": "", "compliance_status": "", "compliance_status_desc": "", "auto_update": "true", "description": "Example, Inc product distribution", "identity_domain": "ExampleIdentityDomain", "creation_time": "Thu Aug 25 22:32:8 UTC 2016", "last_modified_time": "Thu Aug 25 22:32:6 UTC 2016", "created_by": "username", "service_uri" : "https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance", "message": [ "Created Compute resources for WebLogic Server...", "Created security resources for the service...", "Started all Compute resources...", "Established SSH connectivity to WebLogic Administration Server...", "WebLogic Administration Server Configuration completed...", "WebLogic Managed Servers Configuration completed...", " Configuration check for Host [exampleinstance-wls-1] containing WebLogic Managed Server(s) [[ExampleI_server_1]] completed...", "Successfully provisioned WebLogic Administration Server and 1 Managed Servers...", " Service Reachabilty Check (SRC) of WebLogic Administration Server completed...", " Service Reachabilty Check (SRC) of WebLogic Managed Server(s) [ExampleI_server_1] completed...", "Established SSH connectivity to Load Balancer...", "Configured Load Balancer...", "Performing Service Reachability Check (SRC) of Load Balancer...", "Service Reachabilty Check (SRC) of Load Balancer completed..." ] }