Amazon Route 53

2026/11/19 - Amazon Route 53 - 5 new 8 updated api methods

Changes  Route 53 Private Endpoint Health Checks support

CreateHealthCheckSource (new) Link ¶

Creates a health check source, which defines the virtual private cloud (VPC), subnets, and security groups from which Route 53 sends private endpoint health check requests. To use this operation, you must have the route53:CreateHealthCheckSource permission. You must also have permission to create a service-linked role.

Specify a VPC, one subnet in each Availability Zone that Route 53 uses for private endpoint health checks in the Amazon Web Services Region, and one or more security groups for each subnet. The security groups must allow outbound traffic to the endpoints that you want to check.

Route 53 creates a health check source asynchronously, and the initial HealthCheckSourceStatus is CREATE_PENDING. Call GetHealthCheckSource until the status is CREATE_COMPLETED before you create health checks that use the source. You can't change the configuration of a health check source after you create it.

If AWS Identity and Access Management (IAM) is still deleting the Route 53 service-linked role for your account, the request fails with InvalidInput. Retry after the deletion completes.

See also: AWS API Documentation

Request Syntax

client.create_health_check_source(
    CallerReference='string',
    HealthCheckSourceConfig={
        'VpcId': 'string',
        'SubnetConfigurationList': [
            {
                'SubnetId': 'string',
                'AvailabilityZoneId': 'string',
                'SecurityGroupIdList': [
                    'string',
                ]
            },
        ]
    },
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
type CallerReference:

string

param CallerReference:

A unique, case-sensitive identifier that ensures that the operation completes no more than one time. If you retry a CreateHealthCheckSource request with the same CallerReference and the same settings as a previous request, Route 53 returns the existing health check source without creating a duplicate. If that health check source has a status of CREATE_FAILED, Route 53 tries to create it again. To create a new health check source after a failure, specify a new value for CallerReference. If a health check source with the same CallerReference already exists and the settings differ, Route 53 returns a HealthCheckSourceAlreadyExists error.

This field is autopopulated if not provided.

type HealthCheckSourceConfig:

dict

param HealthCheckSourceConfig:

[REQUIRED]

A complex type that contains the virtual private cloud (VPC), subnets, and security groups for the health check source.

  • VpcId (string) -- [REQUIRED]

    The ID of the virtual private cloud (VPC) that contains the subnets for the health check source. All subnets in SubnetConfigurationList must belong to this VPC.

  • SubnetConfigurationList (list) -- [REQUIRED]

    A complex type that contains two or three SubnetConfiguration elements, one in each Availability Zone that Route 53 uses for private endpoint health checks in the Amazon Web Services Region. The Availability Zones must be distinct. Route 53 creates network interfaces in each subnet and sends health check requests from all of them.

    • (dict) --

      A complex type that identifies one subnet for a health check source and the security groups that Route 53 associates with the network interfaces that it creates in that subnet.

      • SubnetId (string) -- [REQUIRED]

        The ID of the subnet that Route 53 uses to send health check requests.

      • AvailabilityZoneId (string) -- [REQUIRED]

        The ID of the Availability Zone that contains the subnet, for example use1-az1. Specify the Availability Zone ID, not the Availability Zone name.

      • SecurityGroupIdList (list) -- [REQUIRED]

        The IDs of the security groups in the same virtual private cloud (VPC) to associate with the network interfaces that Route 53 creates in this subnet. The security groups must allow outbound traffic to the endpoints that the health checks monitor.

        • (string) --

type Tags:

list

param Tags:

A complex type that contains a list of the tags that you want to apply to the health check source when you create it.

  • (dict) --

    A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

    • Key (string) --

      The value of Key depends on the operation that you want to perform:

      • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

      • Edit a tag: Key is the name of the tag that you want to change the Value for.

      • Delete a key: Key is the name of the tag you want to remove.

      • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you've given to each health check.

    • Value (string) --

      The value of Value depends on the operation that you want to perform:

      • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

      • Edit a tag: Value is the new value that you want to assign the tag.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheckSourceId': 'string',
    'HealthCheckSourceStatus': 'CREATE_PENDING'|'CREATE_IN_PROGRESS'|'CREATE_COMPLETED'|'CREATE_FAILED'|'DELETE_PENDING'|'DELETE_IN_PROGRESS'|'DELETE_COMPLETED'|'DELETE_FAILED',
    'Location': 'string'
}

Response Structure

  • (dict) --

    Returns the ID, status, and location URL of the new health check source.

    • HealthCheckSourceId (string) --

      The ID of the new health check source. Route 53 assigns this ID when it creates the source.

    • HealthCheckSourceStatus (string) --

      The current status of the health check source. Immediately after you create a health check source, the status is CREATE_PENDING. If the request is a retry with the same CallerReference, the status is the current status of the existing health check source.

    • Location (string) --

      The unique URL representing the new health check source.

DeleteHealthCheckSource (new) Link ¶

Deletes a health check source. Before you delete a health check source, delete or update any health checks that reference it. Otherwise, the request fails with InvalidInput. The request also fails with InvalidInput if the status of the health check source is CREATE_PENDING or CREATE_IN_PROGRESS. Wait until the status is CREATE_COMPLETED or CREATE_FAILED, and then try again.

Route 53 deletes a health check source asynchronously, and the initial HealthCheckSourceStatus is DELETE_PENDING. Call GetHealthCheckSource to track progress. After the deletion completes, GetHealthCheckSource returns NoSuchHealthCheckSource and the health check source no longer appears in the results of ListHealthCheckSources. If you delete a health check source that is already deleted, the request fails with NoSuchHealthCheckSource.

To use this operation, you must have the route53:DeleteHealthCheckSource permission. You must also have permission to create a service-linked role.

See also: AWS API Documentation

Request Syntax

client.delete_health_check_source(
    HealthCheckSourceId='string'
)
type HealthCheckSourceId:

string

param HealthCheckSourceId:

[REQUIRED]

The ID of the health check source that you want to delete.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheckSourceId': 'string',
    'HealthCheckSourceStatus': 'CREATE_PENDING'|'CREATE_IN_PROGRESS'|'CREATE_COMPLETED'|'CREATE_FAILED'|'DELETE_PENDING'|'DELETE_IN_PROGRESS'|'DELETE_COMPLETED'|'DELETE_FAILED'
}

Response Structure

  • (dict) --

    Contains the ID and status of the health check source that DeleteHealthCheckSource deletes.

    • HealthCheckSourceId (string) --

      The ID of the health check source that is being deleted.

    • HealthCheckSourceStatus (string) --

      The status of the health check source after Route 53 accepts the delete request. The value is DELETE_PENDING, or the current status if deletion of the health check source was already in progress.

ListHealthChecksBySource (new) Link ¶

Retrieves a list of the health checks that use a specified health check source.

Results are paginated. If IsTruncated is true, specify the NextMarker value for marker to get more results.

See also: AWS API Documentation

Request Syntax

client.list_health_checks_by_source(
    HealthCheckSourceId='string',
    Marker='string',
    MaxItems='string'
)
type HealthCheckSourceId:

string

param HealthCheckSourceId:

[REQUIRED]

The ID of the health check source whose health checks you want to list.

type Marker:

string

param Marker:

The NextMarker value from the previous response, if the value of IsTruncated was true. Specify it to get the next group of health checks. If IsTruncated was false, there are no more health checks to get.

type MaxItems:

string

param MaxItems:

The maximum number of health checks that you want ListHealthChecksBySource to return. Route 53 returns a maximum of 1000 health checks. If you specify a value greater than 1000, Route 53 returns only the first 1000.

rtype:

dict

returns:

Response Syntax

{
    'HealthChecks': [
        {
            'Id': 'string',
            'CallerReference': 'string',
            'LinkedService': {
                'ServicePrincipal': 'string',
                'Description': 'string'
            },
            'HealthCheckConfig': {
                'IPAddress': 'string',
                'Port': 123,
                'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
                'ResourcePath': 'string',
                'FullyQualifiedDomainName': 'string',
                'SearchString': 'string',
                'RequestInterval': 123,
                'FailureThreshold': 123,
                'MeasureLatency': True|False,
                'Inverted': True|False,
                'Disabled': True|False,
                'HealthThreshold': 123,
                '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
                    'Name': 'string'
                },
                'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
                'RoutingControlArn': 'string',
                'EndpointType': 'PUBLIC'|'PRIVATE',
                'HealthCheckSourceId': 'string'
            },
            'HealthCheckVersion': 123,
            'CloudWatchAlarmConfiguration': {
                'EvaluationPeriods': 123,
                'Threshold': 123.0,
                'ComparisonOperator': 'GreaterThanOrEqualToThreshold'|'GreaterThanThreshold'|'LessThanThreshold'|'LessThanOrEqualToThreshold',
                'Period': 123,
                'MetricName': 'string',
                'Namespace': 'string',
                'Statistic': 'Average'|'Sum'|'SampleCount'|'Maximum'|'Minimum',
                'Dimensions': [
                    {
                        'Name': 'string',
                        'Value': 'string'
                    },
                ]
            }
        },
    ],
    'Marker': 'string',
    'IsTruncated': True|False,
    'NextMarker': 'string',
    'MaxItems': 'string'
}

