You've created a Google Cloud account and project and enabled the APIs. Now you can create yourorganization.

Prerequisite

To create an organization, you must meet one of the following conditions:

• Have an evaluation account. Evaluation accounts expire after 60 days. At that time, the organization willbe deleted.
• Have a paid account

If neither of these is true, then you must contactApigee Sales before you can continue.

To create a new organization and provision it:

1. On the command line, get yourgcloud authentication credentials, as the following example shows:

   TOKEN=$(gcloud auth print-access-token)

   To check that your token was populated, useecho, as the following example shows:

   echo $TOKEN

   This should display your token as an encoded string.

   For more information, seegcloud command-line tool overview.

2. Send an authenticatedPOST request to theCreate organizations API.Note: After you create a hybrid-enabled organization, you cannot delete it, change the organization ID, or change the Google Cloud project that is bound to it. If you need to migrate to another Google Cloud project, contactApigee Sales to decommission the project and provide an entitlement for a new one.

   The following example shows the request structure that creates an organization:

   curl -H "Authorization: Bearer $TOKEN" -X POST -H "content-type:application/json" \  -d '{    "name":"proposed_org_ID",    "displayName":"display_name",    "description":"organization_description",    "runtimeType":"runtime_type",    "analyticsRegion":"analytics_region"  }' \  "https://apigee.googleapis.com/v1/organizations?parent=projects/project_ID"

   Where:

   • (Required)proposed_org_ID is the programmatic ID that you want for your hybrid-enabled organization. For example,my-hybrid-org.Note: The organization ID can contain only lower- case letters, digits, and hyphens. It has a maximum length of 32 characters.

     The following example IDs are valid:

     check_circle org-all-lowercase
     check_circle short-org-id
     check_circle org-with-hyphens
     check_circle org-number-42

     The following example IDs arenot valid:

     close Org-With-Camel-Case
     close long-organization-id-is-more-than-32-characters
     close org_with_underscores
     close org+with*other/special%chars

     Apigee recommends that you use the same ID as the Google Cloud project ID that you created inStep 2: Create a Google Cloud project, but you can use another ID if you want.

   • (Required)runtime_type is the runtime type of the Apigee organization, where HYBRID is user-managed Apigee hybrid runtime.
   • (Required)analytics_region is the primary region for analytics data storage. Choose one of the following:

     asia-northeast1	australia-southeast1	us-west1
     us-central1	us-east1	europe-west1
     europe-west2

     We provide this option so that you can choose a region that is geographically close or if your organization has other storage requirements.

   • (Required)project_ID is the Google Cloud project that you want bound to your new hybrid-enabled organization. This is the ID that Google generated for you inStep 2: Create a Google Cloud project.Note: The project ID can contain only lower-case letters, digits, and hyphens, with a maximum length of 32 characters.
   • (Optional)display_name is the user-friendly name of your organization. This value does not need to be unique, and can include spaces and special characters. For example, "My Hybrid Organization".
   • (Optional)organization_description is information about the organization that you'd like to use as a reminder of its purpose. For example, "My first organization".

   On a successful creation request, the Organizations API should respond with a message similar to the following:

   {"name":"organizations/organization_ID/operations/long_running_operation_ID","metadata":{"@type":"type.googleapis.com/google.cloud.apigee.v1.OperationMetadata","operationType":"INSERT","targetResourceName":"organizations/organization_ID","state":"IN_PROGRESS"}}

   Where:

   • long_running_operation_ID is the UUID of an asynchronous, long-running operation. You can use this ID to check the status of your organizatioin creation request (described later).
   • organization_ID is the ID of your new organization that is currently being created.

   As thestate property in the response indicates, Apigee has started to create the new organization, so it's state isIN_PROGRESS. This process can take several minutes.

   If you get an error, seeTroubleshooting organization creation.

3. You can check the status of the long-running operation whose ID Apigee returned on your initial creation request. To do this, use theOperations API, as the following example shows:

   curl -H "Authorization: Bearer $TOKEN" \  "https://apigee.googleapis.com/v1/organizations/organization_ID/operations/long_running_operation_ID"

   The following examples show possible responses to this request:

   FINISHED

   When the organization has been provisioned, the state of the long-running operation isFINISHED, as the following example shows:

   {"operations":[{"name":"organizations/organization_ID/operations/long_running_operation_ID","metadata":{"@type":"type.googleapis.com/google.cloud.apigee.v1.OperationMetadata","operationType":"INSERT","targetResourceName":"organizations/organization_ID","state":"FINISHED"},"done":true,"response":{"@type":"type.googleapis.com/google.cloud.apigee.v1.Organization","name":"organization_ID","createdAt":"1572550611","lastModifiedAt":"1572550611","displayName":"display_name""description":"description""properties":{"property":[{"name":"features.hybrid.enabled","value":"true"}]},"analyticsRegion":"us-east1""runtimeType":"HYBRID",}}]}

   If you did not enter a description, then that field will not appear in the response.

   Congratulations! You have created a new organization and it is ready for you to use. You can continue toStep 5: Add an environment.

   IN_PROGRESS

   If Apigee is still creating the organization, Apigee responds with a status ofIN_PROGRESS, as the following example shows:

   {"name":"organizations/organization_ID/operations/long_running_operation_ID","metadata":{"@type":"type.googleapis.com/google.cloud.apigee.v1.OperationMetadata","operationType":"INSERT","targetResourceName":"organizations/organization_ID","state":"IN_PROGRESS"}}

   You should wait a little longer before attempting to verify that the creation process is complete.

Troubleshooting organization creation

When you create an organization with theCreate organizations API, you might get an error response. Responses look like the following:

{  "error": {    "code":HTTP_error_code,    "message": "short_error_message",    "status": "high_level_error_type",    "details": [      {        "@type": "specific_error_type",        "detail": "expanded_error_description"      }    ]  }}

The following example shows a response to a common error—the organization ID containsillegal characters (upper case characters are not allowed in organization IDs):

{"error":{"code":400,"message":"invalid Organization ID\"MY-ORG\":\"MY-ORG\" is an invalid Organization ID","status":"INVALID_ARGUMENT","details":[{"@type":"type.googleapis.com/google.rpc.DebugInfo","detail":"[ORIGINAL ERROR] generic::invalid_argument: invalid Organization ID\"MY-ORG\":\"My-ORG\" is an invalid Organization ID [google.rpc.error_details_ext]{message:\"invalid Organization ID\\\"MY-ORG\\\":\\\"MY-ORG\\\" is an invalidOrganizationID\" }"}]}}

In this case, you could rename the organization with lower-case letters and resend your request.

The following table lists errors you might receive and potential resolutions when you try to create a new organization:

Get organization information

You can get a list of all organizations that your account has access to, or you can get details about a specific organization by its ID. To perform these actions, you use theorganizations API.

https://apigee.googleapis.com/v1/organizations

curl -H "Authorization: Bearer $TOKEN" "https://apigee.googleapis.com/v1/organizations"

{  "organizations": [    {      "organization": "my-org-42",      "projectIds": [        "my-project"      ]    }  ]}

https://apigee.googleapis.com/v1/organizations/organization_ID

curl -H "Authorization: Bearer $TOKEN"  "https://apigee.googleapis.com/v1/organizations/my-org-42"

{  "name": "my-org-42",  "createdAt": "1572550611",  "lastModifiedAt": "1572550611",  "environments": [    "my-environment"  ],  "analyticsRegion": "us-east1"}