サービスの詳細

• サービス名： 名前は任意の文字列に設定でき、Web や CLI で新しいデプロイメントを識別するために使用される名称です。
• リソースグループ： サービスを リソースグループごとに整理している場合は、このフィールドにリソースグループを指定してください。 それ以外の場合は、この値をデフォルトのままにしておくことができます。 詳細については、「 リソースグループの管理 」を参照してください。
• 場所： デプロイ先のクラウドリージョン。 Gen 2では、 Databases for MongoDB は現在、 モントリオール（ca-mon）、 チェンナイ - Airtel（in-che）、 ムンバイ（in-mum）、 フランクフルト（eu-de）、 ワシントン（us-east）、 マドリード（eu-es）、 シドニー（au-syd）、 ダラス（us-south）、 ロンドン（eu-gb） の各リージョンでのみ利用可能です。

デプロイ先のプラットフォームを選択してください。

• Gen 1： IBM Cloud® のオリジナルプラットフォームで、すべての IBM Cloud データセンターで利用可能です。
• Gen 2： IBM Cloud® の最新プラットフォーム。高度にセキュアなソフトウェア定義ネットワーク（SDN）アーキテクチャに基づいています。 Gen 2はクラウドネイティブアプリケーション向けに最適化されており、現在はモントリオール、チェンナイ、ムンバイ、フランクフルト、マドリード、シドニー、ワシントン、ロンドンでのみ利用可能です。

詳細については、「 Gen 1（Classic）および Gen 2（VPC）の概要 」を参照してください。

ホスティング・モデル

Gen 2 では、利用可能なホスティングモデルは「 Isolated 」のみです。これは、複雑で高性能なエンタープライズワークロード向けの、セキュアなシングルテナント型サービスです。 詳細については、「 Isolated Compute 」を参照してください。

リソース割り振り

デプロイメントの初期ホストサイズとディスク構成を選択してください。 ホストのサイズおよびディスクの割り当ては、インスタンスの各メンバーごとに適用されます。

• ホストのサイズ： ワークロードの要件に合わせて、 vCPU およびRAMの利用可能な構成から選択してください。
• ディスク： デプロイメントの初期ディスクサイズを設定します。 スライダーを使ってディスク容量を設定してください。 ディスクの容量によって、IOPSの割り当てが決まります。 ディスク1GBごとに5 IOPSが提供されます。

プロビジョニング後にディスク容量を増やすことは可能ですが、データの損失を防ぐため、容量を減らすことはできません。

サービス構成