Response Structure

  • (dict) --

    Contains the health checks and pagination information that ListHealthChecksBySource returns.

    • HealthChecks (list) --

      A complex type that contains one HealthCheck element for each health check that uses the specified health check source.

      • (dict) --

        A complex type that contains information about one health check that is associated with the current Amazon Web Services account.

        • Id (string) --

          The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

        • CallerReference (string) --

          A unique string that you specified when you created the health check.

        • LinkedService (dict) --

          If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

          • ServicePrincipal (string) --

            If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

          • Description (string) --

            If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

        • HealthCheckConfig (dict) --

          A complex type that contains detailed information about one health check.

          • IPAddress (string) --

            The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

            Use one of the following formats for the value of IPAddress:

            • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

            • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

            For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

            For more information, see FullyQualifiedDomainName.

            Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

            For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

            When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

          • Port (integer) --

            The port on the endpoint that you want Amazon Route 53 to perform health checks on.

          • Type (string) --

            The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

            You can create the following types of health checks:

            • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

            • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

            • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

            • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

            • TCP: Route 53 tries to establish a TCP connection.

            • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

            • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

            • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

            For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

          • ResourcePath (string) --

            The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

          • FullyQualifiedDomainName (string) --

            Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

            If you specify a value for IPAddress:

            Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

            When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

            • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

            • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

            • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

            If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

            If you don't specify a value for IPAddress:

            Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

            If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

            In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

          • SearchString (string) --

            If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

            Route 53 considers case when searching for SearchString in the response body.

          • RequestInterval (integer) --

            The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

            RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

            If you don't specify a value for RequestInterval, the default value is 30 seconds.

          • FailureThreshold (integer) --

            The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

            FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

            Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

          • MeasureLatency (boolean) --

            Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

            MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

          • Inverted (boolean) --

            Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

          • Disabled (boolean) --

            Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

            • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

            • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

            • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

            After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

            Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

          • HealthThreshold (integer) --

            The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

            Note the following:

            • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

            • If you specify 0, Route 53 always considers this health check to be healthy.

          • ChildHealthChecks (list) --

            (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

            • (string) --

          • EnableSNI (boolean) --

            Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

            Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

            The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

          • Regions (list) --

            A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

            If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

            If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

            • (string) --

          • AlarmIdentifier (dict) --

            A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

            • Region (string) --

              For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

              For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

            • Name (string) --

              The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

          • InsufficientDataHealthStatus (string) --

            When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

            • Healthy: Route 53 considers the health check to be healthy.

            • Unhealthy: Route 53 considers the health check to be unhealthy.

            • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

          • RoutingControlArn (string) --

            The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

            For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

          • EndpointType (string) --

            Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

            • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

            • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

          • HealthCheckSourceId (string) --

            The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

            You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

            Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

        • HealthCheckVersion (integer) --

          The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

        • CloudWatchAlarmConfiguration (dict) --

          A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

          • EvaluationPeriods (integer) --

            For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

          • Threshold (float) --

            For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

          • ComparisonOperator (string) --

            For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

          • Period (integer) --

            For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

          • MetricName (string) --

            The name of the CloudWatch metric that the alarm is associated with.

          • Namespace (string) --

            The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

          • Statistic (string) --

            For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

          • Dimensions (list) --

            For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

            • (dict) --

              For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

              • Name (string) --

                For the metric that the CloudWatch alarm is associated with, the name of one dimension.

              • Value (string) --

                For the metric that the CloudWatch alarm is associated with, the value of one dimension.

    • Marker (string) --

      The value that you specified for the marker parameter in the call to ListHealthChecksBySource that produced the current response. This value is present for the second and subsequent calls to ListHealthChecksBySource.

    • IsTruncated (boolean) --

      Specifies whether there are more health checks to list. If the value is true, specify the NextMarker value for marker to get the next group of health checks.

    • NextMarker (string) --

      The identifier of the first health check in the next group of health checks. If IsTruncated is true, specify this value in the marker parameter of another ListHealthChecksBySource request.

    • MaxItems (string) --

      The value that you specified for the maxitems parameter in the call to ListHealthChecksBySource that produced the current response.

GetHealthCheckSource (new) Link ¶

Gets information about a specified health check source, including its status and the virtual private cloud (VPC), subnets, and security groups that it uses.

See also: AWS API Documentation

Request Syntax

client.get_health_check_source(
    HealthCheckSourceId='string'
)
type HealthCheckSourceId:

string

param HealthCheckSourceId:

[REQUIRED]

The ID of the health check source that you want to get information about.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheckSource': {
        'HealthCheckSourceId': 'string',
        'HealthCheckSourceStatus': 'CREATE_PENDING'|'CREATE_IN_PROGRESS'|'CREATE_COMPLETED'|'CREATE_FAILED'|'DELETE_PENDING'|'DELETE_IN_PROGRESS'|'DELETE_COMPLETED'|'DELETE_FAILED',
        'HealthCheckSourceConfig': {
            'VpcId': 'string',
            'SubnetConfigurationList': [
                {
                    'SubnetId': 'string',
                    'AvailabilityZoneId': 'string',
                    'SecurityGroupIdList': [
                        'string',
                    ]
                },
            ]
        },
        'StatusReasonCode': 'INSUFFICIENT_SUBNET_IPS'|'EC2_LIMIT_EXCEEDED'|'INVALID_SUBNET'|'INVALID_SECURITY_GROUP'|'INVALID_CONFIGURATION'|'SLR_MISSING_OR_NOT_ASSUMABLE'|'INTERNAL_ERROR',
        'StatusReason': 'string'
    }
}

Response Structure

  • (dict) --

    Contains the health check source that GetHealthCheckSource returns.

    • HealthCheckSource (dict) --

      A complex type that contains information about the specified health check source.

      • HealthCheckSourceId (string) --

        The ID of the health check source. Route 53 assigns this ID when it creates the source.

      • HealthCheckSourceStatus (string) --

        The current status of the health check source. The health check source status can have one of the following values:

        • CREATE_PENDING - Route 53 accepted the request to create the source and hasn't started creating it. You can't use the source in a health check until its status is CREATE_COMPLETED.

        • CREATE_IN_PROGRESS - Route 53 is creating the source. You can't use the source in a health check until its status is CREATE_COMPLETED.

        • CREATE_COMPLETED - The source is ready to use.

        • CREATE_FAILED - Route 53 couldn't create the source. StatusReasonCode and StatusReason explain why.

        • DELETE_PENDING - Route 53 accepted the request to delete the source and hasn't started deleting it.

        • DELETE_IN_PROGRESS - Route 53 is deleting the source.

        • DELETE_COMPLETED - Route 53 has deleted the source. You can't retrieve a health check source in this status: GetHealthCheckSource returns NoSuchHealthCheckSource.

        • DELETE_FAILED - Route 53 couldn't delete the source. StatusReasonCode and StatusReason explain why.

        If the status is CREATE_FAILED, fix the cause that StatusReasonCode indicates, and then either retry CreateHealthCheckSource with the same CallerReference and settings, or delete the source and create a new one. If the status is DELETE_FAILED, retry the DeleteHealthCheckSource request.

      • HealthCheckSourceConfig (dict) --

        The virtual private cloud (VPC), subnets, and security groups for the health check source.

        • VpcId (string) --

          The ID of the virtual private cloud (VPC) that contains the subnets for the health check source. All subnets in SubnetConfigurationList must belong to this VPC.

        • SubnetConfigurationList (list) --

          A complex type that contains two or three SubnetConfiguration elements, one in each Availability Zone that Route 53 uses for private endpoint health checks in the Amazon Web Services Region. The Availability Zones must be distinct. Route 53 creates network interfaces in each subnet and sends health check requests from all of them.

          • (dict) --

            A complex type that identifies one subnet for a health check source and the security groups that Route 53 associates with the network interfaces that it creates in that subnet.

            • SubnetId (string) --

              The ID of the subnet that Route 53 uses to send health check requests.

            • AvailabilityZoneId (string) --

              The ID of the Availability Zone that contains the subnet, for example use1-az1. Specify the Availability Zone ID, not the Availability Zone name.

            • SecurityGroupIdList (list) --

              The IDs of the security groups in the same virtual private cloud (VPC) to associate with the network interfaces that Route 53 creates in this subnet. The security groups must allow outbound traffic to the endpoints that the health checks monitor.

              • (string) --

      • StatusReasonCode (string) --

        A code that indicates why the health check source has a status of CREATE_FAILED or DELETE_FAILED. Route 53 returns this member only when the status is one of those values. The code can have one of the following values:

        • INSUFFICIENT_SUBNET_IPS - One of the specified subnets doesn't have enough free private IP addresses. Check the available IP addresses in each subnet, and delete network interfaces that you don't need.

        • EC2_LIMIT_EXCEEDED - Your account reached an Amazon virtual private cloud (VPC) quota for network interfaces or security groups. Delete network interfaces that you don't need, specify fewer security groups, or request a quota increase.

        • INVALID_SUBNET - One of the specified subnets doesn't exist or isn't valid, or an AvailabilityZoneId doesn't match the Availability Zone of its subnet. Check that each subnet ID is correct, that the subnet exists, and that each AvailabilityZoneId matches its subnet.

        • INVALID_SECURITY_GROUP - One of the specified security groups doesn't exist or isn't valid. Check that each security group ID is correct and that the security group exists.

        • INVALID_CONFIGURATION - The combination of VPC, subnets, and security groups isn't valid. Check that VpcId is correct and exists, that each subnet is in that VPC, and that the security groups for each subnet are in the same VPC as that subnet.

        • SLR_MISSING_OR_NOT_ASSUMABLE - Route 53 couldn't assume its service-linked role in your account. In IAM, check that the service-linked role for Route 53 private endpoint health checks exists and that no deletion task for it is in progress.

        • INTERNAL_ERROR - Route 53 encountered an internal error. Contact Amazon Web Services Support and provide the health check source ID.

      • StatusReason (string) --

        A description of why the health check source has a status of CREATE_FAILED or DELETE_FAILED, and what you can do about it. The text corresponds to the value of StatusReasonCode. Route 53 returns this member only when StatusReasonCode is present.

ListHealthCheckSources (new) Link ¶

