Skip to content

Modifies an existing application status check

Description

Modifies an existing application status check. You can update the protocol, port, path, thresholds, and other configuration settings. The following rules apply:

  • The application status check must exist and belong to your account.
  • Changes take effect on the next health check interval.

Usage

ec2_modify_application_status_check(ApplicationStatusCheckId,
  Aggregation, HealthCheckPaths, Protocol, Port, Path, DeviceIndex,
  IpVersion, IpScope, Interval, Timeout, FailureThreshold,
  SuccessThreshold, StatusCodeMatcher, InitializationGracePeriodSeconds,
  ClientToken, DryRun)

Arguments

  • ApplicationStatusCheckId

[required] The ID of the application status check to modify.

  • Aggregation

The aggregation setting for the application status check. When set to included, the result of this check contributes to the instance-level application status reported by describe_application_status. When set to excluded, the check runs independently and does not affect the instance-level status. Valid values: included | excluded.

  • HealthCheckPaths

The health check paths to use for the application status check.

  • Protocol

The protocol to use for the health check. Valid values: http | https.

  • Port

The port to use for the health check. Valid values: 1 to 65535.

  • Path

The URL path to use for the health check HTTP request (for example, /health or /status).

  • DeviceIndex

The index of the network device to use for the health check. The value must be greater than or equal to 0.

  • IpVersion

The IP version to use for the health check. Valid values: ipv4 and ipv6.

  • IpScope

The IP scope to use for the health check. Valid value: private.

  • Interval

The interval, in seconds, between health checks. Valid value: 60.

  • Timeout

The amount of time, in seconds, to wait for a health check response before considering it failed. Valid values: 1 to 30. The value must be less than Interval.

  • FailureThreshold

The number of consecutive failed health checks before the application status is considered impaired. The value must be greater than 0.

  • SuccessThreshold

The number of consecutive successful health checks before the application status is considered healthy. The value must be greater than 0.

  • StatusCodeMatcher

The HTTP status codes that indicate a successful health check response. Specify a comma-separated list of individual status codes or ranges, for example, 200,202,300-399. For a range, the first value must be less than the second value. Maximum length: 64 characters.

  • InitializationGracePeriodSeconds

The number of seconds to wait before starting health checks after an instance is launched. Valid values: 1 to 600.

  • ClientToken

A unique, case-sensitive identifier that you provide to ensure that the operation completes no more than one time. If you retry a request with the same token, the service ignores the request but does not return an error. For more information, see Ensuring idempotency.

  • DryRun

Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Value

A list with the following syntax:

list(
  ApplicationStatusCheck = list(
    ApplicationStatusCheckId = "string",
    Aggregation = "included"|"excluded",
    HealthCheckPaths = list(
      list(
        Source = list(
          SubnetId = "string",
          SecurityGroupId = "string"
        ),
        Destinations = list(
          list(
            SubnetId = "string",
            SecurityGroupId = "string"
          )
        )
      )
    ),
    Protocol = "http"|"https",
    Port = 123,
    Path = "string",
    DeviceIndex = 123,
    IpVersion = "ipv4"|"ipv6",
    IpScope = "private",
    Interval = 123,
    Timeout = 123,
    FailureThreshold = 123,
    SuccessThreshold = 123,
    StatusCodeMatcher = "string",
    InitializationGracePeriodSeconds = 123,
    LastUpdatedAt = as.POSIXct(
      "2015-01-01"
    ),
    TargetTagAssociations = list(
      list(
        Key = "string",
        Value = "string"
      )
    ),
    Tags = list(
      list(
        Key = "string",
        Value = "string"
      )
    ),
    CreationTime = as.POSIXct(
      "2015-01-01"
    ),
    ModifyTime = as.POSIXct(
      "2015-01-01"
    ),
    DeletionTime = as.POSIXct(
      "2015-01-01"
    )
  )
)

Request syntax

svc$modify_application_status_check(
  ApplicationStatusCheckId = "string",
  Aggregation = "included"|"excluded",
  HealthCheckPaths = list(
    list(
      Source = list(
        SubnetId = "string",
        SecurityGroupId = "string"
      ),
      Destinations = list(
        list(
          SubnetId = "string",
          SecurityGroupId = "string"
        )
      )
    )
  ),
  Protocol = "http"|"https",
  Port = 123,
  Path = "string",
  DeviceIndex = 123,
  IpVersion = "ipv4"|"ipv6",
  IpScope = "private",
  Interval = 123,
  Timeout = 123,
  FailureThreshold = 123,
  SuccessThreshold = 123,
  StatusCodeMatcher = "string",
  InitializationGracePeriodSeconds = 123,
  ClientToken = "string",
  DryRun = TRUE|FALSE
)