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 My Services APIにアクセスするには、Oracle Cloud Serviceのトライアルまたは有料サブスクリプションをリクエストする必要があります。
Oracle Cloud My Services APIにアクセスするには、アカウント管理者に次の項目を問い合せます。
-
アカウント資格証明:
-
ユーザー名とパスワード
-
アイデンティティ・ドメインID
アイデンティティ・ドメインIDは、Identity Cloud Service (IDCS)におけるのユーザーのアイデンティティ・ドメインを識別するIDCS GUID、または従来のクラウド・アカウントのアイデンティティ・ドメイン名のいずれでもかまいません。
-
-
前述のユーザー名に割り当てられている必須ロール
/itas/
と/myservices/
の間に、アカウント管理者から提供されたアイデンティティ・ドメインID (<domain>)を挿入します。
例:
https://itra.oraclecloud.com/itas/<domain>/myservices/api/v1/serviceEntitlements
Exadataインスタンスの作成
この項では、基本的なExadataインスタンス、IPネットワーク構成をカスタマイズしたインスタンス、および複数のVMをサポートするインスタンスの作成方法について説明します。
必要なペイロードを指定したリクエストを投稿して、特定のサービス資格(この場合は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インスタンスの名前。この名前の要件:
|
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サービス資格の検出」を参照してください。 |
ペイロードの一部として、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ネットワーク定義。 |
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
}