Retrieves a list of the health check sources that are associated with the current Amazon Web Services account.

Results are paginated. To get more results, specify the NextToken value from the previous response for NextToken.

See also: AWS API Documentation

Request Syntax

client.list_health_check_sources(
    NextToken='string',
    MaxResults='string'
)
type NextToken:

string

param NextToken:

The NextToken value from the previous response, if it included one. Specify it to get the next group of health check sources.

type MaxResults:

string

param MaxResults:

The maximum number of health check sources that you want ListHealthCheckSources to return. Route 53 returns a maximum of 100 health check sources. If you specify a value greater than 100, Route 53 returns only the first 100.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheckSources': [
        {
            'HealthCheckSourceId': 'string',
            'HealthCheckSourceStatus': 'CREATE_PENDING'|'CREATE_IN_PROGRESS'|'CREATE_COMPLETED'|'CREATE_FAILED'|'DELETE_PENDING'|'DELETE_IN_PROGRESS'|'DELETE_COMPLETED'|'DELETE_FAILED',
            'HealthCheckSourceConfig': {
                'VpcId': 'string',
                'SubnetConfigurationList': [
                    {
                        'SubnetId': 'string',
                        'AvailabilityZoneId': 'string',
                        'SecurityGroupIdList': [
                            'string',
                        ]
                    },
                ]
            },
            'StatusReasonCode': 'INSUFFICIENT_SUBNET_IPS'|'EC2_LIMIT_EXCEEDED'|'INVALID_SUBNET'|'INVALID_SECURITY_GROUP'|'INVALID_CONFIGURATION'|'SLR_MISSING_OR_NOT_ASSUMABLE'|'INTERNAL_ERROR',
            'StatusReason': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Contains the health check sources and pagination information that ListHealthCheckSources returns.

    • HealthCheckSources (list) --

      A complex type that contains one HealthCheckSource element for each health check source that is associated with the current Amazon Web Services account.

      • (dict) --

        A complex type that contains information about a health check source: its ID, its status, and the virtual private cloud (VPC), subnets, and security groups from which Route 53 sends health check requests to private endpoints.

        • HealthCheckSourceId (string) --

          The ID of the health check source. Route 53 assigns this ID when it creates the source.

        • HealthCheckSourceStatus (string) --

          The current status of the health check source. The health check source status can have one of the following values:

          • CREATE_PENDING - Route 53 accepted the request to create the source and hasn't started creating it. You can't use the source in a health check until its status is CREATE_COMPLETED.

          • CREATE_IN_PROGRESS - Route 53 is creating the source. You can't use the source in a health check until its status is CREATE_COMPLETED.

          • CREATE_COMPLETED - The source is ready to use.

          • CREATE_FAILED - Route 53 couldn't create the source. StatusReasonCode and StatusReason explain why.

          • DELETE_PENDING - Route 53 accepted the request to delete the source and hasn't started deleting it.

          • DELETE_IN_PROGRESS - Route 53 is deleting the source.

          • DELETE_COMPLETED - Route 53 has deleted the source. You can't retrieve a health check source in this status: GetHealthCheckSource returns NoSuchHealthCheckSource.

          • DELETE_FAILED - Route 53 couldn't delete the source. StatusReasonCode and StatusReason explain why.

          If the status is CREATE_FAILED, fix the cause that StatusReasonCode indicates, and then either retry CreateHealthCheckSource with the same CallerReference and settings, or delete the source and create a new one. If the status is DELETE_FAILED, retry the DeleteHealthCheckSource request.

        • HealthCheckSourceConfig (dict) --

          The virtual private cloud (VPC), subnets, and security groups for the health check source.

          • VpcId (string) --

            The ID of the virtual private cloud (VPC) that contains the subnets for the health check source. All subnets in SubnetConfigurationList must belong to this VPC.

          • SubnetConfigurationList (list) --

            A complex type that contains two or three SubnetConfiguration elements, one in each Availability Zone that Route 53 uses for private endpoint health checks in the Amazon Web Services Region. The Availability Zones must be distinct. Route 53 creates network interfaces in each subnet and sends health check requests from all of them.

            • (dict) --

              A complex type that identifies one subnet for a health check source and the security groups that Route 53 associates with the network interfaces that it creates in that subnet.

              • SubnetId (string) --

                The ID of the subnet that Route 53 uses to send health check requests.

              • AvailabilityZoneId (string) --

                The ID of the Availability Zone that contains the subnet, for example use1-az1. Specify the Availability Zone ID, not the Availability Zone name.

              • SecurityGroupIdList (list) --

                The IDs of the security groups in the same virtual private cloud (VPC) to associate with the network interfaces that Route 53 creates in this subnet. The security groups must allow outbound traffic to the endpoints that the health checks monitor.

                • (string) --

        • StatusReasonCode (string) --

          A code that indicates why the health check source has a status of CREATE_FAILED or DELETE_FAILED. Route 53 returns this member only when the status is one of those values. The code can have one of the following values:

          • INSUFFICIENT_SUBNET_IPS - One of the specified subnets doesn't have enough free private IP addresses. Check the available IP addresses in each subnet, and delete network interfaces that you don't need.

          • EC2_LIMIT_EXCEEDED - Your account reached an Amazon virtual private cloud (VPC) quota for network interfaces or security groups. Delete network interfaces that you don't need, specify fewer security groups, or request a quota increase.

          • INVALID_SUBNET - One of the specified subnets doesn't exist or isn't valid, or an AvailabilityZoneId doesn't match the Availability Zone of its subnet. Check that each subnet ID is correct, that the subnet exists, and that each AvailabilityZoneId matches its subnet.

          • INVALID_SECURITY_GROUP - One of the specified security groups doesn't exist or isn't valid. Check that each security group ID is correct and that the security group exists.

          • INVALID_CONFIGURATION - The combination of VPC, subnets, and security groups isn't valid. Check that VpcId is correct and exists, that each subnet is in that VPC, and that the security groups for each subnet are in the same VPC as that subnet.

          • SLR_MISSING_OR_NOT_ASSUMABLE - Route 53 couldn't assume its service-linked role in your account. In IAM, check that the service-linked role for Route 53 private endpoint health checks exists and that no deletion task for it is in progress.

          • INTERNAL_ERROR - Route 53 encountered an internal error. Contact Amazon Web Services Support and provide the health check source ID.

        • StatusReason (string) --

          A description of why the health check source has a status of CREATE_FAILED or DELETE_FAILED, and what you can do about it. The text corresponds to the value of StatusReasonCode. Route 53 returns this member only when StatusReasonCode is present.

    • NextToken (string) --

      A pagination token. If there are more health check sources to list, specify this value for NextToken in the next request.

ChangeTagsForResource (updated) Link ¶
Changes (request)
{'ResourceType': {'healthchecksource'}}

Adds, edits, or deletes tags for a health check, a health check source, or a hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

See also: AWS API Documentation

Request Syntax

client.change_tags_for_resource(
    ResourceType='healthcheck'|'hostedzone'|'healthchecksource',
    ResourceId='string',
    AddTags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    RemoveTagKeys=[
        'string',
    ]
)
type ResourceType:

string

param ResourceType:

[REQUIRED]

The type of the resource.

  • The resource type for health checks is healthcheck.

  • The resource type for health check sources is healthchecksource.

  • The resource type for hosted zones is hostedzone.

type ResourceId:

string

param ResourceId:

[REQUIRED]

The ID of the resource for which you want to add, change, or delete tags.

type AddTags:

list

param AddTags:

A complex type that contains a list of the tags that you want to add to the specified health check or hosted zone and/or the tags that you want to edit Value for.

You can add a maximum of 10 tags to a health check, a health check source, or a hosted zone.

  • (dict) --

    A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

    • Key (string) --

      The value of Key depends on the operation that you want to perform:

      • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

      • Edit a tag: Key is the name of the tag that you want to change the Value for.

      • Delete a key: Key is the name of the tag you want to remove.

      • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you've given to each health check.

    • Value (string) --

      The value of Value depends on the operation that you want to perform:

      • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

      • Edit a tag: Value is the new value that you want to assign the tag.

type RemoveTagKeys:

list

param RemoveTagKeys:

A complex type that contains a list of the tags that you want to delete from the specified health check or hosted zone. You can specify up to 10 keys.

  • (string) --

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

    Empty response for the request.

CreateHealthCheck (updated) Link ¶
Changes (request, response)
Request
{'HealthCheckConfig': {'EndpointType': 'PUBLIC | PRIVATE',
                       'HealthCheckSourceId': 'string'}}
Response
{'HealthCheck': {'HealthCheckConfig': {'EndpointType': 'PUBLIC | PRIVATE',
                                       'HealthCheckSourceId': 'string'}}}

Creates a new health check.

For information about adding health checks to resource record sets, see HealthCheckId in ChangeResourceRecordSets.

ELB Load Balancers

If you're registering EC2 instances with an Elastic Load Balancing (ELB) load balancer, do not create Amazon Route 53 health checks for the EC2 instances. When you register an EC2 instance with a load balancer, you configure settings for an ELB health check, which performs a similar function to a Route 53 health check.

Private Hosted Zones

You can associate health checks with failover resource record sets in a private hosted zone. Note the following:

  • For a public health check, Route 53 health checkers are outside the VPC. To check the health of an endpoint within a VPC by IP address, you must assign a public IP address to the instance in the VPC.

  • To check the health of an endpoint within a VPC by using a private IP address, use a private endpoint health check ( EndpointType of PRIVATE). For more information, see CreateHealthCheckSource.

  • You can configure a health checker to check the health of an external resource that the instance relies on, such as a database server.

  • You can create a CloudWatch metric, associate an alarm with the metric, and then create a health check that is based on the state of the alarm. For example, you might create a CloudWatch metric that checks the status of the Amazon EC2 StatusCheckFailed metric, add an alarm to the metric, and then create a health check that is based on the state of the alarm. For information about creating CloudWatch metrics and alarms by using the CloudWatch console, see the Amazon CloudWatch User Guide.

See also: AWS API Documentation

Request Syntax

client.create_health_check(
    CallerReference='string',
    HealthCheckConfig={
        'IPAddress': 'string',
        'Port': 123,
        'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
        'ResourcePath': 'string',
        'FullyQualifiedDomainName': 'string',
        'SearchString': 'string',
        'RequestInterval': 123,
        'FailureThreshold': 123,
        'MeasureLatency': True|False,
        'Inverted': True|False,
        'Disabled': True|False,
        'HealthThreshold': 123,
        '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
            'Name': 'string'
        },
        'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
        'RoutingControlArn': 'string',
        'EndpointType': 'PUBLIC'|'PRIVATE',
        'HealthCheckSourceId': 'string'
    }
)
type CallerReference:

