エンタープライズへのアカウントの追加

IBM Cloud® アカウントをさらに追加することによって、エンタープライズを大きくすることができます。 アカウントを追加するために、別のエンタープライズ内にない既存のアカウントをインポートすることも、エンタープライズ内に新規アカウントを作成することもできます。

エンタープライズに複数のアカウントができたら、アカウント・グループを使用して関連するアカウントを編成できます。 詳しくは、『エンタープライズ内のアカウントの編成』を参照してください。

企業では最大1000アカウントまで作成できます。 詳細については 、「エンタープライズの制限 」を参照してください。

既存アカウントのインポート

既存のアカウントをエンタープライズにインポートできます。 アカウントをインポートした後でそのアカウントを削除することはできず、各アカウントは 1 つのエンタープライズのみに属することができます。 インポートされるのがライト・アカウントまたはトライアル・アカウントの場合、それは自動的に従量課金 (PAYG) アカウントにアップグレードされます。

アカウントをエンタープライズにインポートすると、以下の影響があります。

  • アカウントに対する請求はエンタープライズによる管理に移行します。 この移行の後、アカウント内のユーザーは、以降の請求対象期間の請求および支払情報 (送り状、支払い、サブスクリプションなど) にアクセスできません。 ユーザーが請求情報を表示または管理するには、エンタープライズ・アカウントに招待され、そのアカウント内の請求処理サービスへのアクセス権限を付与される必要があります。 詳しくは、『エンタープライズを使用した請求および使用量の一元管理』を参照してください。
  • アカウント内のユーザーおよびアクセス許可は変更されません。 アカウント内のアクセス権限はエンタープライズから分離されていて、アカウントのインポート時にエンタープライズ内のアクセス権限がユーザーに自動的に付与されることはありません。
  • アカウント内のリソースは変更されません。 適切なアクセス許可を持つユーザーは、引き続きアカウント内のリソースの使用量情報を表示できます。

既存のアカウントをエンタープライズにインポートするには、以下のアクセス権限が必要です。

  • インポートされるアカウント内で、アカウント所有者であるか、アカウント内の請求処理サービスに対する管理者役割を持っている必要があります。
  • エンタープライズ・アカウント内で、エンタープライズ・サービスに対するエディターまたは管理者の役割、および請求処理サービスに対する管理者役割が必要です。

コンソールでのアカウントのインポート

既存のアカウントをインポートするには、次のステップを実行します。

  1. エンター アカウントにログインし、 IBM Cloud コンソールで [ 管理] > [エンタープライズ ] に移動してください。

  2. アカウント をクリックして、エンタープライズ内のアカウントおよびアカウント・グループを表示します。 「 アカウント 」セクションで、「 追加 > アカウントのインポート 」を選択します。

  3. インポートするアカウントを選択します。

    アカウントがまったく表示されない場合、既存のどのアカウント内でも適切なアクセス権限を持っていない可能性があります。

  4. アカウントをアカウント・グループに追加する場合は、親にするアカウント・グループを選択します。 選択した親によって、このアカウントがエンタープライズ階層内のどこに存在するのかが決まります。

  5. アカウントへの影響に関する情報を確認し、 アカウントに対する影響を理解しました (I understand the impact to my account) を選択します。 次に、 インポート をクリックします。

    アカウントがエンタープライズにインポートされた後でそれを削除することはできません。 アカウントをエンタープライズに永久に移動してもよいことを確認してください。

CLI を使用したアカウントのインポート

  1. エンタープライズにインポートするアカウントの ID を見つけます。

    ibmcloud account list
    
  2. アカウントをアカウント・グループに追加する場合は、エンタープライズ内の既存のアカウント・グループの名前と ID を調べます。

    ibmcloud enterprise account-groups --recursive
    
  3. --account ID パラメーターにアカウント ID を指定して、アカウントをエンタープライズにインポートします。 親アカウント・グループを指定しない場合、アカウントはエンタープライズのすぐ下に追加されます。

    ibmcloud enterprise account-import --account-id ID
    [--parent-account-group ACCOUNT_GROUP_NAME | --parent-account-group-id ACCOUNT_GROUP_ID]
    

API を使用したアカウントのインポート

既存のアカウントエンタープライズにインポートするには、以下のリクエスト例に示すように、 Enterprise Management API を呼び出してください。 その際、IBM Cloud Identity and Access Management (IAM) トークンおよび ID 変数は実際のエンタープライズの値に置き換えてください。

