Step 3: Create an Apigee organization

You're viewing Apigee X documentation.
View Apigee Edge documentation.

An Apigee organization (sometimes referred to as an org) is the top-level container in Apigee. It includes all of your environments and environment groups, users, API proxies, and related resources. For more information, see Understanding organizations.

What you're doing in this step

Now that you've enabled the required APIs, and created the encryption keys, you can create an Apigee organization.

The wizard gives your new organization the same name as your project ID. This ensures that it is globally unique.

Perform the step

To create a new organization in the Apigee provisioning wizard:

  1. In the wizard, click EDIT next to Apigee organization:

    Set up Apigee Subscription > Apigee organization ready

    The Create an Apigee organization view displays:

    Create organization screen

  2. From the Analytics hosting region drop-down list, select the physical location where you want your analytics data stored. For example: us-west1.

  3. Under Runtime database encryption key make the following selections:
    1. Choose a Cloud KMS location. The dropdown menu lists two groupings of locations: multi-regional and dual-regional are grouped together, and regional locations are in another grouping. Note that if you select a Regional location, we cannot offer an SLA higher than 99.9%.
    2. Next, choose a customer-managed encryption key. If a key already exists in the KMS location you selected, you can pick it. The wizard lists all keys in the location across all key rings. If a key doesn't exist, or if you don't want to use an existing key, you can create a new key from within the wizard. To create a key:
      1. Click CREATE KEY.
      2. Select a key ring, or if one doesn't exist, enable Create key ring and enter a key ring name and pick your KMS location. Key ring names can contain letters, numbers, underscores (_), and hyphens (-). Key rings can't be renamed or deleted.
      3. Click CONTINUE.
      4. Create a key. Enter a name and protection level. Note that key names can contain letters, numbers, underscores (_), and hyphens (-). Keys can't be renamed or deleted. For protection level, Software is a good choice. This is the same default used by Cloud KMS; however, you can change it if you wish.
      5. Click CONTINUE and review your selections.
      6. Click CREATE.
    3. Click GRANT to grant the service account permission to encrypt/decrypt with the selected key.
    4. Click CREATE ORGANIZATION.

      Apigee begins the process of creating an organization for your project. The process will take a few minutes.

      When Apigee finishes creating your organization, a check mark appears next to the task and an Edit button appears next to the next task in the wizard:

    If you encounter errors during this part of the process, see Troubleshooting.


    1 2 3 NEXT: Configure service networking 5 6 7 8