string

param CallerReference:

[REQUIRED]

A unique string that identifies the request and that allows you to retry a failed CreateHealthCheck request without the risk of creating two identical health checks:

  • If you send a CreateHealthCheck request with the same CallerReference and settings as a previous request, and if the health check doesn't exist, Amazon Route 53 creates the health check. If the health check does exist, Route 53 returns the health check configuration in the response.

  • If you send a CreateHealthCheck request with the same CallerReference as a deleted health check, regardless of the settings, Route 53 returns a HealthCheckAlreadyExists error.

  • If you send a CreateHealthCheck request with the same CallerReference as an existing health check but with different settings, Route 53 returns a HealthCheckAlreadyExists error.

  • If you send a CreateHealthCheck request with a unique CallerReference but settings identical to an existing health check, Route 53 creates the health check.

Route 53 does not store the CallerReference for a deleted health check indefinitely. The CallerReference for a deleted health check will be deleted after a number of days.

type HealthCheckConfig:

dict

param HealthCheckConfig:

[REQUIRED]

A complex type that contains settings for a new health check.

  • IPAddress (string) --

    The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

    Use one of the following formats for the value of IPAddress:

    • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

    • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

    For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

    For more information, see FullyQualifiedDomainName.

    Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

    For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

    When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

  • Port (integer) --

    The port on the endpoint that you want Amazon Route 53 to perform health checks on.

  • Type (string) -- [REQUIRED]

    The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

    You can create the following types of health checks:

    • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

    • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

    • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

    • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

    • TCP: Route 53 tries to establish a TCP connection.

    • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

    • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

    • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

    For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

  • ResourcePath (string) --

    The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

  • FullyQualifiedDomainName (string) --

    Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

    If you specify a value for IPAddress:

    Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

    When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

    • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

    • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

    • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

    If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

    If you don't specify a value for IPAddress:

    Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

    If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

    In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

  • SearchString (string) --

    If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

    Route 53 considers case when searching for SearchString in the response body.

  • RequestInterval (integer) --

    The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

    RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

    If you don't specify a value for RequestInterval, the default value is 30 seconds.

  • FailureThreshold (integer) --

    The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

    FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

    Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

  • MeasureLatency (boolean) --

    Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

    MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

  • Inverted (boolean) --

    Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

  • Disabled (boolean) --

    Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

    • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

    • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

    • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

    After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

    Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

  • HealthThreshold (integer) --

    The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

    Note the following:

    • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

    • If you specify 0, Route 53 always considers this health check to be healthy.

  • ChildHealthChecks (list) --

    (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

    • (string) --

  • EnableSNI (boolean) --

    Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

    Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

    The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

  • Regions (list) --

    A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

    If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

    If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

    • (string) --

  • AlarmIdentifier (dict) --

    A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

    • Region (string) -- [REQUIRED]

      For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

      For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

    • Name (string) -- [REQUIRED]

      The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

  • InsufficientDataHealthStatus (string) --

    When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

    • Healthy: Route 53 considers the health check to be healthy.

    • Unhealthy: Route 53 considers the health check to be unhealthy.

    • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

  • RoutingControlArn (string) --

    The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

    For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

  • EndpointType (string) --

    Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

    • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

    • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

  • HealthCheckSourceId (string) --

    The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

    You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

    Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheck': {
        'Id': 'string',
        'CallerReference': 'string',
        'LinkedService': {
            'ServicePrincipal': 'string',
            'Description': 'string'
        },
        'HealthCheckConfig': {
            'IPAddress': 'string',
            'Port': 123,
            'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
            'ResourcePath': 'string',
            'FullyQualifiedDomainName': 'string',
            'SearchString': 'string',
            'RequestInterval': 123,
            'FailureThreshold': 123,
            'MeasureLatency': True|False,
            'Inverted': True|False,
            'Disabled': True|False,
            'HealthThreshold': 123,
            '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
                'Name': 'string'
            },
            'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
            'RoutingControlArn': 'string',
            'EndpointType': 'PUBLIC'|'PRIVATE',
            'HealthCheckSourceId': 'string'
        },
        'HealthCheckVersion': 123,
        'CloudWatchAlarmConfiguration': {
            'EvaluationPeriods': 123,
            'Threshold': 123.0,
            'ComparisonOperator': 'GreaterThanOrEqualToThreshold'|'GreaterThanThreshold'|'LessThanThreshold'|'LessThanOrEqualToThreshold',
            'Period': 123,
            'MetricName': 'string',
            'Namespace': 'string',
            'Statistic': 'Average'|'Sum'|'SampleCount'|'Maximum'|'Minimum',
            'Dimensions': [
                {
                    'Name': 'string',
                    'Value': 'string'
                },
            ]
        }
    },
    'Location': 'string'
}

