Entdecken Sie Ressourcen mit AWS Cloud Control API

Verwenden Sie den list-resources Befehl, um die Ressourcen zu ermitteln, die derzeit in Ihrem AWS-Konto Land bereitgestellt werden. AWS-Region Dazu gehören alle Ressourcen des angegebenen Ressourcentyps, unabhängig davon, ob sie über Cloud ControlAPI, direkt über den zugrunde liegenden Dienst oder über einen anderen Mechanismus (z. B. als Teil eines AWS CloudFormation Stacks) bereitgestellt wurden.

Zu den für jede Ressource zurückgegebenen Informationen gehören:

Das folgende Beispiel gibt eine Liste von AWS::Logs::LogGroup Ressourcen zurück.

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

Cloud Control API gibt eine Liste der Ressourcen des angegebenen Ressourcentyps in Ihrem Konto zurück. list-resourcesGibt beispielsweise die primäre Kennung und die Ressourceneigenschaften aller AWS::Logs::LogGroup Ressourcen in Ihrem Konto zurück, unabhängig davon, ob sie von Cloud Control API bereitgestellt wurden. Die zurückgegebenen Informationen ähneln je nach den Ressourcen in Ihrem Konto den folgenden.

{
  "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:*"}'
    }
  ]
}

Im folgenden Beispiel wird eine Liste von AWS::Kinesis::Stream Ressourcen angefordert.

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

Für Kinesis-Streams gibt Cloud Control die primäre Kennung jedes Streams zusammen mit einer Teilmenge der Ressourceneigenschaften API zurück. In diesem Fall nur eine einzelne Eigenschaft,. Name Sie könnten dann den primären Bezeichner eines Streams mit verwendenget-resource, um den vollständigen aktuellen Status der Ressource anzufordern.

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

Ressourcen, die zusätzliche Informationen benötigen

Für bestimmte Ressourcen müssen Sie im Rahmen Ihrer Anfrage zusätzliche Informationen zu den Ressourcen angeben, die Sie auflisten möchten. In diesen Fällen müssen Sie den ResourceModel Parameter verwenden, um diese Eigenschaften anzugeben.

In der folgenden Tabelle sind diese Ressourcen und die Eigenschaften aufgeführt, die Sie bei Listenanfragen im ResourceModel Parameter angeben müssen.