/ - AWS Config

Accepts a resource type and returns a list of resource identifiers that are aggregated for a specific resource type across accounts and regions. A resource identifier includes the resource type, ID, (if available) the custom resource name, source account, and source region. You can narrow the results to include only resources that have specific resource IDs, or a resource name, or source account ID, or source region.

For example, if the input consists of accountID 12345678910 and the region is us-east-1 for resource type AWS::EC2::Instance then the API returns all the EC2 instance identifiers of accountID 12345678910 and region us-east-1.

curl --location --request POST '/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "ConfigurationAggregatorName": "string", "ResourceType": "AWS::EC2::CustomerGateway", "Filters": { "AccountId": "string", "ResourceId": "string", "ResourceName": "string", "Region": "string" }, "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\-]+

ResourceType

enum<string>

required

The type of resources that you want Config to list in the response.

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

Filters

object

optional

Filters the results based on the ResourceFilters object.

AccountId

string

optional

The 12-digit source account ID.

Match pattern:

\d{12}

ResourceId

string

optional

The ID of the resource.

>= 1 characters<= 768 characters

ResourceName

string

optional

The name of the resource.

Region

string

optional

The source region.

>= 1 characters<= 64 characters

Limit

integer

optional

The maximum number of resource identifiers returned on each page. You cannot specify a number greater than 100. If you specify 0, Config uses the default.

>= 0<= 100

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

ResourceIdentifiers

array[object (AggregateResourceIdentifier) {5}]

optional

Returns a list of ResourceIdentifiers objects.

SourceAccountId

string

required

The 12-digit account ID of the source account.

Match pattern:

\d{12}

SourceRegion

string

required

The source region where data is aggregated.

>= 1 characters<= 64 characters

ResourceId

string

required

The ID of the Amazon Web Services resource.

>= 1 characters<= 768 characters

ResourceType

enum<string>

required

The type of the Amazon Web Services resource.

Allowed values:

ResourceName

string

optional

The name of the Amazon Web Services resource.

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