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

complex

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

string

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

complex

defaultRouteAction срабатывает, когда ни одна из правил hostRules не совпадает. Балансировщик нагрузки выполняет сложные действия маршрутизации, такие как переписывание 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

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

В рамках внедрения ошибок, при отправке клиентами запросов к бэкенд-службе, балансировщик нагрузки может вводить задержки для определенного процента запросов до отправки этих запросов бэкенд-службе. Также запросы от клиентов могут быть прерваны балансировщиком нагрузки для определенного процента запросов.

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

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

Балансировщик нагрузки не ожидает ответов от зеркальной службы. Перед отправкой трафика в зеркальную службу к заголовку 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 секунд и положительным полем nanos. Должно быть от 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 Session бэкенд-сервиса.

Значение должно быть от 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

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

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

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

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

Балансировщик нагрузки не ожидает ответов от зеркальной службы. Перед отправкой трафика в зеркальную службу префикс 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.

После определения 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. В рамках введения ошибок, при отправке клиентами запросов на back-end-сервис, Loadbalancer может ввести задержки для определенного процента запросов, прежде чем отправить их на сервер back-end. Аналогично, Loadbalancer может прервать запросы от клиентов для определенного процента запросов. параметры timeout и retry_policy будут игнорироваться клиентами, у которых настроена fault_injection_policy.

complex

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

integer

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

string

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

complex

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

complex

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

integer

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

string

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

string

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

complex

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

dictionary

Ресурс BackendService, которому зеркально отображается трафик.

complex

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

integer

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

complex

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

integer

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

string

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

list / elements=string

Указывает один или несколько условий, когда применяется это правило повторной попытки. Допустимые значения: * 5xx: Loadbalancer попытается повторить попытку, если back-end-сервис ответит любым кодом ответа 5xx или вообще не ответит, например: разъединения, сбросы, таймауты чтения, сбои соединения и отклоненные потоки. * gateway-error: Аналогично 5xx, но применяется только к кодам ответа 502, 503 или 504. * connect-failure: Loadbalancer будет повторять попытку при ошибках подключения к back-end-сервисам, например, из-за таймаутов подключения. * retriable-4xx: Loadbalancer будет повторять попытку для пересчитываемых кодов ответа 4xx. В настоящее время единственная поддерживаемая ошибка - 409. * refused-stream: Loadbalancer повторит попытку, если back-end-сервис сбросит поток с кодом ошибки REFUSED_STREAM. Этот тип сброса указывает, что повторение попытки безопасно. * cancelled: Loadbalancer повторит попытку, если код статуса gRPC в заголовке ответа установлен в cancelled * deadline-exceeded: Loadbalancer повторит попытку, если код статуса gRPC в заголовке ответа установлен в deadline-exceeded * resource-exhausted: Loadbalancer повторит попытку, если код статуса gRPC в заголовке ответа установлен в resource-exhausted * unavailable: Loadbalancer повторит попытку, если код статуса 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-статуса, который следует использовать для этого RedirectAction. Допустимые значения: * 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[].r outeAction.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 приоритет определяет порядок, в котором балансировщик нагрузки будет интерпретировать 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 не должен быть установлен. И наоборот, если 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 отключена.

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

list / elements=string

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

integer

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

complex

Спецификация для введения ошибок в трафик для проверки устойчивости клиентов к отказу бэкенд-службы. В рамках введения ошибок, когда клиенты отправляют запросы бэкенд-службе, балансировщик нагрузки может вводить задержки для определенного процента запросов перед отправкой этих запросов бэкенд-службе. Аналогично, запросы от клиентов могут прерываться балансировщиком нагрузки для определенного процента запросов. 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

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

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

целое число

Промежуток времени, являющийся долей секунды с разрешением в наносекунды. Продолжительности менее одной секунды представлены с полем `seconds` равным 0 и положительным полем `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 в заголовке ответа установлен в cancelled * deadline-exceeded: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в deadline-exceeded * resource-exhausted: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в resource-exhausted * unavailable: Балансировщик нагрузки повторит попытку, если код состояния gRPC в заголовке ответа установлен в unavailable.

сложный тип

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

целое число

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

строка

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

сложный тип

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

строка

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

строка

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

сложный тип

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

словарь

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

сложный тип

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

сложный тип

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

строка

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

строка

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

логическое значение

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

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

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

сложный тип

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

строка

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

строка

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

логическое значение

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

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.