Exadataインスタンスの管理

重要

My ServicesダッシュボードおよびAPIは非推奨です。

次の手順では、Oracle Cloud My Services APIを使用したExadataインスタンスの作成、変更、削除を順を追って説明します。

重要

これらの手順は、Oracle Database Exadata Database Service on Cloud@Customer限定です。詳細は、『Oracle Database Exadata Cloud at Customerの管理』を参照してください。この手順は、Oracle Cloud Infrastructureで使用可能なExadata Cloud Serviceには適用しないでください。

前提条件

Exadataインスタンスを管理するには、次のことが必要です:

  • Oracle Cloud Serviceへのサブスクライブ
  • 必要なロールが割り当てられたアカウント資格証明の取得
  • APIエンドポイントの特定
Oracle Cloud Serviceにサブスクライブするには

Oracle Cloud My Services APIにアクセスするには、Oracle Cloud Serviceのトライアルまたは有料サブスクリプションをリクエストする必要があります。

アカウント資格証明およびロールの割当てを取得するには

Oracle Cloud My Services APIにアクセスするには、アカウント管理者に次の項目を問い合せます。

  • アカウント資格証明:

    • ユーザー名とパスワード

    • アイデンティティ・ドメインID

      アイデンティティ・ドメインIDは、Identity Cloud Service (IDCS)におけるのユーザーのアイデンティティ・ドメインを識別するIDCS GUID、または従来のクラウド・アカウントのアイデンティティ・ドメイン名のいずれでもかまいません。

  • 前述のユーザー名に割り当てられている必須ロール

APIエンドポイントを特定するには

/itas//myservices/の間に、アカウント管理者から提供されたアイデンティティ・ドメインID (<domain>)を挿入します。

例:

https://itra.oraclecloud.com/itas/<domain>/myservices/api/v1/serviceEntitlements

Exadataインスタンスの作成

この項では、基本的なExadataインスタンス、IPネットワーク構成をカスタマイズしたインスタンス、および複数のVMをサポートするインスタンスの作成方法について説明します。

基本的なExadataインスタンスを作成するには

必要なペイロードを指定したリクエストを投稿して、特定のサービス資格(この場合はExadata)の新しいインスタンスを作成します。

次の例の<domain>はアイデンティティ・ドメインIDです。

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

属性

名前 説明
requestPayload.name

必須: はい

タイプ: 文字列

Exadataインスタンスの名前。この名前の要件:

  • 25文字より長くすることはできません。
  • 文字で始める必要があります。
  • 使用できるのは小文字と数字のみです。
  • 空白やその他の特殊文字は使用できません。
  • アイデンティティ・ドメイン内で一意であることが必要です。

requestPayload.

serviceEntitlementId

必須: はい

タイプ: 文字列

Exadataインスタンスのサービス資格。「Exadataサービス資格の検出」を参照してください。接頭辞cesi-やsub-は使用できません。

requestPayload.

customAttributes.

ExaUnitName

必須: はい

タイプ: 文字列

 

Exadata Database Machine環境の名前。この名前は、Oracle Grid Infrastructureインストールのクラスタ名としても使用されます。

requestPayload.

customAttributes.

CreateSparse

必須: はい

タイプ: 文字列

 

疎グリッド・ディスクに基づくディスク・グループを作成する場合はY、それ以外の場合はNにします。

Exadata Cloud Serviceスナップショットを有効にするには、このオプションを選択する必要があります。Exadataスナップショットにより、領域効率のよいOracleデータベースのクローンが有効化され、作成や破棄が非常に簡単にできるようになります。

requestPayload.

customAttributes.

BackupToDisk

必須: はい

タイプ: 文字列

 

「Exadataストレージ上のデータベース・バックアップ」を使用する場合はY、それ以外の場合はNにします。

このオプションでは、Exadataストレージを構成して、Exadataストレージにローカル・データベースをバックアップできるようにします。

requestPayload.

customAttributes.

isBYOL

必須: はい

タイプ: 文字列

Exadata Cloud Serviceインスタンスで、サービス・サブスクリプションの一部として提供されたライセンスではなく、ユーザーが提供したOracle Databaseのライセンスを使用することを示す場合はY、そうでない場合はNにします。

このオプションが影響するのは、サービス・インスタンスに関連付けられている請求のみです。Exadata Cloud Serviceインスタンスの技術構成に影響はありません。

requestPayload.

customAttributes.

PickRackSize

必須: はい

タイプ: 文字列

