管理対象サーバーの追加
post
/api/v1.1/instances/{identityId}/{serviceId}/servers/{clusterName}
指定されたクラスタに新規の管理対象サーバーを追加します。 1つのノードの要因によって、サービスをスケーリングします。
リクエスト
パス・パラメータ
- clusterName
-
タイプ:
string
必須:true
クラスタの名前。
問合せのパラメータ
- createClusterIfMissing
-
タイプ:
boolean
trueに設定すると、クラスタが存在しない場合に、指定した名前でクラスタが作成されます。
レスポンス
サポートされるメディア・タイプ
- application/json
- text/plain
デフォルト・レスポンス
成功した操作
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによってOracle SOA Cloud Serviceインスタンスを1ノードずつスケール・アウトする方法を示しています。 詳細は、「cURLの使用」を参照してください。
Oracle SOA Cloud Serviceインスタンスのスケーリングに関する項も参照してください。
cURLコマンド
curl -i -X POST -u joe@example.com:Welcome1! -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/servers/ExampleI_cluster
注意:: この例では、アメリカ合衆国でのURL接頭辞(soacs)を使用しています。 世界の他の地域のURL接頭辞の詳細は、「リクエストの送信」を参照してください。
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 202 Accepted Date: Thu, 29 Jan 2015 21:20:52 GMT Transfer-Encoding: chunked Location: https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/servers/history/job/17 Content-Type: application/json
レスポンス本文の例
JSON形式で返されるレスポンス・ドキュメントの例を次に示します。
{ "status": "New", "details": { "message": "JASS-SCALING-037: Scale out Job (ID: 17) for service [ExampleInstance] in cluster [ExampleI_cluster] submitted", "jobId": "17" } }