• データベースのバージョン： Set only at deployment これは、 MongoDB のデプロイメントのバージョンです。 コンソールでは、最適なパフォーマンスを確保するために、推奨されるバージョンが強調表示されます。 詳細については、「 バージョン管理ポリシー 」を参照してください。
• データベースエディション： Set only at deployment。Gen 2 では、 Standard エディションのみが利用可能です。
• 暗号化： Set only at deployment もしKey Protect を使用する場合、インスタンスとキーを選択して、デプロイメントのディスクを暗号化できます。 独自の鍵を使用しない場合、デプロイメントは自動的に自身のディスク暗号鍵を作成して管理します。
• エンドポイント Set only at deployment[Set only at deployment- Gen 2 では、プライベートエンドポイントのみがサポートされています。

適切な設定を選択したら、作成をクリックしてプロビジョニング・プロセスを開始します。

CLI を使用してサービスインスタンスを作成する

プロビジョニングを行う前に、ドキュメントに記載されている手順に従って、 IBM Cloud CLI ツールをインストールしてください。

1. IBM Cloud にログインします。 フェデレーテッド・ユーザー ID を使用する場合は、ワンタイム・パスコード (ibmcloud login --sso) に切り替えるか、API キー (ibmcloud --apikey key or @key_file) を使用して認証することが重要です。 CLI を使用したログイン方法の詳細については、 ibmcloud login の「 一般的な CLI(ibmcloud)コマンド」を参照してください。

   ibmcloud login
   

2. Gen 2 プラットフォームの「 Isolated Compute 」ホスティングモデル上で、 IBM Cloud® Databases for MongoDB インスタンスをプロビジョニングできます。

3. 次のコマンドを実行して、データベースをプロビジョニングしてください：

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"host_flavor": "<host_flavor value>"}'
   

   たとえば、 Databases for MongoDB インスタンスをプロビジョニングするには、次のようなコマンドを使用します

   ibmcloud resource service-instance-create test-database databases-for-mongodb standard-gen2 us-south -p '{"host_flavor": "bx3d.4x20.encrypted", "storage_gb": 10 }'
   

   Databases for MongoDB のIsolatedインスタンスを、 host_flavor -p パラメータと同じ設定でプロビジョニングし、Isolatedのサイズを希望のサイズに設定します。 利用可能なホスティング容量とその host_flavor value パラメータ を表2 に示します。

   メンバーがホストするプランの構成にはCPUとRAMの容量が含まれているため（bx3d.4x20.encrypted はCPU 4コア、RAM 20GB）、このリクエストでは、「Isolated」サイズの選択と、個別のCPUおよびRAMの割り当て選択の両方を同時に指定することはできません。

   コマンド内のフィールドについては、以下の表で説明されています。

   基本コマンド形式のフィールド

   フィールド	説明	フラグ
   INSTANCE_NAME Required	インスタンス名は任意の文字列に設定でき、Web や CLI で新しいデプロイメントを識別するために使用される名前です。
   SERVICE_NAME Required	サービスの名前または ID。 Databases for MongoDB については、 databases-for-mongodb をご利用ください。
   SERVICE_PLAN_NAME Required	standard-gen2
   LOCATION Required	デプロイしたい場所。 地域のリストを取得するには、 ibmcloud regions コマンドを使用します。
   RESOURCE_GROUP	リソースグループ名。 デフォルト値は defaultです。	-g
   --parameters	サービス・インスタンスを作成するパラメーターの JSON ファイルまたは JSON 文字列	-p
   host_flavor	Isolated Compute インスタンスをプロビジョニングするには、 {"host_flavor": "<host_flavor value>"} を使用してください。 「Isolated Compute」では、ご希望のCPUおよびRAM構成を選択してください。 詳細については、以下の 表2 を参照してください。

   次のような応答が表示されます：

   Creating service instance INSTANCE_NAME in resource group default of account USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-mongodb:us-south:a/40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                       Status    create in progress
                       Message   Started create instance operation
   

   • プロビジョニングの状態を確認するには、次のコマンドを実行してください

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   完了すると、次のような応答が表示されます：

   Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
   OK
   Name:                  INSTANCE_NAME
   ID:                    crn:v1:bluemix:public:databases-for-mongodb:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
   Location:              <LOCATION>
   Service Name:          databases-for-mongodb
   Service Plan Name:     standard-gen2
   Resource Group Name:   default
   State:                 active
   Type:                  service_instance
   Sub Type:              Public
   Locked:                false
   Service Endpoints:     private
   Created at:            2023-06-26T19:42:07Z
   Created by:            USER
   Updated at:            2023-06-26T19:53:25Z
   Last Operation:
                          Status    create succeeded
                          Message   Provisioning mongodb with version 7.17 (100%)
   

   • オプション：サービスインスタンスを削除するには、次のコマンドを実行します

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

host_flavor パラメータ

host_flavor パラメータは、Computeのサイズ設定を定義します。 Isolated Compute インスタンスをプロビジョニングするには、希望する CPU および RAM の構成に合わせて適切な値を入力してください。

--parameters パラメータ

service-instance-create コマンドは、 -p フラグをサポートしており、これによりJSON形式のパラメータをプロビジョニング処理に渡すことができます。 たとえば、クラウド上のリソースを一意に識別する「クラウドリソース名（CRN）」をパラメータ値として渡すことができます。 パラメーター名と値はすべて文字列として渡されます。

たとえば、特定のバックアップからデータベースをプロビジョニングしており、新しいデータベースの展開に 16x80 というサイズのより大きなホストが必要な場合、コマンドは次のようになります：

