Связаться с намиПодключиться
Yandex Application Load Balancer

Application Load Balancer API, REST: HttpRouter.list

Статья создана
Обновлена 30 августа 2023 г.

Lists HTTP routers in the specified folder.

HTTP request

GET https://alb.api.cloud.yandex.net/apploadbalancer/v1/httpRouters

Query parameters

Parameter Description
folderId

Required. ID of the folder to list HTTP routers in.

To get the folder ID, make a list request.
pageSize

The maximum number of results per page to return. If the number of available results is larger than page_size, the service returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Default value: 100.

Acceptable values are 0 to 1000, inclusive.
pageToken

Page token. To get the next page of results, set page_token to the nextPageToken returned by a previous list request.

The maximum string length in characters is 100.
filter

A filter expression that filters HTTP routers listed in the response.

The expression must specify:

  1. The field name. Currently you can use filtering only on HttpRouter.name field.
  2. An = operator.
  3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9]. Example of a filter: name=my-http-router.

The maximum string length in characters is 1000.

Response

HTTP Code: 200 - OK

{
  "httpRouters": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "folderId": "string",
      "labels": "object",
      "virtualHosts": [
        {
          "name": "string",
          "authority": [
            "string"
          ],
          "routes": [
            {
              "name": "string",
              "routeOptions": {
                "modifyRequestHeaders": [
                  {
                    "name": "string",

                    // `httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
                    "append": "string",
                    "replace": "string",
                    "remove": true,
                    "rename": "string",
                    // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[]`

                  }
                ],
                "modifyResponseHeaders": [
                  {
                    "name": "string",

                    // `httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
                    "append": "string",
                    "replace": "string",
                    "remove": true,
                    "rename": "string",
                    // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[]`

                  }
                ],
                "rbac": {
                  "action": "string",
                  "principals": [
                    {
                      "andPrincipals": [
                        {

                          // `httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[]` includes only one of the fields `header`, `remoteIp`, `any`
                          "header": {
                            "name": "string",
                            "value": {

                              // `httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[].header.value` includes only one of the fields `exactMatch`, `prefixMatch`, `regexMatch`
                              "exactMatch": "string",
                              "prefixMatch": "string",
                              "regexMatch": "string",
                              // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[].header.value`

                            }
                          },
                          "remoteIp": "string",
                          "any": true,
                          // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[]`

                        }
                      ]
                    }
                  ]
                },
                "securityProfileId": "string"
              },

              // `httpRouters[].virtualHosts[].routes[]` includes only one of the fields `http`, `grpc`
              "http": {
                "match": {
                  "httpMethod": [
                    "string"
                  ],
                  "path": {

                    // `httpRouters[].virtualHosts[].routes[].http.match.path` includes only one of the fields `exactMatch`, `prefixMatch`, `regexMatch`
                    "exactMatch": "string",
                    "prefixMatch": "string",
                    "regexMatch": "string",
                    // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].http.match.path`

                  }
                },

                // `httpRouters[].virtualHosts[].routes[].http` includes only one of the fields `route`, `redirect`, `directResponse`
                "route": {
                  "backendGroupId": "string",
                  "timeout": "string",
                  "idleTimeout": "string",
                  "prefixRewrite": "string",
                  "upgradeTypes": [
                    "string"
                  ],

                  // `httpRouters[].virtualHosts[].routes[].http.route` includes only one of the fields `hostRewrite`, `autoHostRewrite`
                  "hostRewrite": "string",
                  "autoHostRewrite": true,
                  // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].http.route`

                },
                "redirect": {
                  "replaceScheme": "string",
                  "replaceHost": "string",
                  "replacePort": "string",
                  "removeQuery": true,
                  "responseCode": "string",

                  // `httpRouters[].virtualHosts[].routes[].http.redirect` includes only one of the fields `replacePath`, `replacePrefix`
                  "replacePath": "string",
                  "replacePrefix": "string",
                  // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].http.redirect`

                },
                "directResponse": {
                  "status": "string",
                  "body": {
                    "text": "string"
                  }
                },
                // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].http`

              },
              "grpc": {
                "match": {
                  "fqmn": {

                    // `httpRouters[].virtualHosts[].routes[].grpc.match.fqmn` includes only one of the fields `exactMatch`, `prefixMatch`, `regexMatch`
                    "exactMatch": "string",
                    "prefixMatch": "string",
                    "regexMatch": "string",
                    // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].grpc.match.fqmn`

                  }
                },

                // `httpRouters[].virtualHosts[].routes[].grpc` includes only one of the fields `route`, `statusResponse`
                "route": {
                  "backendGroupId": "string",
                  "maxTimeout": "string",
                  "idleTimeout": "string",

                  // `httpRouters[].virtualHosts[].routes[].grpc.route` includes only one of the fields `hostRewrite`, `autoHostRewrite`
                  "hostRewrite": "string",
                  "autoHostRewrite": true,
                  // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].grpc.route`

                },
                "statusResponse": {
                  "status": "string"
                },
                // end of the list of possible fields`httpRouters[].virtualHosts[].routes[].grpc`

              },
              // end of the list of possible fields`httpRouters[].virtualHosts[].routes[]`

            }
          ],
          "modifyRequestHeaders": [
            {
              "name": "string",

              // `httpRouters[].virtualHosts[].modifyRequestHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
              "append": "string",
              "replace": "string",
              "remove": true,
              "rename": "string",
              // end of the list of possible fields`httpRouters[].virtualHosts[].modifyRequestHeaders[]`

            }
          ],
          "modifyResponseHeaders": [
            {
              "name": "string",

              // `httpRouters[].virtualHosts[].modifyResponseHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
              "append": "string",
              "replace": "string",
              "remove": true,
              "rename": "string",
              // end of the list of possible fields`httpRouters[].virtualHosts[].modifyResponseHeaders[]`

            }
          ],
          "routeOptions": {
            "modifyRequestHeaders": [
              {
                "name": "string",

                // `httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
                "append": "string",
                "replace": "string",
                "remove": true,
                "rename": "string",
                // end of the list of possible fields`httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[]`

              }
            ],
            "modifyResponseHeaders": [
              {
                "name": "string",

                // `httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
                "append": "string",
                "replace": "string",
                "remove": true,
                "rename": "string",
                // end of the list of possible fields`httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[]`

              }
            ],
            "rbac": {
              "action": "string",
              "principals": [
                {
                  "andPrincipals": [
                    {

                      // `httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[]` includes only one of the fields `header`, `remoteIp`, `any`
                      "header": {
                        "name": "string",
                        "value": {

                          // `httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[].header.value` includes only one of the fields `exactMatch`, `prefixMatch`, `regexMatch`
                          "exactMatch": "string",
                          "prefixMatch": "string",
                          "regexMatch": "string",
                          // end of the list of possible fields`httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[].header.value`

                        }
                      },
                      "remoteIp": "string",
                      "any": true,
                      // end of the list of possible fields`httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[]`

                    }
                  ]
                }
              ]
            },
            "securityProfileId": "string"
          }
        }
      ],
      "createdAt": "string",
      "routeOptions": {
        "modifyRequestHeaders": [
          {
            "name": "string",

            // `httpRouters[].routeOptions.modifyRequestHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
            "append": "string",
            "replace": "string",
            "remove": true,
            "rename": "string",
            // end of the list of possible fields`httpRouters[].routeOptions.modifyRequestHeaders[]`

          }
        ],
        "modifyResponseHeaders": [
          {
            "name": "string",

            // `httpRouters[].routeOptions.modifyResponseHeaders[]` includes only one of the fields `append`, `replace`, `remove`, `rename`
            "append": "string",
            "replace": "string",
            "remove": true,
            "rename": "string",
            // end of the list of possible fields`httpRouters[].routeOptions.modifyResponseHeaders[]`

          }
        ],
        "rbac": {
          "action": "string",
          "principals": [
            {
              "andPrincipals": [
                {

                  // `httpRouters[].routeOptions.rbac.principals[].andPrincipals[]` includes only one of the fields `header`, `remoteIp`, `any`
                  "header": {
                    "name": "string",
                    "value": {

                      // `httpRouters[].routeOptions.rbac.principals[].andPrincipals[].header.value` includes only one of the fields `exactMatch`, `prefixMatch`, `regexMatch`
                      "exactMatch": "string",
                      "prefixMatch": "string",
                      "regexMatch": "string",
                      // end of the list of possible fields`httpRouters[].routeOptions.rbac.principals[].andPrincipals[].header.value`

                    }
                  },
                  "remoteIp": "string",
                  "any": true,
                  // end of the list of possible fields`httpRouters[].routeOptions.rbac.principals[].andPrincipals[]`

                }
              ]
            }
          ]
        },
        "securityProfileId": "string"
      }
    }
  ],
  "nextPageToken": "string"
}
Field Description
httpRouters[] object

