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

サービス・インスタンスの表示

get

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

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/vnd.com.oracle.oracloud.provisioning.Service+json
200レスポンス
OK。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
本文
レスポンス本文には、指定されたOracle Java Cloud Serviceインスタンスに関する情報が含まれます。
ルート・スキーマ: instance-response
レスポンス本文には、指定されたOracle Java Cloud Serviceインスタンスに関する情報が含まれます。
ネストされたスキーマ: db_associations
型: array
使用されているDatabase Cloud Serviceデータベース・デプロイメントおよびデータベースの詳細をグループ化します。
ネストされたスキーマ: options
型: array
Coherenceデータ層に関する情報をグループ化します。
ネストされたスキーマ: service_components
型: array
サービス・コンポーネントの詳細をグループ化します。
ネストされたスキーマ: db_associations
ネストされたスキーマ: options
サービス・インスタンスを表示する場合、サービス・インスタンスでOracle Coherenceが有効にされているとこの属性が返されます。

すべてのサービス・インスタンスを表示する場合、?outputLevel=verbose問合せパラメータが設定されているとこの属性が返されます。

ネストされたスキーマ: clusters
型: array
datagridクラスタに関する情報をグループ化します。
ネストされたスキーマ: clusters
サービス・インスタンスを表示する場合、サービス・インスタンスでOracle Coherenceが有効にされているとこの属性が返されます。

すべてのサービス・インスタンスを表示する場合、?outputLevel=verbose問合せパラメータが設定されているとこの属性が返されます。

ネストされたスキーマ: scalingUnitInstances
型: array
サービス・インスタンスでプロビジョンされる容量単位に関する情報をグループ化します。
ネストされたスキーマ: scalingUnitInstances
ネストされたスキーマ: servers
型: array
容量単位でプロビジョニングされる管理対象サーバーに関する情報をグループ化します。
ネストされたスキーマ: datatierservers
ネストされたスキーマ: service_components

例

次の例では、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

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

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

HTTP/1.1 200 OK
Date: Tue, 14 Jun 2016 19:36:40 GMT
Transfer-Encoding: chunked
Content-Type: application/vnd.com.oracle.oracloud.provisioning.Service+json

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

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

{
    "service_name" : "ExampleInstance",
    "version" : "12cR3",
    "wlsVersion": "12.1.3.0.160419",
    "status" : "Running",
    "error_status_desc": "",
    "compliance_status": "",
    "compliance_status_desc": "",
    "auto_update": "true",
    "description" : "Example, Inc product distribution",
    "identity_domain" : "ExampleIdentityDomain",
    "creation_time": "Tue Jun 14 19:14:27 UTC 2016",
    "last_modified_time": "Tue Jun 14 19:14:25 UTC 2016",
    "created_by":"username",
    "service_uri" : "https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance",
    "domain_name" : "ExampleDomain",
    "domain_mode" : "PRODUCTION",
    "cluster_name" : "ExampleCluster",
    "num_nodes" : 3,
    "level" : "PAAS",
    "subscription_type" : "HOURLY",
    "edition" : "EE",
    "shape" : "oc3",
    "otd_provisioned" : "yes",
    "otd_shape" : "oc3",
    "otd_storage_size": 41984,
    "service_components": [
    {
        "type": "WLS",
        "version": "12.1.3.0.160419"
    },
    {
        "type": "OTD_JDK",
        "version": "1.7.0_101"
    },
    {
        "type": "OTD",
        "version": "11.1.1.9.2"
    },
    {
        "type": "JDK",
        "version": "1.7.0_101"
    }],
    "creation_job_id" : "8466",
    "deletion_job_id" : 0,
    "lifecycle_control_job_id" : 273,
    "db_info" : "myDBService:1521\/PDB1.exampleidentitydomain.oraclecloud.internal",
    "db_service_name" : "myDBService", 
    "num_ip_reservations" : 3,
    "wls_admin_url" : "https:\/\/192.0.2.0:7002\/console",
    "fmw_control_url" : "https:\/\/192.0.2.0:7002\/em",
    "otd_admin_url" : "https:\/\/192.0.2.23:8989",
    "sample_app_url": "https:\/\/192.0.2.23\/sample-app\/",
    "content_url" : "http:\/\/192.0.2.23",
    "secure_content_url" : "https:\/\/192.0.2.23",
    "wls_deployment_channel_port": 9001, 
    "psm_plugin_version": "16.3.1-132"
    "compute_site_name": "XY001_Z23",
    "db_associations": [
    {
        "db_service_name": "myAppDBService",
        "db_infra": false,
        "db_connect_string": "myAppDBService:1521\/PDB1A.exampleidentitydomain.oraclecloud.internal",
        "pdb_service_name": "PDB1A",
        "db_version": "12.1.0.2"
    },
    {
        "db_service_name": "myDBService",
        "db_infra": true,
        "db_connect_string": "myDBService:1521\/PDB1.exampleidentitydomain.oraclecloud.internal",
        "pdb_service_name": "PDB1",
        "db_version": "12.1.0.2"
    }]
}

