Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.
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á.
Exemplos do Resource Explorer usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Resource Explorer.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
Tópicos
Ações
O código de exemplo a seguir mostra como usar associate-default-view
.
- AWS CLI
-
Para definir uma visualização do Resource Explorer como padrão para sua AWS região
O
associate-default-view
exemplo a seguir define uma visualização, conforme especificado por itsARN, como a visualização padrão para a AWS região na qual você chama a operação.aws resource-explorer-2 associate-default-view \ --view-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
Saída:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obter mais informações, consulte Configurando uma exibição padrão em uma AWS região no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte AssociateDefaultView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar batch-get-view
.
- AWS CLI
-
Para recuperar detalhes sobre várias visualizações do Resource Explorer
O
batch-get-view
exemplo a seguir exibe os detalhes sobre duas visualizações especificadas por suasARNs. Use espaços para separar o múltiplo ARNs no parâmetro --view-arn.aws resource-explorer-2 batch-get-view \ --view-arns
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222,
\arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
Saída:
{ "Views": [ { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T21:33:45.249000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }, { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } ] "Errors": [] }
Para obter mais informações sobre exibições, consulte Sobre as exibições do Resource Explorer no Guia do AWS Usuário do Resource Explorer.
-
Para API obter detalhes, consulte BatchGetView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-index
.
- AWS CLI
-
Para ativar o Resource Explorer em uma AWS região criando um índice
O
create-index
exemplo a seguir cria um índice local na AWS região em que a operação é chamada. O gera AWS CLI automaticamente um valor declient-token
parâmetro aleatório e o inclui na chamada AWS se você não especificar um valor.aws resource-explorer-2 create-index \ --region
us-east-1
Saída:
{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222c", "CreatedAt": "2022-11-01T20:00:59.149Z", "State": "CREATING" }
Depois de criar um índice local, você pode convertê-lo no índice agregador da conta executando o update-index-typecomando.
Para obter mais informações, consulte Como ativar o Resource Explorer em uma AWS região para indexar seus recursos no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte CreateIndex
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-view
.
- AWS CLI
-
Exemplo 1: Para criar uma exibição não filtrada para o índice em uma região AWS
O
create-view
exemplo a seguir cria uma visualização na AWS região especificada que retorna todos os resultados na região sem qualquer filtragem. A exibição inclui o campo opcional Tags nos resultados retornados. Como essa visualização é criada na região que contém o índice agregador, ela pode incluir resultados de todas as regiões na conta que contêm um índice do Resource Explorer.aws resource-explorer-2 create-view \ --view-name
My-Main-View
\ --included-propertiesName=tags
\ --regionus-east-1
Saída:
{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-13T20:34:11.314000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }
Exemplo 2: Para criar uma visualização que retorne somente recursos associados à Amazon EC2
O seguinte
create-view
cria uma visualização na AWS Regiãous-east-1
que retorna somente os recursos na Região que estão associados ao EC2 serviço da Amazon. A exibição inclui oTags
campo opcional nos resultados retornados. Como essa visualização é criada na região que contém o índice agregador, ela pode incluir resultados de todas as regiões na conta que contêm um índice do Resource Explorer.aws resource-explorer-2 create-view \ --view-name
My-EC2-Only-View
\ --included-propertiesName=tags
\ --filters FilterString="service:ec2" \ --regionus-east-1
Saída:
{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [ { "Name":"tags" } ], "LastUpdatedAt": "2022-07-13T21:35:09.059Z", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }
Para obter mais informações, consulte Criação de exibições para pesquisa no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte CreateView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-index
.
- AWS CLI
-
Para desativar o Resource Explorer em uma AWS região excluindo seu índice
O
delete-index
exemplo a seguir exclui o índice especificado do Resource Explorer na AWS região em que você faz a solicitação.aws resource-explorer-2 delete-index \ --arn
arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
\ --regionus-west-2
Saída:
{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "State": "DELETING" }
Para obter mais informações sobre como excluir um índice, consulte Como desativar o AWS Resource Explorer em uma AWS região no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte DeleteIndex
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar delete-view
.
- AWS CLI
-
Para excluir uma exibição do Resource Explorer
O
delete-view
exemplo a seguir exclui uma visualização especificada por itsARN.aws resource-explorer-2 delete-view \ --view-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
Saída:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obter mais informações, consulte Excluindo exibições no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte DeleteView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar disassociate-default-view
.
- AWS CLI
-
Para remover a visualização padrão do Resource Explorer de uma AWS região
O seguinte
disassociate-default-view
remove a visualização padrão do Resource Explorer para a AWS região na qual você chama a operação. Depois de realizar essa operação, todas as operações de pesquisa na região devem especificar explicitamente uma visualização ou a operação falhará.aws resource-explorer-2 disassociate-default-view
Este comando não produz saída.
Para obter mais informações, consulte Configurando uma exibição padrão em uma AWS região no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte DisassociateDefaultView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-default-view
.
- AWS CLI
-
Para recuperar a visualização do Resource Explorer, que é a visualização padrão para sua região AWS
O
get-default-view
exemplo a seguir recupera ARN a visualização que é padrão para a AWS região na qual você chama a operação.aws resource-explorer-2 get-default-view
Saída:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obter mais informações, consulte Configurando uma exibição padrão em uma AWS região no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte GetDefaultView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-index
.
- AWS CLI
-
Exemplo 1: Para recuperar os detalhes de um índice agregador do Resource Explorer
O
get-index
exemplo a seguir exibe os detalhes do índice do Resource Explorer na AWS região especificada. Como a região especificada contém o índice agregador da conta, a saída lista as regiões que replicam dados no índice dessa região.aws resource-explorer-2 get-index \ --region
us-east-1
Saída:
{ "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingFrom": [ "ap-south-1", "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "AGGREGATOR" }
Exemplo 2: Para recuperar os detalhes de um índice local do Resource Explorer
O
get-index
exemplo a seguir exibe os detalhes do índice do Resource Explorer na AWS região especificada. Como a região especificada contém um índice local, a saída lista a região para a qual ela replica os dados do índice dessa região.aws resource-explorer-2 get-index \ --region
us-west-2
Saída:
{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "CreatedAt": "2022-07-12T18:59:10.503000+00:00", "LastUpdatedAt": "2022-07-13T18:41:58.799000+00:00", "ReplicatingTo": [ "us-west-2" ], "State": "ACTIVE", "Tags": {}, "Type": "LOCAL" }
Para obter mais informações sobre índices, consulte Verificando quais AWS regiões têm o Resource Explorer ativado no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte GetIndex
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-view
.
- AWS CLI
-
Para recuperar detalhes sobre uma exibição do Resource Explorer
O
get-view
exemplo a seguir exibe os detalhes sobre uma visualização especificada por itsARN.aws resource-explorer-2 get-view \ --view-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
Saída:
{ "Tags" : {}, "View" : { "Filters" : { "FilterString" : "service:ec2" }, "IncludedProperties" : [ { "Name" : "tags" } ], "LastUpdatedAt" : "2022-07-13T21:33:45.249Z", "Owner" : "123456789012", "Scope" : "arn:aws:iam::123456789012:root", "ViewArn" : "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }
Para obter mais informações sobre exibições, consulte Sobre as exibições do Resource Explorer no Guia do AWS Usuário do Resource Explorer.
-
Para API obter detalhes, consulte GetView
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-indexes
.
- AWS CLI
-
Para listar as AWS regiões nas quais o Resource Explorer tem índices
O
list-indexes
exemplo a seguir lista os índices de todas as regiões em que o Resource Explorer tem um índice. A resposta especifica o tipo de cada índice, sua AWS região e seuARN.aws resource-explorer-2 list-indexes
Saída:
{ "Indexes": [ { "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "Region": "us-west-2", "Type": "AGGREGATOR" }, { "Arn": "arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "Region": "us-east-1", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-east-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333", "Region": "us-east-2", "Type": "LOCAL" }, { "Arn": "arn:aws:resource-explorer-2:us-west-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE44444", "Region": "us-west-1", "Type": "LOCAL" } ] }
Para obter mais informações sobre índices, consulte Verificando quais AWS regiões têm o Resource Explorer ativado no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte ListIndexes
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-supported-resource-types
.
- AWS CLI
-
Para listar as AWS regiões nas quais o Resource Explorer tem índices
O
list-supported-resource-types
exemplo a seguir lista todos os tipos de recursos atualmente suportados pelo &AREXlong;. O exemplo de resposta inclui umNextToken
valor que indica que há mais saída disponível para recuperação com chamadas adicionais.aws resource-explorer-2 list-supported-resource-types \ --max-items
10
Saída:
{ "ResourceTypes": [ { "ResourceType": "cloudfront:cache-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:distribution", "Service": "cloudfront" }, { "ResourceType": "cloudfront:function", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-access-identity", "Service": "cloudfront" }, { "ResourceType": "cloudfront:origin-request-policy", "Service": "cloudfront" }, { "ResourceType": "cloudfront:realtime-log-config", "Service": "cloudfront" }, { "ResourceType": "cloudfront:response-headers-policy", "Service": "cloudfront" }, { "ResourceType": "cloudwatch:alarm", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:dashboard", "Service": "cloudwatch" }, { "ResourceType": "cloudwatch:insight-rule", "Service": "cloudwatch" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=" }
Para obter a próxima parte da saída, chame a operação novamente e transmita o valor de
NextToken
resposta da chamada anterior como valor para--starting-token
. Repita até queNextToken
esteja ausente da resposta.aws resource-explorer-2 list-supported-resource-types \ --max-items
10
\ --starting-tokeneyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=
Saída:
{ "ResourceTypes": [ { "ResourceType": "cloudwatch:metric-stream", "Service": "cloudwatch" }, { "ResourceType": "dynamodb:table", "Service": "dynamodb" }, { "ResourceType": "ec2:capacity-reservation", "Service": "ec2" }, { "ResourceType": "ec2:capacity-reservation-fleet", "Service": "ec2" }, { "ResourceType": "ec2:client-vpn-endpoint", "Service": "ec2" }, { "ResourceType": "ec2:customer-gateway", "Service": "ec2" }, { "ResourceType": "ec2:dedicated-host", "Service": "ec2" }, { "ResourceType": "ec2:dhcp-options", "Service": "ec2" }, { "ResourceType": "ec2:egress-only-internet-gateway", "Service": "ec2" }, { "ResourceType": "ec2:elastic-gpu", "Service": "ec2" } ], "NextToken": "eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyMH0=" }
Para obter mais informações sobre índices, consulte Verificando quais AWS regiões têm o Resource Explorer ativado no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte ListSupportedResourceTypes
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-tags-for-resource
.
- AWS CLI
-
Para listar as tags anexadas a uma exibição ou índice do Resource Explorer
O
list-tags-for-resource
exemplo a seguir lista os pares de tag, chave e valor anexados para exibição com o especificadoARN. Você deve chamar a operação da AWS região que contém o recurso.aws resource-explorer-2 list-tags-for-resource \ --resource-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
Saída:
{ "Tags": { "application": "MainCorpApp", "department": "1234" } }
Para obter mais informações sobre a marcação de visualizações, consulte Como marcar visualizações para controle de acesso no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte ListTagsForResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-views
.
- AWS CLI
-
Para listar as visualizações do Resource Explorer disponíveis em uma AWS região
O
list-views
exemplo a seguir lista todas as visualizações disponíveis na região na qual você invoca a operação.aws resource-explorer-2 list-views
Saída:
{ "Views": [ "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Default-All-Resources-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "arn:aws:resource-explorer-2:us-east-1:123456789012:view/Production-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE33333" ] }
Para obter mais informações sobre exibições, consulte Sobre as exibições do Resource Explorer no Guia do AWS Usuário do Resource Explorer.
-
Para API obter detalhes, consulte ListViews
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar search
.
- AWS CLI
-
Exemplo 1: Para pesquisar usando a exibição padrão
O
search
exemplo a seguir exibe todos os recursos especificados que estão associados ao serviço. A pesquisa usa a visualização padrão para a região. O exemplo de resposta inclui umNextToken
valor que indica que há mais saída disponível para recuperação com chamadas adicionais.aws resource-explorer-2 search \ --query-string
"service:iam"
Saída:
{ "Count": { "Complete": true, "TotalResources": 55 }, "NextToken": "AG9VOEF1KLEXAMPLEOhJHVwo5chEXAMPLER5XiEpNrgsEXAMPLE...b0CmOFOryHEXAMPLE", "Resources": [{ "Arn": "arn:aws:iam::123456789012:policy/service-role/Some-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { "Arn": "arn:aws:iam::123456789012:policy/service-role/Another-Policy-For-A-Service-Role", "LastReportedAt": "2022-07-21T12:34:42Z", "OwningAccountId": "123456789012", "Properties": [], "Region": "global", "ResourceType": "iam:policy", "Service": "iam" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/my-default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Exemplo 2: Para pesquisar usando uma visualização especificada
O
search
exemplo de pesquisa a seguir exibe todos os recursos (“*”) na AWS região especificada que são visíveis por meio da visualização especificada. Os resultados incluem somente recursos associados à Amazon EC2 por causa dos filtros anexados à visualização.aws resource-explorer-2 search \ --
query-string
"*"
\ --view-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
Saída:
HTTP/1.1 200 OK Date: Tue, 01 Nov 2022 20:00:59 GMT Content-Type: application/json Content-Length: <PayloadSizeBytes> { "Count": { "Complete": true, "TotalResources": 67 }, "Resources": [{ "Arn": "arn:aws:ec2:us-east-1:123456789012:network-acl/acl-1a2b3c4d", "LastReportedAt": "2022-07-21T18:52:02Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T14:48:29Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:network-acl", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:subnet/subnet-1a2b3c4d", "LastReportedAt": "2022-07-21T21:22:23Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-07-29T19:02:39Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:subnet", "Service": "ec2" }, { "Arn": "arn:aws:ec2:us-east-1:123456789012:dhcp-options/dopt-1a2b3c4d", "LastReportedAt": "2022-07-21T06:08:53Z", "OwningAccountId": "123456789012", "Properties": [{ "Data": [{ "Key": "Department", "Value": "AppDevelopment" }, { "Key": "Environment", "Value": "Production" }], "LastReportedAt": "2021-11-15T15:11:05Z", "Name": "tags" }], "Region": "us-east-1", "ResourceType": "ec2:dhcpoptions", "Service": "ec2" }, { ... TRUNCATED FOR BREVITY ... }], "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" }
Para obter mais informações, consulte Usando o AWS Resource Explorer para pesquisar recursos no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte Pesquisar
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar tag-resource
.
- AWS CLI
-
Para marcar uma exibição do Resource Explorer
O
tag-resource
exemplo a seguir adiciona a chave de tag “ambiente” com o valor “produção” à exibição com o especificadoARN.aws resource-explorer-2 tag-resource \ --resource-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
\ --tagsenvironment=production
Este comando não produz saída.
Para obter mais informações, consulte Como marcar visualizações para controle de acesso no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte TagResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar untag-resource
.
- AWS CLI
-
Para remover uma tag de uma visualização do Resource Explorer
O
untag-resource
exemplo a seguir remove qualquer tag com o nome de chave “ambiente” da exibição com o especificadoARN.aws resource-explorer-2 untag-resource \ --resource-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View//EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
\ --tag-keysenvironment
Este comando não produz saída.
Para obter mais informações, consulte Como marcar visualizações para controle de acesso no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte UntagResource
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-index-type
.
- AWS CLI
-
Para alterar o tipo de um índice do Resource Explorer
O
update-index-type
exemplo a seguir converte o índice especificado de tipolocal
aggregator
para tipo para ativar a capacidade de pesquisar recursos em todas as AWS regiões da conta. Você deve enviar a solicitação para a AWS região que contém o índice que você deseja atualizar.aws resource-explorer-2 update-index-type \ --arn
arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111
\ --typeaggregator
\ --regionus-east-1
Saída:
{ "Arn":"arn:aws:resource-explorer-2:us-east-1:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111", "LastUpdatedAt":"2022-07-13T18:41:58.799Z", "State":"updating", "Type":"aggregator" }
Para obter mais informações sobre como alterar o tipo de um índice, consulte Como ativar a pesquisa entre regiões criando um índice agregador no Guia do usuário do AWS Resource Explorer.
-
Para API obter detalhes, consulte UpdateIndexType
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-view
.
- AWS CLI
-
Exemplo 1: Para atualizar o IncludedProperties campo para uma exibição do Resource Explorer
O
update-view
exemplo a seguir atualiza a exibição especificada adicionando`tags`
à opcional`IncludedProperties`
. Depois de executar essa operação, as operações de pesquisa que usam essa exibição incluem informações sobre as tags anexadas aos recursos que aparecem nos resultados.aws resource-explorer-2 update-view \ --included-properties
Name=tags
\ --view-arnarn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
Saída:
{ "View": { "Filters": { "FilterString": "" }, "IncludedProperties": [ { "Name": "tags" } ], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" } }
Exemplo 2: Para atualizar os filtros anexados a uma exibição
O
update-view
exemplo a seguir atualiza a visualização especificada para usar um filtro que limita os resultados somente aos tipos de recursos associados ao EC2 serviço da Amazon.aws resource-explorer-2 update-view \ --filters FilterString="service:ec2" \ --view-arn
arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222
Saída:
{ "View": { "Filters": { "FilterString": "service:ec2" }, "IncludedProperties": [], "LastUpdatedAt": "2022-07-19T17:41:21.710000+00:00", "Owner": "123456789012", "Scope": "arn:aws:iam::123456789012:root", "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222" } }
Para obter mais informações sobre exibições, consulte Sobre as exibições do Resource Explorer no Guia do AWS Usuário do Resource Explorer.
-
Para API obter detalhes, consulte UpdateView
na Referência de AWS CLI Comandos.
-