List of HTTP routers in the specified folder.
httpRouters[].
id		 string

ID of the router. Generated at creation time.
httpRouters[].
name		 string

Name of the router. The name is unique within the folder.
httpRouters[].
description		 string

Description of the router.
httpRouters[].
folderId		 string

ID of the folder that the router belongs to.
httpRouters[].
labels		 object

Router labels as key:value pairs. For details about the concept, see documentation.
httpRouters[].
virtualHosts[]		 object

Virtual hosts that combine routes inside the router. For details about the concept, see documentation.

Only one virtual host with no authority (default match) can be specified.
httpRouters[].
virtualHosts[].
name		 string

Required. Name of the virtual host. The name is unique within the HTTP router.
httpRouters[].
virtualHosts[].
authority[]		 string

List of domains that are attributed to the virtual host.

The host is selected to process the request received by the load balancer if the domain specified in the HTTP/1.1 Host header or the HTTP/2 :authority pseudo-header matches a domain specified in the host.

A wildcard asterisk character (*) matches 0 or more characters.

If not specified, all domains are attributed to the host, which is the same as specifying a * value. An HTTP router must not contain more than one virtual host to which all domains are attributed.
httpRouters[].
virtualHosts[].
routes[]		 object

Routes of the virtual host.

A route contains a set of conditions (predicates) that are used by the load balancer to select the route for the request and an action on the request. For details about the concept, see documentation.

