Descubriendo recursos con AWS Cloud Control API

Utilice el comando list-resources para detectar los recursos actualmente aprovisionados en su Cuenta de AWS y Región de AWS. Esto incluye todos los recursos del tipo de recurso especificado, independientemente de si se aprovisionaron a través de Cloud ControlAPI, directamente a través del servicio subyacente o de otro mecanismo (por ejemplo, si forman parte de una AWS CloudFormation pila).

La información que se devuelve de cada recurso incluye:

El siguiente ejemplo devuelve una lista de recursos AWS::Logs::LogGroup.

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

Cloud Control API devuelve una lista de los recursos de tu cuenta del tipo de recurso especificado. Por ejemplo, list-resources devuelve el identificador principal y las propiedades de los AWS::Logs::LogGroup recursos de todos los recursos de tu cuenta, independientemente de si Cloud Control API los aprovisionó. La información devuelta es similar a la siguiente, en función de los recursos de su cuenta.

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

El siguiente ejemplo solicita una lista de recursos AWS::Kinesis::Stream.

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

En el caso de las transmisiones de Kinesis, Cloud Control API devuelve el identificador principal de cada transmisión, junto con un subconjunto de las propiedades de los recursos. En este caso, solo una propiedad, Name. A continuación, puede utilizar el identificador principal de una transmisión con get-resource para solicitar el estado actual completo del recurso.

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

Recursos que requieren información adicional

Algunos recursos requieren que proporciones información adicional sobre los recursos que quieres incluir en la lista como parte de tu solicitud. En estos casos, debe usar el parámetro ResourceModel para especificar estas propiedades.

En la siguiente tabla se enumeran estos recursos y las propiedades que se deben especificar en el parámetro ResourceModel durante las solicitudes de lista.