update-health-check

Описание

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

Для получения дополнительной информации об обновлении проверок работоспособности см. Создание, обновление и удаление проверок работоспособности в Руководстве разработчика Amazon Route 53.

См. также: Документация API AWS

Синтаксис

  update-health-check
--health-check-id <value>
[--health-check-version <value>]
[--ip-address <value>]
[--port <value>]
[--resource-path <value>]
[--fully-qualified-domain-name <value>]
[--search-string <value>]
[--failure-threshold <value>]
[--inverted | --no-inverted]
[--disabled | --no-disabled]
[--health-threshold <value>]
[--child-health-checks <value>]
[--enable-sni | --no-enable-sni]
[--regions <value>]
[--alarm-identifier <value>]
[--insufficient-data-health-status <value>]
[--reset-elements <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--health-check-id (строка)

Идентификатор проверки работоспособности, для которого требуется подробная информация. При создании проверки работоспособности CreateHealthCheck вернул ID в ответе, в элементе HealthCheckId.

--health-check-version (длинное целое число)

Последовательный счетчик, который Amazon Route 53 устанавливает в значение 1 при создании проверки работоспособности и увеличивает на 1 каждый раз при обновлении настроек проверки работоспособности.

Рекомендуется использовать GetHealthCheck или ListHealthChecks для получения текущего значения HealthCheckVersion для проверки работоспособности, которую нужно обновить, и включить это значение в запрос UpdateHealthCheck. Это предотвращает перезапись промежуточного обновления:

Если значение в запросе UpdateHealthCheck совпадает со значением HealthCheckVersion в проверке работоспособности, Route 53 обновит проверку работоспособности новыми настройками.
Если значение HealthCheckVersion в проверке работоспособности больше, проверка работоспособности была изменена после получения номера версии. Route 53 не обновляет проверку работоспособности и возвращает ошибку HealthCheckVersionMismatch.

--ip-address (строка)

IP-адрес IPv4 или IPv6 конечной точки, для которой Amazon Route 53 должен выполнить проверки работоспособности. Если вы не укажете значение для IPAddress, Route 53 отправит запрос DNS для разрешения доменного имени, указанного в FullyQualifiedDomainName, с интервалом, указанным в RequestInterval. Используя IP-адрес, возвращённый DNS, Route 53 затем проверяет работоспособность конечной точки.

Используйте один из следующих форматов для значения IPAddress:

IPv4 адрес: четыре значения от 0 до 255, разделенные точками (.), например, 192.0.2.44.
IPv6 адрес: восемь групп из четырех шестнадцатеричных значений, разделенных двоеточиями (:), например, 2001:0db8:85a3:0000:0000:abcd:0001:2345. Вы также можете сократить IPv6 адреса, как описано в RFC 5952, например, 2001:db8:85a3::abcd:1:2345.

Если конечная точка является экземпляром EC2, рекомендуется создать Elastic IP-адрес, связать его с экземпляром EC2 и указать Elastic IP-адрес для IPAddress. Это гарантирует, что IP-адрес вашего экземпляра никогда не изменится. Для получения дополнительной информации см. соответствующую документацию:

Linux: Elastic IP-адреса (EIP) в руководстве пользователя Amazon EC2 для Linux-экземпляров
Windows: Elastic IP-адреса (EIP) в руководстве пользователя Amazon EC2 для Windows-экземпляров

Примечание

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

Для получения дополнительной информации см. FullyQualifiedDomainName.

Ограничения: Route 53 не может проверять работоспособность конечных точек, для которых IP-адрес находится в локальных, частных, немаршрутизируемых или многоадресных диапазонах. Для получения дополнительной информации об IP-адресах, для которых невозможно создать проверки работоспособности, см. следующие документы:

RFC 5735, Специальные IP-адреса IPv4
RFC 6598, Зарезервированный IANA префикс IPv4 для общего адресного пространства
RFC 5156, Специальные IP-адреса IPv6

--port (целое число)

Порт на конечной точке, для которого Amazon Route 53 должен выполнить проверки работоспособности.

Примечание

Не указывайте значение для Port, когда вы указываете значение для Type CLOUDWATCH_METRIC или CALCULATED.

--resource-path (строка)

Путь, который вы хотите, чтобы Amazon Route 53 запрашивал при выполнении проверок работоспособности. Путь может иметь любое значение, для которого ваша конечная точка вернёт HTTP код статуса 2xx или 3xx, когда конечная точка работоспособна, например, файл /docs/route53-health-check.html. Вы также можете включить параметры запроса, например, /welcome.html?language=jp&login=y.

Указывайте это значение только если хотите его изменить.

--fully-qualified-domain-name (строка)

Поведение Amazon Route 53 зависит от того, указываете ли вы значение для IPAddress.

Примечание

Если вы указываете значение для IPAddress:

Route 53 отправляет запросы проверки работоспособности на указанный IPv4 или IPv6 адрес и передает значение FullyQualifiedDomainName в заголовке Host для всех проверок работоспособности, кроме проверок TCP. Обычно это полное доменное имя конечной точки, для которой вы хотите, чтобы Route 53 выполнял проверки работоспособности.

Когда Route 53 проверяет работоспособность конечной точки, вот как он строит заголовок Host:

Если вы указываете значение 80 для Port и HTTP или HTTP_STR_MATCH для Type, Route 53 передает значение FullyQualifiedDomainName конечной точке в заголовке Host.
Если вы указываете значение 443 для Port и HTTPS или HTTPS_STR_MATCH для Type, Route 53 передает значение FullyQualifiedDomainName конечной точке в заголовке Host.
Если вы указываете другое значение для Port и любое значение, кроме TCP для Type, Route 53 передает * FullyQualifiedDomainName :Port * конечной точке в заголовке Host.

Если вы не указываете значение для FullyQualifiedDomainName, Route 53 подставляет значение IPAddress в заголовок Host в каждом из перечисленных выше случаев.

Если вы не указываете значение для IPAddress:

Если вы не указываете значение для IPAddress, Route 53 отправляет запрос DNS к домену, который вы указали в FullyQualifiedDomainName, с интервалом, указанным в RequestInterval. Используя IP-адрес IPv4, возвращённый DNS, Route 53 затем проверяет работоспособность конечной точки.

Если вы не указываете значение для IPAddress, вы не можете обновить проверку работоспособности, чтобы удалить FullyQualifiedDomainName; если вы не указываете значение для IPAddress при создании, требуется FullyQualifiedDomainName.

Примечание

Если вы не указываете значение для IPAddress, Route 53 использует только IPv4 для отправки проверок работоспособности конечной точке. Если нет записи ресурса с типом A для имени, которое вы указали для FullyQualifiedDomainName, проверка работоспособности завершится ошибкой «DNS разрешение не выполнено».

Если вы хотите проверить работоспособность взвешенных, по задержке или с резервированием ресурсных записей и выбираете указать конечную точку только по FullyQualifiedDomainName, рекомендуется создать отдельную проверку работоспособности для каждой конечной точки. Например, создайте проверку работоспособности для каждого HTTP сервера, который предоставляет контент для www.example.com. Для значения FullyQualifiedDomainName укажите доменное имя сервера (например, us-east-2-www.example.com), а не имя набора записей ресурсов (www.example.com).

Предупреждение

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

Кроме того, если значение Type равно HTTP, HTTPS, HTTP_STR_MATCH или HTTPS_STR_MATCH, Route 53 передает значение FullyQualifiedDomainName в заголовке Host, как и в случае, когда вы указываете значение для IPAddress. Если значение Type равно TCP, Route 53 не передает заголовок Host.

--search-string (строка)

Если значение Type равно HTTP_STR_MATCH или HTTPS_STR_MATCH, строка, которую вы хотите, чтобы Amazon Route 53 искал в теле ответа от указанного ресурса. Если строка появляется в теле ответа, Route 53 считает ресурс работоспособным. (Вы не можете изменить значение Type при обновлении проверки работоспособности.)

--failure-threshold (целое число)

Количество последовательных проверок работоспособности, которые должна пройти или не пройти конечная точка, чтобы Amazon Route 53 изменил текущий статус конечной точки с «неработоспособной» на «работоспособную» или наоборот. Для получения дополнительной информации см. Как Amazon Route 53 определяет, работоспособна ли конечная точка в руководстве разработчика Amazon Route 53.

Если вы не указываете значение для FailureThreshold, значение по умолчанию равно трём проверкам.

--inverted | --no-inverted (булево)

Укажите, хотите ли вы, чтобы Amazon Route 53 инвертировал статус проверки работоспособности, например, чтобы проверка работоспособности считалась неработоспособной, когда в противном случае она считалась бы работоспособной.

--disabled | --no-disabled (булево)

Останавливает Route 53 от выполнения проверок работоспособности. Когда вы отключаете проверку работоспособности, происходит следующее:

Проверки работоспособности, проверяющие работоспособность конечных точек: Route 53 прекращает отправку запросов к вашему приложению, серверу или другому ресурсу.
Проверки работоспособности, вычисляющие работоспособность: Route 53 прекращает агрегирование статуса ссылающихся проверок работоспособности.
Проверки работоспособности, отслеживающие оповещения CloudWatch: Route 53 прекращает отслеживание соответствующих метрик CloudWatch.

После отключения проверки работоспособности, Route 53 считает статус проверки работоспособности всегда работоспособным. Если вы настраивали резервирование DNS, Route 53 продолжает маршрутизировать трафик к соответствующим ресурсам. Если вы хотите остановить маршрутизацию трафика к ресурсу, измените значение Inverted.

Плата за проверку работоспособности по-прежнему взимается, когда проверка работоспособности отключена. Для получения дополнительной информации см. Цены Amazon Route 53.

--health-threshold (целое число)

Количество дочерних проверок работоспособности, которые должны считаться работоспособными для проверки работоспособности CALCULATED, чтобы проверка работоспособности CALCULATED считалась работоспособной. Для указания дочерних проверок работоспособности, которые вы хотите связать с проверкой работоспособности CALCULATED, используйте элементы ChildHealthChecks и ChildHealthCheck.

Обратите внимание на следующее:

Если вы указываете число, большее, чем количество дочерних проверок работоспособности, Route 53 всегда считает эту проверку работоспособности неработоспособной.
Если вы указываете 0, Route 53 всегда считает эту проверку работоспособности работоспособной.

--child-health-checks (список)

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

(строка)

Синтаксис:

"string" "string" ...

--enable-sni | --no-enable-sni (булево)

Укажите, хотите ли вы, чтобы Amazon Route 53 передавал значение FullyQualifiedDomainName в конечную точку в сообщении client_hello во время согласования TLS. Это позволит конечной точке отвечать на запросы контрольного пункта работоспособности HTTPS с соответствующим сертификатом SSL/TLS.

Некоторые конечные точки требуют, чтобы запросы HTTPS включали имя хоста в сообщении client_hello. Если вы не включите SNI, статус контрольного пункта работоспособности будет SSL alert handshake_failure. Статус контрольного пункта работоспособности может быть таким и по другим причинам. Если SNI включён, и вы всё ещё получаете ошибку, проверьте конфигурацию SSL/TLS на своей конечной точке и подтвердите, что ваш сертификат действителен.

Сертификат SSL/TLS на вашей конечной точке включает имя домена в поле Common Name и, возможно, несколько других в поле Subject Alternative Names. Одно из имён доменов в сертификате должно соответствовать значению, которое вы укажете для FullyQualifiedDomainName. Если конечная точка отвечает на сообщение client_hello с сертификатом, не содержащим доменное имя, указанное вами в FullyQualifiedDomainName, контрольный пункт работоспособности повторит рукопожатие. Во второй попытке контрольный пункт работоспособности исключит FullyQualifiedDomainName из сообщения client_hello.

--regions (список)

Сложный тип, содержащий по одному элементу Region для каждого региона, из которого контрольные пункты работоспособности Amazon Route 53 должны проверять указанную конечную точку.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  us-east-1
  us-west-1
  us-west-2
  eu-west-1
  ap-southeast-1
  ap-southeast-2
  ap-northeast-1
  sa-east-1

--alarm-identifier (структура)

Сложный тип, идентифицирующий сигнал тревоги CloudWatch, который контрольные пункты работоспособности Amazon Route 53 должны использовать для определения того, является ли указанный контрольный пункт работоспособности работоспособным.

Регион -> (строка)

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

Список текущих регионов CloudWatch см. в документации Amazon CloudWatch endpoints and quotas в разделе Amazon Web Services General Reference.

Имя -> (строка)

Имя сигнала тревоги CloudWatch, который контрольные пункты работоспособности Amazon Route 53 должны использовать для определения работоспособности этого контрольного пункта.

Примечание

Route 53 поддерживает сигналы тревоги CloudWatch с следующими функциями:

Метрики стандартного разрешения. Метрики высокого разрешения не поддерживаются. Для получения дополнительной информации см. раздел High-Resolution Metrics в руководстве пользователя Amazon CloudWatch.
Статистики: среднее, минимальное, максимальное, сумма и SampleCount. Расширенные статистики не поддерживаются.

Упрощенный синтаксис:

Region=string,Name=string

Синтаксис JSON:

{
  "Region": "us-east-1"|"us-east-2"|"us-west-1"|"us-west-2"|"ca-central-1"|"eu-central-1"|"eu-central-2"|"eu-west-1"|"eu-west-2"|"eu-west-3"|"ap-east-1"|"me-south-1"|"me-central-1"|"ap-south-1"|"ap-south-2"|"ap-southeast-1"|"ap-southeast-2"|"ap-southeast-3"|"ap-northeast-1"|"ap-northeast-2"|"ap-northeast-3"|"eu-north-1"|"sa-east-1"|"cn-northwest-1"|"cn-north-1"|"af-south-1"|"eu-south-1"|"eu-south-2"|"us-gov-west-1"|"us-gov-east-1"|"us-iso-east-1"|"us-iso-west-1"|"us-isob-east-1"|"ap-southeast-4"|"il-central-1"|"ca-west-1"|"ap-southeast-5"|"mx-central-1"|"us-isof-south-1"|"us-isof-east-1"|"ap-southeast-7",
  "Name": "string"
}

--insufficient-data-health-status (строка)

Когда у CloudWatch недостаточно данных о метрике для определения состояния сигнала тревоги, статус, который вы хотите, чтобы Amazon Route 53 присвоил контрольному пункту работоспособности:

Healthy : Route 53 считает контрольный пункт работоспособности работоспособным.
Unhealthy : Route 53 считает контрольный пункт работоспособности неработоспособным.
LastKnownStatus : По умолчанию Route 53 использует статус контрольного пункта работоспособности с последнего момента, когда у CloudWatch было достаточно данных для определения состояния сигнала тревоги. Для новых контрольных пунктов работоспособности, у которых нет последнего известного статуса, статус контрольного пункта работоспособности — работоспособный.

Возможные значения:

Healthy
Unhealthy
LastKnownStatus

--reset-elements (список)

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

ChildHealthChecks : Amazon Route 53 сбрасывает ChildHealthChecks до null.
FullyQualifiedDomainName : Route 53 сбрасывает FullyQualifiedDomainName до null.
Regions : Route 53 сбрасывает список регионов до набора регионов по умолчанию.
ResourcePath : Route 53 сбрасывает ResourcePath до null.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  FullyQualifiedDomainName
  Regions
  ResourcePath
  ChildHealthChecks

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передавать произвольные двоичные данные, используя значение, предоставленное JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод, не отправляя запрос к API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, оно выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Общие параметры

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды на указанный URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

json
текст
таблица
yaml
yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла ключей.

--region (строка)

Использовать определённый регион. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

вкл
выкл
авто

--no-sign-request (булево)

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

--ca-bundle (строка)

Файл с сертификатами CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается в двоичный блок fileb://, всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенной cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (булево)

Отключить вывод пейджера CLI.

--cli-auto-prompt (булево)

Автоматически запросить параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматический запрос параметров CLI.

Вывод

HealthCheck -> (структура)

Сложный тип, содержащий ответ на запрос UpdateHealthCheck.

Id -> (строка)

Идентификатор, присвоенный Amazon Route 53 контрольному пункту работоспособности при его создании. При добавлении или обновлении записи ресурса вы используете это значение для указания используемого контрольного пункта работоспособности. Значение может иметь длину до 64 символов.

CallerReference -> (строка)

Уникальная строка, указанная при создании контрольного пункта работоспособности.

LinkedService -> (структура)

Если контрольный пункт работоспособности был создан другим сервисом, сервис, создавший контрольный пункт работоспособности. Когда контрольный пункт работоспособности создаётся другим сервисом, его нельзя изменить или удалить с помощью Amazon Route 53.

ServicePrincipal -> (строка)

Если контрольный пункт работоспособности или зона размещения были созданы другим сервисом, сервис, создавший ресурс. Когда ресурс создан другим сервисом, его нельзя изменить или удалить с помощью Amazon Route 53.

Описание -> (строка)

Если контрольный пункт работоспособности или зона размещения были созданы другим сервисом, необязательное описание, которое может быть предоставлено другим сервисом. Когда ресурс создан другим сервисом, его нельзя изменить или удалить с помощью Amazon Route 53.

HealthCheckConfig -> (структура)

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

IPAddress -> (строка)

IP-адрес IPv4 или IPv6 конечной точки, на которой Amazon Route 53 должен выполнить проверку работоспособности. Если вы не укажете значение для IPAddress, Route 53 отправляет запрос DNS для разрешения доменного имени, указанного в FullyQualifiedDomainName, с интервалом, указанным в RequestInterval. Используя IP-адрес, полученный от DNS, Route 53 затем проверяет работоспособность конечной точки.

Используйте один из следующих форматов для значения IPAddress:

Адрес IPv4 : четыре значения от 0 до 255, разделенные точками (.), например, 192.0.2.44.
Адрес IPv6 : восемь групп из четырех шестнадцатеричных значений, разделенных двоеточиями (:), например, 2001:0db8:85a3:0000:0000:abcd:0001:2345. Вы также можете сократить адреса IPv6, как описано в RFC 5952, например, 2001:db8:85a3::abcd:1:2345.

Если конечная точка является экземпляром EC2, рекомендуется создать Elastic IP-адрес, ассоциировать его с экземпляром EC2 и указать Elastic IP-адрес для IPAddress. Это гарантирует, что IP-адрес вашего экземпляра никогда не изменится.

Для получения дополнительной информации см. FullyQualifiedDomainName.

Ограничения: Route 53 не может проверять работоспособность конечных точек, IP-адреса которых находятся в локальных, частных, немаршрутизируемых или многоадресных диапазонах. Дополнительную информацию об IP-адресах, для которых нельзя создать проверки работоспособности, см. в следующих документах:

RFC 5735, Специальные IP-адреса IPv4
RFC 6598, Зарезервированный IANA префикс IPv4 для совместного адресного пространства
RFC 5156, Специальные IP-адреса IPv6

Когда значение Type равно CALCULATED или CLOUDWATCH_METRIC, опустите IPAddress.

Port -> (целое число)

Порт конечной точки, на котором Amazon Route 53 должен выполнить проверки работоспособности.

Примечание

Не указывайте значение для Port, когда вы указываете значение для Type CLOUDWATCH_METRIC или CALCULATED.

Type -> (строка)

Тип проверки работоспособности, который вы хотите создать, указывающий, как Amazon Route 53 определяет, является ли конечная точка работоспособной.

Предупреждение

Вы не можете изменить значение Type после создания проверки работоспособности.

Вы можете создать следующие типы проверок работоспособности:

HTTP : Route 53 пытается установить TCP-соединение. При успехе Route 53 отправляет HTTP-запрос и ожидает HTTP-код состояния 200 или больше и меньше 400.
HTTPS : Route 53 пытается установить TCP-соединение. При успехе Route 53 отправляет HTTPS-запрос и ожидает HTTP-код состояния 200 или больше и меньше 400.

Предупреждение

Если вы укажете HTTPS для значения Type, конечная точка должна поддерживать TLS v1.0, v1.1 или v1.2.

HTTP_STR_MATCH : Route 53 пытается установить TCP-соединение. При успехе Route 53 отправляет HTTP-запрос и ищет строку, которую вы указали в SearchString, в первых 5120 байтах тела ответа.
HTTPS_STR_MATCH : Route 53 пытается установить TCP-соединение. При успехе Route 53 отправляет HTTPS запрос и ищет строку, которую вы указали в SearchString, в первых 5120 байтах тела ответа.
TCP : Route 53 пытается установить TCP-соединение.
CLOUDWATCH_METRIC : Проверка работоспособности связана с CloudWatch-сигналом тревоги. Если состояние сигнала тревоги OK, проверка работоспособности считается работоспособной. Если состояние ALARM, проверка работоспособности считается неработоспособной. Если CloudWatch не имеет достаточных данных, чтобы определить, является ли состояние OK или ALARM, статус проверки работоспособности зависит от параметра InsufficientDataHealthStatus: Healthy, Unhealthy или LastKnownStatus.
CALCULATED : Для проверок работоспособности, которые отслеживают состояние других проверок работоспособности, Route 53 суммирует количество проверок работоспособности, которые Route 53 считает работоспособными, и сравнивает это число со значением HealthThreshold.
RECOVERY_CONTROL : Проверка работоспособности связана с контролем маршрутизации Route53 Application Recovery Controller. Если состояние контроля маршрутизации ON, проверка работоспособности считается работоспособной. Если состояние OFF, проверка работоспособности считается неработоспособной.

Дополнительную информацию см. в разделе Как Route 53 определяет, является ли конечная точка работоспособной в руководстве разработчика Amazon Route 53.

ResourcePath -> (строка)

Путь, если таковой имеется, который вы хотите, чтобы Amazon Route 53 запрашивал при выполнении проверок работоспособности. Путь может быть любым значением, для которого ваша конечная точка вернет HTTP-код состояния 2xx или 3xx, когда конечная точка работоспособна, например, файл /docs/route53-health-check.html. Вы также можете включать параметры строки запроса, например, /welcome.html?language=jp&login=y.

FullyQualifiedDomainName -> (строка)

Поведение Amazon Route 53 зависит от того, укажете ли вы значение для IPAddress.

Если вы укажете значение для IPAddress:

Amazon Route 53 отправляет запросы проверки работоспособности по указанному IPv4 или IPv6 адресу и передает значение FullyQualifiedDomainName в заголовок Host для всех проверок работоспособности, кроме проверок работоспособности TCP. Обычно это полное доменное имя конечной точки, на которой вы хотите, чтобы Route 53 выполнил проверки работоспособности.

Когда Route 53 проверяет работоспособность конечной точки, вот как он строит заголовок Host:

Если вы укажете значение 80 для Port и HTTP или HTTP_STR_MATCH для Type, Route 53 передаёт значение FullyQualifiedDomainName конечной точке в заголовке Host.
Если вы укажете значение 443 для Port и HTTPS или HTTPS_STR_MATCH для Type, Route 53 передаёт значение FullyQualifiedDomainName конечной точке в заголовке Host.
Если вы укажете другое значение для Port и любое значение, кроме TCP, для Type, Route 53 передаёт FullyQualifiedDomainName:Port конечной точке в заголовке Host.

Если вы не укажете значение для FullyQualifiedDomainName, Route 53 подставит значение IPAddress в заголовок Host в каждом из вышеупомянутых случаев.

Если вы не укажете значение для IPAddress:

Route 53 отправляет запрос DNS к домену, который вы указали для FullyQualifiedDomainName, с интервалом, который вы указали для RequestInterval. Используя IP-адрес IPv4, возвращённый DNS, Route 53 затем проверяет работоспособность конечной точки.

Примечание

Если вы не укажете значение для IPAddress, Route 53 будет использовать только IPv4 для отправки проверок работоспособности конечной точке. Если нет записи ресурса с типом A для имени, которое вы указали для FullyQualifiedDomainName, проверка работоспособности завершается с ошибкой «Не удалось разрешить DNS».

Если вы хотите проверить работоспособность взвешенных, по времени задержки или резервирования записей ресурсов, и вы выберете указать конечную точку только по FullyQualifiedDomainName, мы рекомендуем создать отдельную проверку работоспособности для каждой конечной точки. Например, создайте проверку работоспособности для каждого HTTP-сервера, который предоставляет контент для www.example.com. В качестве значения FullyQualifiedDomainName укажите доменное имя сервера (например, us-east-2-www.example.com), а не имя наборов записей ресурсов (www.example.com).

Предупреждение

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

Кроме того, если значение, которое вы укажете для Type, равно HTTP, HTTPS, HTTP_STR_MATCH или HTTPS_STR_MATCH, Route 53 передаёт значение FullyQualifiedDomainName в заголовке Host, как и в случае, когда вы указываете значение для IPAddress. Если значение Type равно TCP, Route 53 не передает заголовок Host.

SearchString -> (строка)

Если значение Type равно HTTP_STR_MATCH или HTTPS_STR_MATCH, строка, которую вы хотите, чтобы Amazon Route 53 искал в теле ответа от указанного ресурса. Если строка появляется в теле ответа, Route 53 считает ресурс работоспособным.

Route 53 учитывает регистр при поиске SearchString в теле ответа.

RequestInterval -> (целое число)

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

Предупреждение

Вы не можете изменить значение RequestInterval после создания проверки работоспособности.

Если вы не укажете значение для RequestInterval, значение по умолчанию составляет 30 секунды.

FailureThreshold -> (целое число)

Количество последовательных проверок работоспособности, которые конечная точка должна пройти или не пройти, чтобы Amazon Route 53 изменил текущий статус конечной точки с неработоспособной на работоспособную или наоборот. Дополнительную информацию см. в разделе Как Amazon Route 53 определяет, является ли конечная точка работоспособной в руководстве разработчика Amazon Route 53.

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

MeasureLatency -> (булево значение)

Укажите, хотите ли вы, чтобы Amazon Route 53 измерял задержку между контроллерами работоспособности в нескольких регионах Amazon Web Services и вашей конечной точкой и отображал графики задержки CloudWatch на странице «Проверки работоспособности» в консоли Route 53.

Предупреждение

Вы не можете изменить значение MeasureLatency после создания проверки работоспособности.

Inverted -> (булево значение)

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

Disabled -> (булево значение)

Прекращает выполнение проверок работоспособности Route 53. При отключении проверки работоспособности происходит следующее:

Проверки работоспособности, проверяющие работоспособность конечных точек: Route 53 прекращает отправку запросов к вашему приложению, серверу или другому ресурсу.
Вычисленные проверки работоспособности: Route 53 прекращает агрегирование статуса связанных проверок работоспособности.
Проверки работоспособности, отслеживающие оповещения CloudWatch: Route 53 прекращает мониторинг соответствующих метрик CloudWatch.

После отключения проверки работоспособности Route 53 считает статус проверки всегда работоспособным. Если вы настроили резервирование DNS, Route 53 продолжает маршрутизировать трафик на соответствующие ресурсы. Если вы хотите прекратить маршрутизацию трафика на ресурс, измените значение параметра Inverted .

Плата за проверку работоспособности всё ещё взимается, даже если проверка отключена. Дополнительную информацию можно найти в разделе Цены на Amazon Route 53 .

HealthThreshold -> (целое число)

Количество дочерних проверок работоспособности, связанных с проверкой работоспособности CALCULATED, которое Amazon Route 53 должно считать работоспособным для того, чтобы проверка работоспособности CALCULATED считалась работоспособной. Для указания дочерних проверок работоспособности, которые вы хотите связать с проверкой работоспособности CALCULATED, используйте элемент ChildHealthChecks.

Обратите внимание на следующее:

Если вы укажете число, большее, чем количество дочерних проверок работоспособности, Route 53 всегда будет считать эту проверку неработоспособной.
Если вы укажете 0 , Route 53 всегда будет считать эту проверку работоспособной.

ChildHealthChecks -> (список)

(Только для вычисленных проверок работоспособности) Сложный тип, содержащий по одному элементу ChildHealthCheck для каждой проверки работоспособности, которую вы хотите связать с проверкой работоспособности CALCULATED.

(строка)

EnableSNI -> (булево)

Укажите, хотите ли вы, чтобы Amazon Route 53 отправлял значение FullyQualifiedDomainName на конечную точку в сообщении client_hello во время согласования TLS. Это позволит конечной точке отвечать на запросы проверки работоспособности HTTPS с соответствующим сертификатом SSL/TLS.

Некоторые конечные точки требуют, чтобы запросы HTTPS включали имя хоста в сообщении client_hello. Если SNI не включён, статус проверки работоспособности будет SSL alert handshake_failure. Проверка работоспособности также может иметь такой статус по другим причинам. Если SNI включён, а ошибка всё ещё возникает, проверьте конфигурацию SSL/TLS на вашей конечной точке и убедитесь, что ваш сертификат действителен.

Сертификат SSL/TLS на вашей конечной точке включает имя домена в поле Common Name и, возможно, ещё несколько в поле Subject Alternative Names. Одно из имён доменов в сертификате должно соответствовать значению, указанному для FullyQualifiedDomainName. Если конечная точка отвечает на сообщение client_hello с сертификатом, не включающим имя домена, указанное в FullyQualifiedDomainName, программа проверки работоспособности повторит рукопожатие. При второй попытке программа проверки работоспособности опустит FullyQualifiedDomainName из сообщения client_hello.

Regions -> (список)

Сложный тип, содержащий по одному элементу Region для каждого региона, из которого вы хотите, чтобы проверки работоспособности Amazon Route 53 проверяли указанную конечную точку.

Если вы не укажете регионы, проверки работоспособности Route 53 автоматически выполняют проверки из всех регионов, перечисленных в разделе Допустимые значения.

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

(строка)

AlarmIdentifier -> (структура)

Сложный тип, определяющий оповещение CloudWatch, которое вы хотите, чтобы проверки работоспособности Amazon Route 53 использовали для определения работоспособности указанной проверки работоспособности.

Region -> (строка)

Регион, в котором было создано оповещение CloudWatch, которое вы хотите, чтобы проверки работоспособности Route 53 использовали для определения работоспособности этой проверки работоспособности.

Список текущих регионов CloudWatch см. в разделе Точки доступа и квоты Amazon CloudWatch в Amazon Web Services General Reference.

Name -> (строка)

Имя оповещения CloudWatch, которое вы хотите, чтобы проверки работоспособности Amazon Route 53 использовали для определения работоспособности этой проверки работоспособности.

Примечание

Route 53 поддерживает оповещения CloudWatch с следующими функциями:

Метрики стандартного разрешения. Метрики высокого разрешения не поддерживаются. Дополнительную информацию см. в разделе Метрики высокого разрешения в Руководстве пользователя Amazon CloudWatch.
Статистики: Среднее значение, Минимальное значение, Максимальное значение, Сумма и SampleCount. Расширенные статистики не поддерживаются.

InsufficientDataHealthStatus -> (строка)

Если у CloudWatch недостаточно данных о метрике для определения состояния оповещения, статус, который вы хотите назначить проверке работоспособности Amazon Route 53:

Healthy: Route 53 считает проверку работоспособности работоспособной.
Unhealthy: Route 53 считает проверку работоспособности неработоспособной.
LastKnownStatus: Route 53 использует статус проверки работоспособности с последнего момента, когда у CloudWatch было достаточно данных для определения состояния оповещения. Для новых проверок работоспособности без последнего известного статуса, значение по умолчанию для проверки работоспособности — работоспособно.

RoutingControlArn -> (строка)

Идентификатор ресурса Amazon (ARN) для управления маршрутизацией контроллера восстановления приложения Route 53.

Дополнительную информацию об Application Recovery Controller Route 53 см. в Руководстве разработчика Application Recovery Controller Route 53 .

HealthCheckVersion -> (длинное целое)

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

CloudWatchAlarmConfiguration -> (структура)

Сложный тип, содержащий информацию об оповещении CloudWatch, которое Amazon Route 53 отслеживает для данной проверки работоспособности.

EvaluationPeriods -> (целое число)

Для метрики, с которой связано оповещение CloudWatch, количество периодов, с которыми сравнивается метрика с порогом.

Threshold -> (двойное)

Для метрики, с которой связано оповещение CloudWatch, значение, с которым сравнивается метрика.

ComparisonOperator -> (строка)

Для метрики, с которой связано оповещение CloudWatch, арифметическая операция, используемая для сравнения.

Period -> (целое число)

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

MetricName -> (строка)

Имя метрики CloudWatch, с которой связано оповещение.

Namespace -> (строка)

Пространство имён метрики, с которой связано оповещение. Дополнительную информацию см. в разделе Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference в Руководстве пользователя Amazon CloudWatch.

Statistic -> (строка)

Для метрики, с которой связано оповещение CloudWatch, статистика, применяемая к метрике.

Dimensions -> (список)

Для метрики, с которой связано оповещение CloudWatch, сложный тип, содержащий информацию о измерениях для метрики. Подробности см. в разделе Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference в Руководстве пользователя Amazon CloudWatch.

(структура)

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

Name -> (строка)

Для метрики, с которой связано оповещение CloudWatch, имя одного измерения.

Value -> (строка)

Для метрики, с которой связано оповещение CloudWatch, значение одного измерения.