サービス・インスタンスのラック構成を指定します。使用できる正確な値は購入内容によって異なります。一般的な値は、「フル・ラック」、「ハーフ・ラック」、「クオータ・ラック」または「1/8ラック」です。

requestPayload.

customAttributes.

SELECTED_DC_ID

必須: はい

タイプ: 文字列

Exadata Cloud Serviceインスタンスをホストするデータ・センター。対象のデータ・センターIDを取得するには、「Exadataサービス資格の検出」を参照してください。

IPネットワーク構成をカスタマイズしたExadataインスタンスを作成するには

ペイロードの一部として、ClientNetworkおよびBackupNetwork属性を指定したリクエストを投稿します。次の例に、これらのオプションの属性と必須属性を示します。

次の例の<domain>はアイデンティティ・ドメインIDです。

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
        { 
          "name": "requestPayload.customAttributes.ClientNetwork", 
          "value": "/root/root/1/ipnetwork1" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupNetwork", 
          "value": "/root/root/1/ipnetwork2" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

属性

名前 説明

requestPayload.

customAttributes.

ClientNetwork

必須: はい

タイプ: URL

主にデータベース・サーバーへのクライアント・アクセスに使用するネットワークのIPネットワーク定義。アプリケーションは通常、単一クライアント・アクセス名(SCAN)およびOracle RAC仮想IP (VIP)インタフェースとともにOracle Net Servicesを使用して、このネットワークからExadata Cloud Service上のデータベースにアクセスします。

requestPayload.

customAttributes.

BackupNetwork

必須: はい

タイプ: URL

バックアップやバルク・データ転送など、様々な目的でデータベース・サーバーへのアクセスに使用されることが多いネットワークのIPネットワーク定義。

複数のVMをサポートするExadataインスタンスを作成するには

Exadataシステム環境で複数の仮想マシン(VM)クラスタをサポートできるようになっている場合は、最大8つのクラスタを定義し、Exadataシステム・リソース全体をクラスタにどのように割り当てるかを指定できます。

複数のVMクラスタがある構成の場合は、各VMクラスタに、Exadataシステム・リソース全体の一部が専用に割り当てられるため、過剰プロビジョニングやリソースの共有は起こりません。コンピュート・ノードでは、VMクラスタごとに別のVMが定義され、各VMに使用可能なコンピュート・ノードのCPU、メモリーおよびローカル・ディスク・リソースの一部が専用に割り当てられます。また、各VMクラスタには、Exadataストレージ全体の一部が専用に割り当てられます。

ペイロードの一部として、EXAUNIT_ALLOCATIONSおよびMULTIVM_ENABLED属性を指定したリクエストを投稿します。次の例に、これらのオプションの属性と必須属性を示します。

次の例の<domain>はアイデンティティ・ドメインのIDで、<base64_encoded_string>は、例に従ったペイロードのbase64エンコーディングです。

リクエストのペイロードの例:

POST /itas/<domain>/myservices/api/v1/operations
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "requestPayload.name", 
          "value": "newinstanceName" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.adminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.adminFirstName", 
          "value": "John" 
        }, 
        { 
          "name": "requestPayload.adminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.invokerAdminUserName", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminEmail", 
          "value": "john.smith@example.com" 
        }, 
        { 
          "name": "requestPayload.invokerAdminFirstName", 
          "value": "John"
        }, 
        { 
          "name": "requestPayload.invokerAdminLastName", 
          "value": "Smith" 
        }, 
        { 
          "name": "requestPayload.customAttributes.ExaUnitName", 
          "value": "systemname" 
        }, 
        { 
          "name": "requestPayload.customAttributes.CreateSparse", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.BackupToDisk", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.isBYOL", 
          "value": "N" 
        }, 
        { 
          "name": "requestPayload.customAttributes.PickRackSize", 
          "value": "Quarter Rack"  
        }, 
        { 
          "name": "requestPayload.customAttributes.SELECTED_DC_ID", 
          "value": "US001"                     
        }
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes.MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-CREATE" 
      } 
    } 
  ] 
}

<base64_encoded_string>のペイロード:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
    {name:Operation, value:AddCluster},
    {name:TotalNumOfCoresForCluster, value:4},
    {name:TotalMemoryInGb, value:30},
    {name:StorageInTb, value:3},
    {name:OracleHomeDiskSizeInGb, value:60},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2},  // Only if Higgs is also required
    {name:ExaUnitName, value:systemname},
    {name:CreateSparse, value:N},
    {name:BackupToDisk, value:N}
  ] 
}

属性

名前 説明

requestId

必須: オプション

タイプ: 文字列

