As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Descobrindo recursos com AWS Cloud Control API
Use o comando list-resources
para descobrir os recursos atualmente provisionados em sua Conta da AWS e Região da AWS. Isso inclui todos os recursos do tipo de recurso especificado, independentemente de terem sido provisionados por meio do Cloud ControlAPI, diretamente por meio do serviço subjacente ou de outro mecanismo (como fazer parte de uma AWS CloudFormation pilha).
As informações retornadas para cada recurso incluem:
-
O identificador primário do recurso.
-
Opcionalmente, ele pode incluir parte das ou todas as propriedades do recurso, detalhando o estado atual do recurso. Para obter mais informações, consulte Visualizando esquemas de tipos de recursos.
O exemplo a seguir retorna uma lista de recursos do AWS::Logs::LogGroup
.
$
aws cloudcontrol list-resources --type-name AWS::Logs::LogGroup
O Cloud Control API retorna uma lista dos recursos em sua conta do tipo de recurso especificado. Por exemplo, list-resources
retorna o identificador principal e as propriedades do recurso de todos os AWS::Logs::LogGroup
recursos em sua conta, independentemente de terem sido provisionados pelo Cloud Control. API As informações retornadas são semelhantes às informações a seguir, dependendo dos recursos em sua conta.
{ "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:*"}' } ] }
O exemplo a seguir solicita uma lista de recursos do AWS::Kinesis::Stream
.
$
aws cloudcontrol list-resources --type-name AWS::Kinesis::Stream
Para streams do Kinesis, o Cloud Control API retorna o identificador primário de cada stream, junto com um subconjunto das propriedades do recurso. Nesse caso, apenas uma única propriedade, Name
. Você poderia então usar o identificador primário de um stream com get-resource
para solicitar o estado atual completo do recurso.
{ "TypeName": "AWS::Kinesis::Stream", "ResourceDescriptions": [ { "Identifier": "MyKinesisStream", "Properties": '{"Name": "MyKinesisStream"}' }, { "Identifier": "AnotherStream", "Properties": '{"Name": "AnotherStream"}' } ] }
Recursos que exigem informações adicionais.
Alguns recursos exigem que você forneça informações adicionais sobre os recursos que você deseja listar como parte de sua solicitação. Nesses casos, você deve usar o parâmetro ResourceModel
para especificar essas propriedades.
A tabela abaixo lista esses recursos e as propriedades que você deve especificar no parâmetro ResourceModel
durante as solicitações de lista.
Recursos | Propriedades necessárias |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|