探索資源

使用list-resources命令探索和中目前佈建的 AWS 帳戶 資源 AWS 區域。這包括指定資源類型的所有資源，無論這些資源是透過 Cloud Control API 佈建、直接透過基礎服務或其他機制 (例如成為 AWS CloudFormation 堆疊的一部分) 進行佈建。

針對每個資源傳回的資訊包括：

• 資源的主要識別碼。

• 或者，它可以包括零件或所有資源的屬性，詳細說明資源的目前狀態。如需詳細資訊，請參閱 檢視資源類型綱要。

下列範例會傳回AWS::Logs::LogGroup資源清單。

$ aws cloudcontrol list-resources --type-name AWS::Logs::LogGroup

Cloud Control API 會傳回您帳戶中指定資源類型的資源清單。例如，list-resources傳回帳戶中所有資源的主要識別碼和AWS::Logs::LogGroup資源屬性，無論這些資源是否由 Cloud Control API 佈建。根據您帳戶中的資源，傳回的資訊類似下列。

{
  "TypeName": "AWS::Logs::LogGroup",
  "ResourceDescriptions":
  [
    {
      "Identifier": "CloudControlExample", 
      "Properties": '{"RetentionInDays":180, "LogGroupName": "CloudControlExample", "Arn": "arn:aws:logs:us-west-2:123456789012:log-group:CloudControlExample:*"}'
    },
    {
      "Identifier": "AnotherLogGroupResourceExample", 
      "Properties": '{"RetentionInDays":90, "LogGroupName": "AnotherLogGroupResourceExample", "Arn": "arn:aws:logs:us-west-2:123456789012:log-group:AnotherLogGroupResourceExample:*"}'
    }
  ]
}

下列範例會要求AWS::Kinesis::Stream資源清單。

$ aws cloudcontrol list-resources --type-name AWS::Kinesis::Stream

針對 Kinesis 串流，雲端控制 API 會傳回每個串流的主要識別碼，以及資源屬性的子集。在這種情況下，只是一個單一的屬性，Name. 然後，您可以使用流的主標識符get-resource來請求資源的完整當前狀態。

{
    "TypeName": "AWS::Kinesis::Stream",
    "ResourceDescriptions": [
        {
            "Identifier": "MyKinesisStream",
            "Properties": '{"Name": "MyKinesisStream"}'
        },
        {
            "Identifier": "AnotherStream",
            "Properties": '{"Name": "AnotherStream"}'
        }
    ]
}

需要其他資訊的資源

某些資源會要求您提供有關要在請求中列出的資源的其他資訊。在這些情況下，您必須使用ResourceModel參數來指定這些屬性。

下表列出這些資源，以及您在清單要求期間要在ResourceModel參數中指定的屬性。

資源	必要的屬性
AWS::ApiGateway::DocumentationVersion	RestApiId
AWS::ApiGateway::Step	RestApiId
AWS::CloudFormation::ResourceVersion	TypeArn 或 TypeName
AWS::CustomerProfiles::Integration	DomainName
AWS::CustomerProfiles::ObjectType	DomainName
AWS::EC2::TransitGatewayMulticastGroupMember	TransitGatewayMulticastDomainId
AWS::EC2::TransitGatewayMulticastGroupSource	TransitGatewayMulticastDomainId
AWS::ECS::TaskSet	Cluster、Service 與 ID
AWS::EKS::AddOn	ClusterName
AWS::EKS::FargateProfile	ClusterName
AWS::ElasticLoadBalancingV2::Listener	LoadBalancerArn
AWS::ElasticLoadBalancingV2::ListenerRule	ListenerArn
AWS::Glue::Attach::SchemaVersion	SchemaDefinition、Schema/RegistryName 與 Schema/SchemaName SchemaDefinition 和 Schema/SchemaArn
AWS::Glue::Attach::SchemaVersionMetadata	SchemaVersionId
AWS::IoTSiteWise::AccessPolicy	/AccessPolicyResource/Portal /AccessPolicyResource/Project
AWS::IoTSiteWise::Dashboard	ProjectId
AWS::IoTSiteWise::Project	PortalId
AWS::Kendra::DataSource	IndexId
AWS::Kendra::Faq	IndexId
AWS::MediaConnect::FlowEntitlement	FlowArn
AWS::MediaConnect::FlowOutput	FlowArn
AWS::MediaConnect::FlowSource	FlowArn
AWS::MediaConnect::FlowVpcInterface	FlowArn
AWS::MediaPackage::Asset	PackagingGroupId
AWS::MediaPackage::PackagingConfiguration	PackagingGroupId
AWS::NetworkFirewall::LoggingConfiguration	FirewallArn FirewallName
AWS::QuickSight::Analysis	AwsAccountId
AWS::QuickSight::Dashboard	AwsAccountId
AWS::QuickSight::DataSet	AwsAccountId
AWS::QuickSight::DataSource	AwsAccountId
AWS::QuickSight::Template	AwsAccountId
AWS::QuickSight::Theme	AwsAccountId
AWS::RDS::DBProxyTargetGroup	DBProxyName
AWS::S3Outposts::AccessPoint	Bucket
AWS::S3Outposts::Bucket	OutpostId
AWS::SSO::Assignment	InstanceArn、PermissionSetArn、PrincipalId、PrincipalType、TargetId 和 TargetType
AWS::SSO::InstanceAccessControlAttributeConfiguration	InstanceArn
AWS::SSO::PermissionSet	InstanceArn 和 PermissionSetArn
AWS::WAFv2::WebACL	Scope