Oracle Java Cloud Service REST API

クラスタのスケール・イン

delete

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

管理対象サーバーを削除し、基本的に1ノードずつOracle Java Cloud Serviceインスタンスをスケール・インします。

この項は、Oracle Coherenceが有効なサービス・インスタンスをスケーリングする場合、アプリケーション層のスケール・インのみに適用されます。 Coherenceデータ層でのスケーリングの詳細は、「Coherenceデータ層のスケーリング」を参照してください。

クラスタのスケーリングは、Oracle Java Cloud Service - Virtual Imageインスタンスではサポートされていません。

クラスタのスケーリングは、WebLogic Server Standard Editionに基づくOracle Java Cloud Serviceインスタンスではサポートされません。

Oracle Public Cloudの場合: Oracle Exadataデータベースを使用するサービス・インスタンスでスケーリングしている場合、管理対象サーバー・ノードが削除されると、ノードに関連付けられているIP予約が解放されますが削除されません。

リクエスト

パス・パラメータ

identityDomainId: 型: string

必須: true

Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。
Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
name: 型: string

必須: true

削除する管理対象サーバーの名前。
serviceId: 型: string

必須: true

Oracle Java Cloud Serviceインスタンスの名前。

問合せパラメータ

force: 型: boolean

必須: true

実行中のプロセスの有無にかかわらず管理対象サーバーの削除を強制するかどうかを示すフラグ。この値のデフォルトはfalseです。

ヘッダー・パラメータ

X-ID-TENANT-NAME: 型: string

必須: true

Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。
Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

レスポンス

サポートされているメディア・タイプ

application/json

202 Response

Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

本文

レスポンス本文には、スケール操作に関する情報が含まれます。

ルート・スキーマ: scale-response

レスポンス本文には、スケール操作に関する情報が含まれます。

プロパティ

details: 型: object details

スケール操作の詳細をグループ化します。
status: 型: string

操作の状態初めて開始する際、ステータスはNewに設定されます。ステータスは次の値のどちらかに遷移します: CompletedおよびCannot Complete。

ネストされたスキーマ: details

タイプ: object

スケール操作の詳細をグループ化します。

プロパティ

jobId: 型: string

スケール操作のジョブID。
message: 型: string

操作を説明するシステム・メッセージ。たとえば、scaleup.job.submittedです

例

次の例では、cURLを使用してRESTリソースに対するDELETEリクエストを発行することによってOracle Java Cloud Serviceインスタンスを1ノードずつスケール・インする方法を示しています。

注意: この例のコマンドでは、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 DELETE -u username:userPassword1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/servers/ExampleI_server_4

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

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

HTTP/1.1 202 Accepted
Connection: close
Date: Thu, 29 Jan 2015 21:11:01 GMT
Transfer-Encoding: chunked
Location: https://rest_server_url/paas/service/jcs/api/v1.1/instances/ExampleIdentityDomain/servers/history/job/20
Content-Type: application/json

レスポンス本文の例

JSON形式で返されるレスポンス・ドキュメントの例を次に示します。

{
   "status": "New",
   "details": {
      "message": "JAAS-SCALING-044: Scaling in Job (ID: 20) server name [ExampleI_server_4] submitted for service [ExampleInstance]",
      "jobId": "20"
   }
}