/ - AWS Config

Returns the resource counts across accounts and regions that are present in your Config aggregator. You can request the resource counts by providing filters and GroupByKey.

For example, if the input contains accountID 12345678910 and region us-east-1 in filters, the API returns the count of resources in account ID 12345678910 and region us-east-1. If the input contains ACCOUNT_ID as a GroupByKey, the API returns resource counts for all source accounts that are present in your aggregator.

curl --location --request POST '/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "ConfigurationAggregatorName": "string", "Filters": { "ResourceType": "AWS::EC2::CustomerGateway", "AccountId": "string", "Region": "string" }, "GroupByKey": "RESOURCE_TYPE", "Limit": 0, "NextToken": "string" }'

Request

Query Params

Limit

string

optional

Pagination limit

NextToken

string

optional

Pagination token

Header Params

X-Amz-Target

string

required

Body Params application/json

ConfigurationAggregatorName

string

required

The name of the configuration aggregator.

>= 1 characters<= 256 characters

Match pattern:

[\w\-]+

Filters

object

optional

Filters the results based on the ResourceCountFilters object.

ResourceType

enum<string>

optional

The type of the Amazon Web Services resource.

Allowed values:

AWS::EC2::CustomerGatewayAWS::EC2::EIPAWS::EC2::HostAWS::EC2::InstanceAWS::EC2::InternetGatewayAWS::EC2::NetworkAclAWS::EC2::NetworkInterfaceAWS::EC2::RouteTableAWS::EC2::SecurityGroupAWS::EC2::SubnetAWS::CloudTrail::TrailAWS::EC2::VolumeAWS::EC2::VPCAWS::EC2::VPNConnectionAWS::EC2::VPNGatewayAWS::EC2::RegisteredHAInstanceAWS::EC2::NatGatewayAWS::EC2::EgressOnlyInternetGatewayAWS::EC2::VPCEndpointAWS::EC2::VPCEndpointServiceAWS::EC2::FlowLogAWS::EC2::VPCPeeringConnectionAWS::Elasticsearch::DomainAWS::IAM::GroupAWS::IAM::PolicyAWS::IAM::RoleAWS::IAM::UserAWS::ElasticLoadBalancingV2::LoadBalancerAWS::ACM::CertificateAWS::RDS::DBInstanceAWS::RDS::DBSubnetGroupAWS::RDS::DBSecurityGroupAWS::RDS::DBSnapshotAWS::RDS::DBClusterAWS::RDS::DBClusterSnapshotAWS::RDS::EventSubscriptionAWS::S3::BucketAWS::S3::AccountPublicAccessBlockAWS::Redshift::ClusterAWS::Redshift::ClusterSnapshotAWS::Redshift::ClusterParameterGroupAWS::Redshift::ClusterSecurityGroupAWS::Redshift::ClusterSubnetGroupAWS::Redshift::EventSubscriptionAWS::SSM::ManagedInstanceInventoryAWS::CloudWatch::AlarmAWS::CloudFormation::StackAWS::ElasticLoadBalancing::LoadBalancerAWS::AutoScaling::AutoScalingGroupAWS::AutoScaling::LaunchConfigurationAWS::AutoScaling::ScalingPolicyAWS::AutoScaling::ScheduledActionAWS::DynamoDB::TableAWS::CodeBuild::ProjectAWS::WAF::RateBasedRuleAWS::WAF::RuleAWS::WAF::RuleGroupAWS::WAF::WebACLAWS::WAFRegional::RateBasedRuleAWS::WAFRegional::RuleAWS::WAFRegional::RuleGroupAWS::WAFRegional::WebACLAWS::CloudFront::DistributionAWS::CloudFront::StreamingDistributionAWS::Lambda::FunctionAWS::NetworkFirewall::FirewallAWS::NetworkFirewall::FirewallPolicyAWS::NetworkFirewall::RuleGroupAWS::ElasticBeanstalk::ApplicationAWS::ElasticBeanstalk::ApplicationVersionAWS::ElasticBeanstalk::EnvironmentAWS::WAFv2::WebACLAWS::WAFv2::RuleGroupAWS::WAFv2::IPSetAWS::WAFv2::RegexPatternSetAWS::WAFv2::ManagedRuleSetAWS::XRay::EncryptionConfigAWS::SSM::AssociationComplianceAWS::SSM::PatchComplianceAWS::Shield::ProtectionAWS::ShieldRegional::ProtectionAWS::Config::ConformancePackComplianceAWS::Config::ResourceComplianceAWS::ApiGateway::StageAWS::ApiGateway::RestApiAWS::ApiGatewayV2::StageAWS::ApiGatewayV2::ApiAWS::CodePipeline::PipelineAWS::ServiceCatalog::CloudFormationProvisionedProductAWS::ServiceCatalog::CloudFormationProductAWS::ServiceCatalog::PortfolioAWS::SQS::QueueAWS::KMS::KeyAWS::QLDB::LedgerAWS::SecretsManager::SecretAWS::SNS::TopicAWS::SSM::FileDataAWS::Backup::BackupPlanAWS::Backup::BackupSelectionAWS::Backup::BackupVaultAWS::Backup::RecoveryPointAWS::ECR::RepositoryAWS::ECS::ClusterAWS::ECS::ServiceAWS::ECS::TaskDefinitionAWS::EFS::AccessPointAWS::EFS::FileSystemAWS::EKS::ClusterAWS::OpenSearch::DomainAWS::EC2::TransitGatewayAWS::Kinesis::StreamAWS::Kinesis::StreamConsumerAWS::CodeDeploy::ApplicationAWS::CodeDeploy::DeploymentConfigAWS::CodeDeploy::DeploymentGroupAWS::EC2::LaunchTemplateAWS::ECR::PublicRepositoryAWS::GuardDuty::DetectorAWS::EMR::SecurityConfigurationAWS::SageMaker::CodeRepositoryAWS::Route53Resolver::ResolverEndpointAWS::Route53Resolver::ResolverRuleAWS::Route53Resolver::ResolverRuleAssociationAWS::DMS::ReplicationSubnetGroupAWS::DMS::EventSubscriptionAWS::MSK::ClusterAWS::StepFunctions::ActivityAWS::WorkSpaces::WorkspaceAWS::WorkSpaces::ConnectionAliasAWS::SageMaker::ModelAWS::ElasticLoadBalancingV2::ListenerAWS::StepFunctions::StateMachineAWS::Batch::JobQueueAWS::Batch::ComputeEnvironmentAWS::AccessAnalyzer::AnalyzerAWS::Athena::WorkGroupAWS::Athena::DataCatalogAWS::Detective::GraphAWS::GlobalAccelerator::AcceleratorAWS::GlobalAccelerator::EndpointGroupAWS::GlobalAccelerator::ListenerAWS::EC2::TransitGatewayAttachmentAWS::EC2::TransitGatewayRouteTableAWS::DMS::CertificateAWS::AppConfig::ApplicationAWS::AppSync::GraphQLApiAWS::DataSync::LocationSMBAWS::DataSync::LocationFSxLustreAWS::DataSync::LocationS3AWS::DataSync::LocationEFSAWS::DataSync::TaskAWS::DataSync::LocationNFSAWS::EC2::NetworkInsightsAccessScopeAnalysisAWS::EKS::FargateProfileAWS::Glue::JobAWS::GuardDuty::ThreatIntelSetAWS::GuardDuty::IPSetAWS::SageMaker::WorkteamAWS::SageMaker::NotebookInstanceLifecycleConfigAWS::ServiceDiscovery::ServiceAWS::ServiceDiscovery::PublicDnsNamespaceAWS::SES::ContactListAWS::SES::ConfigurationSetAWS::Route53::HostedZoneAWS::IoTEvents::InputAWS::IoTEvents::DetectorModelAWS::IoTEvents::AlarmModelAWS::ServiceDiscovery::HttpNamespaceAWS::Events::EventBusAWS::ImageBuilder::ContainerRecipeAWS::ImageBuilder::DistributionConfigurationAWS::ImageBuilder::InfrastructureConfigurationAWS::DataSync::LocationObjectStorageAWS::DataSync::LocationHDFSAWS::Glue::ClassifierAWS::Route53RecoveryReadiness::CellAWS::Route53RecoveryReadiness::ReadinessCheckAWS::ECR::RegistryPolicyAWS::Backup::ReportPlanAWS::Lightsail::CertificateAWS::RUM::AppMonitorAWS::Events::EndpointAWS::SES::ReceiptRuleSetAWS::Events::ArchiveAWS::Events::ApiDestinationAWS::Lightsail::DiskAWS::FIS::ExperimentTemplateAWS::DataSync::LocationFSxWindowsAWS::SES::ReceiptFilterAWS::GuardDuty::FilterAWS::SES::TemplateAWS::AmazonMQ::BrokerAWS::AppConfig::EnvironmentAWS::AppConfig::ConfigurationProfileAWS::Cloud9::EnvironmentEC2AWS::EventSchemas::RegistryAWS::EventSchemas::RegistryPolicyAWS::EventSchemas::DiscovererAWS::FraudDetector::LabelAWS::FraudDetector::EntityTypeAWS::FraudDetector::VariableAWS::FraudDetector::OutcomeAWS::IoT::AuthorizerAWS::IoT::SecurityProfileAWS::IoT::RoleAliasAWS::IoT::DimensionAWS::IoTAnalytics::DatastoreAWS::Lightsail::BucketAWS::Lightsail::StaticIpAWS::MediaPackage::PackagingGroupAWS::Route53RecoveryReadiness::RecoveryGroupAWS::ResilienceHub::ResiliencyPolicyAWS::Transfer::WorkflowAWS::EKS::IdentityProviderConfigAWS::EKS::AddonAWS::Glue::MLTransformAWS::IoT::PolicyAWS::IoT::MitigationActionAWS::IoTTwinMaker::WorkspaceAWS::IoTTwinMaker::EntityAWS::IoTAnalytics::DatasetAWS::IoTAnalytics::PipelineAWS::IoTAnalytics::ChannelAWS::IoTSiteWise::DashboardAWS::IoTSiteWise::ProjectAWS::IoTSiteWise::PortalAWS::IoTSiteWise::AssetModelAWS::IVS::ChannelAWS::IVS::RecordingConfigurationAWS::IVS::PlaybackKeyPairAWS::KinesisAnalyticsV2::ApplicationAWS::RDS::GlobalClusterAWS::S3::MultiRegionAccessPointAWS::DeviceFarm::TestGridProjectAWS::Budgets::BudgetsActionAWS::Lex::BotAWS::CodeGuruReviewer::RepositoryAssociationAWS::IoT::CustomMetricAWS::Route53Resolver::FirewallDomainListAWS::RoboMaker::RobotApplicationVersionAWS::EC2::TrafficMirrorSessionAWS::IoTSiteWise::GatewayAWS::Lex::BotAliasAWS::LookoutMetrics::AlertAWS::IoT::AccountAuditConfigurationAWS::EC2::TrafficMirrorTargetAWS::S3::StorageLensAWS::IoT::ScheduledAuditAWS::Events::ConnectionAWS::EventSchemas::SchemaAWS::MediaPackage::PackagingConfigurationAWS::KinesisVideo::SignalingChannelAWS::AppStream::DirectoryConfigAWS::LookoutVision::ProjectAWS::Route53RecoveryControl::ClusterAWS::Route53RecoveryControl::SafetyRuleAWS::Route53RecoveryControl::ControlPanelAWS::Route53RecoveryControl::RoutingControlAWS::Route53RecoveryReadiness::ResourceSetAWS::RoboMaker::SimulationApplicationAWS::RoboMaker::RobotApplicationAWS::HealthLake::FHIRDatastoreAWS::Pinpoint::SegmentAWS::Pinpoint::ApplicationSettingsAWS::Events::RuleAWS::EC2::DHCPOptionsAWS::EC2::NetworkInsightsPathAWS::EC2::TrafficMirrorFilterAWS::EC2::IPAMAWS::IoTTwinMaker::SceneAWS::NetworkManager::TransitGatewayRegistrationAWS::CustomerProfiles::DomainAWS::AutoScaling::WarmPoolAWS::Connect::PhoneNumber