The order of routes matters: the first route whose predicate matches the request is selected. The most specific routes should be at the top of the list, so that they are not overridden. For example, if the first HTTP route is configured, via match, to match paths prefixed with just /, other routes are never matched.
httpRouters[].
virtualHosts[].
routes[].
name		 string

Required. Name of the route.
httpRouters[].
virtualHosts[].
routes[].
routeOptions		 object
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[]		 object

Apply the following modifications to the request headers.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[].
append		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[].
replace		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyRequestHeaders[].
rename		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[]		 object

Apply the following modifications to the response headers.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[].
append		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[].
replace		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
modifyResponseHeaders[].
rename		 string
httpRouters[].virtualHosts[].routes[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac		 object

Role Based Access Control (RBAC) provides router, virtual host, and route access control for the ALB service. Requests are allowed or denied based on the action and whether a matching principal is found. For instance, if the action is ALLOW and a matching principal is found the request should be allowed.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
action		 string

Required. The action to take if a principal matches. Every action either allows or denies a request.

  • ALLOW: Allows the request if and only if there is a principal that matches the request.
  • DENY: Allows the request if and only if there are no principal that match the request.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[]		 object

Required. Required. A match occurs when at least one matches the request.

The minimum number of elements is 1.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[]		 object

Required. Required. A match occurs when all principals match the request.

The minimum number of elements is 1.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header		 object
A header (or pseudo-header such as :path or :method) of the incoming HTTP request.
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
name		 string

Required. Specifies the name of the header in the request.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value		 object

Specifies how the header match will be performed to route the request. In the absence of value a request that has specified header name will match, regardless of the header's value.

A string matcher resource.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
exactMatch		 string
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Exact match string.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
prefixMatch		 string
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Prefix match string.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
regexMatch		 string
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Regular expression match string.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
remoteIp		 string
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

A CIDR block or IP that describes the request remote/origin address, e.g. 192.0.0.0/24 or192.0.0.4 .
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
rbac.
principals[].
andPrincipals[].
any		 boolean (boolean)
httpRouters[].virtualHosts[].routes[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

When any is set, it matches any request.
httpRouters[].
virtualHosts[].
routes[].
routeOptions.
securityProfileId		 string

Security profile that will take effect to all requests routed via particular virtual host.
httpRouters[].
virtualHosts[].
routes[].
http		 object
HTTP route configuration.
httpRouters[].virtualHosts[].routes[] includes only one of the fields http, grpc
httpRouters[].
virtualHosts[].
routes[].
http.
match		 object
Condition (predicate) used to select the route.
httpRouters[].
virtualHosts[].
routes[].
http.
match.
httpMethod[]		 string

HTTP method specified in the request.
httpRouters[].
virtualHosts[].
routes[].
http.
match.
path		 object

Match settings for the path specified in the request.

If not specified, the route matches all paths.

A string matcher resource.
httpRouters[].
virtualHosts[].
routes[].
http.
match.
path.
exactMatch		 string
httpRouters[].virtualHosts[].routes[].http.match.path includes only one of the fields exactMatch, prefixMatch, regexMatch

Exact match string.
httpRouters[].
virtualHosts[].
routes[].
http.
match.
path.
prefixMatch		 string
httpRouters[].virtualHosts[].routes[].http.match.path includes only one of the fields exactMatch, prefixMatch, regexMatch

Prefix match string.
httpRouters[].
virtualHosts[].
routes[].
http.
match.
path.
regexMatch		 string
httpRouters[].virtualHosts[].routes[].http.match.path includes only one of the fields exactMatch, prefixMatch, regexMatch

Regular expression match string.
httpRouters[].
virtualHosts[].
routes[].
http.
route		 object
Forwards the request to a backend group for processing as configured.
httpRouters[].virtualHosts[].routes[].http includes only one of the fields route, redirect, directResponse
httpRouters[].
virtualHosts[].
routes[].
http.
route.
backendGroupId		 string

Required. Backend group to forward requests to.

Stream (TCP) backend groups are not supported.
httpRouters[].
virtualHosts[].
routes[].
http.
route.
timeout		 string

Overall timeout for an HTTP connection between a load balancer node an a backend from the backend group: the maximum time the connection is kept alive for, regardless of whether data is transferred over it.

If a connection times out, the load balancer responds to the client with a 504 Gateway Timeout status code.

Default value: 60.
httpRouters[].
virtualHosts[].
routes[].
http.
route.
idleTimeout		 string

Idle timeout for an HTTP connection between a load balancer node an a backend from the backend group: the maximum time the connection is allowed to be idle, i.e. without any data transferred over it.

Specifying meaningful values for both timeout and idle_timeout is useful for implementing server-push mechanisms such as long polling, server-sent events (EventSource interface) etc.

If a connection times out, the load balancer responds to the client with a 504 Gateway Timeout status code.

If not specified, no idle timeout is used, and an alive connection may be idle for any duration (see timeout).
httpRouters[].
virtualHosts[].
routes[].
http.
route.
prefixRewrite		 string

Replacement for the path prefix matched by StringMatch.

For instance, if prefixMatch value is /foo and prefix_rewrite value is /bar, a request with /foobaz path is forwarded with /barbaz path. For exactMatch, the whole path is replaced.

If not specified, the path is not changed.
httpRouters[].
virtualHosts[].
routes[].
http.
route.
upgradeTypes[]		 string

Supported values for HTTP Upgrade header. E.g. websocket.
httpRouters[].
virtualHosts[].
routes[].
http.
route.
hostRewrite		 string
httpRouters[].virtualHosts[].routes[].http.route includes only one of the fields hostRewrite, autoHostRewrite

Host replacement.
httpRouters[].
virtualHosts[].
routes[].
http.
route.
autoHostRewrite		 boolean (boolean)
httpRouters[].virtualHosts[].routes[].http.route includes only one of the fields hostRewrite, autoHostRewrite

Automatically replaces the host with that of the target.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect		 object
Redirects the request as configured.
httpRouters[].virtualHosts[].routes[].http includes only one of the fields route, redirect, directResponse
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
replaceScheme		 string

URI scheme replacement.

If http or https scheme is to be replaced and 80 or 443 port is specified in the original URI, the port is also removed.

If not specified, the original scheme and port are used.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
replaceHost		 string

URI host replacement.

If not specified, the original host is used.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
replacePort		 string (int64)

URI host replacement.

If not specified, the original host is used.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
removeQuery		 boolean (boolean)

Removes URI query.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
responseCode		 string
HTTP status code to use in redirect responses.
  • MOVED_PERMANENTLY: 301 Moved Permanently status code.
  • FOUND: 302 Found status code.
  • SEE_OTHER: 303 See Other status code.
  • TEMPORARY_REDIRECT: 307 Temporary Redirect status code.
  • PERMANENT_REDIRECT: 308 Permanent Redirect status code.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
replacePath		 string
httpRouters[].virtualHosts[].routes[].http.redirect includes only one of the fields replacePath, replacePrefix

Replacement for the whole path.
httpRouters[].
virtualHosts[].
routes[].
http.
redirect.
replacePrefix		 string
httpRouters[].virtualHosts[].routes[].http.redirect includes only one of the fields replacePath, replacePrefix

Replacement for the path prefix matched by StringMatch.

For instance, if prefixMatch value is /foo and replace_prefix value is /bar, a request with https://example.com/foobaz URI is redirected to https://example.com/barbaz. For exactMatch, the whole path is replaced.
httpRouters[].
virtualHosts[].
routes[].
http.
directResponse		 object
Instructs the load balancer to respond directly as configured.
httpRouters[].virtualHosts[].routes[].http includes only one of the fields route, redirect, directResponse
httpRouters[].
virtualHosts[].
routes[].
http.
directResponse.
status		 string (int64)

HTTP status code to use in responses.

Acceptable values are 100 to 599, inclusive.
httpRouters[].
virtualHosts[].
routes[].
http.
directResponse.
body		 object

Response body.

A health check payload resource.
httpRouters[].
virtualHosts[].
routes[].
http.
directResponse.
body.
text		 string

Payload text.

The string length in characters must be greater than 0.
httpRouters[].
virtualHosts[].
routes[].
grpc		 object
gRPC route configuration.
httpRouters[].virtualHosts[].routes[] includes only one of the fields http, grpc
httpRouters[].
virtualHosts[].
routes[].
grpc.
match		 object
Condition (predicate) used to select the route.
httpRouters[].
virtualHosts[].
routes[].
grpc.
match.
fqmn		 object

Match settings for gRPC service method called in the request.

A match string must be a fully qualified method name, e.g. foo.bar.v1.BazService/Get, or a prefix of such.

If not specified, the route matches all methods.

A string matcher resource.
httpRouters[].
virtualHosts[].
routes[].
grpc.
match.
fqmn.
exactMatch		 string
httpRouters[].virtualHosts[].routes[].grpc.match.fqmn includes only one of the fields exactMatch, prefixMatch, regexMatch

Exact match string.
httpRouters[].
virtualHosts[].
routes[].
grpc.
match.
fqmn.
prefixMatch		 string
httpRouters[].virtualHosts[].routes[].grpc.match.fqmn includes only one of the fields exactMatch, prefixMatch, regexMatch

Prefix match string.
httpRouters[].
virtualHosts[].
routes[].
grpc.
match.
fqmn.
regexMatch		 string
httpRouters[].virtualHosts[].routes[].grpc.match.fqmn includes only one of the fields exactMatch, prefixMatch, regexMatch

Regular expression match string.
httpRouters[].
virtualHosts[].
routes[].
grpc.
route		 object
Forwards the request to a backend group for processing as configured.
httpRouters[].virtualHosts[].routes[].grpc includes only one of the fields route, statusResponse
httpRouters[].
virtualHosts[].
routes[].
grpc.
route.
backendGroupId		 string

Required. Backend group to forward requests to.
httpRouters[].
virtualHosts[].
routes[].
grpc.
route.
maxTimeout		 string

Overall timeout for an underlying HTTP connection between a load balancer node an a backend from the backend group: the maximum time the connection is kept alive for, regardless of whether data is transferred over it.

If a client specifies a lower timeout in HTTP grpc-timeout header, the max_timeout value is ignored.

If a connection times out, the load balancer responds to the client with an UNAVAILABLE status code.

Default value: 60.
httpRouters[].
virtualHosts[].
routes[].
grpc.
route.
idleTimeout		 string

Idle timeout for an underlying HTTP connection between a load balancer node an a backend from the backend group: the maximum time the connection is allowed to be idle, i.e. without any data transferred over it.

Specifying meaningful values for both maxTimeout and idle_timeout is useful for implementing server-push mechanisms such as long polling, server-sent events etc.

If a connection times out, the load balancer responds to the client with an UNAVAILABLE status code.

If not specified, no idle timeout is used, and an alive connection may be idle for any duration (see maxTimeout).
httpRouters[].
virtualHosts[].
routes[].
grpc.
route.
hostRewrite		 string
httpRouters[].virtualHosts[].routes[].grpc.route includes only one of the fields hostRewrite, autoHostRewrite

Host replacement.
httpRouters[].
virtualHosts[].
routes[].
grpc.
route.
autoHostRewrite		 boolean (boolean)
httpRouters[].virtualHosts[].routes[].grpc.route includes only one of the fields hostRewrite, autoHostRewrite

Automatically replaces the host with that of the target.
httpRouters[].
virtualHosts[].
routes[].
grpc.
statusResponse		 object
Instructs the load balancer to respond directly with a specified status.
httpRouters[].virtualHosts[].routes[].grpc includes only one of the fields route, statusResponse
httpRouters[].
virtualHosts[].
routes[].
grpc.
statusResponse.
status		 string

gRPC status code to use in responses.

gRPC status code supported for use in responses.

  • OK: OK (0) status code.
  • INVALID_ARGUMENT: INVALID_ARGUMENT (3) status code.
  • NOT_FOUND: NOT_FOUND (5) status code.
  • PERMISSION_DENIED: PERMISSION_DENIED (7) status code.
  • UNAUTHENTICATED: UNAUTHENTICATED (16) status code.
  • UNIMPLEMENTED: UNIMPLEMENTED (12) status code.
  • INTERNAL: INTERNAL (13) status code.
  • UNAVAILABLE: UNAVAILABLE (14) status code.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[]		 object

Deprecated, use route_options.modify_request_headers.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[].
append		 string
httpRouters[].virtualHosts[].modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[].
replace		 string
httpRouters[].virtualHosts[].modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
modifyRequestHeaders[].
rename		 string
httpRouters[].virtualHosts[].modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[]		 object

Deprecated, use route_options.modify_response_headers.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[].
append		 string
httpRouters[].virtualHosts[].modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[].
replace		 string
httpRouters[].virtualHosts[].modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
modifyResponseHeaders[].
rename		 string
httpRouters[].virtualHosts[].modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
routeOptions		 object
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[]		 object

Apply the following modifications to the request headers.
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[].
append		 string
httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[].
replace		 string
httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
routeOptions.
modifyRequestHeaders[].
rename		 string
httpRouters[].virtualHosts[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[]		 object

Apply the following modifications to the response headers.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[].
name		 string

Name of the header.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[].
append		 string
httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[].
replace		 string
httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[].
remove		 boolean (boolean)
httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
virtualHosts[].
routeOptions.
modifyResponseHeaders[].
rename		 string
httpRouters[].virtualHosts[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
virtualHosts[].
routeOptions.
rbac		 object

Role Based Access Control (RBAC) provides router, virtual host, and route access control for the ALB service. Requests are allowed or denied based on the action and whether a matching principal is found. For instance, if the action is ALLOW and a matching principal is found the request should be allowed.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
action		 string

Required. The action to take if a principal matches. Every action either allows or denies a request.

  • ALLOW: Allows the request if and only if there is a principal that matches the request.
  • DENY: Allows the request if and only if there are no principal that match the request.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[]		 object

Required. Required. A match occurs when at least one matches the request.

The minimum number of elements is 1.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[]		 object

Required. Required. A match occurs when all principals match the request.

The minimum number of elements is 1.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header		 object
A header (or pseudo-header such as :path or :method) of the incoming HTTP request.
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
name		 string

Required. Specifies the name of the header in the request.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value		 object

Specifies how the header match will be performed to route the request. In the absence of value a request that has specified header name will match, regardless of the header's value.

A string matcher resource.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
exactMatch		 string
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Exact match string.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
prefixMatch		 string
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Prefix match string.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
regexMatch		 string
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Regular expression match string.
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
remoteIp		 string
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

A CIDR block or IP that describes the request remote/origin address, e.g. 192.0.0.0/24 or192.0.0.4 .
httpRouters[].
virtualHosts[].
routeOptions.
rbac.
principals[].
andPrincipals[].
any		 boolean (boolean)
httpRouters[].virtualHosts[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

When any is set, it matches any request.
httpRouters[].
virtualHosts[].
routeOptions.
securityProfileId		 string

Security profile that will take effect to all requests routed via particular virtual host.
httpRouters[].
createdAt		 string (date-time)

Creation timestamp.

String in RFC3339 text format. The range of possible values is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the Protocol Buffers reference. In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).
httpRouters[].
routeOptions		 object
httpRouters[].
routeOptions.
modifyRequestHeaders[]		 object

Apply the following modifications to the request headers.
httpRouters[].
routeOptions.
modifyRequestHeaders[].
name		 string

Name of the header.
httpRouters[].
routeOptions.
modifyRequestHeaders[].
append		 string
httpRouters[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
routeOptions.
modifyRequestHeaders[].
replace		 string
httpRouters[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
routeOptions.
modifyRequestHeaders[].
remove		 boolean (boolean)
httpRouters[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
routeOptions.
modifyRequestHeaders[].
rename		 string
httpRouters[].routeOptions.modifyRequestHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
routeOptions.
modifyResponseHeaders[]		 object

Apply the following modifications to the response headers.
httpRouters[].
routeOptions.
modifyResponseHeaders[].
name		 string

Name of the header.
httpRouters[].
routeOptions.
modifyResponseHeaders[].
append		 string
httpRouters[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Appends the specified string to the header value.

Variables defined for Envoy proxy are supported.
httpRouters[].
routeOptions.
modifyResponseHeaders[].
replace		 string
httpRouters[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the value of the header with the specified string.

Variables defined for Envoy proxy are supported.
httpRouters[].
routeOptions.
modifyResponseHeaders[].
remove		 boolean (boolean)
httpRouters[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Removes the header.
httpRouters[].
routeOptions.
modifyResponseHeaders[].
rename		 string
httpRouters[].routeOptions.modifyResponseHeaders[] includes only one of the fields append, replace, remove, rename

Replaces the name of the header with the specified string. This operation is only supported for ALB Virtual Hosts.
httpRouters[].
routeOptions.
rbac		 object

Role Based Access Control (RBAC) provides router, virtual host, and route access control for the ALB service. Requests are allowed or denied based on the action and whether a matching principal is found. For instance, if the action is ALLOW and a matching principal is found the request should be allowed.
httpRouters[].
routeOptions.
rbac.
action		 string

Required. The action to take if a principal matches. Every action either allows or denies a request.

  • ALLOW: Allows the request if and only if there is a principal that matches the request.
  • DENY: Allows the request if and only if there are no principal that match the request.
httpRouters[].
routeOptions.
rbac.
principals[]		 object

Required. Required. A match occurs when at least one matches the request.

The minimum number of elements is 1.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[]		 object

Required. Required. A match occurs when all principals match the request.

The minimum number of elements is 1.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header		 object
A header (or pseudo-header such as :path or :method) of the incoming HTTP request.
httpRouters[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
name		 string

Required. Specifies the name of the header in the request.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value		 object

Specifies how the header match will be performed to route the request. In the absence of value a request that has specified header name will match, regardless of the header's value.

A string matcher resource.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
exactMatch		 string
httpRouters[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Exact match string.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
prefixMatch		 string
httpRouters[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Prefix match string.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
header.
value.
regexMatch		 string
httpRouters[].routeOptions.rbac.principals[].andPrincipals[].header.value includes only one of the fields exactMatch, prefixMatch, regexMatch

Regular expression match string.
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
remoteIp		 string
httpRouters[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

A CIDR block or IP that describes the request remote/origin address, e.g. 192.0.0.0/24 or192.0.0.4 .
httpRouters[].
routeOptions.
rbac.
principals[].
andPrincipals[].
any		 boolean (boolean)
httpRouters[].routeOptions.rbac.principals[].andPrincipals[] includes only one of the fields header, remoteIp, any

When any is set, it matches any request.
httpRouters[].
routeOptions.
securityProfileId		 string

Security profile that will take effect to all requests routed via particular virtual host.
nextPageToken string

Token for getting the next page of the list. If the number of results is greater than the specified pageSize, use next_page_token as the value for the pageToken parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.
Предыдущая
get
Следующая
listOperations
В этой статье: