Creating an enterprise

Creating an enterprise in the console

1. In the IBM Cloud console, go to Manage > Enterprise, and click Create.

2. Enter a unique name to identify your enterprise. Typically, the name reflects your company or organization, such as My organization's enterprise. You can edit the enterprise name later if needed.

3. If your company or organization has an associated domain name, enter it in the Domain field. You can specify any domain or subdomain format, such as example.com or my.example.com.

4. Review the information about the impact to your account, and select I understand the impact to my account. Then, click Create.

   After the account is added to the enterprise, it can't be removed. Be sure you want to permanently move the account to an enterprise.

After a few moments, your enterprise is created, and you can view the enterprise dashboard. Your IBMid is listed as the contact. The contact serves as a focal point for any enterprise concerns, such as billing or usage questions. You're also assigned as the enterprise account owner, so you can invite additional users to manage the enterprise.

Click Accounts to view your enterprise hierarchy, which contains two accounts.

• The enterprise account, which is where you invite users and grant access to manage the enterprise.
• The account that you used to create the enterprise. Its users and resources remain the same, but billing is now managed by the enterprise.

Creating an enterprise by using the CLI

1. Log in, and select the account.

   ibmcloud login
   

2. Create the enterprise by running the ibmcloud enterprise create command, where NAME is a unique name to identify the enterprise.

   ibmcloud enterprise create NAME [-d, --domain DOMAIN_NAME] [--primary-contact-id PRIMARY_CONTACT_USER_ID]
   

   For example, the following command creates an enterprise that is named Example Corp Enterprise with the examplecorp.com domain.

   ibmcloud enterprise create "Example Corp Enterprise" -d examplecorp.com
   

   By default, the enterprise is created with the currently logged-in user in the following roles:

   • The contact for the enterprise, which identifies a focal person to notify with enterprise-related concerns
   • The owner of the enterprise account, which has full access to manage the enterprise account

   You can specify the IBMid for a different user on the --primary-contact-id option. The same user is assigned to both roles.

3. Review the impact to your account, and confirm that you want to continue by entering y.

   Account abcde12345fghij67890 will be incorporated into enterprise My new enterprise
   (which cannot be undone). Do you want to proceed? [y/N]> y
   

After the enterprise is created, two new IDs are displayed. The first ID is associated with the enterprise, and the second ID identifies the enterprise account, which you use to manage the enterprise.

ID:                      09876jihgf54321edcba
Enterprise Account ID:   edcba12345jihgf67890

The account that you used to create the enterprise is now a part of the enterprise. Run the ibmcloud enterprise accounts command to view the two accounts in your enterprise: the enterprise account, and the account you used to create the enterprise.

Creating an enterprise by using the API

You can programmatically create an enterprise by calling the Enterprise Management API as shown in the following sample request. For detailed information about the API, see Enterprise Management API.

curl -X POST "https://enterprise.cloud.ibm.com/v1/enterprises
-H "Authorization: Bearer <IAM_Token>"
-H 'Content-Type: application/json'
-d '{
  "source_account_id": "a1b2c32a5ea94809a9840f5e23c362d",
  "name": "Example Enterprise",
  "domain": "example.com",
  "primary_contact_iam_id": "IBMid-0123ABC"
}'

CreateEnterpriseOptions createEnterpriseOptions = new CreateEnterpriseOptions.Builder()
    .sourceAccountId(srcAccountId)
    .name("Example Enterprise")
    .primaryContactIamId(contactIamId)
    .build();

Response<CreateEnterpriseResponse> response = service.createEnterprise(createEnterpriseOptions).execute();
CreateEnterpriseResponse createEnterpriseResponse = response.getResult();

System.out.println(createEnterpriseResponse);

const params = {
  sourceAccountId: srcAccountId,
  name: 'Example Enterprise',
  primaryContactIamId: contactIamId,
};

enterpriseManagementService.createEnterprise(params)
  .then(res => {
    console.log(JSON.stringify(res.result, null, 2));
  })
  .catch(err => {
    console.warn(err)
  });

create_enterprise_response = enterprise_management_service.create_enterprise(
  source_account_id=src_account_id,
  name='Example Enterprise',
  primary_contact_iam_id=contact_iam_id,
).get_result()

print(json.dumps(create_enterprise_response, indent=2))

createEnterpriseOptions := enterpriseManagementService.NewCreateEnterpriseOptions(
  srcAccountID,
  "Example Enterprise",
  contactIamID,
)

createEnterpriseResponse, response, err := enterpriseManagementService.CreateEnterprise(createEnterpriseOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(createEnterpriseResponse, "", "  ")
fmt.Println(string(b))

Creating an enterprise by using Terraform

Use the following steps to create an enterprise:

1. Create an argument in your main.tf file. The following example creates an enterprise by using the ibm_enterprise resource, where name is a unique name to identify the enterprise. You must have an existing IAM ID of an enterprise primary contact in order to complete the task.

   resource "ibm_enterprise" "enterprise" {
    source_account_id = <source_account_id>
    name = <name>
    primary_contact_iam_id = <primary_contact_iam_id>
   }
   

   You can specify the ID of an account that is used to create the enterprise on the source_account_id option. For more information, see the argument reference details on the Terraform Enterprise Management page.

2. After you finish building your configuration file, initialize the Terraform CLI. For more information, see Initializing Working Directories.

   terraform init
   

3. Provision the resources from the main.tf file. For more information, see Provisioning Infrastructure with Terraform.

   1. Run terraform plan to generate a Terraform execution plan to preview the proposed actions.

      terraform plan
      

   2. Run terraform apply to create the resources that are defined in the plan.

      terraform apply