Response Structure

  • (dict) --

    A complex type containing the response information for the new health check.

    • HealthCheck (dict) --

      A complex type that contains identifying information about the health check.

      • Id (string) --

        The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

      • CallerReference (string) --

        A unique string that you specified when you created the health check.

      • LinkedService (dict) --

        If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

        • ServicePrincipal (string) --

          If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

        • Description (string) --

          If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

      • HealthCheckConfig (dict) --

        A complex type that contains detailed information about one health check.

        • IPAddress (string) --

          The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

          Use one of the following formats for the value of IPAddress:

          • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

          • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

          For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

          For more information, see FullyQualifiedDomainName.

          Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

          For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

          When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

        • Port (integer) --

          The port on the endpoint that you want Amazon Route 53 to perform health checks on.

        • Type (string) --

          The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

          You can create the following types of health checks:

          • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • TCP: Route 53 tries to establish a TCP connection.

          • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

          • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

          • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

          For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

        • ResourcePath (string) --

          The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

        • FullyQualifiedDomainName (string) --

          Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

          If you specify a value for IPAddress:

          Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

          When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

          • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

          If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

          If you don't specify a value for IPAddress:

          Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

          If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

          In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

        • SearchString (string) --

          If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

          Route 53 considers case when searching for SearchString in the response body.

        • RequestInterval (integer) --

          The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

          RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

          If you don't specify a value for RequestInterval, the default value is 30 seconds.

        • FailureThreshold (integer) --

          The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

          FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

          Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

        • MeasureLatency (boolean) --

          Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

          MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

        • Inverted (boolean) --

          Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

        • Disabled (boolean) --

          Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

          • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

          • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

          • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

          After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

          Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

        • HealthThreshold (integer) --

          The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

          Note the following:

          • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

          • If you specify 0, Route 53 always considers this health check to be healthy.

        • ChildHealthChecks (list) --

          (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

          • (string) --

        • EnableSNI (boolean) --

          Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

          Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

          The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

        • Regions (list) --

          A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

          If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

          If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

          • (string) --

        • AlarmIdentifier (dict) --

          A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

          • Region (string) --

            For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

            For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

          • Name (string) --

            The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

        • InsufficientDataHealthStatus (string) --

          When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

          • Healthy: Route 53 considers the health check to be healthy.

          • Unhealthy: Route 53 considers the health check to be unhealthy.

          • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

        • RoutingControlArn (string) --

          The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

          For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

        • EndpointType (string) --

          Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

          • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

          • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

        • HealthCheckSourceId (string) --

          The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

          You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

          Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

      • HealthCheckVersion (integer) --

        The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

      • CloudWatchAlarmConfiguration (dict) --

        A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

        • EvaluationPeriods (integer) --

          For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

        • Threshold (float) --

          For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

        • ComparisonOperator (string) --

          For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

        • Period (integer) --

          For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

        • MetricName (string) --

          The name of the CloudWatch metric that the alarm is associated with.

        • Namespace (string) --

          The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

        • Statistic (string) --

          For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

        • Dimensions (list) --

          For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

          • (dict) --

            For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

            • Name (string) --

              For the metric that the CloudWatch alarm is associated with, the name of one dimension.

            • Value (string) --

              For the metric that the CloudWatch alarm is associated with, the value of one dimension.

    • Location (string) --

      The unique URL representing the new health check.

GetAccountLimit (updated) Link ¶
Changes (request, response)
Request
{'Type': {'MAX_HEALTH_CHECK_SOURCES_BY_OWNER'}}
Response
{'Limit': {'Type': {'MAX_HEALTH_CHECK_SOURCES_BY_OWNER'}}}

Gets the specified limit for the current account, for example, the maximum number of health checks that you can create using the account.

For the default limit, see Limits in the Amazon Route 53 Developer Guide. To request a higher limit, open a case.

See also: AWS API Documentation

Request Syntax

client.get_account_limit(
    Type='MAX_HEALTH_CHECKS_BY_OWNER'|'MAX_HOSTED_ZONES_BY_OWNER'|'MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER'|'MAX_REUSABLE_DELEGATION_SETS_BY_OWNER'|'MAX_TRAFFIC_POLICIES_BY_OWNER'|'MAX_HEALTH_CHECK_SOURCES_BY_OWNER'
)
type Type:

string

param Type:

[REQUIRED]

The limit that you want to get. Valid values include the following:

  • MAX_HEALTH_CHECKS_BY_OWNER: The maximum number of health checks that you can create using the current account.

  • MAX_HEALTH_CHECK_SOURCES_BY_OWNER The maximum number of health check sources that you can create using the current account.

  • MAX_HOSTED_ZONES_BY_OWNER: The maximum number of hosted zones that you can create using the current account.

  • MAX_REUSABLE_DELEGATION_SETS_BY_OWNER: The maximum number of reusable delegation sets that you can create using the current account.

  • MAX_TRAFFIC_POLICIES_BY_OWNER: The maximum number of traffic policies that you can create using the current account.

  • MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER: The maximum number of traffic policy instances that you can create using the current account. (Traffic policy instances are referred to as traffic flow policy records in the Amazon Route 53 console.)

rtype:

dict

returns:

Response Syntax

{
    'Limit': {
        'Type': 'MAX_HEALTH_CHECKS_BY_OWNER'|'MAX_HOSTED_ZONES_BY_OWNER'|'MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER'|'MAX_REUSABLE_DELEGATION_SETS_BY_OWNER'|'MAX_TRAFFIC_POLICIES_BY_OWNER'|'MAX_HEALTH_CHECK_SOURCES_BY_OWNER',
        'Value': 123
    },
    'Count': 123
}

Response Structure

  • (dict) --

    A complex type that contains the requested limit.

    • Limit (dict) --

      The current setting for the specified limit. For example, if you specified MAX_HEALTH_CHECKS_BY_OWNER for the value of Type in the request, the value of Limit is the maximum number of health checks that you can create using the current account.

      • Type (string) --

        The limit that you requested. Valid values include the following:

        • MAX_HEALTH_CHECKS_BY_OWNER: The maximum number of health checks that you can create using the current account.

        • MAX_HEALTH_CHECK_SOURCES_BY_OWNER The maximum number of health check sources that you can create using the current account.

        • MAX_HOSTED_ZONES_BY_OWNER: The maximum number of hosted zones that you can create using the current account.

        • MAX_REUSABLE_DELEGATION_SETS_BY_OWNER: The maximum number of reusable delegation sets that you can create using the current account.

        • MAX_TRAFFIC_POLICIES_BY_OWNER: The maximum number of traffic policies that you can create using the current account.

        • MAX_TRAFFIC_POLICY_INSTANCES_BY_OWNER: The maximum number of traffic policy instances that you can create using the current account. (Traffic policy instances are referred to as traffic flow policy records in the Amazon Route 53 console.)

      • Value (integer) --

        The current value for the limit that is specified by Type.

    • Count (integer) --

      The current number of entities that you have created of the specified type. For example, if you specified MAX_HEALTH_CHECKS_BY_OWNER for the value of Type in the request, the value of Count is the current number of health checks that you have created using the current account.

GetHealthCheck (updated) Link ¶
Changes (response)
{'HealthCheck': {'HealthCheckConfig': {'EndpointType': 'PUBLIC | PRIVATE',
                                       'HealthCheckSourceId': 'string'}}}

Gets information about a specified health check.

See also: AWS API Documentation

Request Syntax

client.get_health_check(
    HealthCheckId='string'
)
type HealthCheckId:

string

param HealthCheckId:

[REQUIRED]

The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheck': {
        'Id': 'string',
        'CallerReference': 'string',
        'LinkedService': {
            'ServicePrincipal': 'string',
            'Description': 'string'
        },
        'HealthCheckConfig': {
            'IPAddress': 'string',
            'Port': 123,
            'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
            'ResourcePath': 'string',
            'FullyQualifiedDomainName': 'string',
            'SearchString': 'string',
            'RequestInterval': 123,
            'FailureThreshold': 123,
            'MeasureLatency': True|False,
            'Inverted': True|False,
            'Disabled': True|False,
            'HealthThreshold': 123,
            '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
                'Name': 'string'
            },
            'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
            'RoutingControlArn': 'string',
            'EndpointType': 'PUBLIC'|'PRIVATE',
            'HealthCheckSourceId': 'string'
        },
        'HealthCheckVersion': 123,
        'CloudWatchAlarmConfiguration': {
            'EvaluationPeriods': 123,
            'Threshold': 123.0,
            'ComparisonOperator': 'GreaterThanOrEqualToThreshold'|'GreaterThanThreshold'|'LessThanThreshold'|'LessThanOrEqualToThreshold',
            'Period': 123,
            'MetricName': 'string',
            'Namespace': 'string',
            'Statistic': 'Average'|'Sum'|'SampleCount'|'Maximum'|'Minimum',
            'Dimensions': [
                {
                    'Name': 'string',
                    'Value': 'string'
                },
            ]
        }
    }
}

Response Structure

  • (dict) --

    A complex type that contains the response to a GetHealthCheck request.

    • HealthCheck (dict) --

      A complex type that contains information about one health check that is associated with the current Amazon Web Services account.

      • Id (string) --

        The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

      • CallerReference (string) --

        A unique string that you specified when you created the health check.

      • LinkedService (dict) --

        If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

        • ServicePrincipal (string) --

          If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

        • Description (string) --

          If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

      • HealthCheckConfig (dict) --

        A complex type that contains detailed information about one health check.

        • IPAddress (string) --

          The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

          Use one of the following formats for the value of IPAddress:

          • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

          • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

          For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

          For more information, see FullyQualifiedDomainName.

          Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

          For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

          When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

        • Port (integer) --

          The port on the endpoint that you want Amazon Route 53 to perform health checks on.

        • Type (string) --

          The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

          You can create the following types of health checks:

          • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • TCP: Route 53 tries to establish a TCP connection.

          • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

          • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

          • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

          For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

        • ResourcePath (string) --

          The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

        • FullyQualifiedDomainName (string) --

          Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

          If you specify a value for IPAddress:

          Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

          When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

          • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

          If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

          If you don't specify a value for IPAddress:

          Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

          If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

          In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

        • SearchString (string) --

          If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

          Route 53 considers case when searching for SearchString in the response body.

        • RequestInterval (integer) --

          The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

          RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

          If you don't specify a value for RequestInterval, the default value is 30 seconds.

        • FailureThreshold (integer) --

          The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

          FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

          Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

        • MeasureLatency (boolean) --

          Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

          MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

        • Inverted (boolean) --

          Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

        • Disabled (boolean) --

          Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

          • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

          • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

          • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

          After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

          Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

        • HealthThreshold (integer) --

          The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

          Note the following:

          • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

          • If you specify 0, Route 53 always considers this health check to be healthy.

        • ChildHealthChecks (list) --

          (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

          • (string) --

        • EnableSNI (boolean) --

          Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

          Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

          The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

        • Regions (list) --

          A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

          If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

          If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

          • (string) --

        • AlarmIdentifier (dict) --

          A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

          • Region (string) --

            For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

            For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

          • Name (string) --

            The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

        • InsufficientDataHealthStatus (string) --

          When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

          • Healthy: Route 53 considers the health check to be healthy.

          • Unhealthy: Route 53 considers the health check to be unhealthy.

          • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

        • RoutingControlArn (string) --

          The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

          For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

        • EndpointType (string) --

          Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

          • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

          • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

        • HealthCheckSourceId (string) --

          The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

          You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

          Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

      • HealthCheckVersion (integer) --

        The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

      • CloudWatchAlarmConfiguration (dict) --

        A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

        • EvaluationPeriods (integer) --

          For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

        • Threshold (float) --

          For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

        • ComparisonOperator (string) --

          For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

        • Period (integer) --

          For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

        • MetricName (string) --

          The name of the CloudWatch metric that the alarm is associated with.

        • Namespace (string) --

          The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

        • Statistic (string) --

          For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

        • Dimensions (list) --

          For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

          • (dict) --

            For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

            • Name (string) --

              For the metric that the CloudWatch alarm is associated with, the name of one dimension.

            • Value (string) --

              For the metric that the CloudWatch alarm is associated with, the value of one dimension.

ListHealthChecks (updated) Link ¶
Changes (response)
{'HealthChecks': {'HealthCheckConfig': {'EndpointType': 'PUBLIC | PRIVATE',
                                        'HealthCheckSourceId': 'string'}}}

Retrieve a list of the health checks that are associated with the current Amazon Web Services account.

See also: AWS API Documentation

Request Syntax

client.list_health_checks(
    Marker='string',
    MaxItems='string'
)
type Marker:

string

param Marker:

If the value of IsTruncated in the previous response was true, you have more health checks. To get another group, submit another ListHealthChecks request.

For the value of marker, specify the value of NextMarker from the previous response, which is the ID of the first health check that Amazon Route 53 will return if you submit another request.

If the value of IsTruncated in the previous response was false, there are no more health checks to get.

type MaxItems:

string

param MaxItems:

The maximum number of health checks that you want ListHealthChecks to return in response to the current request. Amazon Route 53 returns a maximum of 1000 items. If you set MaxItems to a value greater than 1000, Route 53 returns only the first 1000 health checks.

rtype:

dict

returns:

Response Syntax

{
    'HealthChecks': [
        {
            'Id': 'string',
            'CallerReference': 'string',
            'LinkedService': {
                'ServicePrincipal': 'string',
                'Description': 'string'
            },
            'HealthCheckConfig': {
                'IPAddress': 'string',
                'Port': 123,
                'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
                'ResourcePath': 'string',
                'FullyQualifiedDomainName': 'string',
                'SearchString': 'string',
                'RequestInterval': 123,
                'FailureThreshold': 123,
                'MeasureLatency': True|False,
                'Inverted': True|False,
                'Disabled': True|False,
                'HealthThreshold': 123,
                '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
                    'Name': 'string'
                },
                'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
                'RoutingControlArn': 'string',
                'EndpointType': 'PUBLIC'|'PRIVATE',
                'HealthCheckSourceId': 'string'
            },
            'HealthCheckVersion': 123,
            'CloudWatchAlarmConfiguration': {
                'EvaluationPeriods': 123,
                'Threshold': 123.0,
                'ComparisonOperator': 'GreaterThanOrEqualToThreshold'|'GreaterThanThreshold'|'LessThanThreshold'|'LessThanOrEqualToThreshold',
                'Period': 123,
                'MetricName': 'string',
                'Namespace': 'string',
                'Statistic': 'Average'|'Sum'|'SampleCount'|'Maximum'|'Minimum',
                'Dimensions': [
                    {
                        'Name': 'string',
                        'Value': 'string'
                    },
                ]
            }
        },
    ],
    'Marker': 'string',
    'IsTruncated': True|False,
    'NextMarker': 'string',
    'MaxItems': 'string'
}