一意のUUID

TotalNumOfCores

ForCluster

必須: はい

タイプ: 文字列

VMクラスタに割り当てられるCPUコアの数。これは、VMクラスタ内のすべてのコンピュート・ノード間で均等に割り当てられているCPUコアの合計数です。ecra/endpoint/clustershapesの呼出しで返されたnumComputesの倍数であることが必要です。

TotalMemoryInGb

必須: はい

タイプ: 文字列

VMクラスタに割り当てられるメモリー量(GB単位)。これは、VMクラスタ内のすべてのコンピュート・ノード間で均等に割り当てられているメモリーの合計量です。ecra/endpoint/clustershapesの呼出しで返されたnumComputesの倍数であることが必要です。

StorageInTb

必須: はい

タイプ: 文字列

VMクラスタに割り当てられているExadataストレージの合計量(TB単位)。このストレージは、すべてのExadata Storage Serverから均等に割り当てられます。

OracleHomeDiskSize

InGb

必須: はい

タイプ: 文字列

最初のVMクラスタ内の各データベース・サーバーに割り当てられるローカル・ディスク・ストレージの容量(GB単位)。

Exadataインスタンスの変更

この項では、既存インスタンスへのクラスタの追加、クラスタの再構成およびクラスタの削除方法について説明します。

既存インスタンスにクラスタを追加するには

CIM-Exadata-CUSTOM-PRODUCTION-UPDATEのoperationItemDefinitionと、AddClusterのOperation値を含むペイロードのbase64エンコーディングを使用してリクエストを投稿します。

次の例の<domain>はアイデンティティ・ドメインのID、<instanceId>および<serviceEntitlementId>はiTAS serviceInstancesから返される値で、<base64_encoded_string>は、例に従ったペイロードのbase64エンコーディングです。

リクエストのペイロードの例:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "<instanceId>" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "<serviceEntitlementId>" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

<base64_encoded_string>のペイロード:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
    {name:Operation, value:AddCluster},
    {name:TotalNumOfCoresForCluster, value:4},
    {name:TotalMemoryInGb, value:30},
    {name:StorageInTb, value:3},
    {name:OracleHomeDiskSizeInGb, value:60},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2},  // Only if Higgs is also required
    {name:ExaUnitName, value:Cluster2},
    {name:CreateSparse, value:N},
    {name:BackupToDisk, value:N}
  ] 
}
クラスタを再構成するには

CIM-Exadata-CUSTOM-PRODUCTION-UPDATEのoperationItemDefinitionと、ReshapeClusterのOperation値を含むペイロードのbase64エンコーディングを使用してリクエストを投稿します。

次の例の<domain>はアイデンティティ・ドメインのIDで、<base64_encoded_string>は、例に従ったペイロードのbase64エンコーディングです。

リクエストのペイロードの例:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

<base64_encoded_string>のペイロード:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d2a0}, 
	{name:ExaunitID, value:1},		// From ecra/endpoint/exaservice/{serviceInstance}/resourceinfo
    {name:Operation, value:ReshapeCluster},
    {name:TotalNumOfCoresForCluster, value:10},
    {name:TotalMemoryInGb, value:10},
    {name:StorageInTb, value:4},
    {name:OhomePartitionInGB, value:100},
    {name:ClientNetwork, value:/root/root/1/ipnetwork1},  // Only if Higgs is also required
    {name:BackupNetwork, value:/root/root/1/ipnetwork2}   // Only if Higgs is also required
  ] 
}
重要

  • 1つの再構成リクエストで変更できるのは、1つの属性のみです。ペイロードに含められるのは、変更属性のみです。例:

    
    
    {ExaunitProperties
    
    :
    
    [{name:Operation,value
    
    :
    
    ReshapeCluster},
    
    {
    
    name:ExaunitID,value:5
    
    },{
    
    name:TotalNumOfCoresForCluster
    
    ,
    
    value:6}]
    
    }
  • OracleHomeDiskSizeInGb属性を使用して再構成を実行する場合は、OhomePartitionInGBという名前を使用します。
  • TotalNumOfCoresForClusterの値は、ecra/endpoint/clustershapesの呼出しによって返されるnumComputesの倍数であることが必要です。
  • TotalMemoryInGbの値は、ecra/endpoint/clustershapesの呼出しによって返されるnumComputesの倍数であることが必要です。
クラスタを削除するには

CIM-Exadata-CUSTOM-PRODUCTION-UPDATEのoperationItemDefinitionと、DeleteClusterのOperation値を含むペイロードのbase64エンコーディングを使用してリクエストを投稿します。

