AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Indicates whether the specified Config rules are compliant. If a rule is noncompliant, this action returns the number of Amazon Web Services resources that do not comply with the rule.
A rule is compliant if all of the evaluated resources comply with it. It is noncompliant if any of these resources do not comply.
If Config has no current evaluation results for the rule, it returns INSUFFICIENT_DATA
.
This result might indicate one of the following conditions:
Config has never invoked an evaluation for the rule. To check whether it has, use
the DescribeConfigRuleEvaluationStatus
action to get the LastSuccessfulInvocationTime
and LastFailedInvocationTime
.
The rule's Lambda function is failing to send evaluation results to Config. Verify
that the role you assigned to your configuration recorder includes the config:PutEvaluations
permission. If the rule is a custom rule, verify that the Lambda execution role includes
the config:PutEvaluations
permission.
The rule's Lambda function has returned NOT_APPLICABLE
for all evaluation results.
This can occur if the resources were deleted or removed from the rule's scope.
For .NET Core this operation is only available in asynchronous form. Please refer to DescribeComplianceByConfigRuleAsync.
Namespace: Amazon.ConfigService
Assembly: AWSSDK.ConfigService.dll
Version: 3.x.y.z
public abstract DescribeComplianceByConfigRuleResponse DescribeComplianceByConfigRule( DescribeComplianceByConfigRuleRequest request )
Container for the necessary parameters to execute the DescribeComplianceByConfigRule service method.
Exception | Condition |
---|---|
InvalidNextTokenException | The specified next token is not valid. Specify the nextToken string that was returned in the previous response to get the next page of results. |
InvalidParameterValueException | One or more of the specified parameters are not valid. Verify that your parameters are valid and try again. |
NoSuchConfigRuleException | The Config rule in the request is not valid. Verify that the rule is an Config Process Check rule, that the rule name is correct, and that valid Amazon Resouce Names (ARNs) are used before trying again. |
.NET Framework:
Supported in: 4.5 and newer, 3.5