AccountId

string

optional

The 12-digit ID of the account.

Match pattern:

\d{12}

Region

string

optional

The region where the account is located.

>= 1 characters<= 64 characters

GroupByKey

enum<string>

optional

The key to group the resource counts.

Allowed values:

RESOURCE_TYPEACCOUNT_IDAWS_REGION

Limit

integer

optional

The maximum number of GroupedResourceCount objects returned on each page. The default is 1000. You cannot specify a number greater than 1000. If you specify 0, Config uses the default.

>= 0<= 1000

NextToken

string

optional

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

Examples

Responses

🟢200Success

application/json

Body

TotalDiscoveredResources

integer

required

The total number of resources that are present in an aggregator with the filters that you provide.

GroupByKey

string

optional

The key passed into the request object. If GroupByKey is not provided, the result will be empty.

>= 1 characters<= 256 characters

GroupedResourceCounts

array[object (GroupedResourceCount) {2}]

optional

Returns a list of GroupedResourceCount objects.

GroupName

string

required

The name of the group that can be region, account ID, or resource type. For example, region1, region2 if the region was chosen as GroupByKey.

>= 1 characters<= 256 characters

ResourceCount

integer

required

The number of resources in the group.

NextToken

string

optional

The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

🟠480ValidationException

🟠481InvalidLimitException

🟠482InvalidNextTokenException

🟠483NoSuchConfigurationAggregatorException