View a markdown version of this page

EnableApplicationStatusCheckSuppression - Amazon Elastic Compute Cloud

EnableApplicationStatusCheckSuppression

Suppresses application status checks for the specified instances. While suppressed, health checks continue to run but do not affect the instance-level application status. The following rules apply:

  • Maximum 100 instance IDs per request.

  • Use DisableApplicationStatusCheckSuppression to resume normal health check reporting.

  • If you do not specify DurationSeconds, suppression continues indefinitely until you call DisableApplicationStatusCheckSuppression.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

ClientToken

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

Type: String

Required: No

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.

Type: Boolean

Required: No

DurationSeconds

The duration, in seconds, for which to suppress application status checks. If omitted, the application status check is suppressed indefinitely until you call DisableApplicationStatusCheckSuppression.

Type: Integer

Required: No

InstanceId.N

The IDs of the instances for which to suppress application status checks.

Type: Array of strings

Required: No

Response Elements

The following elements are returned by the service.

requestId

The ID of the request.

Type: String

successfulResultSet

The instances for which suppression was successfully enabled.

Type: Array of SuccessfulSuppressionResponseObject objects

unsuccessfulResultSet

The instances for which suppression failed to be enabled.

Type: Array of UnsuccessfulSuppressionResponseObject objects

Errors

For information about the errors that are common to all actions, see Common Error Types.

Examples

To enable application status check suppression

This example enables suppression for the specified instance.

Sample Request

https://ec2.amazonaws.com/?Action=EnableApplicationStatusCheckSuppression &InstanceId.1=i-0123456789abcdef0 &DurationSeconds=3600 &AUTHPARAMS

Sample Response

<EnableApplicationStatusCheckSuppressionResult xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> <successfulResultSet> <item> <instanceId>i-0123456789abcdef0</instanceId> <suppressAt>1609459200000</suppressAt> <resumeAt>1609462800000</resumeAt> </item> </successfulResultSet> </EnableApplicationStatusCheckSuppressionResult>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: