本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
探索資源
使用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
參數中指定的屬性。
資源 | 必要的屬性 |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|