機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. サービス・インスタンス

サービス・インスタンスおよび個々のVMの停止と起動

post

/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}

サービス・インスタンスとその仮想マシン(VM)のライフサイクル状態を制御します。 具体的には、次のことができます。
  • Oracle Java Cloud ServiceインスタンスとそのすべてのVMの停止または起動
  • 管理サーバーとそれに関連付けられたVMの再起動
  • ロード・バランサとそれに関連付けられたVMの停止、起動または再起動
  • 管理対象サーバーとそれに関連付けられたVMの停止、起動または再起動

Oracle Public Cloudでインスタンスを停止および起動したときの動作の詳細は、Oracle Java Cloud Serviceの使用のOracle Java Cloud Serviceインスタンスおよび個別のVMの停止および起動に関する項を参照してください。 たとえば、Coherenceデータ層を持つサービス・インスタンスが停止された場合、Coherenceキャッシュのすべてのデータが失われます。 Oracle Cloud Machineの場合、OPCMでのOracle Java Cloud Serviceの使用のOracle Java Cloud Serviceインスタンスおよび個別のVMの停止および起動に関する項を参照してください。

注意: Oracle Public Cloudで請求頻度が毎時の場合、Oracle Java Cloud Serviceインスタンスが停止状態のときの時間に対しては請求されません。

リクエスト

サポートされているメディア・タイプ
  • application/vnd.com.oracle.oracloud.provisioning.Service+json
パス・パラメータ
identityDomainId
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。

Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

serviceId
型: string
必須: true
Oracle Java Cloud Serviceインスタンスの名前。
ヘッダー・パラメータ
X-ID-TENANT-NAME
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。

Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

本文パラメータ
リクエスト本文では、サービス・インスタンスまたはVMライフサイクル・リクエストの詳細を定義します。
ルート・スキーマ: stopstart-postrequest

レスポンス

サポートされているメディア・タイプ
  • application/json
202 Response
Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

Locationヘッダーは、サービス・インスタンス・リクエストのステータスにアクセスする際に使用できるREST URIを返します(「サービス・インスタンス・ライフサイクル操作のステータスの表示」を参照)。

例

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによってmanagedServer1という名前の管理対象サーバーを再起動する方法を示しています。

注意: この例のコマンドでは、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コマンド

curl -i -X POST -u username:userPassword1! -d @restartServer.json -H "Content-Type:application/vnd.com.oracle.oracloud.provisioning.Service+json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します。 この例では、指定した管理対象サーバーが実行されているVMを再起動します。 forceフラグをtrueに設定すると、VM上で複数の管理対象サーバーが実行されている場合に、VMを確実に再起動できます。 

{
    "lifecycleState" : "restart",
    "force" : true,
    "serverName" : "managedServer1"
}

レスポンス・ヘッダーの例

次にレスポンス・ヘッダーの例を示します。

Locationヘッダーは、ライフサイクル状態のリクエストのステータスにアクセスする際に使用できるRESTリソースを返します。 詳細は、「サービス・インスタンス・ライフサイクル操作のステータスの表示」を参照してください。

ライフサイクル状態のリクエストの処理中にサービス・インスタンスの詳細を表示すると、lifecycle_control_job_id属性からライフサイクル状態のジョブID (次の例では138)を取得でき(「すべてのサービス・インスタンスの表示」および「サービス・インスタンスの表示」を参照)、さらにそのジョブIDを使用してリクエストのステータスを表示できます(「サービス・インスタンス・ライフサイクル操作のステータスの表示」を参照)。

HTTP/1.1 202 Accepted
Date: Tue, 07 Apr 2015 14:07:04 GMT
Location: https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/status/control/job/138
Content-Length: 0
Content-Type: application/json