create-health-check

Описание

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

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

ELB Load Balancers

Если вы регистрируете экземпляры EC2 с балансировщиком нагрузки Elastic Load Balancing (ELB), не создавайте контрольные пункты работоспособности Amazon Route 53 для экземпляров EC2. При регистрации экземпляра EC2 с балансировщиком вы настраиваете параметры контрольного пункта работоспособности ELB, который выполняет аналогичную функцию контрольного пункта работоспособности Route 53.

Приватные зоны размещения

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

Контроллеры работоспособности Route 53 находятся за пределами VPC. Для проверки работоспособности конечной точки внутри VPC по IP-адресу необходимо назначить публичный IP-адрес экземпляру в VPC.
Вы можете настроить контроллер работоспособности для проверки работоспособности внешнего ресурса, от которого зависит экземпляр, например, сервера базы данных.
Вы можете создать метрику CloudWatch, связать с ней сигнал тревоги и затем создать контрольный пункт работоспособности, основанный на состоянии сигнала тревоги. Например, вы можете создать метрику CloudWatch, которая проверяет состояние метрики Amazon EC2 StatusCheckFailed, добавить сигнал тревоги к метрике и затем создать контрольный пункт работоспособности, основанный на состоянии сигнала тревоги. Сведения о создании метрик и сигналов тревоги CloudWatch с помощью консоли CloudWatch см. в руководстве пользователя Amazon CloudWatch.

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

Синтаксис

  create-health-check
--caller-reference <value>
--health-check-config <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]

Параметры

--caller-reference (строка)

Уникальная строка, идентифицирующая запрос, которая позволяет повторно выполнить невыполненный запрос CreateHealthCheck без риска создания двух одинаковых контрольных пунктов работоспособности:

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

Route 53 не хранит CallerReference удаленного контрольного пункта работоспособности неопределенно долго. CallerReference удаленного контрольного пункта работоспособности будет удален через определенное количество дней.

--health-check-config (структура)

Сложный тип, содержащий настройки для нового проверки работоспособности.

IPAddress -> (строка)

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

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

IP-адрес IPv4: четыре значения от 0 до 255, разделенные точками (.), например, 192.0.2.44.
IP-адрес 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. Используя возвращённый DNS IPv4-адрес, 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, которое вы хотите использовать для определения работоспособности данной проверки работоспособности.

Region -> (строка)

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

Для текущего списка регионов CloudWatch см. Amazon CloudWatch endpoints and quotas в Amazon Web Services General Reference.

Name -> (строка)

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

Примечание

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

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

InsufficientDataHealthStatus -> (строка)

Когда CloudWatch не имеет достаточных данных о метрике для определения состояния оповещения, состояние, которое вы хотите назначить проверке работоспособности:

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 Application Recovery Controller.

Синтаксис сокращенного вида:

IPAddress=string,Port=integer,Type=string,ResourcePath=string,FullyQualifiedDomainName=string,SearchString=string,RequestInterval=integer,FailureThreshold=integer,MeasureLatency=boolean,Inverted=boolean,Disabled=boolean,HealthThreshold=integer,ChildHealthChecks=string,string,EnableSNI=boolean,Regions=string,string,AlarmIdentifier={Region=string,Name=string},InsufficientDataHealthStatus=string,RoutingControlArn=string

Синтаксис JSON:

{
  "IPAddress": "string",
  "Port": integer,
  "Type": "HTTP"|"HTTPS"|"HTTP_STR_MATCH"|"HTTPS_STR_MATCH"|"TCP"|"CALCULATED"|"CLOUDWATCH_METRIC"|"RECOVERY_CONTROL",
  "ResourcePath": "string",
  "FullyQualifiedDomainName": "string",
  "SearchString": "string",
  "RequestInterval": integer,
  "FailureThreshold": integer,
  "MeasureLatency": true|false,
  "Inverted": true|false,
  "Disabled": true|false,
  "HealthThreshold": integer,
  "ChildHealthChecks": ["string", ...],
  "EnableSNI": true|false,
  "Regions": ["us-east-1"|"us-west-1"|"us-west-2"|"eu-west-1"|"ap-southeast-1"|"ap-southeast-2"|"ap-northeast-1"|"sa-east-1", ...],
  "AlarmIdentifier": {
    "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"
  },
  "InsufficientDataHealthStatus": "Healthy"|"Unhealthy"|"LastKnownStatus",
  "RoutingControlArn": "string"
}

--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
text
таблица
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-auto-prompt (булево)

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

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

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию можно найти в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, характерные для Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Дополнительная информация приведена в разделе "Использование кавычек со строками" в Руководстве пользователя AWS CLI.

Для создания проверки работоспособности

Следующая create-health-check команда создаёт проверку работоспособности, используя ссылку вызывающего абонента 2014-04-01-18:47 и JSON-форматированную конфигурацию в файле C:\awscli\route53\create-health-check.json:

aws route53 create-health-check --caller-reference 2014-04-01-18:47 --health-check-config file://C:\awscli\route53\create-health-check.json

Синтаксис JSON:

{
  "IPAddress": "IP address of the endpoint to check",
  "Port": port on the endpoint to check--required when Type is "TCP",
  "Type": "HTTP"|"HTTPS"|"HTTP_STR_MATCH"|"HTTPS_STR_MATCH"|"TCP",
  "ResourcePath": "path of the file that you want Amazon Route 53 to request--all Types except TCP",
  "FullyQualifiedDomainName": "domain name of the endpoint to check--all Types except TCP",
  "SearchString": "if Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string to search for in the response body from the specified resource",
  "RequestInterval": 10 | 30,
  "FailureThreshold": integer between 1 and 10
}

Для добавления проверки работоспособности в запись ресурса Route 53 используйте команду change-resource-record-sets.

Дополнительную информацию см. в разделе "Проверки работоспособности Amazon Route 53 и резервирование DNS" в Руководстве разработчика Amazon Route 53.

Вывод

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

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

Id -> (строка)

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

CallerReference -> (строка)

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

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

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

ServicePrincipal -> (строка)

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

Description -> (строка)

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

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

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

IPAddress -> (строка)

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

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

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

Дополнительную информацию см. в разделе 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 -> (строка)

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

Вы не можете изменить значение 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-запрос и ищет в первых 5120 байтах тела ответа строку, которую вы укажете в SearchString.
HTTPS_STR_MATCH: Route 53 пытается установить TCP-соединение. При успехе Route 53 отправляет HTTPS-запрос и ищет в первых 5120 байтах тела ответа строку, которую вы укажете в SearchString.
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, проверка работоспособности считается неработоспособной.

Дополнительную информацию см. в разделе How Route 53 Determines Whether an Endpoint Is Healthy в руководстве разработчика 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 отправляет запросы проверки работоспособности указанному IP-адресу 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. Используя возвращённый DNS IP-адрес IPv4, 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 изменил текущий статус конечной точки с неработоспособного на работоспособный или наоборот. Дополнительную информацию см. в разделе How Amazon Route 53 Determines Whether an Endpoint Is Healthy в руководстве разработчика Amazon Route 53.

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

MeasureLatency -> (логическое значение)

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

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

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

Inverted -> (логическое значение)

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 -> (список)

(строка)

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.

Name -> (строка)

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

Примечание

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

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

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 Application Recovery Controller.

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, значение одного измерения.

Location -> (строка)

Уникальный URL, представляющий новую проверку работоспособности.