クラスタのスケール・イン
/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/servers/{name}
この項は、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 ResponseAccepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。本文レスポンス本文には、スケール操作に関する情報が含まれます。ルート・スキーマ: scale-responseネストされたスキーマ: 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" } }