Application Load Balancer API, REST: HttpRouter.list
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 Acceptable values are 0 to 1000, inclusive. |
pageToken | Page token. To get the next page of results, set The maximum string length in characters is 100. |
filter | A filter expression that filters HTTP routers listed in the response. The expression must specify:
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 |
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 A wildcard asterisk character ( If not specified, all domains are attributed to the host, which is the same as specifying a |
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 |
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 |
httpRouters[]. virtualHosts[]. routes[]. routeOptions. rbac. action |
string Required. The action to take if a principal matches. Every action either allows or denies a 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. |
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 Default value: |
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 If a connection times out, the load balancer responds to the client with a If not specified, no idle timeout is used, and an alive connection may be idle for any duration (see |
httpRouters[]. virtualHosts[]. routes[]. http. route. prefixRewrite |
string Replacement for the path prefix matched by For instance, if If not specified, the path is not changed. |
httpRouters[]. virtualHosts[]. routes[]. http. route. upgradeTypes[] |
string Supported values for HTTP |
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 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.
|
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 For instance, if |
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. 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 If a connection times out, the load balancer responds to the client with an Default value: |
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 If a connection times out, the load balancer responds to the client with an If not specified, no idle timeout is used, and an alive connection may be idle for any duration (see |
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.
|
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 |
httpRouters[]. virtualHosts[]. routeOptions. rbac. action |
string Required. The action to take if a principal matches. Every action either allows or denies a 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. |
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 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 |
httpRouters[]. routeOptions. rbac. action |
string Required. The action to take if a principal matches. Every action either allows or denies a 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. |
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 Each subsequent page will have its own |