curl -X PUT "https://enterprise.cloud.ibm.com/v1/enterprises/$ENTERPRISE_ID/import/accounts/$ACCOUNT_ID" -H "Authorization: Bearer <IAM_Token>" -H 'Content-Type: application/json' -d '{
   "parent": "crn:v1:bluemix:public:enterprise::a/$ENTERPRISE_ACCOUNT_ID::enterprise:$ENTERPRISE_ID",
   "billing_unit_id": "$BILLING_UNIT_ID"
}'
ImportAccountToEnterpriseOptions importAccountToEnterpriseOptions = new ImportAccountToEnterpriseOptions.Builder()
    .enterpriseId(enterpriseId)
    .accountId(importAccountId)
    .build();
Response<Void> response = service.importAccountToEnterprise(importAccountToEnterpriseOptions).execute();
const params = {
   enterpriseId: enterpriseId,
   accountId: importAccountId,
};
enterpriseManagementService.importAccountToEnterprise(params)
   .then(res => {
    done();
   })
   .catch(err => {
    console.warn(err)
   });
response = enterprise_management_service.import_account_to_enterprise(
   enterprise_id=enterprise_id,
   account_id=import_account_id,
)
print(json.dumps(response, indent=2))
importAccountToEnterpriseOptions := enterpriseManagementService.NewImportAccountToEnterpriseOptions(
   enterpriseID,
   importAccountID,
)
response, err := enterpriseManagementService.ImportAccountToEnterprise(importAccountToEnterpriseOptions)
if err != nil {
   panic(err)
}

開始前に

Terraformを使用してアカウントを企業に追加する前に、以下の作業が完了していることを確認してください

  • Terraform CLIをインストールし、 IBM Cloud ProviderプラグインをTerraform用に設定します。 詳細については 、 IBM Cloud® の Terraform 入門 チュートリアルをご覧ください。 このプラグインは、以下のタスクを実行するために使用される IBM Cloud API を抽象化します。
  • main.tfという名前の Terraform 構成ファイルを作成します。 このファイルでは、 HashiCorp 設定言語を使用してリソースを定義します。 詳細については、 Terraformのドキュメントを参照してください。

Terraform を使用したアカウントのインポート

Terraformを使用して、企業リソースに既存のアカウントをインポートするには、以下の手順に従います。

  1. main.tf ファイルに引数を追加します。 以下の例では、ibm_enterprise_account リソースを使用してアカウントをインポートします。ここで、enterprise_id はアカウントのインポート先です。 タスクを完了するには、エンタープライズの主要連絡先の既存の IAM ID が必要です。

    resource "ibm_enterprise_account" "enterprise_import_account"{
     parent = "parent"
     enterprise_id = "enterprise_id"
     account_id = "account_id"
     }
    

    インポートする必要があるアカウントの ID は、account_id オプションで指定することができます。 詳細については、「 Terraform Enterprise の管理 」ページの引数リファレンスを参照してください。

  2. 構成ファイルの作成が完了したら、Terraform CLI を初期化します。 詳細は 、「作業ディレクトリの初期化 」を参照してください。

    terraform init
    
  3. main.tf ファイルからリソースを準備します。 詳細については 、「Terraformによるインフラストラクチャのプロビジョニング 」を参照してください。

    1. terraform plan を実行して、提案されたアクションのプレビューを表示するための Terraform 実行計画を生成します。
       terraform plan
    
    1. terraform apply を実行して、計画で定義されたリソースを作成します。
       terraform apply
    

新規アカウントの作成

エンタープライズ内に新規アカウントを作成できます。 アカウントは従量課金 (PAYG) アカウントとして作成され、使用についての請求先はエンタープライズになります。 アカウントを作成するには、エンタープライズ・サービスに対するエディターまたは管理者の役割が設定されたアクセス・ポリシーが必要です。

コンソールでのアカウントの作成

  1. エンタープライズ・ダッシュボードで アカウント をクリックして、エンタープライズ内のアカウントおよびアカウント・グループを表示します。
  2. 「 アカウント 」セクションで、「 追加 > アカウントを作成 」を選択します。
  3. エンタープライズ内で固有のアカウント名を入力します。 これは多くのアカウントの 1 つであるため、固有の記述名は、アカウントの目的を一目で理解するのに役立ちます。
  4. 別のユーザーをアカウント所有者として割り当てる場合は、 所有者 フィールドにそのユーザーの IBMid を入力します。 アカウント所有者は、アカウントを管理するための全アクセス権限を持ちます。
  5. アカウントをアカウント・グループに追加する場合は、親にするアカウント・グループを選択します。 選択する親によって、このアカウントがエンタープライズ階層内のどこに存在するのかが決まります。
  6. Enterprise-managed IAM をオンにして、新しいアカウントのアクセスとセキュリティ設定を一元管理します。 詳細については 、「企業管理のIAMへのオプトイン 」を参照してください。
  7. 「作成」 をクリックします。

