1. In the Google Cloud console, go to theManagement> Environments page.

   Go to Environments

2. In theEnvironments pane, selectEnvironment Groups.
3. Click+ Create Environment Group.
4. Enter the following:
   • Environment group name: A name for the environment group. The name must start and end with an alphanumeric character. It can have up to 63 characters consisting of alphanumeric characters and hyphens. The name must be different from any existing environment group name in your organization.

   • Hostnames: A list of host names that can be used to call proxies. Each host name must be on a separate line.

     Note: The names assigned to an environment group must be unique to that group: they can't be used by other environment groups.

     You also have the option to clickConfigure Google Load Balancer with these domains. This opens theLoad balancing page in the Cloud console, where you can configure load balancing for the host names.

   • Environments: An optional list of environments to include in the environment group.
5. ClickCreate.

Classic Apigee

To create a new environment group in the classic Apigee UI:

1. In theApigee UI, selectAdmin > Environments > Groups.
2. Click+Environment Group:

   

   TheAdd an Environment Group dialog displays.

3. Enter a name for your new environment group:

   

   The name can contain onlylower case letters, numbers, and hyphens. In addition, it must start with a letter, be at least two characters long, and cannot end with a hyphen. Valid names includemy-env-group andprod2.

4. ClickAdd.

   Apigee creates a new environment group. This is usually a very quick operation.

   On a successful operation, Apigee confirms that the group has been created with a banner that looks like the following:

   

   Apigee also assigns a default host name to the new group.

5. (Optional) Assign additional host names to the new group by clickingcreate for that group.

   Apigee displays theEnvironment group details pane:

   

6. Add host names to theHostnames field. Each host name must be on a separate line.

7. ClickSave when you're done.

   You can add and remove host names to this list at any time using the same procedure.

Apigee API

To create a new environment group using the Apigee API, send aPOST request to theCreate environment groups API. Before calling the API, be sure that you have a valid token, as describedinObtaining an OAuth 2.0 access token.

The following examplecurl command shows the syntax to create a new group:

curl -i $TOKEN -X POST \  https://apigee.googleapis.com/v1/organizations/ORG_NAME/envgroups?name=new-group-name

When specifying the new group's name, you must use only lower case letters, numbers, and hyphens(a-z,A-Z, and-). You cannot use upper case letters or anyspecial characters other than hyphens. You must also start the name with a lower case letter.

If you don't specify any additional parameters, this command creates a new group with no hostnames assigned to it.

You can also assign host names when you create the group by specifying them as an array in thebody of the request.

The following example creates a new groupmy-group and assigns three new host names tothe new group:

curl -i $TOKEN -X POST \  https://apigee.googleapis.com/v1/organizations/org_name/envgroups?name=my-group \  -d '{ \    "hostnames": ["server1.mycompany.com", "server2.mycompany.com", "10.1.142.8"] \  }'

You can later change the host names in the list by sending aPATCH request to thePatch environment groups API.

Apigee in Cloud console

To add an environment to an environment group in the Apigee in Cloud console:

1. Create the environment, as described inCreating environments.

2. In the Google Cloud console, go to theManagement> Environments page.

   Go to Environments

3. In theEnvironments pane, selectEnvironment Groups.
4. In the environment group row, click more_vertActions, and selectEdit.
5. In theEdit Environment Group pane, underEnvironments (Optional), select the environment you want to add to the environment group.
6. ClickUpdate.

Classic Apigee

To add an environment to an environment group in the classic Apigee UI:

1. Create the environment, as described inCreating environments.
2. In theApigee UI, selectAdmin > Environments > Groups.
3. Look underUnassigned to see a list of environments that are not part of an environment group:

   

   Note which environments are unassigned as you want to assign them.

4. Clickcreate next to the environment group to which you want to add environments.

   TheEnvironment Group Details pane displays:

   

5. To add a new environment to this group, click+ in theEnvironments list.

   TheAdd environment pane displays:

   

