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
)