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