6. Select the environment you want to add to the group and clickAdd.

   Apigee adds the environment to the group.

Apigee API

To add a new environment to an environment group using the Apigee API, send aPOST request to theEnvironment group attachment API, as the following example shows:

curl -H "Authorization: Bearer $TOKEN" -X POST  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group/attachments"  -d '{    "name": "my-attachment",    "environment": "test"  }'

Where:

• $TOKEN is set to your OAuth 2.0 access token, as described inObtaining an OAuth 2.0 access token.
• The body of the request contains the name of the attachment as well as the name of the new environment.

The body of the request contains an instance of anEnvironmentGroupAttachment resource, which is a simple wrapper around a single environment.

If successful, the response contains details about the new attachment, including the timestamp atwhich it was created; for example:

{  "name": "my-attachment",  "environment": "test"  "createdAt": "42"}

Apigee in Cloud console

To remove an environment from an environment group in the Apigee in Cloud console:

1. In the Google Cloud console, go to theManagement> Environments page.

   Go to Environments

2. In theEnvironments pane, selectEnvironment Groups.
3. In the environment group row, click more_vertActions, and selectEdit.
4. In theEdit Environment Group pane, underEnvironments (Optional), deselect the environment you want to remove from the environment group.
5. ClickUpdate.

Classic Apigee

To remove an environment from an environment group in the classic Apigee UI:

1. In theApigee UI, selectAdmin > Environments > Overview.
2. Select the environment you want to remove.
3. In theGroups pane, move the cursor to the end of the row for the group from which you want to remove the environment and click.

Apigee API

To remove an environment from an environment group using the Apigee API,use thedelete method in theEnvironmentGroupAttachment resource to delete the attachment corresponding tothe environment.

Apigee in Cloud console

To delete an environment group in the Apigee in Cloud console:

1. In the Google Cloud console, go to theManagement> Environments page.

   Go to Environments

2. In theEnvironments pane, selectEnvironment Groups.
3. In the environment group row, click more_vertActions, and selectEdit.

Classic Apigee

To delete an environment group in the classic Apigee UI:

1. In theApigee UI, selectAdmin > Environments > Groups.
2. Move the cursor to the pane for the group you want to delete.
3. Click the icon.

Apigee API

To delete an environment group using the Apigee API, use thedeletemethod in theEnvironmentGroup resource.

Apigee in Cloud console

To add a host name to an environment group in the Apigee in Cloud console:

1. In the Google Cloud console, go to theManagement> Environments page.

   Go to Environments

2. In theEnvironments pane, selectEnvironment Groups.
3. In the environment group row, click more_vertActions, and selectEdit.
4. In theEdit Environment Group pane, underHostnames, enter the host name name you want to add to the environment group.
5. ClickUpdate.

Classic Apigee

To add a host name to an environment group in the classic Apigee UI:

1. In theApigee UI, selectAdmin > Environments > Groups.

2. Hover over the group's card and selectcreate.

   TheEnvironment group details pane displays:

   

3. In theHostnames field, enter your new hosts.
4. ClickSave to add the new hosts to the group.

Apigee API

To add host names to an environment group using theApigee API, send aPATCH requestto thePatch environment groups API. Be sure to set theupdateMask parameter tohostnames and specify the entire list of host names that you want: the value of thatfield in your requestreplaces the existing list.

The following example sets the host names for the test environment:

curl -H "Authorization: Bearer $TOKEN" -X PATCH  "https://apigee.googleapis.com/v1/organizations/my-org/envgroups/test-group?updateMask=hostnames"  -d '{    "name": "my-hostnames",    "hostnames": [      "test-1.example.com",      "test-2.example.com",      "test-3.example.com"    ]  }'

Where:

• $TOKEN is set to your OAuth 2.0 access token, as described inObtaining an OAuth 2.0 access token.
• The payload of the request specifies a name for the array of hostname attachments, plus the array of names themselves.

If the request was successful, the response contains anOperation resource.