使用 探索資源 AWS Cloud Control API - 雲端控制 API

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 探索資源 AWS Cloud Control API

使用 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 串流,Cloud Control 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

TypeArnTypeName

AWS::CustomerProfiles::Integration

DomainName

AWS::CustomerProfiles::ObjectType

DomainName

AWS::EC2::TransitGatewayMulticastGroupMember

TransitGatewayMulticastDomainId

AWS::EC2::TransitGatewayMulticastGroupSource

TransitGatewayMulticastDomainId

AWS::ECS::TaskSet

ClusterServiceID

AWS::EKS::AddOn

ClusterName

AWS::EKS::FargateProfile

ClusterName

AWS::ElasticLoadBalancingV2::Listener

LoadBalancerArn

AWS::ElasticLoadBalancingV2::ListenerRule

ListenerArn

AWS::Glue::Attach::SchemaVersion

  • SchemaDefinitionSchema/RegistryNameSchema/SchemaName

  • SchemaDefinitionSchema/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

InstanceArnPermissionSetArnPrincipalIdPrincipalTypeTargetIdTargetType

AWS::SSO::InstanceAccessControlAttributeConfiguration

InstanceArn

AWS::SSO::PermissionSet

InstanceArnPermissionSetArn

AWS::WAFv2::WebACL

Scope