ibmcloud resource service-instance-create databases-for-mongodb <SERVICE_NAME> standard-gen2 us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "host_flavor": "bx3d.16x80.encrypted"
}'

例

Isolated Computeインスタンスを作成するには、以下の例に従ってください

```sh {: pre}
  curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
  "name": "my-instance",
  "target": "ca-mon",
  "resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
  "resource_plan_id": databases-for-mongodb-gen2-standard",
  "dataservices": {
    "mongodb": {
        "storage_gb": 10,
        "host_flavor": "bx3d.4x20.encrypted"
      },
    "encryption": {
      "disk": "crn:v1..."
    },
    "version": "8",
  },
}'
```
「 Databases for MongoDB 」のIsolatedインスタンスを、同じ `host_flavor` パラメータでプロビジョニングし、そのパラメータを希望するIsolatedサイズに設定します。 利用可能なホスティング容量とその `host_flavor value` パラメータ [を表2](#members_host-flavor-parameter-api) に示します。 例えば、`{"host_flavor": "bx3d.4x20.encrypted"}`です。

メンバーがホストするプランの構成にはCPUとRAMの容量が含まれているため（bx3d.4x20.encrypted はCPU 4コア、RAM 20GB）、このリクエストでは、「Isolated」サイズの選択と、個別のCPUおよびRAMの割り当て選択の両方を同時に指定することはできません。

コマンド内のフィールドについては、以下の表で説明されています。

host_flavor パラメータ

host_flavor パラメータは、Computeのサイズ設定を定義します。 Isolated Compute インスタンスをプロビジョニングするには、希望する CPU および RAM の構成に合わせて適切な値を入力してください。

追加パラメーターのリスト

--parameters オブジェクトでは、サービスインスタンスを作成するために、次のような追加情報を指定できます

• backup_id - リストア元となるバックアップ・リソースの CRN。 バックアップは、同じサービス ID を持つデータベースのデプロイによって作成される必要があります。 バックアップはプロビジョニングの後にロードされ、その後にそのデータを使用する新規デプロイメントが開始されます。 バックアップ CRN の形式は crn:v1:<...>:backup:<uuid> です。 これを省略した場合、データベースは空のままプロビジョンされます。
• version - プロビジョンするデータベースのバージョン。 省略した場合、データベースは最新のメジャー・バージョンとマイナー・バージョンを使用して作成されます。
• disk_encryption_key_crn- KMS キーの CRN（ Key Protect ）のCRN。これはその後、ディスクの暗号化に使用されます。 KMS キーの CRN は、 crn:v1:<...>:key:<id> という形式になっています。
• backup_encryption_key_crn- KMS キーの CRN（ Key Protect ）のCRN。これは、バックアップの暗号化に使用されます。 KMS キーの CRN は、 crn:v1:<...>:key:<id> という形式になっています。

バックアップにキーを使用するには、まず [サービス間委任を有効にする](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok) 必要があります。
{: note}

Terraform を使用した隔離されたコンピュートリソースのプロビジョニング

「 Databases for MongoDB 」のIsolatedインスタンスを、同じ "host_flavor" パラメータでプロビジョニングし、そのパラメータを希望するIsolatedサイズに設定します。 利用可能なホスティング容量とその host_flavor value パラメータ を表1 に示します。 例えば、{"host_flavor": "bx3d.4x20.encrypted"}です。 ホストのフレーバー選択にはCPUとRAMの容量が含まれているため（bx3d.4x20.encrypted はCPU 4コア、RAM 16GB）、このリクエストでは、「Isolated」サイズの選択と、個別のCPUおよびRAMの割り当て選択の両方を指定することはできません。

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "eu-gb"
  service           = "databases-for-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword                = "password12"
  group {
    group_id = "member"
    host_flavor {
      id = "bx3d.4x20.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

host flavor パラメータ

host_flavor パラメータは、Computeのサイズ設定を定義します。 Isolated Compute インスタンスをプロビジョニングするには、希望する CPU および RAM の構成に合わせて適切な値を入力してください。 次の表の値をご覧ください。