Response Structure

  • (dict) --

    A complex type that contains the response to a ListHealthChecks request.

    • HealthChecks (list) --

      A complex type that contains one HealthCheck element for each health check that is associated with the current Amazon Web Services account.

      • (dict) --

        A complex type that contains information about one health check that is associated with the current Amazon Web Services account.

        • Id (string) --

          The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

        • CallerReference (string) --

          A unique string that you specified when you created the health check.

        • LinkedService (dict) --

          If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

          • ServicePrincipal (string) --

            If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

          • Description (string) --

            If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

        • HealthCheckConfig (dict) --

          A complex type that contains detailed information about one health check.

          • IPAddress (string) --

            The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

            Use one of the following formats for the value of IPAddress:

            • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

            • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

            For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

            For more information, see FullyQualifiedDomainName.

            Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

            For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

            When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

          • Port (integer) --

            The port on the endpoint that you want Amazon Route 53 to perform health checks on.

          • Type (string) --

            The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

            You can create the following types of health checks:

            • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

            • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

            • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

            • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

            • TCP: Route 53 tries to establish a TCP connection.

            • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

            • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

            • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

            For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

          • ResourcePath (string) --

            The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

          • FullyQualifiedDomainName (string) --

            Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

            If you specify a value for IPAddress:

            Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

            When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

            • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

            • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

            • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

            If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

            If you don't specify a value for IPAddress:

            Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

            If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

            In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

          • SearchString (string) --

            If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

            Route 53 considers case when searching for SearchString in the response body.

          • RequestInterval (integer) --

            The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

            RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

            If you don't specify a value for RequestInterval, the default value is 30 seconds.

          • FailureThreshold (integer) --

            The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

            FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

            Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

          • MeasureLatency (boolean) --

            Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

            MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

          • Inverted (boolean) --

            Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

          • Disabled (boolean) --

            Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

            • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

            • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

            • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

            After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

            Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

          • HealthThreshold (integer) --

            The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

            Note the following:

            • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

            • If you specify 0, Route 53 always considers this health check to be healthy.

          • ChildHealthChecks (list) --

            (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

            • (string) --

          • EnableSNI (boolean) --

            Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

            Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

            The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

          • Regions (list) --

            A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

            If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

            If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

            • (string) --

          • AlarmIdentifier (dict) --

            A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

            • Region (string) --

              For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

              For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

            • Name (string) --

              The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

          • InsufficientDataHealthStatus (string) --

            When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

            • Healthy: Route 53 considers the health check to be healthy.

            • Unhealthy: Route 53 considers the health check to be unhealthy.

            • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

          • RoutingControlArn (string) --

            The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

            For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

          • EndpointType (string) --

            Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

            • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

            • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

          • HealthCheckSourceId (string) --

            The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

            You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

            Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

        • HealthCheckVersion (integer) --

          The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

        • CloudWatchAlarmConfiguration (dict) --

          A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

          • EvaluationPeriods (integer) --

            For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

          • Threshold (float) --

            For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

          • ComparisonOperator (string) --

            For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

          • Period (integer) --

            For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

          • MetricName (string) --

            The name of the CloudWatch metric that the alarm is associated with.

          • Namespace (string) --

            The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

          • Statistic (string) --

            For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

          • Dimensions (list) --

            For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

            • (dict) --

              For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

              • Name (string) --

                For the metric that the CloudWatch alarm is associated with, the name of one dimension.

              • Value (string) --

                For the metric that the CloudWatch alarm is associated with, the value of one dimension.

    • Marker (string) --

      For the second and subsequent calls to ListHealthChecks, Marker is the value that you specified for the marker parameter in the previous request.

    • IsTruncated (boolean) --

      A flag that indicates whether there are more health checks to be listed. If the response was truncated, you can get the next group of health checks by submitting another ListHealthChecks request and specifying the value of NextMarker in the marker parameter.

    • NextMarker (string) --

      If IsTruncated is true, the value of NextMarker identifies the first health check that Amazon Route 53 returns if you submit another ListHealthChecks request and specify the value of NextMarker in the marker parameter.

    • MaxItems (string) --

      The value that you specified for the maxitems parameter in the call to ListHealthChecks that produced the current response.

ListTagsForResource (updated) Link ¶
Changes (request, response)
Request
{'ResourceType': {'healthchecksource'}}
Response
{'ResourceTagSet': {'ResourceType': {'healthchecksource'}}}

Lists tags for one health check or hosted zone.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resource(
    ResourceType='healthcheck'|'hostedzone'|'healthchecksource',
    ResourceId='string'
)
type ResourceType:

string

param ResourceType:

[REQUIRED]

The type of the resource.

  • The resource type for health checks is healthcheck.

  • The resource type for health check sources is healthchecksource.

  • The resource type for hosted zones is hostedzone.

type ResourceId:

string

param ResourceId:

[REQUIRED]

The ID of the resource for which you want to retrieve tags.

rtype:

dict

returns:

Response Syntax

{
    'ResourceTagSet': {
        'ResourceType': 'healthcheck'|'hostedzone'|'healthchecksource',
        'ResourceId': 'string',
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    }
}

Response Structure

  • (dict) --

    A complex type that contains information about the health checks or hosted zones for which you want to list tags.

    • ResourceTagSet (dict) --

      A ResourceTagSet containing tags associated with the specified resource.

      • ResourceType (string) --

        The type of the resource.

        • The resource type for health checks is healthcheck.

        • The resource type for health check sources is healthchecksource.

        • The resource type for hosted zones is hostedzone.

      • ResourceId (string) --

        The ID for the specified resource.

      • Tags (list) --

        The tags associated with the specified resource.

        • (dict) --

          A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

          • Key (string) --

            The value of Key depends on the operation that you want to perform:

            • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

            • Edit a tag: Key is the name of the tag that you want to change the Value for.

            • Delete a key: Key is the name of the tag you want to remove.

            • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you've given to each health check.

          • Value (string) --

            The value of Value depends on the operation that you want to perform:

            • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

            • Edit a tag: Value is the new value that you want to assign the tag.

ListTagsForResources (updated) Link ¶
Changes (request, response)
Request
{'ResourceType': {'healthchecksource'}}
Response
{'ResourceTagSets': {'ResourceType': {'healthchecksource'}}}

Lists tags for up to 10 health checks or hosted zones.

For information about using tags for cost allocation, see Using Cost Allocation Tags in the Billing and Cost Management User Guide.

See also: AWS API Documentation

Request Syntax

client.list_tags_for_resources(
    ResourceType='healthcheck'|'hostedzone'|'healthchecksource',
    ResourceIds=[
        'string',
    ]
)
type ResourceType:

string

param ResourceType:

[REQUIRED]

The type of the resources.

  • The resource type for health checks is healthcheck.

  • The resource type for health check sources is healthchecksource.

  • The resource type for hosted zones is hostedzone.

type ResourceIds:

list

param ResourceIds:

[REQUIRED]

A complex type that contains the ResourceId element for each resource for which you want to get a list of tags.

  • (string) --

rtype:

dict

returns:

Response Syntax

{
    'ResourceTagSets': [
        {
            'ResourceType': 'healthcheck'|'hostedzone'|'healthchecksource',
            'ResourceId': 'string',
            'Tags': [
                {
                    'Key': 'string',
                    'Value': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    A complex type containing tags for the specified resources.

    • ResourceTagSets (list) --

      A list of ``ResourceTagSet``s containing tags associated with the specified resources.

      • (dict) --

        A complex type containing a resource and its associated tags.

        • ResourceType (string) --

          The type of the resource.

          • The resource type for health checks is healthcheck.

          • The resource type for health check sources is healthchecksource.

          • The resource type for hosted zones is hostedzone.

        • ResourceId (string) --

          The ID for the specified resource.

        • Tags (list) --

          The tags associated with the specified resource.

          • (dict) --

            A complex type that contains information about a tag that you want to add or edit for the specified health check or hosted zone.

            • Key (string) --

              The value of Key depends on the operation that you want to perform:

              • Add a tag to a health check or hosted zone: Key is the name that you want to give the new tag.

              • Edit a tag: Key is the name of the tag that you want to change the Value for.

              • Delete a key: Key is the name of the tag you want to remove.

              • Give a name to a health check: Edit the default Name tag. In the Amazon Route 53 console, the list of your health checks includes a Name column that lets you see the name that you've given to each health check.

            • Value (string) --

              The value of Value depends on the operation that you want to perform:

              • Add a tag to a health check or hosted zone: Value is the value that you want to give the new tag.

              • Edit a tag: Value is the new value that you want to assign the tag.

UpdateHealthCheck (updated) Link ¶
Changes (request, response)
Request
{'HealthCheckSourceId': 'string'}
Response
{'HealthCheck': {'HealthCheckConfig': {'EndpointType': 'PUBLIC | PRIVATE',
                                       'HealthCheckSourceId': 'string'}}}

Updates an existing health check. Note that some values can't be updated.

For more information about updating health checks, see Creating, Updating, and Deleting Health Checks in the Amazon Route 53 Developer Guide.

See also: AWS API Documentation

Request Syntax

client.update_health_check(
    HealthCheckId='string',
    HealthCheckVersion=123,
    IPAddress='string',
    Port=123,
    ResourcePath='string',
    FullyQualifiedDomainName='string',
    SearchString='string',
    FailureThreshold=123,
    Inverted=True|False,
    Disabled=True|False,
    HealthThreshold=123,
    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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
        'Name': 'string'
    },
    InsufficientDataHealthStatus='Healthy'|'Unhealthy'|'LastKnownStatus',
    ResetElements=[
        'FullyQualifiedDomainName'|'Regions'|'ResourcePath'|'ChildHealthChecks',
    ],
    HealthCheckSourceId='string'
)
type HealthCheckId:

string

param HealthCheckId:

[REQUIRED]

The ID for the health check for which you want detailed information. When you created the health check, CreateHealthCheck returned the ID in the response, in the HealthCheckId element.

type HealthCheckVersion:

integer

param HealthCheckVersion:

A sequential counter that Amazon Route 53 sets to 1 when you create a health check and increments by 1 each time you update settings for the health check.

We recommend that you use GetHealthCheck or ListHealthChecks to get the current value of HealthCheckVersion for the health check that you want to update, and that you include that value in your UpdateHealthCheck request. This prevents Route 53 from overwriting an intervening update:

  • If the value in the UpdateHealthCheck request matches the value of HealthCheckVersion in the health check, Route 53 updates the health check with the new settings.

  • If the value of HealthCheckVersion in the health check is greater, the health check was changed after you got the version number. Route 53 does not update the health check, and it returns a HealthCheckVersionMismatch error.

type IPAddress:

string

param IPAddress:

The IPv4 or IPv6 IP address for the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address that is returned by DNS, Route 53 then checks the health of the endpoint.

Use one of the following formats for the value of IPAddress:

  • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

  • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance never changes. For more information, see the applicable documentation:

For more information, see FullyQualifiedDomainName.

Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

type Port:

integer

param Port:

The port on the endpoint that you want Amazon Route 53 to perform health checks on.

type ResourcePath:

string

param ResourcePath:

The path that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

Specify this value only if you want to change it.

type FullyQualifiedDomainName:

string

param FullyQualifiedDomainName:

Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

If you specify a value for IPAddress:

Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

  • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

  • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName: Port to the endpoint in the Host header.

If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the above cases.

If you don't specify a value for IPAddress:

If you don't specify a value for IPAddress, Route 53 sends a DNS request to the domain that you specify in FullyQualifiedDomainName at the interval you specify in RequestInterval. Using an IPv4 address that is returned by DNS, Route 53 then checks the health of the endpoint.

If you don't specify a value for IPAddress, you can’t update the health check to remove the FullyQualifiedDomainName; if you don’t specify a value for IPAddress on creation, a FullyQualifiedDomainName is required.

If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

In addition, if the value of Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

type SearchString:

string

param SearchString:

If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy. (You can't change the value of Type when you update a health check.)

type FailureThreshold:

integer

param FailureThreshold:

The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

type Inverted:

boolean

param Inverted:

Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

type Disabled:

boolean

param Disabled:

Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

  • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

  • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

  • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. Additionally, in disabled state, you can also invert the status of the health check to route traffic differently. For more information, see Inverted.

Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

type HealthThreshold:

integer

param HealthThreshold:

The number of child health checks that are associated with a CALCULATED health that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks and ChildHealthCheck elements.

Note the following:

  • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

  • If you specify 0, Route 53 always considers this health check to be healthy.

type ChildHealthChecks:

list

param ChildHealthChecks:

A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

  • (string) --

type EnableSNI:

boolean

param EnableSNI:

Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

type Regions:

list

param Regions:

A complex type that contains one Region element for each region that you want Amazon Route 53 health checkers to check the specified endpoint from.

  • (string) --

type AlarmIdentifier:

dict

param AlarmIdentifier:

A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

  • Region (string) -- [REQUIRED]

    For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

    For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

  • Name (string) -- [REQUIRED]

    The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

type InsufficientDataHealthStatus:

string

param InsufficientDataHealthStatus:

When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

  • Healthy: Route 53 considers the health check to be healthy.

  • Unhealthy: Route 53 considers the health check to be unhealthy.

  • LastKnownStatus: By default, Route 53 uses the status of the health check from the last time CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the status for the health check is healthy.

type ResetElements:

list

param ResetElements:

A complex type that contains one ResettableElementName element for each element that you want to reset to the default value. Valid values for ResettableElementName include the following:

  • (string) --

type HealthCheckSourceId:

string

param HealthCheckSourceId:

The ID of the health check source from which Route 53 sends requests to the endpoint. Applies only to health checks that have an EndpointType of PRIVATE. The health check source must be in the same account and have a status of CREATE_COMPLETED.

Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

rtype:

dict

returns:

Response Syntax

{
    'HealthCheck': {
        'Id': 'string',
        'CallerReference': 'string',
        'LinkedService': {
            'ServicePrincipal': 'string',
            'Description': 'string'
        },
        'HealthCheckConfig': {
            'IPAddress': 'string',
            'Port': 123,
            'Type': 'HTTP'|'HTTPS'|'HTTP_STR_MATCH'|'HTTPS_STR_MATCH'|'TCP'|'CALCULATED'|'CLOUDWATCH_METRIC'|'RECOVERY_CONTROL',
            'ResourcePath': 'string',
            'FullyQualifiedDomainName': 'string',
            'SearchString': 'string',
            'RequestInterval': 123,
            'FailureThreshold': 123,
            'MeasureLatency': True|False,
            'Inverted': True|False,
            'Disabled': True|False,
            'HealthThreshold': 123,
            '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'|'ap-east-2'|'eu-isoe-west-1'|'ap-southeast-6'|'us-isob-west-1'|'eusc-de-east-1',
                'Name': 'string'
            },
            'InsufficientDataHealthStatus': 'Healthy'|'Unhealthy'|'LastKnownStatus',
            'RoutingControlArn': 'string',
            'EndpointType': 'PUBLIC'|'PRIVATE',
            'HealthCheckSourceId': 'string'
        },
        'HealthCheckVersion': 123,
        'CloudWatchAlarmConfiguration': {
            'EvaluationPeriods': 123,
            'Threshold': 123.0,
            'ComparisonOperator': 'GreaterThanOrEqualToThreshold'|'GreaterThanThreshold'|'LessThanThreshold'|'LessThanOrEqualToThreshold',
            'Period': 123,
            'MetricName': 'string',
            'Namespace': 'string',
            'Statistic': 'Average'|'Sum'|'SampleCount'|'Maximum'|'Minimum',
            'Dimensions': [
                {
                    'Name': 'string',
                    'Value': 'string'
                },
            ]
        }
    }
}

Response Structure

  • (dict) --

    A complex type that contains the response to the UpdateHealthCheck request.

    • HealthCheck (dict) --

      A complex type that contains the response to an UpdateHealthCheck request.

      • Id (string) --

        The identifier that Amazon Route 53 assigned to the health check when you created it. When you add or update a resource record set, you use this value to specify which health check to use. The value can be up to 64 characters long.

      • CallerReference (string) --

        A unique string that you specified when you created the health check.

      • LinkedService (dict) --

        If the health check was created by another service, the service that created the health check. When a health check is created by another service, you can't edit or delete it using Amazon Route 53.

        • ServicePrincipal (string) --

          If the health check or hosted zone was created by another service, the service that created the resource. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

        • Description (string) --

          If the health check or hosted zone was created by another service, an optional description that can be provided by the other service. When a resource is created by another service, you can't edit or delete it using Amazon Route 53.

      • HealthCheckConfig (dict) --

        A complex type that contains detailed information about one health check.

        • IPAddress (string) --

          The IPv4 or IPv6 IP address of the endpoint that you want Amazon Route 53 to perform health checks on. If you don't specify a value for IPAddress, Route 53 sends a DNS request to resolve the domain name that you specify in FullyQualifiedDomainName at the interval that you specify in RequestInterval. Using an IP address returned by DNS, Route 53 then checks the health of the endpoint.

          Use one of the following formats for the value of IPAddress:

          • IPv4 address: four values between 0 and 255, separated by periods (.), for example, 192.0.2.44.

          • IPv6 address: eight groups of four hexadecimal values, separated by colons (:), for example, 2001:0db8:85a3:0000:0000:abcd:0001:2345. You can also shorten IPv6 addresses as described in RFC 5952, for example, 2001:db8:85a3::abcd:1:2345.

          For a public health check, if the endpoint is an EC2 instance, we recommend that you create an Elastic IP address, associate it with your EC2 instance, and specify the Elastic IP address for IPAddress. This ensures that the IP address of your instance will never change.

          For more information, see FullyQualifiedDomainName.

          Constraints: For a public health check ( EndpointType of PUBLIC, the default), Route 53 can't check the health of endpoints for which the IP address is in local, private, non-routable, or multicast ranges. For more information about IP addresses for which you can't create public health checks, see the following documents:

          For a private endpoint health check ( EndpointType of PRIVATE), if you specify IPAddress, it must be a private IPv4 or IPv6 address. Route 53 sends health checks to it from the health check source that you specify in HealthCheckSourceId.

          When the value of Type is CALCULATED or CLOUDWATCH_METRIC, omit IPAddress.

        • Port (integer) --

          The port on the endpoint that you want Amazon Route 53 to perform health checks on.

        • Type (string) --

          The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.

          You can create the following types of health checks:

          • HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.

          • HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.

          • TCP: Route 53 tries to establish a TCP connection.

          • CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.

          • CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.

          • RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.

          For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

        • ResourcePath (string) --

          The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, /welcome.html?language=jp&login=y.

        • FullyQualifiedDomainName (string) --

          Amazon Route 53 behavior depends on whether you specify a value for IPAddress.

          If you specify a value for IPAddress:

          Amazon Route 53 sends health check requests to the specified IPv4 or IPv6 address and passes the value of FullyQualifiedDomainName in the Host header for all health checks except TCP health checks. This is typically the fully qualified DNS name of the endpoint on which you want Route 53 to perform health checks.

          When Route 53 checks the health of an endpoint, here is how it constructs the Host header:

          • If you specify a value of 80 for Port and HTTP or HTTP_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify a value of 443 for Port and HTTPS or HTTPS_STR_MATCH for Type, Route 53 passes the value of FullyQualifiedDomainName to the endpoint in the Host header.

          • If you specify another value for Port and any value except TCP for Type, Route 53 passes FullyQualifiedDomainName:Port to the endpoint in the Host header.

          If you don't specify a value for FullyQualifiedDomainName, Route 53 substitutes the value of IPAddress in the Host header in each of the preceding cases.

          If you don't specify a value for IPAddress:

          Route 53 sends a DNS request to the domain that you specify for FullyQualifiedDomainName at the interval that you specify for RequestInterval. Using an IPv4 address that DNS returns, Route 53 then checks the health of the endpoint.

          If you want to check the health of weighted, latency, or failover resource record sets and you choose to specify the endpoint only by FullyQualifiedDomainName, we recommend that you create a separate health check for each endpoint. For example, create a health check for each HTTP server that is serving content for www.example.com. For the value of FullyQualifiedDomainName, specify the domain name of the server (such as us-east-2-www.example.com), not the name of the resource record sets (www.example.com).

          In addition, if the value that you specify for Type is HTTP, HTTPS, HTTP_STR_MATCH, or HTTPS_STR_MATCH, Route 53 passes the value of FullyQualifiedDomainName in the Host header, as it does when you specify a value for IPAddress. If the value of Type is TCP, Route 53 doesn't pass a Host header.

        • SearchString (string) --

          If the value of Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy.

          Route 53 considers case when searching for SearchString in the response body.

        • RequestInterval (integer) --

          The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval.

          RequestInterval is not supported when you specify a value for Type of RECOVERY_CONTROL.

          If you don't specify a value for RequestInterval, the default value is 30 seconds.

        • FailureThreshold (integer) --

          The number of consecutive health checks that an endpoint must pass or fail for Amazon Route 53 to change the current status of the endpoint from unhealthy to healthy or vice versa. For more information, see How Amazon Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.

          FailureThreshold is not supported when you specify a value for Type of RECOVERY_CONTROL.

          Otherwise, if you don't specify a value for FailureThreshold, the default value is three health checks.

        • MeasureLatency (boolean) --

          Specify whether you want Amazon Route 53 to measure the latency between health checkers in multiple Amazon Web Services regions and your endpoint, and to display CloudWatch latency graphs on the Health Checks page in the Route 53 console.

          MeasureLatency is not supported when you specify a value for Type of RECOVERY_CONTROL.

        • Inverted (boolean) --

          Specify whether you want Amazon Route 53 to invert the status of a health check, for example, to consider a health check unhealthy when it otherwise would be considered healthy.

        • Disabled (boolean) --

          Stops Route 53 from performing health checks. When you disable a health check, here's what happens:

          • Health checks that check the health of endpoints: Route 53 stops submitting requests to your application, server, or other resource.

          • Calculated health checks: Route 53 stops aggregating the status of the referenced health checks.

          • Health checks that monitor CloudWatch alarms: Route 53 stops monitoring the corresponding CloudWatch metrics.

          After you disable a health check, Route 53 considers the status of the health check to always be healthy. If you configured DNS failover, Route 53 continues to route traffic to the corresponding resources. If you want to stop routing traffic to a resource, change the value of Inverted.

          Charges for a health check still apply when the health check is disabled. For more information, see Amazon Route 53 Pricing.

        • HealthThreshold (integer) --

          The number of child health checks that are associated with a CALCULATED health check that Amazon Route 53 must consider healthy for the CALCULATED health check to be considered healthy. To specify the child health checks that you want to associate with a CALCULATED health check, use the ChildHealthChecks element.

          Note the following:

          • If you specify a number greater than the number of child health checks, Route 53 always considers this health check to be unhealthy.

          • If you specify 0, Route 53 always considers this health check to be healthy.

        • ChildHealthChecks (list) --

          (CALCULATED Health Checks Only) A complex type that contains one ChildHealthCheck element for each health check that you want to associate with a CALCULATED health check.

          • (string) --

        • EnableSNI (boolean) --

          Specify whether you want Amazon Route 53 to send the value of FullyQualifiedDomainName to the endpoint in the client_hello message during TLS negotiation. This allows the endpoint to respond to HTTPS health check requests with the applicable SSL/TLS certificate.

          Some endpoints require that HTTPS requests include the host name in the client_hello message. If you don't enable SNI, the status of the health check will be SSL alert handshake_failure. A health check can also have that status for other reasons. If SNI is enabled and you're still getting the error, check the SSL/TLS configuration on your endpoint and confirm that your certificate is valid.

          The SSL/TLS certificate on your endpoint includes a domain name in the Common Name field and possibly several more in the Subject Alternative Names field. One of the domain names in the certificate should match the value that you specify for FullyQualifiedDomainName. If the endpoint responds to the client_hello message with a certificate that does not include the domain name that you specified in FullyQualifiedDomainName, a health checker will retry the handshake. In the second attempt, the health checker will omit FullyQualifiedDomainName from the client_hello message.

        • Regions (list) --

          A complex type that contains one Region element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint.

          If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under Valid Values.

          If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).

          • (string) --

        • AlarmIdentifier (dict) --

          A complex type that identifies the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether the specified health check is healthy.

          • Region (string) --

            For the CloudWatch alarm that you want Route 53 health checkers to use to determine whether this health check is healthy, the region that the alarm was created in.

            For the current list of CloudWatch regions, see Amazon CloudWatch endpoints and quotas in the Amazon Web Services General Reference.

          • Name (string) --

            The name of the CloudWatch alarm that you want Amazon Route 53 health checkers to use to determine whether this health check is healthy.

        • InsufficientDataHealthStatus (string) --

          When CloudWatch has insufficient data about the metric to determine the alarm state, the status that you want Amazon Route 53 to assign to the health check:

          • Healthy: Route 53 considers the health check to be healthy.

          • Unhealthy: Route 53 considers the health check to be unhealthy.

          • LastKnownStatus: Route 53 uses the status of the health check from the last time that CloudWatch had sufficient data to determine the alarm state. For new health checks that have no last known status, the default status for the health check is healthy.

        • RoutingControlArn (string) --

          The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.

          For more information about Route 53 Application Recovery Controller, see Route 53 Application Recovery Controller Developer Guide..

        • EndpointType (string) --

          Specifies whether the health check targets a public endpoint or a private endpoint in a virtual private cloud (VPC). Valid values:

          • PUBLIC: The health check targets an endpoint that is reachable over the internet. This is the default.

          • PRIVATE: The health check targets a private endpoint in your virtual private cloud. You must also specify HealthCheckSourceId. PRIVATE isn't supported for health checks with a Type of CALCULATED, CLOUDWATCH_METRIC, or RECOVERY_CONTROL.

        • HealthCheckSourceId (string) --

          The ID of the health check source that Route 53 uses to send health checks to a private endpoint. Required when EndpointType is PRIVATE.

          You can change HealthCheckSourceId on an existing private health check. You can't add it to a public health check.

          Each health check source supports a limited number of active health checks. If you reach that limit, specify a different health check source.

      • HealthCheckVersion (integer) --

        The version of the health check. You can optionally pass this value in a call to UpdateHealthCheck to prevent overwriting another change to the health check.

      • CloudWatchAlarmConfiguration (dict) --

        A complex type that contains information about the CloudWatch alarm that Amazon Route 53 is monitoring for this health check.

        • EvaluationPeriods (integer) --

          For the metric that the CloudWatch alarm is associated with, the number of periods that the metric is compared to the threshold.

        • Threshold (float) --

          For the metric that the CloudWatch alarm is associated with, the value the metric is compared with.

        • ComparisonOperator (string) --

          For the metric that the CloudWatch alarm is associated with, the arithmetic operation that is used for the comparison.

        • Period (integer) --

          For the metric that the CloudWatch alarm is associated with, the duration of one evaluation period in seconds.

        • MetricName (string) --

          The name of the CloudWatch metric that the alarm is associated with.

        • Namespace (string) --

          The namespace of the metric that the alarm is associated with. For more information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

        • Statistic (string) --

          For the metric that the CloudWatch alarm is associated with, the statistic that is applied to the metric.

        • Dimensions (list) --

          For the metric that the CloudWatch alarm is associated with, a complex type that contains information about the dimensions for the metric. For information, see Amazon CloudWatch Namespaces, Dimensions, and Metrics Reference in the Amazon CloudWatch User Guide.

          • (dict) --

            For the metric that the CloudWatch alarm is associated with, a complex type that contains information about one dimension.

            • Name (string) --

              For the metric that the CloudWatch alarm is associated with, the name of one dimension.

            • Value (string) --

              For the metric that the CloudWatch alarm is associated with, the value of one dimension.