Manage extensions

This page describes how to manage extensions that are configured using Service Extensions.

For a product overview, see Service Extensions overview.

Note: Authorization extensions are in Preview and supported using Google Cloud CLI and REST APIs, but not the Google Cloud console.

List extensions

Console

1. Go to the Service Extensions page.

   Go to Service Extensions

   A list of the extensions in your project appears in a sortable table that shows the following information:

   • Name: the name of the extension
   • Product: the Google Cloud product that uses the extension
   • Type: the type of extension
   • Region: the region for regional load balancers
   • Extensions: the number of extension chains
   • In use by: the forwarding rules with which the extension is associated
   • Last modified: the time when the extension was last modified

2. Optional: To filter the list, do the following:

   1. To see a list of properties, click next to Filter table.

   2. From the list, select a property.

      The property name, followed by a colon, appears next to the Filter table label.

   3. To see a list of values that match the property, insert a space next to the colon, and then select a value from the list.

   4. Optional: To specify combined filters, enter the OR operator between property-value pairs.

3. Optional: To perform other operations with a selected extension, click More actions, and then select an option:

   • To edit the extension, click Edit.
   • To delete the extension, click Delete.

gcloud

Route extensions

To list the route extensions in the current project, use the gcloud service-extensions lb-route-extensions list command.

gcloud service-extensions lb-route-extensions list \
    --location LOCATION

Replace LOCATION with the location of the extension resource.

The following high-level information is provided about each extension: the name, the load-balancing scheme, and the last modified date.

Authorization extensions

To list the authorization extensions in the current project, use the gcloud beta service-extensions authz-extensions list command.

gcloud beta service-extensions authz-extensions list \
    --location LOCATION

Replace LOCATION with the location of the extension resource.

The following high-level information is provided about each extension: the name, the authorization policy, and the last modified date.

Traffic extensions

To list the traffic extensions in the current project, use the gcloud service-extensions lb-traffic-extensions list command.

gcloud service-extensions lb-traffic-extensions list \
  --location LOCATION

Replace LOCATION with the location of the extension resource.

The following high-level information is provided about each extension: the name, the load-balancing scheme, and the last modified date.

View the details of an extension

Console

1. Go to the Service Extensions page.

   Go to Service Extensions

2. Click the name of the extension for which you want to see details.

   The Details page for the extension opens. It has the following sections:

   • Basics: This section shows these basic details about the extension: the product, the load balancer, the extension type, the description, and labels.

   • Forwarding rules: This section provides a link to the associated forwarding rules. You can click the link to view its details.

   • Extension chains: This section lists the extension chains included in the extension in the specified sequence. Additionally, for each extension chain, it shows the chain name, match conditions, extensions, and details for each extension. The name of the backend service is a link that you can click to view its details and, if required, edit it.

gcloud

Route extensions

To view the details of a route extension, use the gcloud service-extensions lb-route-extensions describe command.

gcloud service-extensions lb-route-extensions describe EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the route extension
• LOCATION: the location of the extension resource

Authorization extensions

To view the details of an authorization extension, use the gcloud beta service-extensions authz-extensions describe command.

gcloud beta service-extensions authz-extensions describe EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the route extension
• LOCATION: the location of the extension resource

Traffic extensions

To view the details of a traffic extension, use the gcloud service-extensions lb-traffic-extensions describe command.

gcloud service-extensions lb-traffic-extensions describe EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the traffic extension
• LOCATION: the location of the backend

Edit an extension

Console

1. Go to the Service Extensions page.

   Go to Service Extensions

2. For the extension that you want to edit, click More actions, and then select Edit.

   Alternatively, click the extension name, and then, on the Details page, click Edit.

   On the Edit service extensions page, the basic information about the extension isn't editable. You can edit other details.

3. Make changes as required.

   For information about most fields, see the pages on how to configure route extensions and traffic extensions.

4. Click Update extension.

gcloud

To edit an extension, use the same steps that you used to configure it. For more information, see the pages about how to configure route extensions, authorization extensions, and traffic extensions.

Note: You can't modify the extension name or the load balancing scheme of an existing extension.

Delete an extension

Console

1. Go to the Service Extensions page.

   Go to Service Extensions

2. For the extension that you want to delete, select the checkbox, and then click Delete at the top of the page.

   Alternatively, click More actions, and then select Delete.

3. In the confirmation message box, to confirm the operation, click Delete.

gcloud

Route extensions

To delete a route extension, use the gcloud service-extensions lb-route-extensions delete command.

gcloud service-extensions lb-route-extensions delete EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the route extension
• LOCATION: the location of the backend

Authorization extensions

To delete a authorization extension, use the gcloud beta service-extensions authz-extensions delete command.

gcloud beta service-extensions authz-extensions delete EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the authorization extension
• LOCATION: the location of the backend

Traffic extensions

To delete a traffic extension, use the gcloud service-extensions lb-traffic-extensions delete command.

gcloud service-extensions lb-traffic-extensions delete EXTENSION_ID \
    --location LOCATION

Replace the following:

• EXTENSION_ID: the ID or the fully qualified name of the traffic extension
• LOCATION: the location of the backend

What's next

• Manage plugins