Request Parameters Response Elements Errors Examples See Also

DisassociateApplicationStatusCheck

Disassociates an application status check from instances or tags. After disassociation, health monitoring stops for the affected instances. The following rules apply:

You must specify either TargetTagAssociations or InstanceIds, but not both. Specifying both results in an InvalidParameterCombination error.
The application status check must already exist and belong to your account.
Tag keys must not be blank.

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.

ApplicationStatusCheckId

The ID of the application status check to disassociate.

Type: String

Required: Yes

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

InstanceId.N

The IDs of the instances to disassociate from the application status check.

Type: Array of strings

Required: No

TargetTagAssociation.N

The tags to disassociate from the application status check. Specify the same key-value pairs that were used during association.

Type: Array of CustomTagKeyValueRequestPair objects

Required: No

Response Elements

The following elements are returned by the service.

requestId

The ID of the request.

Type: String

successfulResultSet

The associations that were successfully removed.

Type: Array of SuccessfulAssociationResponseObject objects

unsuccessfulResultSet

The associations that failed to be removed.

Type: Array of UnsuccessfulAssociationResponseObject objects

Errors

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

Examples

To disassociate an application status check from instances

This example disassociates an application status check from the specified instance.

Sample Request


https://ec2.amazonaws.com/?Action=DisassociateApplicationStatusCheck
&ApplicationStatusCheckId=asc-0123456789abcdef0
&InstanceId.1=i-0123456789abcdef0
&AUTHPARAMS

Sample Response


<DisassociateApplicationStatusCheckResult xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
    <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
    <successfulResultSet>
        <item>
            <applicationStatusCheckId>asc-0123456789abcdef0</applicationStatusCheckId>
            <associationType>instance</associationType>
            <associationValue>i-0123456789abcdef0</associationValue>
        </item>
    </successfulResultSet>
</DisassociateApplicationStatusCheckResult>

To disassociate an application status check from tags

The following example disassociates an application status check from instances with the specified tag.

Sample Request


https://ec2.amazonaws.com/?Action=DisassociateApplicationStatusCheck
&ApplicationStatusCheckId=asc-0123456789abcdef0
&TargetTagAssociation.1.Key=environment
&TargetTagAssociation.1.Value=production
&AUTHPARAMS

Sample Response


<DisassociateApplicationStatusCheckResult xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
    <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
    <successfulResultSet>
        <item>
            <applicationStatusCheckId>asc-0123456789abcdef0</applicationStatusCheckId>
            <associationType>tag</associationType>
            <associationValue>environment=production</associationValue>
        </item>
    </successfulResultSet>
</DisassociateApplicationStatusCheckResult>