Découvrir des ressources avec AWS Cloud Control API

Utilisez la list-resources commande pour découvrir les ressources actuellement provisionnées dans votre Compte AWS et Région AWS. Cela inclut toutes les ressources du type de ressource spécifié, qu'elles aient été provisionnées via l'API Cloud Control, directement via le service sous-jacent ou par un autre mécanisme (comme le fait de faire partie d'une AWS CloudFormation pile).

Les informations renvoyées pour chaque ressource incluent :

L'exemple suivant renvoie une liste de AWS::Logs::LogGroup ressources.

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

L'API Cloud Control renvoie une liste des ressources de votre compte correspondant au type de ressource spécifié. Par exemple, list-resources renvoie l'identifiant principal et les propriétés des ressources de toutes les AWS::Logs::LogGroup ressources de votre compte, qu'elles aient été fournies ou non par l'API Cloud Control. Les informations renvoyées ressemblent aux suivantes, en fonction des ressources de votre compte.

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

L'exemple suivant demande une liste de AWS::Kinesis::Stream ressources.

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

Pour les flux Kinesis, l'API Cloud Control renvoie l'identifiant principal de chaque flux, ainsi qu'un sous-ensemble des propriétés des ressources. Dans ce cas, une seule propriété,Name. Vous pouvez ensuite utiliser l'identifiant principal d'un flux avec get-resource pour demander l'état actuel complet de la ressource.

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

Ressources nécessitant des informations supplémentaires

Certaines ressources nécessitent que vous fournissiez des informations supplémentaires sur les ressources que vous souhaitez répertorier dans le cadre de votre demande. Dans ces cas, vous devez utiliser le ResourceModel paramètre pour spécifier ces propriétés.

Le tableau ci-dessous répertorie ces ressources, ainsi que les propriétés que vous devez spécifier dans le ResourceModel paramètre lors des demandes de liste.