google.cloud.gcp_compute_region_url_map_info – Сбор информации о GCP RegionUrlMap

complex

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

string

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

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-код состояния, который будет использоваться для этого действия перенаправления. Поддерживаемые значения: * MOVED_PERMANENTLY_DEFAULT — значение по умолчанию, соответствует 301.

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

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

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

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

boolean

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

string

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

string

Отпечаток этого ресурса. Это поле используется во время обновлений ресурса.

complex

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

string

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

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.

dictionary

Ссылка на ресурс RegionBackendService. Будет использоваться, если ни одно из pathRules, определённых этим PathMatcher, не соответствует пути части URL.

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-код состояния, который будет использоваться для этого действия перенаправления. Поддерживаемые значения: * MOVED_PERMANENTLY_DEFAULT — значение по умолчанию, соответствует 301.

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

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

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

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

boolean

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

string

Необязательное описание этого ресурса.

строка

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

сложное

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

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

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

сложное

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

сложное

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

булево

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

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

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

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

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

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

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

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

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

булево

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

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

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

целое число

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

сложное

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

сложное

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

целое число

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

строка

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

сложное

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

сложное

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

целое число

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

строка

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

строка

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

сложное

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

словарь

Ресурс RegionBackendService, который будет зеркально отображен.

complex

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

integer

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

complex

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

integer

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

string

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

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

Указывает тайм-аут для выбранного маршрута. Тайм-аут вычисляется с момента полного обработки запроса (т. е. конца потока) до момента полной обработки ответа. Тайм-аут включает все повторные попытки. Если не указано, значение по умолчанию составляет 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

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

complex

Указывает изменения в заголовках запросов и ответов, которые должны вступить в силу для выбранной службы бэкенда. 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). Выбор backend service определяется только для нового трафика. После того, как запрос пользователя был перенаправлен в backendService, последующие запросы будут отправлены в тот же backendService, как определено политикой affinity сессии BackendService.

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

dictionary

Ресурс backend service в регионе, которому направляется трафик, если это правило соответствует. Если routeAction также указан, применяются дополнительные действия маршрутизации, такие как перенаправление URL и т. д., перед отправкой запроса в backend. Однако, если 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 перед перенаправлением запроса. 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, указанные здесь, применяются перед matching 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 со значением headerName ":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

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

string

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

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

string

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

complex

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

string

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

В ответ на запрос preflight, установка этого значения в 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

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

complex

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

complex

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

integer

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

string

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

complex

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

complex

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

целое число

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

строка

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

строка

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

сложный тип

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

словарь

Ресурс RegionBackendService, который зеркально отображается.

сложный тип

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

целое число

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

сложный тип

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

целое число

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

строка

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

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

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

- 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.

сложный тип

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

целое число

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

строка

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

сложный тип

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

строка

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

строка

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

сложный тип

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

словарь

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

сложный тип

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

сложный тип

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

строка

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

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). Выбор backend service определяется только для нового трафика. После направления запроса пользователя в backendService последующие запросы будут направлены в тот же backendService, как определено политикой affinity backendService.

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

dictionary

Ресурс backend service в регионе, в который будет направлен трафик, если правило совпадет. Если дополнительно указан routeAction, выполняются продвинутые действия маршрутизации, такие как URL Rewrites и т.д., прежде чем запрос будет отправлен в backend. Однако, если указан 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 перед перенаправлением запроса. 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, часть запроса сохраняется. По умолчанию false.

string

Ссылка на регион, в котором находится url map.

complex

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

string

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

string

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

string

Часть пути URL.

dictionary

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