新增帳戶至企業

您可以將其他 IBM Cloud® 帳戶新增至其中,以建置企業。 若要新增帳戶,您可以匯入不在另一個企業中的現有帳戶,也可以在企業內建立新的帳戶。

在您的企業有多個帳戶之後,您可以使用帳戶群組來組織相關的帳戶。 如需相關資訊,請參閱在企業中組織帳戶。

一個企業最多可以擁有 1000 個帳戶。 如需詳細資訊,請參閱 企業限制。

匯入現有帳戶

您可以將現有帳戶匯入企業中。 在匯入帳戶之後,無法移除它,而且每一個帳戶都只能是某個企業的一部分。 如果匯入「精簡」或試用帳戶,則會自動將它升級至隨收隨付制帳戶。

將帳戶匯入至企業後,會有下列影響:

  • 帳戶的計費會轉移為由企業管理。 在轉移之後,帳戶中的使用者無法存取將來計費期間的計費及付款資訊(例如發票、付款或訂閱)。 若要檢視或管理計費,使用者需要受邀加入企業帳戶,並獲得該帳戶中「計費」服務的存取權。 如需相關資訊,請參閱使用企業集中管理計費及用量。
  • 帳戶內的使用者及存取權不會變更。 帳戶內的存取權與企業是分開的,而且在匯入帳戶時,使用者不會自動取得企業內的存取權。
  • 帳戶內的資源不會變更。 具有正確存取權的使用者,可以繼續檢視帳戶中資源的用量資訊。

若要將現有帳戶匯入至企業,則需要下列存取權:

  • 在要匯入的帳戶內,您必須是帳戶擁有者,或具有帳戶內「計費」服務的「管理者」角色。
  • 在企業帳戶內,您需要「企業」服務的「編輯者」或「管理者」角色,以及「計費」服務的「管理者」角色。

在主控台中匯入帳戶

若要匯入現有帳戶,請完成下列步驟:

  1. 登入您的企業帳戶,並在 IBM Cloud 控制台中前往「管理 > 企業」選項。

  2. 按一下帳戶,以檢視企業中的帳戶及帳戶群組。 在「帳戶」區段中,請選擇「新增」>「匯入帳戶」。

  3. 選取您要匯入的帳戶。

    如果未顯示任何帳戶,您可能在所有現有帳戶中都沒有正確的存取權。

  4. 如果您要將帳戶新增至帳戶群組,請選取要成為其母項的帳戶群組。 您選取的母項會決定帳戶在企業階層中的存在位置。

  5. 檢閱對您帳戶的影響的相關資訊,並選取我瞭解對我的帳戶的影響。 然後,按一下匯入。

    將帳戶匯入至企業之後,就無法移除它。 請確定您要將帳戶永久移至企業。

使用 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 匯入帳戶

若要將現有帳戶匯入企業,請依照以下範例請求所示,呼叫「企業管理 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 並為 Terraform 配置 IBM Cloud Provider 外掛程式。 如需詳細資訊,請參閱 IBM Cloud® 上的 Terraform 入門 教學。 外掛程式抽象出 IBM Cloud API,用來完成這項任務。
  • 建立一個名為 main.tf`` 的 Terraform 配置檔。 在此檔案中,您使用 HashiCorp Configuration Language 定義資源。 如需詳細資訊,請參閱 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"
     }
    

    您可以在 account_id 選項中指定需要匯入的帳戶 ID。 如需更多資訊,請參閱 Terraform 企業管理頁面的參數詳細資訊。

  2. 完成建立組態檔案後,初始化 Terraform CLI。 如需詳細資訊,請參閱 初始化工作目錄。

    terraform init
    
  3. 從 main.tf 檔案提供資源。 如需詳細資訊,請參閱 使用 Terraform 佈建基礎結構。

    1. 執行 terraform plan 以產生 Terraform 執行計畫,預覽建議的動作。
       terraform plan
    
    1. 執行 terraform apply 以建立計劃中定義的資源。
       terraform apply
    

建立新帳戶

您可以在企業內建立新帳戶。 帳戶會建立為「隨收隨付制」帳戶,而且會根據用量向企業收費。 若要建立帳戶,您需要「企業」服務的「編輯者」或「管理者」角色的存取原則。

在控制台中建立帳戶

  1. 從「企業」儀表板中,按一下帳戶,以檢視企業中的帳戶及帳戶群組。
  2. 在「帳戶」區段中,請選擇「新增」>「建立帳戶」。
  3. 輸入在企業內唯一的帳戶名稱。 因為它是多個帳戶中的其中一個,唯一的敘述性名稱可協助您一目瞭然地瞭解帳戶的用途。
  4. 如果您要將不同的使用者指派為帳戶擁有者,請在擁有者欄位中輸入其 IBM ID。 帳戶擁有者具有管理帳戶的完整存取權。
  5. 如果您要將帳戶新增至帳戶群組,請選取要成為其母項的帳戶群組。 您選擇的母項會決定帳戶在企業階層中的存在位置。
  6. 開啟企業管理的 IAM,以集中管理新帳戶的存取和安全性設定。 如需詳細資訊,請參閱 選擇加入企業管理式 IAM。
  7. 按一下建立。

在建立帳戶之後,帳戶擁有者即可登入帳戶,以邀請其他使用者,並管理其存取權。

使用 CLI 來建立帳戶

  1. 如果您要將帳戶新增至帳戶群組,請尋找現有帳戶群組的名稱和 ID。

    ibmcloud enterprise account-groups --recursive
    
  2. 執行下列指令,以建立帳戶。 如果您未指定母項帳戶群組,則會直接在企業下新增帳戶。 若要讓不同的使用者成為帳戶擁有者,請在 --owner 選項上指定其 IBM ID。

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

使用 API 來建立帳戶

若要在企業中建立新的帳戶,請呼叫「企業管理 API」,如下列範例要求所示,將 IAM 記號及 ID 變數取代為您企業的值。 有關此 API 的詳細資訊,請參閱「企業管理 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"
     }
    

    您可以在 owner_iam_id 選項中指定帳戶擁有者的 ID。 如需更多資訊,請參閱 Terraform 企業管理頁面的參數詳細資訊。

  2. 完成建立組態檔案後,初始化 Terraform CLI。 如需詳細資訊,請參閱 初始化工作目錄。

    terraform init
    
  3. 從 main.tf 檔案提供資源。 如需詳細資訊,請參閱 使用 Terraform 佈建基礎結構。

    1. 執行 terraform plan 以產生 Terraform 執行計畫,預覽建議的動作。
       terraform plan
    
    1. 執行 terraform apply 以建立計劃中定義的資源。
       terraform apply