AWS SDK Version 3 for .NET
API Reference

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.

Runs an on-demand evaluation for the specified resource to determine whether the resource details will comply with configured Config rules. You can also use it for evaluation purposes. Config recommends using an evaluation context. It runs an execution against the resource details with all of the Config rules in your account that match with the specified proactive mode and resource type.

Ensure you have the cloudformation:DescribeType role setup to validate the resource type schema.

You can find the Resource type schema in "Amazon Web Services public extensions" within the CloudFormation registry or with the following CLI commmand: aws cloudformation describe-type --type-name "AWS::S3::Bucket" --type RESOURCE.

For more information, see Managing extensions through the CloudFormation registry and Amazon Web Services resource and property types reference in the CloudFormation User Guide.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginStartResourceEvaluation and EndStartResourceEvaluation.

Namespace: Amazon.ConfigService
Assembly: AWSSDK.ConfigService.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<StartResourceEvaluationResponse> StartResourceEvaluationAsync(
         StartResourceEvaluationRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.ConfigService.Model.StartResourceEvaluationRequest

Container for the necessary parameters to execute the StartResourceEvaluation service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the StartResourceEvaluation service method, as returned by ConfigService.

Exceptions

ExceptionCondition
IdempotentParameterMismatchException Using the same client token with one or more different parameters. Specify a new client token with the parameter changes and try again.
InvalidParameterValueException One or more of the specified parameters are not valid. Verify that your parameters are valid and try again.

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5 and newer

See Also