アカウント作成後、アカウント所有者は、アカウントにログインして、他のユーザーを招待し、彼らのアクセス権限を管理することができます。

CLI を使用したアカウントの作成

  1. アカウントをアカウント・グループに追加する場合は、既存のアカウント・グループの名前と ID を調べます。

    ibmcloud enterprise account-groups --recursive
    
  2. 次のコマンドを実行してアカウントを作成します。 親アカウント・グループを指定しない場合、アカウントはエンタープライズのすぐ下に追加されます。 別のユーザーをアカウント所有者にするには、そのユーザーの IBMid を --owner オプションで指定します。

    ibmcloud enterprise account-create NAME
    [--parent-account-group ACCOUNT_GROUP_NAME] [--owner USER_ID]
    

API を使用したアカウントの作成

エンタープライズ内に新規アカウントを作成するには、以下のサンプル要求に示すように、Enterprise Management API を呼び出します (その際、IAM トークンおよび ID 変数は実際のエンタープライズの値に置き換えてください)。 APIの詳細については、「 Enterprise Management API 」を参照してください。

curl -X POST "https://enterprise.cloud.ibm.com/v1/accounts
-H "Authorization: Bearer <IAM_Token>"
-H 'Content-Type: application/json'
-d '{
  "parent":
  "crn:v1:bluemix:public:enterprise::a/$ENTERPRISE_ACCOUNT_ID::account-group:$ACCOUNT_GROUP_ID",
  "name": "Example Account",
  "owner_iam_id": "$OWNER_IAM_ID"
}'
CreateAccountOptions createAccountOptions = new CreateAccountOptions.Builder()
    .parent(parentCRN)
    .name("Example Account")
    .ownerIamId(enterpriseAccountIamId)
    .build();
Response<CreateAccountResponse> response = service.createAccount(createAccountOptions).execute();
CreateAccountResponse createAccountResponse = response.getResult();
System.out.println(createAccountResponse);();
const params = {
  parent: parentCrn,
  name: 'Example Account',
  ownerIamId: enterpriseAccountIamId,
};
enterpriseManagementService.createAccount(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });
create_account_response = enterprise_management_service.create_account(
  parent=parent_crn,
  name='Example Account',
  owner_iam_id=enterprise_account_iam_id,
).get_result()
print(json.dumps(create_account_response, indent=2))
createAccountOptions := enterpriseManagementService.NewCreateAccountOptions(
  parentCRN,
  "Example Account",
  enterpriseAccountIamID,
)
createAccountResponse, response, err := enterpriseManagementService.CreateAccount(createAccountOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(createAccountResponse, "", "  ")
fmt.Println(string(b))

Terraform を使用したアカウントの作成

Terraformを使用してアカウントを作成するには、以下の手順に従います

  1. main.tf ファイルに引数を追加します。 以下の例では、ibm_enterprise_account リソースを使用してアカウントを作成します。ここで、name はエンタープライズを識別する固有の名前です。 タスクを完了するには、エンタープライズの主要連絡先の既存の IAM ID が必要です。

    resource "ibm_enterprise_account" "enterprise_account" {
     parent = "parent"
     name = "name"
     owner_iam_id = "owner_iam_id"
     }
    

    アカウント所有者の ID は、owner_iam_id オプションで指定することができます。 詳細については、「 Terraform Enterprise の管理 」ページの引数リファレンスを参照してください。

  2. 構成ファイルの作成が完了したら、Terraform CLI を初期化します。 詳細は 、「作業ディレクトリの初期化 」を参照してください。

    terraform init
    
  3. main.tf ファイルからリソースを準備します。 詳細については 、「Terraformによるインフラストラクチャのプロビジョニング 」を参照してください。

    1. terraform plan を実行して、提案されたアクションのプレビューを表示するための Terraform 実行計画を生成します。
       terraform plan
    
    1. terraform apply を実行して、計画で定義されたリソースを作成します。
       terraform apply