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.
Creates and updates the configuration aggregator with the selected source accounts and regions. The source account can be individual account(s) or an organization.
accountIds
that are passed will be replaced with existing accounts. If you
want to add additional accounts into the aggregator, call DescribeConfigurationAggregators
to get the previous accounts and then append new ones.
Config should be enabled in source accounts and regions you want to aggregate.
If your source type is an organization, you must be signed in to the management account
or a registered delegated administrator and all the features must be enabled in your
organization. If the caller is a management account, Config calls EnableAwsServiceAccess
API to enable integration between Config and Organizations. If the caller is a registered
delegated administrator, Config calls ListDelegatedAdministrators
API to verify
whether the caller is a valid delegated administrator.
To register a delegated administrator, see Register a Delegated Administrator in the Config developer guide.
PutConfigurationAggregator
is an idempotent API. Subsequent requests won’t
create a duplicate resource if one was already created. If a following request has
different tags
values, Config will ignore these differences and treat it as
an idempotent request of the previous. In this case, tags
will not be updated,
even if they are different.
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 BeginPutConfigurationAggregator and EndPutConfigurationAggregator.
Namespace: Amazon.ConfigService
Assembly: AWSSDK.ConfigService.dll
Version: 3.x.y.z
public abstract Task<PutConfigurationAggregatorResponse> PutConfigurationAggregatorAsync( PutConfigurationAggregatorRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the PutConfigurationAggregator service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
Exception | Condition |
---|---|
InvalidParameterValueException | One or more of the specified parameters are not valid. Verify that your parameters are valid and try again. |
InvalidRoleException | You have provided a null or empty Amazon Resource Name (ARN) for the IAM role assumed by Config and used by the configuration recorder. |
LimitExceededException | For StartConfigRulesEvaluation API, this exception is thrown if an evaluation is in progress or if you call the StartConfigRulesEvaluation API more than once per minute. For PutConfigurationAggregator API, this exception is thrown if the number of accounts and aggregators exceeds the limit. |
NoAvailableOrganizationException | Organization is no longer available. |
OrganizationAccessDeniedException | For PutConfigurationAggregator API, you can see this exception for the following reasons: No permission to call EnableAWSServiceAccess API The configuration aggregator cannot be updated because your Amazon Web Services Organization management account or the delegated administrator role changed. Delete this aggregator and create a new one with the current Amazon Web Services Organization. The configuration aggregator is associated with a previous Amazon Web Services Organization and Config cannot aggregate data with current Amazon Web Services Organization. Delete this aggregator and create a new one with the current Amazon Web Services Organization. You are not a registered delegated administrator for Config with permissions to call ListDelegatedAdministrators API. Ensure that the management account registers delagated administrator for Config service principle name before the delegated administrator creates an aggregator. For all OrganizationConfigRule and OrganizationConformancePack APIs, Config throws an exception if APIs are called from member accounts. All APIs must be called from organization management account. |
OrganizationAllFeaturesNotEnabledException | Config resource cannot be created because your organization does not have all features enabled. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5