Oracle Java Cloud Service REST API

機械翻訳について

すべての管理対象サーバーの表示

get

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

Oracle Java Cloud Serviceインスタンスのすべての管理対象サーバーに関する情報を返します。

リクエスト

パス・パラメータ

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の場合)。

レスポンス

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

application/json

200レスポンス

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

本文

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

プロパティ

serverInProgress: 型: array serverInProgress

現在進行中のサーバー作成がある場合、その詳細をグループ化します。
servers: 型: array servers

サービス・インスタンスに対して定義されているサーバーの詳細をグループ化します。

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

型: array

現在進行中のサーバー作成がある場合、その詳細をグループ化します。

アイテム

型: object allservers

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

型: array

サービス・インスタンスに対して定義されているサーバーの詳細をグループ化します。

アイテム

型: object allservers

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

プロパティ

clusterName: 型: string

管理対象サーバーの所属するクラスタの名前。
creationDate: 型: string

サーバーが作成された日時。
hostname: 型: string

サーバーのホスト名。
isAdmin: 型: boolean

この管理対象サーバーが管理サーバーも兼ねているかどうかを示すフラグ。
jobId: 型: string

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

サーバーの名前。
nodeType: 型: string

ノードのタイプたとえば、WLSまたはDG。
reservedIp: 型: string

この属性は、Oracle Cloud Machineでのみ使用できます。それはもはや使用されていません。
reservedIpAddress: 型: string

この属性は、Oracle Public Cloudでのみ使用できます。サービス・インスタンスでOracle Exadataデータベースが使用されている場合にのみ表示されます。
マネージド・サーバーに割り当てられているIP予約のIPアドレス。
reservedIpName: 型: string

この属性は、Oracle Public Cloudでのみ使用できます。サービス・インスタンスでOracle Exadataデータベースが使用されている場合にのみ表示されます。
管理対象サーバーに割り当てられているIP予約の名前。
shape: 型: string

サーバーのコンピューティング・シェイプを計算します。
Oracle Public Cloudの場合、『Oracle Compute Cloud Serviceの使用 (for PaaS)』のマシン・イメージとシェイプに関する項を参照してください。
status: 型: string

操作の状態たとえば、Readyです。
storageAllocated: 型: string

割り当てられるストレージの量(MB)。

例

次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによってOracle Java Cloud Serviceインスタンスのすべての管理対象サーバーに関する情報を表示する方法を示しています。

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

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

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

HTTP/1.1 200 OK
Date: Wed, 11 May 2016 16:48:25 GMT
Transfer-Encoding: chunked
Content-Type: application/json

レスポンス本文の例

レスポンス本文の例を次に示します。

{
   "servers":[
   {
      "clusterName":"ExampleI_cluster",
      "name":"ExampleI_server_1",
      "shape":"oc3",
      "nodeType":"WLS",
      "isAdmin":true,
      "hostname":"123.45.6.78",
      "status":"Ready",
      "reservedIp":"",
      "storageAllocated":47000,
      "creationDate":"May 11, 2016 3:58:40 PM"
   },
   {
      "clusterName":"ExampleI_cluster"",
      "name":"ExampleI_server_2",
      "shape":"oc3",
      "nodeType":"WLS",
      "isAdmin":false,
      "hostname":"exampleinstance-wls-2",
      "status":"Ready",
      "reservedIp":"",
      "storageAllocated":27000,
      "creationDate":"May 11, 2016 3:58:43 PM"
   }],
   "serverInProgress":[
   {
      "clusterName":"MyCluster",
      "name":"MyCluste_server_3",
      "shape":"oc3",
      "nodeType":"WLS",
      "isAdmin":false,
      "hostname":"mycluster-wls-3",
      "status":"Preparing_VM",
      "reservedIp":"",
      "jobId":"705",
      "storageAllocated":28672,
      "creationDate":"May 11, 2016 4:29:17 PM"
   }]
}

次に、Coherenceデータ層の管理対象サーバーのみを表示する例を示します。

{
   "servers": [       
   {
       "clusterName": "ExampleI_DGCluster",
       "name": "ExampleI_server_3_DG",
       "shape": "oc3",
       "nodeType": "DG",
       "isAdmin": false,
       "hostname": "exampleinstance-wls-3",
       "status": "Ready",
       "reservedIp":"",
       "jobId": "11",
       "storageAllocated": 27000,
       "creationDate": "Jun 17, 2014 12:50:22 PM"
   },
   {
       "clusterName": "ExampleI_DGCluster",
       "name": "ExampleI_server_4_DG",
       "shape": "oc3",
       "nodeType": "DG",
       "isAdmin": false,
       "hostname": "exampleinstance-wls-4",
       "status": "Ready",
       "reservedIp":"",
       "jobId": "14",
       "storageAllocated": 27000,
       "creationDate": "Jun 17, 2014 2:17:00 PM"
   },
   {
       "clusterName": "ExampleI_DGCluster",
       "name": "ExampleI_server_5_DG",
       "shape": "oc3",
       "nodeType": "DG",
       "isAdmin": false,
       "hostname": "exampleinstance-wls-5",
       "status": "Ready",
       "reservedIp":"",
       "jobId": "201",
       "storageAllocated": 27000,
       "creationDate": "Jun 18, 2014 10:27:06 AM"
   }]
}

レスポンス本文の例(Oracle Public Cloud)

Oracle Public Cloudでは、Oracle Java Cloud ServiceインスタンスでOracle Exadataデータベースが使用されている場合、クラスタ内の各管理対象サーバーのIP予約名およびアドレスが返されます。例:

{
   "servers":[
   {
      "clusterName":"ExampleI_cluster",
      "name":"ExampleI_server_1",
      "shape":"oc3",
      "nodeType":"WLS",
      "isAdmin":true,
      "hostname":"123.45.6.78",
      "status":"Ready",
      "reservedIpName":"ipres01",
      "reservedIpAddress":"10.222.333.17",
      "storageAllocated":47000,
      "creationDate":"May 11, 2016 3:58:40 PM"
   },
   {
      "clusterName":"ExampleI_cluster"",
      "name":"ExampleI_server_2",
      "shape":"oc3",
      "nodeType":"WLS",
      "isAdmin":false,
      "hostname":"exampleinstance-wls-2",
      "status":"Ready",
      "reservedIpName":"ipres02",
      "reservedIpAddress":"10.222.343.121",
      "storageAllocated":27000,
      "creationDate":"May 11, 2016 3:58:43 PM"
   }
   ],
   "serverInProgress:[]
}