Spec-Zone.ru › Ansible

Модуль google.cloud.gcp_compute_region_backend_service_info — сбор сведений о GCP RegionBackendService

Примечание

Этот модуль входит в коллекцию google.cloud (версия 1.13.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install google.cloud. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: google.cloud.gcp_compute_region_backend_service_info.

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Сбор сведений о GCP RegionBackendService

Требования

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

  • python >= 2.6
  • requests >= 2.18.4
  • google-auth >= 1.3.0

Параметры

Параметр

Комментарии

access_token

string

Токен доступа OAuth2, если выбран тип учетных данных accesstoken.

auth_kind

string / обязательный

Тип используемых учетных данных.

Варианты:

  • "application"
  • "machineaccount"
  • "serviceaccount"
  • "accesstoken"

env_type

string

Указывает, в какой среде Ansible выполняется этот модуль.

Не задавайте этот параметр, если не знаете, что делаете.

Этот параметр изменяет только строку User Agent для любых запросов API.

filters

list / элементы=string

Список пар значений фильтров. Доступные фильтры перечислены здесь: https://cloud.google.com/sdk/gcloud/reference/topic/filters.

Каждый дополнительный фильтр в списке добавляется как условие AND (filter1 и filter2).

project

string

Проект Google Cloud Platform, который нужно использовать.

region

string / обязательный

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

scopes

list / элементы=string

Массив используемых областей доступа

service_account_contents

jsonarg

Содержимое файла JSON учетной записи службы: в виде словаря или строки JSON, представляющей его.

service_account_email

string

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

service_account_file

path

Путь к файлу JSON учетной записи службы, если выбран тип serviceaccount.

Примечания

Примечание

  • Для аутентификации можно задать service_account_file с помощью переменной среды GCP_SERVICE_ACCOUNT_FILE.
  • Для аутентификации можно задать service_account_contents с помощью переменной среды GCP_SERVICE_ACCOUNT_CONTENTS.
  • Для аутентификации можно задать service_account_email с помощью переменной среды GCP_SERVICE_ACCOUNT_EMAIL.
  • Для аутентификации можно задать access_token с помощью переменной среды GCP_ACCESS_TOKEN.
  • Для аутентификации можно задать auth_kind с помощью переменной среды GCP_AUTH_KIND.
  • Для аутентификации можно задать scopes с помощью переменной среды GCP_SCOPES.
  • Значения переменных среды используются только в том случае, если значения в плейбуке не заданы.
  • Параметры service_account_email и service_account_file являются взаимоисключающими.

Примеры

- name: get info on a region backend service
  gcp_compute_region_backend_service_info:
    region: us-central1
    filters:
    - name = test_object
    project: test_project
    auth_kind: serviceaccount
    service_account_file: "/tmp/auth.pem"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

resources

complex

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

Возвращается: всегда

affinityCookieTtlSec

integer

Срок действия файлов cookie в секундах, если для session_affinity задано значение GENERATED_COOKIE. Если задано значение 0, файл cookie не является постоянным и действует только до завершения сеанса браузера (или аналогичного сеанса). Максимально допустимое значение TTL — один день.

Если схема балансировки нагрузки — INTERNAL, это поле не используется.

Возвращается: при успешном выполнении

backends

complex

Набор серверных компонентов, обслуживающих этот RegionBackendService.

Возвращается: при успешном выполнении

balancingMode

string

Задает режим балансировки для этого серверного компонента.

Возвращается: при успешном выполнении

capacityScaler

string

Множитель, применяемый к максимальной пропускной способности группы (на основе UTILIZATION, RATE или CONNECTION).

~>**ПРИМЕЧАНИЕ**: это поле нельзя задавать для региональных серверных служб INTERNAL (схема балансировки нагрузки по умолчанию), однако оно обязательно для серверных служб с другой схемой. Суммарное значение capacity_scaler для всех серверных компонентов должно быть ненулевым.

Значение 0 означает, что группа полностью выведена из обслуживания и использует 0% доступной пропускной способности. Допустимый диапазон: [0.0,1.0].

Возвращается: при успешном выполнении

description

string

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

Укажите это свойство при создании ресурса.

Возвращается: при успешном выполнении

failover

boolean

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

Возвращается: при успешном выполнении

group

string

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

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

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

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

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

Возвращается: при успешном выполнении

maxConnections

integer

Максимальное количество одновременных подключений для группы. Можно использовать в режимах балансировки CONNECTION или UTILIZATION.

Нельзя задавать для серверных служб INTERNAL.

Для режима CONNECTION необходимо задать либо maxConnections, либо одно из значений maxConnectionsPerInstance или maxConnectionsPerEndpoint в зависимости от типа группы.

Возвращается: при успешном выполнении

maxConnectionsPerEndpoint

integer

Максимальное количество одновременных подключений, которое может обслуживать одна конечная точка сети на серверной стороне. Нельзя задавать для серверных служб INTERNAL.

Используется для вычисления пропускной способности группы. Можно использовать в режимах балансировки CONNECTION или UTILIZATION. Для режима CONNECTION необходимо задать maxConnections или maxConnectionsPerEndpoint.

Возвращается: при успешном выполнении

maxConnectionsPerInstance

integer

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

Используется для вычисления пропускной способности группы.

Можно использовать в режимах балансировки CONNECTION или UTILIZATION.

Для режима CONNECTION необходимо задать maxConnections или maxConnectionsPerInstance.

Возвращается: при успешном выполнении

maxRate

integer

Максимальное количество запросов группы в секунду (RPS). Нельзя задавать для серверных служб INTERNAL.

Можно использовать в режимах балансировки RATE или UTILIZATION, но для режима RATE это поле обязательно. Необходимо задать либо maxRate, либо одно из значений maxRatePerInstance или maxRatePerEndpoint в зависимости от типа группы.

Возвращается: при успешном выполнении

maxRatePerEndpoint

string

Максимальное количество запросов в секунду (RPS), которое может обслуживать одна конечная точка сети на серверной стороне. Используется для вычисления пропускной способности группы. Можно использовать в любом режиме балансировки. Для режима RATE необходимо задать maxRate или maxRatePerEndpoint. Нельзя задавать для серверных служб INTERNAL.

Возвращается: при успешном выполнении

maxRatePerInstance

string

Максимальное количество запросов в секунду (RPS), которое может обслуживать один экземпляр на серверной стороне. Используется для вычисления пропускной способности группы. Можно использовать в любом режиме балансировки. Для режима RATE необходимо задать maxRate или maxRatePerInstance. Нельзя задавать для серверных служб INTERNAL.

Возвращается: при успешном выполнении

maxUtilization

string

Используется, если для balancingMode задано значение UTILIZATION. Это отношение определяет целевой уровень загрузки процессора для группы. Допустимый диапазон: [0.0, 1.0].

Нельзя задавать для серверных служб INTERNAL.

Возвращается: при успешном выполнении

cdnPolicy

complex

Конфигурация Cloud CDN для этой BackendService.

Возвращается: при успешном выполнении

cacheKeyPolicy

complex

Политика CacheKeyPolicy для этой CdnPolicy.

Возвращается: при успешном выполнении

includeHost

boolean

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

Возвращается: при успешном выполнении

includeProtocol

boolean

Если задано значение true, запросы http и https будут кэшироваться отдельно.

Возвращается: при успешном выполнении

includeQueryString

boolean

Если задано значение true, параметры строки запроса включаются в ключ кэша согласно query_string_whitelist и query_string_blacklist. Если не задан ни один из этих параметров, будет включена вся строка запроса.

Если задано значение false, строка запроса полностью исключается из ключа кэша.

Возвращается: при успешном выполнении

queryStringBlacklist

list / elements=string

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

Все остальные параметры будут включены. Укажите либо query_string_whitelist, либо query_string_blacklist, но не оба параметра одновременно.

Символы ‘&’ и ‘=’ будут закодированы в процентах и не будут рассматриваться как разделители.

Возвращается: при успешном выполнении

queryStringWhitelist

list / elements=string

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

Все остальные параметры будут исключены. Укажите либо query_string_whitelist, либо query_string_blacklist, но не оба параметра одновременно.

Символы ‘&’ и ‘=’ будут закодированы в процентах и не будут рассматриваться как разделители.

Возвращается: при успешном выполнении

cacheMode

string

Задает режим кэширования для всех ответов от этого серверного компонента.

Возможные значения: USE_ORIGIN_HEADERS, FORCE_CACHE_ALL и CACHE_ALL_STATIC.

Возвращается: при успешном выполнении

clientTtl

integer

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

Возвращается: при успешном выполнении

defaultTtl

integer

Задает время жизни кэшированного содержимого по умолчанию, предоставляемого этим источником, для ответов без существующего допустимого значения TTL (max-age или s-max-age).

Возвращается: при успешном выполнении

maxTtl

integer

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

Возвращается: при успешном выполнении

negativeCaching

boolean

Отрицательное кэширование позволяет задавать TTL для отдельных кодов состояния, чтобы настроить детальное кэширование распространённых ошибок или перенаправлений.

Возвращается: при успешном выполнении

negativeCachingPolicy

complex

Задает TTL кэша для указанного кода состояния HTTP. Для настройки negativeCachingPolicy необходимо включить negativeCaching.

Если не указывать политику, но оставить negativeCaching включенным, будут использоваться TTL кэша Cloud CDN по умолчанию.

Возвращается: при успешном выполнении

code

integer

Код состояния HTTP, для которого задается TTL. В качестве значения можно указать только коды состояния HTTP 300, 301, 308, 404, 405, 410, 421, 451 и 501; один и тот же код состояния нельзя указывать более одного раза.

Возвращается: при успешном выполнении

serveWhileStale

integer

Предоставлять имеющееся в кэше содержимое (если оно доступно) во время проверки его актуальности у источника или при возникновении ошибки при обновлении кэша.

Возвращается: при успешном выполнении

signedUrlCacheMaxAgeSec

integer

Максимальное количество секунд, в течение которых ответ на запрос с подписанным URL считается актуальным; по умолчанию — 1 час (3600 секунд). По истечении этого времени ответ будет повторно проверен перед отправкой.

При отправке ответов на запросы с подписанным URL Cloud CDN будет внутренне обрабатывать все ответы от этого серверного компонента так, как если бы они содержали заголовок “Cache-Control: public, max-age=[TTL]”, независимо от существующего заголовка Cache-Control. Фактические заголовки в отправляемых ответах изменяться не будут.

Возвращается: при успешном выполнении

circuitBreakers

complex

Настройки, определяющие количество подключений к серверной службе. Это поле применяется только в том случае, если для `load_balancing_scheme` задано значение INTERNAL_MANAGED, а для `protocol` — HTTP, HTTPS или HTTP2.

Возвращается: при успешном выполнении

maxConnections

integer

Максимальное количество подключений к кластеру серверной части.

По умолчанию — 1024.

Возвращается: при успешном выполнении

maxPendingRequests

integer

Максимальное количество ожидающих запросов к кластеру серверной части.

По умолчанию — 1024.

Возвращается: при успешном выполнении

maxRequests

integer

Максимальное количество параллельных запросов к кластеру серверной части.

По умолчанию — 1024.

Возвращается: при успешном выполнении

maxRequestsPerConnection

integer

Максимальное количество запросов для одного подключения к серверной части. Этот параметр учитывается реализациями HTTP/1.1 и HTTP/2. Если он не указан, ограничение отсутствует. Значение 1 фактически отключает постоянное подключение.

Возвращается: при успешном выполнении

maxRetries

integer

Максимальное количество параллельных повторных попыток обращения к кластеру серверной части.

По умолчанию — 3.

Возвращается: при успешном выполнении

connectionDraining

complex

Настройки для постепенного отключения подключений.

Возвращается: при успешном выполнении

drainingTimeoutSec

integer

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

Возвращается: при успешном выполнении

consistentHash

complex

Балансировку нагрузки на основе согласованного хеширования можно использовать для обеспечения приблизительной привязки сеанса на основе HTTP-заголовков, файлов cookie и других свойств. Эта политика балансировки нагрузки применяется только к HTTP-подключениям. Привязка к определённому целевому хосту будет потеряна при добавлении или удалении одного или нескольких хостов из целевой службы. В этом поле задаются параметры, управляющие согласованным хешированием.

Это поле применяется только при выполнении всех следующих условий: * для `load_balancing_scheme` задано значение INTERNAL_MANAGED * для `protocol` задано значение HTTP, HTTPS или HTTP2 * для `locality_lb_policy` задано значение MAGLEV или RING_HASH.

Возвращается: при успешном выполнении

httpCookie

complex

Хеш вычисляется на основе файла cookie HTTP. В этом поле описывается файл cookie HTTP, который будет использоваться в качестве ключа хеширования для балансировщика нагрузки с согласованным хешированием. Если файл cookie отсутствует, он будет создан.

Это поле применяется, если для sessionAffinity задано значение HTTP_COOKIE.

Возвращается: при успешном выполнении

name

string

Имя файла cookie.

Возвращается: при успешном выполнении

path

string

Путь, задаваемый для файла cookie.

Возвращается: при успешном выполнении

ttl

complex

Срок действия файла cookie.

Возвращается: при успешном выполнении

nanos

integer

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

Возвращается: успех

seconds

integer

Интервал времени с точностью до секунды.

Допустимый диапазон: от 0 до 315,576,000,000 включительно.

Возвращается: успех

httpHeaderName

string

Хеш на основе значения указанного поля заголовка.

Это поле применимо, если для sessionAffinity задано значение HEADER_FIELD.

Возвращается: успех

minimumRingSize

integer

Минимальное количество виртуальных узлов, используемых для хеш-кольца.

Чем больше размер кольца, тем более детальным будет распределение нагрузки. Если количество хостов в пуле балансировки нагрузки превышает размер кольца, каждому хосту будет назначен один виртуальный узел.

По умолчанию — 1024.

Возвращается: успех

creationTimestamp

string

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

Возвращается: успех

description

string

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

Возвращается: успех

enableCDN

boolean

Если значение равно true, включается Cloud CDN для этого RegionBackendService.

Возвращается: успех

failoverPolicy

complex

Политика переключения при сбое.

Возвращается: успех

disableConnectionDrainOnFailover

boolean

При переключении на резервный ресурс или возврате к основному это поле указывает, будет ли учитываться постепенное завершение соединений. Если задать значение true, произойдет следующее: соединения со старым активным пулом не будут постепенно завершаться. Для соединений с новым активным пулом будет использоваться тайм-аут в 10 мин (в настоящее время фиксированный). Если задать значение false, и для старых, и для новых соединений будет использоваться тайм-аут постепенного завершения в 10 мин.

Значение true можно задать, только если протокол — TCP.

По умолчанию используется значение false.

Возвращается: успех

dropTrafficIfUnhealthy

boolean

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

По умолчанию используется значение false.

Возвращается: успех

failoverRatio

string

Значение поля должно находиться в диапазоне [0, 1]. Если доля работоспособных виртуальных машин в основном бэкенде меньше или равна этому числу, трафик, поступающий на IP-адрес балансировщика нагрузки, будет направлен на резервный бэкенд.

Если `failoverRatio` не задан или все виртуальные машины резервного бэкенда неработоспособны, трафик будет перенаправлен обратно на основной бэкенд в режиме «force». В этом режиме трафик будет по возможности распределен между работоспособными виртуальными машинами или между всеми виртуальными машинами, если ни одна из них не работоспособна.

Это поле используется только при балансировке нагрузки уровня L4.

Возвращается: успех

fingerprint

string

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

Возвращается: успех

healthChecks

list / elements=string

Набор URL-адресов ресурсов HealthCheck для проверки работоспособности этого RegionBackendService. В настоящее время можно указать не более одной проверки работоспособности.

Проверка работоспособности обязательна, если в качестве бэкенда службы не используется интернет- или бессерверный NEG.

Возвращается: успех

id

integer

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

Возвращается: успех

loadBalancingScheme

string

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

Возвращается: успех

localityLbPolicy

string

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

Возможные значения: * ROUND_ROBIN — простая политика, при которой каждый работоспособный бэкенд выбирается по очереди.

* LEAST_REQUEST — алгоритм случайным образом выбирает два работоспособных хоста и выбирает тот, у которого меньше активных запросов.

* RING_HASH — балансировщик нагрузки с хешированием по кольцу/модулю использует согласованное хеширование для бэкендов. Алгоритм обладает свойством, при котором добавление или удаление хоста из набора из N хостов затрагивает только 1/N запросов.

* RANDOM — балансировщик нагрузки выбирает случайный работоспособный хост.

* ORIGINAL_DESTINATION — бэкенд-хост выбирается на основе метаданных подключения клиента; то есть соединения открываются с тем же адресом, что и адрес назначения входящего соединения до его перенаправления на балансировщик нагрузки.

* MAGLEV — используется как непосредственная замена балансировщика нагрузки с хешированием по кольцу.

Maglev менее стабилен, чем хеширование по кольцу, но обеспечивает более быстрое построение таблицы и выбор хоста. Подробнее о Maglev см. на странице https://ai.google/research/pubs/pub44824. Это поле применимо, только если для `load_balancing_scheme` задано значение INTERNAL_MANAGED, а для `protocol` — HTTP, HTTPS или HTTP2.

Возвращается: успех

logConfig

complex

Это поле содержит параметры ведения журнала трафика балансировщика нагрузки, обслуживаемого этой службой бэкенда.

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

Возвращается: успех

enable

boolean

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

Возвращается: успех

sampleRate

string

Это поле можно указать, только если для этой службы бэкенда включено ведение журнала. Значение поля должно находиться в диапазоне [0, 1]. Этот параметр задает частоту выборки запросов к балансировщику нагрузки: значение 1.0 означает, что будут переданы сведения обо всех запросах, занесенных в журнал, а значение 0.0 — что не будет передан ни один такой запрос.

Значение по умолчанию — 1.0.

Возвращается: успех

name

string

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

Возвращается: успех

network

dictionary

URL-адрес сети, к которой относится эта служба бэкенда.

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

Возвращается: успех

outlierDetection

complex

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

Это поле применимо, только если для `load_balancing_scheme` задано значение INTERNAL_MANAGED, а для `protocol` — HTTP, HTTPS или HTTP2.

Возвращается: успех

baseEjectionTime

complex

Базовое время, на которое хост исключается из пула. Фактическое время равно базовому времени, умноженному на количество исключений хоста. По умолчанию — 30000 мс или 30 с.

Возвращается: успех

nanos

integer

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

Возвращается: успех

seconds

integer

Интервал времени с точностью до секунды. Допустимый диапазон: от 0 до 315,576,000,000 включительно.

Возвращается: успех

consecutiveErrors

integer

Количество ошибок, после которого хост исключается из пула соединений. Если доступ к хосту бэкенда осуществляется по HTTP, код ответа 5xx считается ошибкой.

По умолчанию — 5.

Возвращается: успех

consecutiveGatewayFailure

integer

Количество последовательных сбоев шлюза (статусы 502, 503, 504 или ошибки соединения, сопоставленные с одним из этих кодов состояния), после которого хост исключается из пула из-за последовательных сбоев шлюза. По умолчанию — 5.

Возвращается: успех

enforcingConsecutiveErrors

integer

Вероятность в процентах того, что хост действительно будет исключен при обнаружении аномального состояния по последовательным ответам 5xx. Этот параметр можно использовать, чтобы отключить исключение или постепенно увеличить его интенсивность. По умолчанию — 100.

Возвращается: успех

enforcingConsecutiveGatewayFailure

integer

Вероятность в процентах того, что хост действительно будет исключен при обнаружении аномального состояния по последовательным сбоям шлюза. Этот параметр можно использовать, чтобы отключить исключение или постепенно увеличить его интенсивность. По умолчанию — 0.

Возвращается: успех

enforcingSuccessRate

integer

Вероятность в процентах того, что хост действительно будет исключен при обнаружении аномального состояния по статистике успешности. Этот параметр можно использовать, чтобы отключить исключение или постепенно увеличить его интенсивность. По умолчанию — 100.

Возвращается: успех

interval

complex

Интервал между проверками для анализа исключения хостов. В результате могут исключаться новые хосты, а ранее исключенные — возвращаться к обслуживанию. По умолчанию — 10 секунд.

Возвращается: успех

nanos

integer

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

Возвращается: успех

seconds

integer

Интервал времени с точностью до секунды. Допустимый диапазон: от 0 до 315,576,000,000 включительно.

Возвращается: успех

maxEjectionPercent

integer

Максимальная доля хостов в пуле балансировки нагрузки для службы бэкенда, которые могут быть исключены. По умолчанию — 10%.

Возвращается: успех

successRateMinimumHosts

integer

Количество хостов в кластере, на которых должно быть достаточно запросов для обнаружения аномалий по показателю успешности. Если хостов меньше указанного значения, обнаружение аномалий по статистике успешности не выполняется ни для одного хоста кластера. По умолчанию — 5.

Возвращается: успех

successRateRequestVolume

integer

Минимальное общее количество запросов, которое должно быть собрано за один интервал (определенный выше длительностью интервала), чтобы включить этот хост в обнаружение аномалий на основе показателя успешности. Если количество запросов ниже указанного значения, обнаружение аномалий по статистике успешности для этого хоста не выполняется. По умолчанию — 100.

Возвращается: успех

successRateStdevFactor

integer

Этот коэффициент используется для определения порога исключения хостов при обнаружении аномалий по показателю успешности. Порог исключения — это разница между средним показателем успешности и произведением этого коэффициента на стандартное отклонение среднего показателя успешности: mean - (stdev * success_rate_stdev_factor). Чтобы получить значение типа double, коэффициент делится на тысячу. Например, если желаемый коэффициент равен 1.9, во время выполнения следует указать значение 1900. По умолчанию — 1900.

Возвращается: успех

portName

string

Именованный порт в группе экземпляров бэкенда, используемый для связи с виртуальными машинами бэкенда в этой группе. Обязателен, если для loadBalancingScheme задано значение EXTERNAL, INTERNAL_MANAGED или INTERNAL_SELF_MANAGED, а в качестве бэкендов используются группы экземпляров. Именованный порт должен быть определен в каждой группе экземпляров бэкенда. Этот параметр не имеет значения, если в качестве бэкендов используются NEG. Если значение не указано, API задает по умолчанию “http”.

Необходимо опустить, если для loadBalancingScheme задано значение INTERNAL (внутренняя балансировка нагрузки TCP/UDP).

Возвращается: успех

protocol

string

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

По умолчанию используется HTTP. **ПРИМЕЧАНИЕ**: HTTP2 допустим только для бета-версий типов балансировщиков нагрузки HTTP/2; его использование с общедоступным API может привести к ошибкам.

Возвращается: успех

region

string

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

Возвращается: успех

sessionAffinity

string

Тип используемой привязки сеанса. По умолчанию — NONE. Привязка сеанса неприменима, если используется протокол UDP.

Возвращается: успех

timeoutSec

integer

Количество секунд ожидания ответа от бэкенда, прежде чем запрос будет считаться неудачным. Значение по умолчанию — 30 секунд. Допустимый диапазон: [1, 86400].

Возвращается: успех

Авторы

  • Google Inc. (@googlecloudplatform)

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/google/cloud/gcp_compute_region_backend_service_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API