次の例の<domain>はアイデンティティ・ドメインのIDで、<base64_encoded_string>は、例に従ったペイロードのbase64エンコーディングです。

リクエストのペイロードの例:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1 
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        }, 
        { 
          "name": "requestPayload.size", 
          "value": "CUSTOM" 
        }, 
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        }, 
        { 
          "name": "requestPayload.customAttributes.EXAUNIT_ALLOCATIONS", 
          "value": "<base64_encoded_string>" 
        }, 
        { 
          "name": "requestPayload.customAttributes. MULTIVM_ENABLED", 
          "value": "true" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-UPDATE" 
      } 
    } 
  ] 
}

<base64_encoded_string>のペイロード:

{
  ExaunitProperties: [
    {name:requestId, value:27ac0ee3-0c72-4493-b02b-40038f07d202},  // Optional
	{name:ExaunitID, value:2},
    {name:Operation, value:DeleteCluster}
  ] 
}

Exadataインスタンスの削除

この項では、Exadataインスタンスの削除方法を説明します。

重要

Exadataインスタンスを削除する前に、既存の複数VMクラスタをすべて削除してください。このガイダンスに従うと、インスタンスが無効な状態で終了することを避けられます。
インスタンスを削除する手順

CIM-Exadata-CUSTOM-PRODUCTION-DELETEのoperationItemDefinitionを使用してリクエストを投稿します。

次の例の<domain>はアイデンティティ・ドメインIDです。

リクエストのペイロードの例:

POST /itas/<domain>/myservices/api/v1/operations HTTP/1.1 
{ 
  "operationItems": [ 
    { 
      "attributes": [ 
        { 
          "name": "instanceId", 
          "value": "500076173" 
        }, 
        { 
          "name": "requestPayload.serviceEntitlementId", 
          "value": "500073421" 
        },  
        { 
          "name": "requestPayload.serviceType", 
          "value": "Exadata" 
        } 
      ], 
        "operationItemDefinition": { 
        "id": "CIM-Exadata-CUSTOM-PRODUCTION-DELETE" 
      } 
    } 
  ] 
}

資格とインスタンスの検出

この項では、サービス資格とサービス・インスタンスの検出方法を説明します。

サービス資格を検出するには

次のリクエストを送信します。

GET /itas/<domain>/myservices/api/v1/serviceEntitlements?serviceDefinitionNames=Exadata

このリクエストに対して返されるペイロードの例:

{
    "items": [
      {
        "id": "cesi-585927251",               // Unique ServiceEntitlementId
        "serviceDefinition": {
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceDefinitions/502579309",
          "id": "502579309",
          "name": "Exadata"                 // The customer is entitled to use the Exadata Service
        },
        "status": "ACTIVE",
        ...
        "canonicalLink": "/itas/a517289/myservices/api/v1/serviceInstances/csi-585928949"
      }
    ...                                              // More Service Entitlements could be displayed
    ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements",
  "hasMore": false,
  "limit": 25, 
  "offset": 0
}

対象のデータ・センター:

使用例:

/itas/<domain>/myservices/api/v1/serviceEntitlements/{ServiceEntitlementId}?expands=serviceInstancesEligibleDataCenters

ここで、{ServiceEntitlementId}は、cesi-500074601などのサービス資格IDです。これにより、次のような追加情報が提供されます:

  "serviceInstancesEligibleDataCenters": [
    {
      "id": "US001"
    }
  ],
サービス・インスタンスを検出するには

次のリクエストを送信します。

GET /<domain>/myservices/api/v1/serviceInstances?serviceDefinitionNames=Exadata

このリクエストに対して返されるペイロードの例:

{
    "items": [
      {
        "id": "csi-585928949",               // Unique ServiceInstanceId
        "serviceEntitlement": {
          "id": "cesi-585927251",          // Related ServiceEntitlementId     
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceEntitlements/cesi-585927251"
        },
        "serviceDefinition": {
          "canonicalLink": "/itas/a517289/myservices/api/v1/serviceDefinitions/502579309",
          "id": "502579309",
          "name": "Exadata"                 // The customer is entitled to use the Exadata Service
        },
        ...
        "canonicalLink": "/itas/a517289/myservices/api/v1/serviceInstances/csi-585928949"
      }
    ...                                              // More Service Entitlements could be displayed
    ],
  "canonicalLink": "/itas/<domain>/myservices/api/v1/serviceEntitlements",
  "hasMore": false,
  "limit": 25, 
  "offset": 0
}