サービス・インスタンスがAppToCloudアーティファクトとともに最近作成され、オンプレミスのドメインがまだインポートされていない場合、次の追加の属性が表示されます。

    "isApp2Cloud": "true",
    "shiftStatus": "readyToShift",

オンプレミスのドメインがAppToCloudサービス・インスタンスにインポートされている場合は、インポートのジョブIDが表示されます。 例: 

    "shiftStatus": "shiftCompleted",
    "shiftJobId": "30059",
    "isApp2Cloud": "true",

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

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

{
    "service_name" : "ExampleInstance",
    "version" : "12cR3",
    "wlsVersion" : "12.1.3.0.160419",
    "status" : "Running",
    "error_status_desc": "",
    "compliance_status": "",
    "compliance_status_desc": "",
    "auto_update": "true",
    "description" : "Example, Inc product distribution",
    "identity_domain" : "myTenantName",
    "creation_time": "Thu Aug 25 22:32:8 UTC 2016",
    "last_modified_time": "Thu Aug 25 22:32:6 UTC 2016",
    "created_by":"username",
    "service_uri" : "https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance",
    "domain_name" : "ExampleDomain",
    "domain_mode" : "PRODUCTION",
    "cluster_name" : "ExampleCluster",
    "num_nodes" : 3,
    "level" : "PAAS",
    "subscription_type" : "HOURLY",
    "edition" : "EE",
    "shape" : "oc3",
    "otd_provisioned" : "yes",
    "otd_shape" : "oc3",
    "otd_storage_size": 43008,
    "service_components": [
    {
        "type": "WLS",
        "version": "12.1.3.0.160419"
    },
    {
        "type": "OTD_JDK",
        "version": "1.7.0_101"
    },
    {
        "type": "OTD",
        "version": "11.1.1.9.2"
    },
    {
        "type": "JDK",
        "version": "1.7.0_101"
    }],
    "creation_job_id" : "1",
    "deletion_job_id" : 0,
    "lifecycle_control_job_id" : 273,
    "db_info": "mydbhost:1521\/dbservicename",   
    "num_ip_reservations" : 3,
    "wls_admin_url" : "https:\/\/thehost:7002\/console",
    "fmw_control_url" : "https:\/\/thehost:7002\/em",
    "otd_admin_url" : "https:\/\/thelbhost:8989",
    "sample_app_url": "https:\/\/thehost\/sample-app\/",
    "content_url": "http:\/\/thehost",
    "secure_content_url" : "https:\/\/thehost",
    "wls_deployment_channel_port": 9001, 
    "psm_plugin_version": "16.3.3-1-168",
    "compute_site_name": "PRIVATE_SITE",
    "db_associations": [
    {
        "db_connect_string": "mydbhost:1521\/dbservicename",
        "db_infra": true
    }]
}

レスポンス本文のDatagridオプションの例

次に、サービス・インスタンスで(Oracle Public CloudまたはOracle Cloud Machine上で)Oracle Coherenceが有効な場合のレスポンス本文のdatagridオプションに関する例を示します。

  "options": [{
    "type": "datagrid",
    "clusters": [{
      "clusterName": "ExampleI_DGCluster",
      "scalingUnitCount": 4,
      "scalingUnitName": "BASIC",
      "shape": "oc3",
      "vmCount": 1,
      "jvmCount": 1,
      "heapSize": "4608M",
      "maxScalingUnit": 30,
      "heapIncrements": "4608M",
      "primaryIncrements": "1536M",
      "totalHeap": "18432M",
      "totalPrimary": "6144M",
      "maxHeap": "138240M",
      "maxPrimary": "46080M",
      "scalingUnitInstances": [
        {
          "servers": [{"name": "ExampleI_server_3_DG"}],
          "scalingUnitInstanceId": 4,
          "status": "Ready"
        },
        {
          "servers": [{"name": "ExampleI_server_4_DG"}],
          "scalingUnitInstanceId": 6,
          "status": "Ready"
        },
        {
          "servers": [{"name": "ExampleI_server_2_DG"}],
          "scalingUnitInstanceId": 2,
          "status": "Ready"
        },
        {
          "servers": [{"name": "ExampleI_server_5_DG"}],
          "scalingUnitInstanceId": 8,
          "status": "Ready"
        }
      ]
    }]
  }]