google.cloud.gcp_compute_url_map_info – Сбор информации о GCP UrlMap

complex

Список ресурсов

string

Маркер создания в формате RFC3339.

complex

defaultRouteAction вступает в силу, когда ни одно из правил hostRules не соответствует запросу. Load Balancer выполняет расширенные действия маршрутизации, такие как изменение URL, преобразование заголовков и т. д., прежде чем перенаправить запрос на выбранный бэкенд.

Если defaultRouteAction указывает какие-либо weightedBackendServices, то defaultService не должен быть задан. И наоборот, если задан defaultService, defaultRouteAction не может содержать weightedBackendServices.

Должно быть задано либо defaultRouteAction, либо defaultUrlRedirect.

complex

Спецификация для разрешения кросс-доменных запросов со стороны клиента. См. [Рекомендацию W3C по кросс-доменному обмену ресурсами](https://www.w3.org/TR/cors/).

boolean

В ответ на предварительный запрос, установка этого значения в true указывает, что фактический запрос может содержать учетные данные пользователя.

Это соответствует заголовку Access-Control-Allow-Credentials.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Headers.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Methods.

list / elements=string

Указывает шаблоны регулярных выражений, которые соответствуют разрешенным источникам. Для синтаксиса регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Источник разрешен, если он соответствует элементу в allowOrigins или allowOriginRegexes.

list / elements=string

Указывает список источников, которым будет разрешено выполнять запросы CORS.

Источник разрешен, если он соответствует элементу в allowOrigins или allowOriginRegexes.

boolean

Если true, указывает, что политика CORS отключена. По умолчанию false, что означает, что политика CORS активна.

list / elements=string

Указывает содержимое заголовка Access-Control-Expose-Headers.

integer

Указывает, как долго результаты предварительного запроса могут кешироваться в секундах.

Это соответствует заголовку Access-Control-Max-Age.

complex

Спецификация для введения отказоустойчивости в трафик для проверки устойчивости клиентов к сбоям бэкенд-служб.

В рамках отказоустойчивости, при отправке клиентами запросов на бэкенд-службу, Load Balancer может вводить задержки в процент запросов, перед отправкой их бэкенд-службе. Аналогично, запросы от клиентов могут быть прерваны Load Balancer для определенного процента запросов.

timeout и retryPolicy будут игнорироваться клиентами, у которых настроена faultInjectionPolicy.

complex

Спецификация для прерывания клиентских запросов в рамках отказоустойчивости.

integer

Код HTTP-статуса, используемый для прерывания запроса.

Значение должно быть в диапазоне от 200 до 599 включительно.

string

Процент трафика (соединений/операций/запросов), который будет прерван в рамках отказоустойчивости.

Значение должно быть в диапазоне от 0.0 до 100.0 включительно.

complex

Спецификация для задержки клиентских запросов в рамках отказоустойчивости перед отправкой на бэкенд-службу.

complex

Указывает значение фиксированного интервала задержки.

integer

Продолжительность, представляющая долю секунды с разрешением в наносекунды. Продолжительности меньше секунды представляются с полем 0 секунд и положительным полем nanos. Должно быть в диапазоне от 0 до 999 999 999 включительно.

string

Продолжительность с разрешением в секунды. Должно быть в диапазоне от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/час * 24 час/день * 365,25 дней/год * 10000 лет.

string

Процент трафика (соединений/операций/запросов), для которого будет введена задержка в рамках отказоустойчивости.

Значение должно быть в диапазоне от 0.0 до 100.0 включительно.

complex

Указывает политику того, как запросы, предназначенные для бэкендов маршрута, дублируются на отдельную зеркальную бэкенд-службу.

Load Balancer не ожидает ответов от зеркальной службы. Перед отправкой трафика на зеркальную службу к заголовку host/authority добавляется суффикс -shadow.

dictionary

Полный или частичный URL ресурса BackendService, который будет дублироваться.

complex

Указывает политику повторных попыток, связанную с этим маршрутом.

integer

Указывает разрешенное количество повторных попыток. Это число должно быть > 0. Если не указано, по умолчанию равно 1.

complex

Указывает ненулевой тайм-аут на попытку повторной отправки.

Если не указано, будет использоваться тайм-аут, установленный в HttpRouteAction. Если тайм-аут в HttpRouteAction не установлен, будет использоваться максимальный тайм-аут среди всех бэкенд-служб, связанных с маршрутом.

integer

Продолжительность, представляющая долю секунды с разрешением в наносекунды. Продолжительности меньше секунды представляются с полем 0 секунд и положительным полем nanos. Должно быть в диапазоне от 0 до 999 999 999 включительно.

string

Продолжительность с разрешением в секунды. Должно быть в диапазоне от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/час * 24 час/день * 365,25 дней/год * 10000 лет.

list / elements=string

Указывает один или несколько условий, когда применяется данное правило повторной попытки. Допустимые значения: 5xx: балансировщик нагрузки попытается повторить попытку, если бэкенд-сервис ответит любым кодом ответа 5xx, или если бэкенд-сервис не ответит вовсе, например: отключения, сброс, таймаут чтения, отказ в подключении и отказ от потоков.

gateway-error: Аналогично 5xx, но применяется только к кодам ответа 502, 503 или 504.

connect-failure: Балансировщик нагрузки повторит попытку при ошибках подключения к бэкенд-сервисам, например, из-за таймаутов подключения.

retriable-4xx: Балансировщик нагрузки повторит попытку для исправленных кодов ответа 4xx.

В настоящее время поддерживается только одна исправленная ошибка — 409.

refused-stream: Балансировщик нагрузки повторит попытку, если бэкенд-сервис сбросит поток с кодом ошибки REFUSED_STREAM.

Этот тип сброса указывает на то, что повторение попытки безопасно.

cancelled: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в cancelled deadline-exceeded: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в deadline-exceeded resource-exhausted: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в resource-exhausted unavailable: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в unavailable.

complex

Устанавливает таймаут для выбранного маршрута. Таймаут вычисляется от момента полного обработки запроса (т. е. конца потока) до момента полной обработки ответа. Таймаут включает все повторные попытки.

Если не указано, используется наибольший таймаут среди всех бэкенд-сервисов, связанных с маршрутом.

integer

Продолжительность, представляющая собой дробь секунды с разрешением в наносекунды. Продолжительности, меньшие одной секунды, представлены значением поля «секунды» равным 0 и положительным значением поля «наносекунды». Должно быть от 0 до 999 999 999 включительно.

string

Продолжительность времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/ч * 24 ч/сут * 365,25 дней/год * 10000 лет.

complex

Спецификация для изменения URL запроса перед пересылкой его на соответствующий сервис.

string

Перед пересылкой запроса на выбранный сервис заголовок хоста запроса заменяется содержимым hostRewrite.

Значение должно быть от 1 до 255 символов.

string

Перед пересылкой запроса на выбранный бэкенд-сервис соответствующая часть пути запроса заменяется на pathPrefixRewrite.

Значение должно быть от 1 до 1024 символов.

complex

Список взвешенных бэкенд-сервисов для отправки трафика при совпадении маршрута.

Веса определяют долю трафика, поступающего на соответствующий бэкенд-сервис.

Если весь трафик должен направляться на один бэкенд-сервис, должен быть один weightedBackendService с весом, отличным от 0.

После идентификации бэкенд-сервиса и перед пересылкой запроса на бэкенд-сервис применяются расширенные действия маршрутизации, такие как перенаправление URL и преобразования заголовков, в зависимости от дополнительных параметров, указанных в этом HttpRouteAction.

dictionary

Полный или частичный URL ресурса бэкенд-сервиса по умолчанию. Перед пересылкой запроса на backendService, балансировщик нагрузки применяет все соответствующие headerActions, указанные в рамках этого backendServiceWeight.

complex

Указывает изменения в заголовках запроса и ответа, которые должны применяться для выбранного backendService.

headerAction, указанные здесь, применяются до headerAction в охватывающем HttpRouteRule, PathMatcher и UrlMap.

complex

Заголовки, которые нужно добавить к соответствующему запросу перед пересылкой его на backendService.

string

Имя добавляемого заголовка.

string

Значение добавляемого заголовка.

boolean

Если false, headerValue добавляется к любым значениям, которые уже существуют для заголовка.

Если true, headerValue устанавливается для заголовка, отбрасывая любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков для заголовков, которые нужно удалить из запроса перед пересылкой его на backendService.

complex

Заголовки, которые нужно добавить в ответ перед отправкой его обратно клиенту.

string

Имя добавляемого заголовка.

string

Значение добавляемого заголовка.

boolean

Если false, headerValue добавляется к любым значениям, которые уже существуют для заголовка.

Если true, headerValue устанавливается для заголовка, отбрасывая любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков для заголовков, которые нужно удалить из ответа перед отправкой его обратно клиенту.

integer

Указывает долю трафика, отправляемого на backendService, вычисленную как weight / (сумма всех весов weightedBackendService в routeAction).

Выбор бэкенд-сервиса определяется только для нового трафика. После того, как запрос пользователя был направлен на backendService, последующие запросы будут отправлены на тот же backendService, как определено политикой affinity сеанса BackendService.

Значение должно быть от 0 до 1000.

dictionary

Полный или частичный URL ресурса defaultService, на который направляется трафик, если ни один из hostRules не совпадает. Если дополнительно указан defaultRouteAction, расширенные действия маршрутизации, такие как перенаправление URL и т. д., применяются до отправки запроса на бэкенд. Однако, если указан defaultService, defaultRouteAction не может содержать weightedBackendServices. И наоборот, если routeAction содержит weightedBackendServices, service не должен быть указан. Только одно из defaultService, defaultUrlRedirect или defaultRouteAction.weightedBackendService должно быть установлено.

complex

Если ни один из указанных hostRules не совпадает, запрос перенаправляется на URL, указанный в defaultUrlRedirect. Если указан defaultUrlRedirect, defaultService или defaultRouteAction не должны быть установлены.

string

Хост, который будет использован в ответе перенаправления вместо того, который был предоставлен в запросе. Значение должно быть между 1 и 255 символами.

boolean

Если установлено в true, схема URL в запросе перенаправления устанавливается как https. Если установлено в false, схема URL перенаправленного запроса останется такой же, как и в запросе. Это свойство должно быть задано только для UrlMaps, используемых в TargetHttpProxys. Установка в true для TargetHttpsProxy запрещена. По умолчанию установлено в false.

string

Путь, который будет использован в ответе перенаправления вместо пути, предоставленного в запросе. pathRedirect не может быть задан вместе с prefixRedirect. Укажите одно или ни одного из них. Если ни то, ни другое не указано, для перенаправления будет использоваться путь исходного запроса. Значение должно быть между 1 и 1024 символами.

string

Префикс, который заменяет prefixMatch, указанный в HttpRouteRuleMatch, сохраняя оставшуюся часть URL перед перенаправлением запроса.

prefixRedirect не может быть задан вместе с pathRedirect. Укажите одно или ни одного из них. Если ни то, ни другое не указано, для перенаправления будет использоваться путь исходного запроса. Значение должно быть между 1 и 1024 символами.

string

Код HTTP-статуса, используемый для этого RedirectAction. Допустимые значения: * MOVED_PERMANENTLY_DEFAULT, которое является значением по умолчанию и соответствует 301.

* FOUND, которое соответствует 302.

* SEE_OTHER, которое соответствует 303.

* TEMPORARY_REDIRECT, которое соответствует 307. В этом случае метод запроса сохранится.

* PERMANENT_REDIRECT, которое соответствует 308. В этом случае метод запроса сохранится.

boolean

Если установлено в true, любая сопутствующая часть запроса исходного URL удаляется перед перенаправлением запроса. Если установлено в false, часть запроса исходного URL сохраняется. По умолчанию установлено в false.

string

Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.

string

Отпечаток ресурса. Хэш содержимого, хранящегося в этом объекте. Это поле используется для оптимистической блокировки.

complex

Указывает изменения в заголовках запроса и ответа, которые должны быть применены для выбранного backendService. Заголовки headerAction, указанные здесь, применяются после headerAction, указанных в pathMatcher.

complex

Заголовки, которые нужно добавить к соответствующему запросу перед передачей запроса backendService.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым существующим значениям заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые ранее заданные значения для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из запроса перед передачей его backendService.

complex

Заголовки для добавления в ответ перед отправкой ответа клиенту.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым существующим значениям заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые ранее заданные значения для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из ответа перед отправкой его клиенту.

complex

Список HostRules для использования с URL.

string

Необязательное описание этого ресурса. Укажите это свойство при создании ресурса.

list / elements=string

Список шаблонов хостов для соответствия. Они должны быть допустимыми именами хостов, за исключением *, которое соответствует любой строке ([a-z0-9-.]*). В этом случае * должен быть первым символом и должен быть после него либо - или .

string

Имя PathMatcher для соответствия части пути URL, если hostRule соответствует части хоста URL.

integer

Уникальный идентификатор ресурса.

string

Имя ресурса. Предоставляется клиентом при создании ресурса. Имя должно иметь длину от 1 до 63 символов и соответствовать RFC1035. Конкретно, имя должно иметь длину от 1 до 63 символов и соответствовать регулярному выражению `[a-z]([-a-z0-9]*[a-z0-9])?`, что означает, что первый символ должен быть строчной буквой, а все последующие символы должны быть дефисом, строчной буквой или цифрой, за исключением последнего символа, который не может быть дефисом.

complex

Список именованных PathMatchers для использования с URL.

complex

defaultRouteAction срабатывает, когда ни один из pathRules или routeRules не соответствует. Балансировщик нагрузки выполняет расширенные действия по маршрутизации, такие как переписывание URL, преобразование заголовков и т. д., прежде чем передать запрос выбранному бэкенду. Если defaultRouteAction указывает любые weightedBackendServices, defaultService не должен быть установлен.

И наоборот, если defaultService установлен, defaultRouteAction не может содержать weightedBackendServices.

Только одно из defaultRouteAction или defaultUrlRedirect должно быть установлено.

complex

Спецификация для разрешения междоменных запросов со стороны клиента. См. [Рекомендацию W3C по междоменному обмену ресурсами](https://www.w3.org/TR/cors/).

boolean

В ответ на предварительный запрос, установка в true указывает, что фактический запрос может включать учетные данные пользователя.

Это преобразуется в заголовок Access-Control-Allow-Credentials.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Headers.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Methods.

list / elements=string

Указывает шаблоны регулярных выражений, соответствующие разрешенным источникам. Для грамматики регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Источник разрешен, если он соответствует элементу в allowOrigins или элементу в allowOriginRegexes.

list / elements=string

Указывает список источников, которым разрешено выполнять запросы CORS.

Источник разрешен, если он соответствует элементу в allowOrigins или элементу в allowOriginRegexes.

boolean

Если true, указывает, что политика CORS отключена. Значение по умолчанию — false, что означает, что политика CORS включена.

list / elements=string

Указывает содержимое заголовка Access-Control-Expose-Headers.

integer

Указывает, как долго результаты запроса предварительной проверки можно кэшировать в секундах.

Это соответствует заголовку Access-Control-Max-Age.

complex

Указывает параметры введения сбоев в трафик для проверки устойчивости клиентов к ошибкам службы бэкенда.

В рамках введения сбоев, когда клиенты отправляют запросы службе бэкенда, Loadbalancer может вводить задержки в процент запросов перед отправкой этих запросов службе бэкенда. Аналогично запросы от клиентов могут быть прерваны Loadbalancer для процента запросов.

timeout и retryPolicy будут проигнорированы клиентами, настроенными с faultInjectionPolicy.

complex

Указывает, как прерываются запросы клиентов в рамках введения сбоев.

integer

Код HTTP-статуса, используемый для прерывания запроса.

Значение должно быть в диапазоне от 200 до 599 включительно.

string

Процент трафика (соединений/операций/запросов), который будет прерван в рамках введения сбоев.

Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Указывает, как задерживаются запросы клиентов в рамках введения сбоев перед отправкой их службе бэкенда.

complex

Указывает значение интервала фиксированной задержки.

integer

Промежуток времени, являющийся дробью секунды с разрешением в наносекунды. Длительности меньше одной секунды представляются значением 0 секунд и положительным значением nanos. Должно быть в диапазоне от 0 до 999 999 999 включительно.

string

Промежуток времени с разрешением в секунду. Должно быть в диапазоне от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/час * 24 час/сутки * 365,25 дней/год * 10000 лет.

string

Процент трафика (соединений/операций/запросов), для которых будет введена задержка в рамках введения сбоев.

Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Указывает политику того, как запросы, предназначенные для бэкендов маршрута, дублируются в отдельной службе бэкенда-копии.

Loadbalancer не ожидает ответов от службы-копии. Перед отправкой трафика в службу-копию к заголовку host/authority добавляется суффикс -shadow.

dictionary

Полный или частичный URL ресурса BackendService, который будет дублироваться.

complex

Указывает политику повторных попыток, связанную с этим маршрутом.

integer

Указывает разрешенное количество повторных попыток. Это число должно быть > 0. Если не указано, по умолчанию равно 1.

complex

Указывает ненулевой таймаут на каждую попытку повторной отправки.

Если не указано, будет использоваться таймаут, установленный в HttpRouteAction. Если таймаут в HttpRouteAction не установлен, будет использоваться максимальный таймаут среди всех служб бэкенда, связанных с маршрутом.

integer

Промежуток времени, являющийся дробью секунды с разрешением в наносекунды. Длительности меньше одной секунды представляются значением 0 секунд и положительным значением nanos. Должно быть в диапазоне от 0 до 999 999 999 включительно.

string

Промежуток времени с разрешением в секунду. Должно быть в диапазоне от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/час * 24 час/сутки * 365,25 дней/год * 10000 лет.

list / elements=string

Указывает одно или несколько условий, когда применяется эта политика повторных попыток. Допустимые значения:

5xx: Loadbalancer попытается повторить попытку, если служба бэкенда ответит с кодом ответа 5xx, или если служба бэкенда вообще не ответит, например: разъединения, сбросы, таймауты чтения, ошибки подключения и отказ потоков.

gateway-error: Аналогично 5xx, но применяется только к кодам ответов 502, 503 или 504.

connect-failure: Loadbalancer повторит попытку при ошибках подключения к службам бэкенда, например, из-за таймаутов подключения.

retriable-4xx: Loadbalancer повторит попытку для исправленных кодов ответов 4xx.

В настоящее время единственная поддерживаемая ошибка для повторных попыток — 409.

refused-stream: Loadbalancer повторит попытку, если служба бэкенда сбросит поток с кодом ошибки REFUSED_STREAM.

Этот тип сброса указывает, что повторная попытка безопасна.

cancelled: Loadbalancer повторит попытку, если код состояния gRPC в заголовке ответа установлен на cancelled deadline-exceeded: Loadbalancer повторит попытку, если код состояния gRPC в заголовке ответа установлен на deadline-exceeded resource-exhausted: Loadbalancer повторит попытку, если код состояния gRPC в заголовке ответа установлен на resource-exhausted unavailable: Loadbalancer повторит попытку, если код состояния gRPC в заголовке ответа установлен на unavailable.

complex

Указывает таймаут для выбранного маршрута. Таймаут рассчитывается с момента полного обработки запроса (т.е. окончания потока) до момента полной обработки ответа. Таймаут включает все повторные попытки.

Если не указано, используется наибольший таймаут среди всех бэкенд-сервисов, связанных с маршрутом.

integer

Промежуток времени, являющийся дробной частью секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представляются значением 0 для секунд и положительным значением для наносекунд. Должно быть от 0 до 999 999 999 включительно.

string

Промежуток времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

Примечание: эти границы вычислены из: 60 сек/мин * 60 мин/ч * 24 ч/сут * 365,25 сут/год * 10000 лет .

complex

Спецификация для изменения URL запроса перед пересылкой запроса на соответствующий сервис.

string

Перед пересылкой запроса выбранному сервису заголовок хоста запроса заменяется содержимым hostRewrite.

Значение должно быть между 1 и 255 символами.

string

Перед пересылкой запроса на выбранный бэкенд-сервис соответствующая часть пути запроса заменяется на pathPrefixRewrite.

Значение должно быть между 1 и 1024 символами.

complex

Список весовых бэкенд-сервисов для отправки трафика при совпадении маршрута.

Веса определяют долю трафика, направляемого на соответствующий бэкенд-сервис.

Если весь трафик должен идти на один бэкенд-сервис, должен быть один weightedBackendService с весом, отличным от 0.

После определения backendService и перед пересылкой запроса на бэкенд-сервис применяются дополнительные действия маршрутизации, такие как перенаправление URL и преобразования заголовков, в зависимости от дополнительных настроек, указанных в HttpRouteAction.

dictionary

Полный или частичный URL ресурса BackendService по умолчанию. Перед пересылкой запроса на backendService балансировщик приложений применяет все соответствующие headerActions, указанные как часть этого backendServiceWeight.

complex

Указывает изменения в заголовках запроса и ответа, которые необходимо применить для выбранного backendService.

headerAction, указанный здесь, применяется до headerAction во включённых HttpRouteRule, PathMatcher и UrlMap.

complex

Заголовки, которые необходимо добавить к соответствующему запросу перед пересылкой запроса на backendService.

string

Имя заголовка для добавления.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к существующим значениям для заголовка.

Если true, headerValue устанавливается для заголовка, отбрасывая любые ранее установленные значения для этого заголовка.

list / elements=string

Список имён заголовков для удаления из запроса перед пересылкой запроса на backendService.

complex

Заголовки для добавления в ответ перед отправкой ответа клиенту.

string

Имя заголовка для добавления.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к существующим значениям для заголовка.

Если true, headerValue устанавливается для заголовка, отбрасывая любые ранее установленные значения для этого заголовка.

list / elements=string

Список имён заголовков для удаления из ответа перед отправкой ответа клиенту.

integer

Указывает долю трафика, отправляемого на backendService, вычисляется как weight / (сумма весов всех weightedBackendService в routeAction).

Выбор бэкенд-сервиса определяется только для нового трафика. После того, как запрос пользователя был направлен на backendService, последующие запросы будут отправляться на тот же backendService, как определено политикой аффинитирования сеанса BackendService.

Значение должно быть между 0 и 1000.

dictionary

Полный или частичный URL ресурса BackendService по умолчанию. Он будет использоваться, если ни одно из pathRules или routeRules, определённых этим PathMatcher, не совпадёт. Например, следующие являются допустимыми URL для ресурса BackendService: - https://www.googleapis.com/compute/v1/projects/project/global/backendServices/backendService - compute/v1/projects/project/global/backendServices/backendService - global/backendServices/backendService Если дополнительно указан defaultRouteAction, дополнительные действия маршрутизации, такие как перенаправление URL, применяются до отправки запроса на бэкенд. Однако, если указан defaultService, defaultRouteAction не может содержать weightedBackendServices. Напротив, если defaultRouteAction содержит weightedBackendServices, defaultService не должен быть указан.

Только один из defaultService, defaultUrlRedirect или defaultRouteAction.weightedBackendService должен быть задан. Для авторизации требуется один или несколько следующих разрешений Google IAM на указанный ресурс defaultService: - compute.backendBuckets.use - compute.backendServices.use .

complex

Когда ни один из указанных hostRules не совпадает, запрос перенаправляется на URL, указанный в defaultUrlRedirect. Если defaultUrlRedirect задан, defaultService или defaultRouteAction не должны быть заданы.

string

Хост, который будет использован в ответе перенаправления вместо хоста, предоставленного в запросе. Значение должно быть между 1 и 255 символами.

boolean

Если установлено в значение true, схема URL в запросе перенаправления устанавливается в https. Если установлено в значение false, схема URL перенаправляемого запроса остаётся такой же, как и в исходном запросе. Это свойство должно быть установлено только для UrlMaps, используемых в TargetHttpProxys. Установка его в значение true для TargetHttpsProxy запрещена. По умолчанию установлено в значение false.

string

Путь, который будет использован в ответе перенаправления вместо пути, предоставленного в запросе. pathRedirect не может быть указан вместе с prefixRedirect. Укажите только один или ни одного. Если ни один не указан, путь исходного запроса будет использован для перенаправления. Значение должно быть между 1 и 1024 символами.

string

Префикс, который заменяет префикс prefixMatch, указанный в HttpRouteRuleMatch, сохраняя оставшуюся часть URL перед перенаправлением запроса.

prefixRedirect не может быть указан вместе с pathRedirect. Укажите только один или ни одного. Если ни один не указан, путь исходного запроса будет использован для перенаправления. Значение должно быть между 1 и 1024 символами.

string

Код HTTP-статуса, который нужно использовать для этого RedirectAction. Доступные значения: * MOVED_PERMANENTLY_DEFAULT (по умолчанию), соответствует 301.

* FOUND, соответствует 302.

* SEE_OTHER, соответствует 303.

* TEMPORARY_REDIRECT, соответствует 307. В этом случае метод запроса сохраняется.

* PERMANENT_REDIRECT, соответствует 308. В этом случае метод запроса сохраняется.

boolean

Если установлено в значение true, любая часть запроса в исходном URL удаляется перед перенаправлением запроса. Если установлено в значение false, часть запроса исходного URL сохраняется.

string

Необязательное описание данного ресурса. Укажите это свойство при создании ресурса.

complex

Указывает изменения в заголовках запроса и ответа, которые должны быть применены для выбранной службы backendService. Заголовки HeaderAction, указанные здесь, применяются после HeaderAction, соответствующего HttpRouteRule, и до HeaderAction в UrlMap.

complex

Заголовки, которые нужно добавить к сопоставленному запросу перед пересылкой запроса backendService.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым существующим значениям заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые предыдущие значения этого заголовка.

list / elements=string

Список имён заголовков, которые нужно удалить из запроса перед пересылкой его backendService.

complex

Заголовки, которые нужно добавить в ответ перед отправкой ответа клиенту.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым существующим значениям заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые предыдущие значения этого заголовка.

list / elements=string

Список имён заголовков, которые нужно удалить из ответа перед отправкой его клиенту.

string

Имя, по которому эта PathMatcher ссылается на HostRule.

complex

Список правил путей. Используйте этот список вместо routeRules, когда требуется маршрутизация на основе простого сопоставления путей. Порядок, в котором указаны правила путей, не имеет значения. Сопоставление всегда выполняется по принципу "самый длинный путь". Например: pathRule с путём /a/b/c/* будет совпадать раньше /a/b/* независимо от порядка, в котором эти пути появляются в списке. В рамках данной pathMatcher должен быть установлен только один из pathRules или routeRules.

list / elements=string

Список шаблонов путей для сопоставления. Каждый должен начинаться с /, и символ * допускается только в конце после /. Строка, переданная в path matcher, не включает текст после первого ? или #, и эти символы запрещены здесь.

complex

В ответ на совпадающий путь балансировщик нагрузки выполняет расширенные действия маршрутизации, такие как изменение URL, преобразование заголовков и т. д., перед пересылкой запроса выбранному бэкенду. Если routeAction указывает какие-либо weightedBackendServices, служба не должна быть установлена. И наоборот, если service установлена, routeAction не может содержать weightedBackendServices. Должен быть установлен только один из routeAction или urlRedirect.

complex

Спецификация для разрешения кросс-доменных запросов со стороны клиента. См. рекомендацию W3C по кросс-доменному обмену ресурсами.

boolean

В ответ на предварительный запрос, установка в значение true указывает, что фактический запрос может включать учетные данные пользователя. Это переводится в заголовок Access-Control-Allow-Credentials. По умолчанию false.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Headers.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Methods.

list / elements=string

Указывает шаблоны регулярных выражений, которые соответствуют разрешенным источникам. Для грамматики регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Источник разрешен, если он соответствует либо allow_origins, либо allow_origin_regex.

list / elements=string

Указывает список источников, которым разрешено выполнять запросы CORS. Источник разрешен, если он соответствует либо allow_origins, либо allow_origin_regex.

boolean

Если true, указывает, что политика CORS отключена.

list / elements=string

Указывает содержимое заголовка Access-Control-Expose-Headers.

integer

Указывает, как долго результаты запроса префлайта могут храниться в кэше. Это соответствует содержимому заголовка Access-Control-Max-Age.

complex

Спецификация для внедрения сбоев в трафик для проверки устойчивости клиентов к отказам сервера back-end. В рамках внедрения сбоев, когда клиенты отправляют запросы на бэкенд-сервис, задержки могут быть добавлены балансировщиком нагрузки для определенного процента запросов до отправки этих запросов на бэкенд-сервис. Аналогичным образом, запросы от клиентов могут быть прерваны балансировщиком нагрузки для определенного процента запросов. Параметры timeout и retry_policy будут проигнорированы клиентами, настроенными с fault_injection_policy.

complex

Спецификация для прерывания клиентских запросов в рамках внедрения сбоев.

integer

Код HTTP-статуса, используемый для прерывания запроса. Значение должно быть в диапазоне от 200 до 599 включительно.

string

Процент трафика (соединений/операций/запросов), который будет прерван в рамках внедрения сбоев. Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Спецификация для задержки клиентских запросов в рамках внедрения сбоев перед отправкой на бэкенд-сервис.

complex

Указывает значение интервала фиксированной задержки.

integer

Продолжительность времени, которая является дробью секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены с полем `seconds`, равным 0, и положительным полем `nanos`. Должно быть от 0 до 999 999 999 включительно.

string

Продолжительность времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

string

Процент трафика (соединений/операций/запросов), для которого будет введена задержка в рамках внедрения сбоев. Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Указывает политику, определяющую, как запросы, предназначенные для бэкендов маршрута, дублируются на отдельный сервисный бэкенд с отражением. Балансировщик нагрузки не ждет ответов от сервиса отражения. Перед отправкой трафика сервису отражения в заголовок хоста / authority добавляется приставка -shadow.

dictionary

Ресурс BackendService, который отражается.

complex

Указывает политику повторных попыток, связанную с этим маршрутом.

integer

Указывает разрешенное количество повторных попыток. Это число должно быть > 0.

complex

Указывает ненулевой таймаут за попытку повтора.

integer

Продолжительность времени, которая является дробью секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены с полем `seconds`, равным 0, и положительным полем `nanos`. Должно быть от 0 до 999 999 999 включительно.

string

Продолжительность времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

list / elements=string

Указывает одно или несколько условий, когда применяется правило повторной попытки. Допустимые значения: - 5xx: балансировщик нагрузки предпримет повторную попытку, если бэкенд-сервис ответит любым кодом 5xx, или если бэкенд-сервис вообще не ответит, например, разъединения, сбросы, таймауты чтения, сбои соединения и отказ потоков.

- gateway-error: аналогично 5xx, но применяется только к кодам ответов 502, 503 или 504.

- connect-failure: балансировщик нагрузки будет повторять попытки при проблемах соединения с бэкенд-сервисами, например, из-за таймаутов подключения.

- retriable-4xx: балансировщик нагрузки будет повторять попытки для обрабатываемых кодов 4xx.

В настоящее время единственной поддерживаемой ошибкой повторной обработки является 409.

- refused-stream: балансировщик нагрузки будет повторять попытки, если бэкенд-сервис сбрасывает поток с ошибкой REFUSED_STREAM. Этот тип сброса указывает, что повторная попытка безопасна.

- cancelled: балансировщик нагрузки будет повторять попытки, если код состояния gRPC в заголовке ответа установлен в cancelled - deadline-exceeded: балансировщик нагрузки будет повторять попытки, если код состояния gRPC в заголовке ответа установлен в deadline-exceeded - resource-exhausted: балансировщик нагрузки будет повторять попытки, если код состояния gRPC в заголовке ответа установлен в resource-exhausted - unavailable: балансировщик нагрузки будет повторять попытки, если код состояния gRPC в заголовке ответа установлен в unavailable.

complex

Указывает таймаут для выбранного маршрута. Таймаут вычисляется от момента полного обработки запроса (т.е. окончания потока) до момента полной обработки ответа. Таймаут включает все повторные попытки. Если не указано, значение по умолчанию составляет 15 секунд.

integer

Промежуток времени, являющийся дробной частью секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены полем `seconds` со значением 0 и положительным полем `nanos`. Должно быть от 0 до 999 999 999 включительно.

string

Промежуток времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

complex

Спецификация для изменения URL запроса перед переадресацией запроса в соответствующую службу.

string

Перед переадресацией запроса к выбранной службе заголовок хоста запроса заменяется содержимым hostRewrite. Значение должно быть от 1 до 255 символов.

string

Перед переадресацией запроса к выбранной службе целевого узла соответствующая часть пути запроса заменяется на pathPrefixRewrite. Значение должно быть от 1 до 1024 символов.

complex

Список весовых служб целевого узла для отправки трафика при совпадении с маршрутом. Веса определяют долю трафика, которая перенаправляется на соответствующую службу целевого узла. Если весь трафик должен направляться на одну службу целевого узла, должна быть одна weightedBackendService с весом, отличным от 0. После определения службы целевого узла и перед переадресацией запроса на службу целевого узла применяются расширенные действия маршрутизации, такие как перенаправление URL и преобразование заголовков, в зависимости от дополнительных настроек, указанных в этом действии HttpRouteAction.

dictionary

Ресурс службы целевого узла по умолчанию. Перед переадресацией запроса к backendService балансировщик приложений применяет все соответствующие действия с заголовками, указанные в рамках этого backendServiceWeight.

complex

Указывает изменения в заголовках запроса и ответа, которые должны быть выполнены для выбранной службы целевого узла. Действия с заголовками, указанные здесь, применяются до действий с заголовками в содержащем HttpRouteRule, PathMatcher и UrlMap.

complex

Заголовки для добавления в соответствующий запрос перед переадресацией запроса к backendService.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым значениям, которые уже существуют для заголовка. Если true, headerValue устанавливается для заголовка, удаляя любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из запроса перед переадресацией запроса к backendService.

complex

Заголовки для добавления в ответ перед отправкой ответа клиенту.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым значениям, которые уже существуют для заголовка. Если true, headerValue устанавливается для заголовка, удаляя любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из ответа перед отправкой ответа клиенту.

integer

Указывает долю трафика, направляемого на backendService, вычисляемую как weight / (сумма весов всех weightedBackendService в routeAction). Выбор службы целевого узла определяется только для нового трафика. После того, как запрос пользователя был перенаправлен на backendService, последующие запросы будут отправляться на ту же backendService, что определяется политикой сродства сеанса backendService.

Значение должно быть от 0 до 1000.

dictionary

Ресурс службы целевого узла, на который перенаправляется трафик, если это правило совпадает. Если дополнительно указано routeAction, применяются расширенные действия маршрутизации, такие как перенаправление URL и т. д., прежде чем отправлять запрос на целевой узел. Однако, если указан service, routeAction не может содержать weightedBackendService. И наоборот, если routeAction указывает weightedBackendServices, service не должен быть указан. Только одно из urlRedirect, service или routeAction.weightedBackendService должно быть установлено.

complex

При совпадении с шаблоном пути запрос перенаправляется на URL, указанный в urlRedirect. Если urlRedirect указан, service или routeAction не должны быть установлены.

string

Хост, который будет использоваться в ответе о перенаправлении вместо хоста, указанного в запросе. Значение должно быть от 1 до 255 символов.

boolean

Если установлено в значение true, схема URL в перенаправленном запросе устанавливается в https.

Если установлено в значение false, схема URL перенаправленного запроса останется такой же, как у исходного запроса. Это свойство должно быть установлено только для UrlMaps, используемых в TargetHttpProxys. Установка его в true для TargetHttpsProxy запрещена. По умолчанию установлено в значение false.

string

Путь, который будет использован в ответе перенаправления вместо пути, предоставленного в запросе. pathRedirect не может быть предоставлен вместе с prefixRedirect. Предоставьте одно или ни одного. Если ни одно не предоставлено, путь исходного запроса будет использован для перенаправления.

Значение должно быть между 1 и 1024 символами.

string

Префикс, который заменяет префикс prefixMatch, указанный в HttpRouteRuleMatch, сохраняя оставшуюся часть URL-адреса перед перенаправлением запроса. prefixRedirect не может быть предоставлен вместе с pathRedirect. Предоставьте одно или ни одного. Если ни одно не предоставлено, путь исходного запроса будет использован для перенаправления. Значение должно быть между 1 и 1024 символами.

string

Код HTTP-статуса для этого действия перенаправления. Поддерживаемые значения: * MOVED_PERMANENTLY_DEFAULT, значение по умолчанию, соответствующее 301.

* FOUND, соответствующее 302.

* SEE_OTHER, соответствующее 303.

* TEMPORARY_REDIRECT, соответствующее 307. В этом случае метод запроса сохранится.

* PERMANENT_REDIRECT, соответствующее 308. В этом случае метод запроса сохранится.

boolean

Если установлено в true, любая часть запроса исходного URL удаляется перед перенаправлением запроса. Если установлено в false, часть запроса исходного URL сохраняется.

complex

Список упорядоченных правил маршрутизации HTTP. Используйте этот список вместо pathRules, когда требуются расширенное сопоставление маршрутов и действия маршрутизации. Порядок указания routeRules важен: первое совпавшее правило вызовет указанное действие маршрутизации. В данном pathMatcher должен быть установлен только один из pathRules или routeRules. routeRules не поддерживаются в UrlMaps, предназначенных для внешних балансировщиков нагрузки.

complex

Указывает изменения в заголовках запроса и ответа, которые должны быть применены для выбранного backendService. Действия headerAction, указанные здесь, применяются до сопоставления pathMatchers[].headerAction и после pathMatchers[].routeRules[].routeAction.weightedBackendService.backendServiceWeightAction[].headerAction.

complex

Заголовки, которые необходимо добавить к соответствующему запросу перед пересылкой запроса в backendService.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым уже существующим значениям для заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из запроса перед пересылкой в backendService.

complex

Заголовки, которые необходимо добавить в ответ перед отправкой клиенту.

string

Имя заголовка.

string

Значение заголовка для добавления.

boolean

Если false, headerValue добавляется к любым уже существующим значениям для заголовка. Если true, headerValue устанавливается для заголовка, отбрасывая любые значения, которые были установлены для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из ответа перед отправкой клиенту.

complex

Правила для определения соответствия.

string

Для удовлетворения условия matchRule путь запроса должен точно совпадать со значением, указанным в fullPathMatch, после удаления любых параметров запроса и якорей, которые могут быть частью исходного URL. FullPathMatch должен быть между 1 и 1024 символами. Только одно из prefixMatch, fullPathMatch или regexMatch должно быть указано.

complex

Указывает список критериев соответствия заголовков, все из которых должны совпадать с соответствующими заголовками в запросе.

string

Значение должно точно совпадать с содержимым exactMatch. Только одно из exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

string

Имя HTTP-заголовка для соответствия. Для соответствия авторитету HTTP-запроса используйте headerMatch с именем заголовка ":authority". Для соответствия методу запроса используйте headerName ":method".

boolean

Если установлено в значение false, headerMatch считается совпадением, если выполнены вышеуказанные критерии соответствия. Если установлено в значение true, headerMatch считается совпадением, если вышеуказанные критерии соответствия НЕ выполнены. По умолчанию false.

string

Значение заголовка должно начинаться с содержимого prefixMatch. Только одно из exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

boolean

Заголовок с содержимым headerName должен существовать. Сопоставление происходит независимо от наличия значения у заголовка запроса. Только одно из значений exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

complex

Значение заголовка должно быть целым числом и находиться в указанном диапазоне rangeMatch. Если заголовок не содержит целого числа, числа или пуст, сопоставление не выполняется. Например, для диапазона [-5, 0] - -3 будет соответствовать. - 0 не будет соответствовать. - 0.25 не будет соответствовать. - -3someString не будет соответствовать. Только одно из значений exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

integer

Конец диапазона (исключительно).

integer

Начало диапазона (включительно).

string

Значение заголовка должно соответствовать заданному в regexMatch регулярному выражению. Для грамматики регулярных выражений см.: en.cppreference.com/w/cpp/regex/ecmascript Для сопоставления с портом, указанным в HTTP-запросе, используйте headerMatch с headerName, установленным на PORT, и регулярное выражение, соответствующее спецификатору порта заголовка Host RFC2616.

Только одно из значений exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

string

Значение заголовка должно оканчиваться на содержимое suffixMatch. Только одно из значений exactMatch, prefixMatch, suffixMatch, regexMatch, presentMatch или rangeMatch должно быть установлено.

boolean

Указывает, что сопоставления prefixMatch и fullPathMatch чувствительны к регистру.

По умолчанию false.

complex

Непрозрачные критерии фильтрации, используемые Loadbalancer для ограничения конфигурации маршрутизации на ограниченный набор клиентов, совместимых с xDS. В своих запросах xDS к Loadbalancer клиенты xDS представляют метаданные узла. Если происходит сопоставление, соответствующая конфигурация маршрутизации становится доступной для этих прокси. Для каждого metadataFilter в этом списке, если его filterMatchCriteria установлено в MATCH_ANY, по крайней мере, одна из filterLabels должна соответствовать соответствующей метке, предоставленной в метаданных. Если его filterMatchCriteria установлено в MATCH_ALL, то все его filterLabels должны соответствовать соответствующим меткам в предоставленных метаданных. metadataFilters, указанные здесь, могут переопределять те, которые указаны в ForwardingRule, которые ссылаются на эту UrlMap. metadataFilters применяются только к Loadbalancer, у которых loadBalancingScheme установлено в INTERNAL_SELF_MANAGED.

complex

Список пар имя-значение меток, которые должны соответствовать меткам в предоставленных метаданных на основе filterMatchCriteria. Этот список не должен быть пустым и может содержать не более 64 записей.

string

Имя метки метаданных. Длина имени может составлять максимум 1024 символа и должна быть не менее 1 символа.

string

Значение метки должно соответствовать указанному значению. Длина value может составлять максимум 1024 символа.

string

Указывает, как отдельные сопоставления filterLabel в списке filterLabels вносят вклад в общее соответствие metadataFilter. Доступные значения: - MATCH_ANY: По крайней мере, одна из filterLabels должна иметь соответствующую метку в предоставленных метаданных.

- MATCH_ALL: Все filterLabels должны иметь соответствующие метки в предоставленных метаданных.

string

Для удовлетворения условия matchRule путь запроса должен начинаться с указанного prefixMatch. prefixMatch должен начинаться с /. Значение должно быть между 1 и 1024 символами. Только одно из prefixMatch, fullPathMatch или regexMatch должно быть указано.

complex

Указывает список критериев сопоставления параметров запроса, все из которых должны соответствовать соответствующим параметрам запроса.

string

queryParameterMatch совпадает, если значение параметра точно соответствует содержимому exactMatch. Только одно из presentMatch, exactMatch и regexMatch должно быть установлено.

string

Имя параметра запроса для сопоставления. Параметр запроса должен существовать в запросе, в противном случае сопоставление запроса не выполняется.

boolean

Указывает, что queryParameterMatch совпадает, если запрос содержит параметр запроса, независимо от того, имеет ли параметр значение или нет. Только одно из presentMatch, exactMatch и regexMatch должно быть установлено.

string

queryParameterMatch совпадает, если значение параметра соответствует регулярному выражению, заданному regexMatch. Для грамматики регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Только одно из presentMatch, exactMatch и regexMatch должно быть установлено.

string

Для удовлетворения условия matchRule, путь запроса должен удовлетворять регулярному выражению, указанному в regexMatch, после удаления параметров запроса и якоря, предоставленного в исходном URL-адресе. Для грамматики регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Только одно из prefixMatch, fullPathMatch или regexMatch должно быть указано.

integer

Для routeRules в данном pathMatcher приоритет определяет порядок, в котором Load balancer будет интерпретировать routeRules. RouteRules оцениваются в порядке приоритета, от наименьшего к наибольшему числу. Приоритет правила уменьшается по мере увеличения его номера (1, 2, 3, N+1). Первое правило, соответствующее запросу, применяется.

Нельзя настроить два или более routeRules с одинаковым приоритетом.

Приоритет каждого правила должен быть установлен на число от 0 до 2147483647 включительно.

Номера приоритета могут иметь пробелы, что позволяет добавлять или удалять правила в будущем, не влияя на остальные правила. Например, 1, 2, 3, 4, 5, 9, 12, 16 — это допустимая последовательность номеров приоритета, в которую вы можете добавить правила с номерами от 6 до 8, от 10 до 11 и от 13 до 15 в будущем без каких-либо последствий для существующих правил.

complex

В ответ на соответствующее matchRule, балансировщик нагрузки выполняет расширенные действия маршрутизации, такие как переписывание URL, преобразование заголовков и т.д., прежде чем передать запрос выбранному бэкенду. Если routeAction указывает какие-либо weightedBackendServices, служба не должна быть установлена. И наоборот, если service установлена, routeAction не может содержать какие-либо weightedBackendServices. Должен быть установлен только один из routeAction или urlRedirect.

complex

Спецификация для разрешения запросов с разных доменов со стороны клиента. Пожалуйста, обратитесь к рекомендации W3C по Cross Origin Resource Sharing.

boolean

В ответ на запрос предварительного просмотра, установка этого значения в true указывает, что фактический запрос может включать учетные данные пользователя. Это переводится в заголовок Access-Control-Allow-Credentials. По умолчанию значение false.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Headers.

list / elements=string

Указывает содержимое заголовка Access-Control-Allow-Methods.

list / elements=string

Указывает шаблоны регулярных выражений, которые соответствуют разрешенным источникам. Для грамматики регулярных выражений см. en.cppreference.com/w/cpp/regex/ecmascript. Источник разрешен, если он соответствует либо allow_origins, либо allow_origin_regex.

list / elements=string

Указывает список источников, которым будет разрешено выполнять запросы CORS. Источник разрешен, если он соответствует либо allow_origins, либо allow_origin_regex.

boolean

Если true, указывает, что политика CORS отключена.

что указывает на то, что политика CORS активна. По умолчанию значение false.

list / elements=string

Указывает содержимое заголовка Access-Control-Expose-Headers.

integer

Указывает, как долго результаты запроса предварительного просмотра могут быть кэшированы. Это соответствует содержимому заголовка Access-Control-Max-Age.

complex

Спецификация для введения сбоя в трафик для проверки устойчивости клиентов к сбоям бэкенд-службы. В рамках введения сбоя, когда клиенты отправляют запросы на бэкенд-службу, балансировщик нагрузки может вводить задержки для определенного процента запросов, прежде чем отправлять эти запросы на бэкенд-службу. Аналогично, балансировщик нагрузки может прерывать запросы от клиентов для определенного процента запросов. Параметры timeout и retry_policy будут игнорироваться клиентами, настроенными с policy fault_injection_policy.

complex

Спецификация того, как прерываются запросы клиентов в рамках введения сбоя.

integer

Код HTTP-статуса, используемый для прерывания запроса. Значение должно быть в диапазоне от 200 до 599 включительно.

string

Процент трафика (соединений/операций/запросов), который будет прерван в рамках введения сбоя. Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Спецификация того, как задерживаются запросы клиентов в рамках введения сбоя, прежде чем они отправляются на бэкенд-службу.

complex

Указывает значение интервала фиксированной задержки.

integer

Промежуток времени, который представляет собой дробную часть секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены полем `seconds` равным 0 и положительным полем `nanos`. Должно быть от 0 до 999 999 999 включительно.

string

Промежуток времени с разрешением в секунду. Должно быть от 0 до 315 576 000 000 включительно.

string

Процент трафика (соединений/операций/запросов), для которого будет введена задержка в рамках введения сбоя. Значение должно быть в диапазоне от 0,0 до 100,0 включительно.

complex

Указывает политику того, как запросы, предназначенные для бэкендов маршрута, дублируются в отдельной зеркальной бэкенд-службе. Балансировщик нагрузки не ждет ответов от зеркальной службы. Перед отправкой трафика в зеркальную службу в заголовок host/authority добавляется суффикс -shadow.

dictionary

Ресурс BackendService, который будет дублироваться.

complex

Указывает политику повторных попыток, связанную с этим маршрутом.

integer

Указывает разрешенное количество повторных попыток. Это число должно быть > 0.

complex

Указывает ненулевой таймаут для каждой повторной попытки.

Если не указано, используется таймаут, заданный в HttpRouteAction. Если таймаут в HttpRouteAction не задан, используется наибольший таймаут среди всех бэкенд-служб, связанных с маршрутом.

целое число

Промежуток времени, составляющий дробную часть секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены значением 0 в поле `seconds` и положительным значением в поле `nanos`. Должно быть от 0 до 999 999 999 включительно.

строка

Промежуток времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

список / элементы=строка

Указывает одно или несколько условий, при которых применяется данное правило повторной попытки. Допустимые значения:

- 5xx: балансировщик нагрузки попытается повторить попытку, если служба обратной связи ответит любым кодом состояния 5xx, или если служба обратной связи не ответит вообще (например, отключения, сброс, таймаут чтения, ошибка подключения и отказ потоков).

- gateway-error: аналогично 5xx, но применяется только к кодам состояния 502, 503 или 504.

- connect-failure: балансировщик нагрузки повторит попытку при ошибках подключения к службам обратной связи, например, из-за таймаутов подключения.

- retriable-4xx: балансировщик нагрузки повторит попытку для повторно-возможности кодов состояния 4xx.

В настоящее время единственная поддерживаемая ошибка - 409.

- refused-stream: балансировщик нагрузки повторит попытку, если служба обратной связи сбросит поток с кодом ошибки REFUSED_STREAM. Этот тип сброса указывает, что можно безопасно повторить попытку.

- cancelled: балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен на отменённый - deadline-exceeded: балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен на превышение срока действия - resource-exhausted: балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен на исчерпание ресурсов - unavailable: балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен на недоступность .

сложное

Устанавливает таймаут для выбранного маршрута. Таймаут вычисляется с момента полного обработки запроса (т.е. завершения потока) до полного завершения обработки ответа. Таймаут включает все повторные попытки. Если не указано, значение по умолчанию составляет 15 секунд.

целое число

Промежуток времени, составляющий дробную часть секунды с разрешением в наносекунды. Продолжительности меньше одной секунды представлены значением 0 в поле `seconds` и положительным значением в поле `nanos`. Должно быть от 0 до 999 999 999 включительно.

строка

Промежуток времени с разрешением в секунды. Должно быть от 0 до 315 576 000 000 включительно.

сложное

Спецификация для изменения URL запроса перед пересылкой запроса к сопоставленной службе.

строка

Перед пересылкой запроса к выбранной службе заголовок хоста запроса заменяется содержимым hostRewrite. Значение должно быть от 1 до 255 символов.

строка

Перед пересылкой запроса к выбранной службе обратной связи соответствующая часть пути запроса заменяется на pathPrefixRewrite. Значение должно быть от 1 до 1024 символов.

сложное

Список взвешенных служб обратной связи для отправки трафика при совпадении маршрута. Веса определяют долю трафика, направляемого в соответствующую службу обратной связи. Если весь трафик должен направляться в одну службу обратной связи, должен быть один weightedBackendService с весом, отличным от 0. После определения службы обратной связи и перед пересылкой запроса в службу обратной связи применяются дополнительные действия маршрутизации, такие как перенаправление URL и преобразования заголовков, в зависимости от дополнительных настроек, указанных в HttpRouteAction.

словарь

Ресурс службы обратной связи по умолчанию. Перед пересылкой запроса в backendService балансировщик нагрузки применяет все соответствующие действия с заголовками, указанные как часть backendServiceWeight.

сложное

Указывает изменения в заголовках запроса и ответа, которые должны вступить в силу для выбранной службы обратной связи. Действия с заголовками, указанные здесь, вступают в силу до действий с заголовками во вложенном HttpRouteRule, PathMatcher и UrlMap.

сложное

Заголовки, которые необходимо добавить к соответствующему запросу перед пересылкой запроса в backendService.

строка

Имя заголовка.

строка

Значение добавляемого заголовка.

булево

Если значение ложь, значение заголовка добавляется к любым существующим значениям заголовка. Если значение истина, значение заголовка устанавливается для заголовка, отбрасывая любые ранее установленные значения для этого заголовка.

список / элементы=строка

Список имён заголовков, которые необходимо удалить из запроса перед пересылкой запроса в backendService.

сложное

Заголовки, которые необходимо добавить к ответу перед отправкой ответа клиенту.

строка

Имя заголовка.

строка

Значение добавляемого заголовка.

булево

Если значение ложь, значение заголовка добавляется к любым существующим значениям заголовка. Если значение истина, значение заголовка устанавливается для заголовка, отбрасывая любые ранее установленные значения для этого заголовка.

list / elements=string

Список имён заголовков, которые необходимо удалить из ответа перед отправкой клиенту.

integer

Определяет долю трафика, отправляемого в backendService, вычисляемую как weight / (сумма всех весов weightedBackendService в routeAction). Выбор бэкенд-сервиса определяется только для нового трафика. После того, как запрос пользователя был направлен на backendService, последующие запросы будут отправлены тому же backendService, как определено политикой Affinity сессии BackendService.

Значение должно быть от 0 до 1000.

dictionary

Ресурс бэкенд-сервиса, на который направляется трафик, если совпадает это правило. Если дополнительно указан routeAction, сложные действия маршрутизации, такие как перенаправление URL и т. д., выполняются перед отправкой запроса на бэкенд. Однако, если указан service, routeAction не может содержать weightedBackendService. И наоборот, если routeAction содержит weightedBackendServices, service не должен быть указан. Только одно из значений urlRedirect, service или routeAction.weightedBackendService должно быть задано.

complex

При совпадении этого правила запрос перенаправляется на URL, указанный в urlRedirect. Если указан urlRedirect, service или routeAction не должны быть заданы.

string

Хост, который будет использоваться в ответе о перенаправлении вместо того, который был передан в запросе. Значение должно быть от 1 до 255 символов.

boolean

Если установлено в true, схема URL в перенаправленном запросе устанавливается в https. Если установлено в false, схема URL перенаправленного запроса останется такой же, как у запроса. Это должно быть установлено только для UrlMaps, используемых в TargetHttpProxys.

Установка в true для TargetHttpsProxy запрещена. По умолчанию false.

string

Путь, который будет использоваться в ответе о перенаправлении вместо пути, переданного в запросе. Только одно из pathRedirect или prefixRedirect должно быть указано. Значение должно быть от 1 до 1024 символов.

string

Префикс, который заменяет префиксMatch, указанный в HttpRouteRuleMatch, сохраняя оставшуюся часть URL перед перенаправлением запроса.

string

Код HTTP-статуса, который следует использовать для этого RedirectAction. Поддерживаемые значения: * MOVED_PERMANENTLY_DEFAULT, которое является значением по умолчанию и соответствует 301.

* FOUND, что соответствует 302.

* SEE_OTHER, что соответствует 303.

* TEMPORARY_REDIRECT, что соответствует 307. В этом случае метод запроса сохранится.

* PERMANENT_REDIRECT, что соответствует 308. В этом случае метод запроса сохранится.

boolean

Если установлено в true, любая сопутствующая часть запроса исходного URL удаляется перед перенаправлением запроса. Если установлено в false, часть запроса исходного URL сохраняется. По умолчанию false.

complex

Список ожидаемых тестов сопоставления URL. Запрос на обновление этого UrlMap будет успешным только в том случае, если пройдут все тестовые случаи. Вы можете указать максимум 100 тестов на UrlMap.

string

Описание этого тестового случая.

string

Часть хоста URL.

string

Часть пути URL.

dictionary

Ожидаемый ресурс BackendService, к которому должен быть сопоставлен данный URL.