Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Ejemplos de Resource Explorer que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el Explorador AWS Command Line Interface de recursos.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.
Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.
Temas
Acciones
En el siguiente ejemplo de código se muestra cómo usar associate-default-view
.
- AWS CLI
-
Para configurar una vista del Explorador de recursos como predeterminada para su AWS región
En el siguiente
associate-default-view
ejemplo, se establece una vista, tal como lo especificaARN, como la vista predeterminada de la AWS región en la que se llama a la operación.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
Salida:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/My-Main-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obtener más información, consulte Configurar una vista predeterminada en una AWS región en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte AssociateDefaultView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar batch-get-view
.
- AWS CLI
-
Para recuperar detalles sobre varias vistas del Explorador de recursos
En el siguiente
batch-get-view
ejemplo, se muestran los detalles de dos vistas especificadas por susARNs. Utilice espacios para separar el múltiplo del ARNs 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
Salida:
{ "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 obtener más información sobre las vistas, consulte Acerca de las vistas del Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte BatchGetView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar create-index
.
- AWS CLI
-
Para activar el explorador de recursos en una AWS región mediante la creación de un índice
El siguiente
create-index
ejemplo crea un índice local en la AWS región en la que se llama a la operación. Genera AWS CLI automáticamente un valor declient-token
parámetro aleatorio y lo incluye en la llamada a AWS si no se especifica ningún valor.aws resource-explorer-2 create-index \ --region
us-east-1
Salida:
{ "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" }
Tras crear un índice local, puede convertirlo en el índice agregador de la cuenta ejecutando el update-index-typecomando.
Para obtener más información, consulte Activar el explorador de recursos en una AWS región para indexar los recursos en la Guía del usuario del explorador de AWS recursos.
-
Para API obtener más información, consulte CreateIndex
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar create-view
.
- AWS CLI
-
Ejemplo 1: Para crear una vista sin filtrar del índice de una AWS región
El siguiente
create-view
ejemplo crea una vista en la AWS región especificada que devuelve todos los resultados de la región sin ningún tipo de filtrado. La vista incluye el campo Etiquetas opcional en los resultados devueltos. Como esta vista se crea en la región que contiene el índice del agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice del explorador de recursos.aws resource-explorer-2 create-view \ --view-name
My-Main-View
\ --included-propertiesName=tags
\ --regionus-east-1
Salida:
{ "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" } }
Ejemplo 2: Para crear una vista que devuelva solo los recursos asociados a Amazon EC2
A continuación, se
create-view
crea una vista en AWS la regiónus-east-1
que muestra solo los recursos de la región que están asociados al EC2 servicio de Amazon. La vista incluye elTags
campo opcional de los resultados devueltos. Como esta vista se crea en la región que contiene el índice del agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice del explorador de recursos.aws resource-explorer-2 create-view \ --view-name
My-EC2-Only-View
\ --included-propertiesName=tags
\ --filters FilterString="service:ec2" \ --regionus-east-1
Salida:
{ "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 obtener más información, consulte Crear vistas para la búsqueda en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte CreateView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar delete-index
.
- AWS CLI
-
Para desactivar el Explorador de recursos en una AWS región mediante la eliminación de su índice
En el siguiente
delete-index
ejemplo, se elimina el índice del explorador de recursos especificado en la AWS región en la que se realiza la solicitud.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
Salida:
{ "Arn": "arn:aws:resource-explorer-2:us-west-2:123456789012:index/EXAMPLE8-90ab-cdef-fedc-EXAMPLE22222", "State": "DELETING" }
Para obtener más información sobre la eliminación de un índice, consulte Desactivar el Explorador de AWS recursos en una AWS región en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte DeleteIndex
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar delete-view
.
- AWS CLI
-
Para eliminar una vista del explorador de recursos
En el siguiente
delete-view
ejemplo, se elimina una vista especificada por suARN.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
Salida:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/EC2-Only-View/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obtener más información, consulte Eliminar vistas en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte DeleteView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar disassociate-default-view
.
- AWS CLI
-
Para eliminar la vista predeterminada del Explorador de recursos de una AWS región
Lo siguiente
disassociate-default-view
elimina la vista predeterminada del explorador de recursos de la AWS región en la que se llama a la operación. Tras realizar esta operación, todas las operaciones de búsqueda de la región deben especificar explícitamente una vista; de lo contrario, la operación fallará.aws resource-explorer-2 disassociate-default-view
Este comando no genera ninguna salida.
Para obtener más información, consulte Configurar una vista predeterminada en una AWS región en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte DisassociateDefaultView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar get-default-view
.
- AWS CLI
-
Para recuperar la vista del Explorador de recursos, que es la vista predeterminada para su AWS región
En el siguiente
get-default-view
ejemplo, se recupera la vista predeterminada ARN de la AWS región en la que se llama a la operación.aws resource-explorer-2 get-default-view
Salida:
{ "ViewArn": "arn:aws:resource-explorer-2:us-east-1:123456789012:view/default-view/EXAMPLE8-90ab-cdef-fedc-EXAMPLE11111" }
Para obtener más información, consulte Configurar una vista predeterminada en una AWS región en la Guía del usuario de AWS Resource Explorer.
-
Para API obtener más información, consulte GetDefaultView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar get-index
.
- AWS CLI
-
Ejemplo 1: Para recuperar los detalles de un índice de agregadores de Resource Explorer
En el siguiente
get-index
ejemplo, se muestran los detalles del índice del Explorador de recursos en la AWS región especificada. Como la región especificada contiene el índice agregador de la cuenta, el resultado muestra las regiones que replican los datos en el índice de esta región.aws resource-explorer-2 get-index \ --region
us-east-1
Salida:
{ "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" }
Ejemplo 2: Para recuperar los detalles de un índice local de Resource Explorer
En el siguiente
get-index
ejemplo, se muestran los detalles del índice del explorador de recursos en la AWS región especificada. Como la región especificada contiene un índice local, el resultado muestra la región en la que se replican los datos del índice de esta región.aws resource-explorer-2 get-index \ --region
us-west-2
Salida:
{ "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 obtener más información sobre los índices, consulte Comprobar qué AWS regiones tienen activado el Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte GetIndex
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar get-view
.
- AWS CLI
-
Para recuperar detalles sobre una vista del explorador de recursos
En el siguiente
get-view
ejemplo, se muestran los detalles de una vista especificada por suARN.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
Salida:
{ "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 obtener más información sobre las vistas, consulte Acerca de las vistas del Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte GetView
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar list-indexes
.
- AWS CLI
-
Para enumerar las AWS regiones en las que Resource Explorer tiene índices
El siguiente
list-indexes
ejemplo muestra los índices de todas las regiones en las que Resource Explorer tiene un índice. La respuesta especifica el tipo de cada índice, su AWS región y suARN.aws resource-explorer-2 list-indexes
Salida:
{ "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 obtener más información sobre los índices, consulte Comprobar qué AWS regiones tienen activado el Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte ListIndexes
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar list-supported-resource-types
.
- AWS CLI
-
Para enumerar las AWS regiones en las que Resource Explorer tiene índices
El siguiente
list-supported-resource-types
ejemplo muestra todos los tipos de recursos que actualmente admite &AREXlong;. La respuesta de ejemplo incluye unNextToken
valor que indica que hay más resultados disponibles para recuperar con llamadas adicionales.aws resource-explorer-2 list-supported-resource-types \ --max-items
10
Salida:
{ "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 obtener la siguiente parte del resultado, vuelva a llamar a la operación y pase el valor de
NextToken
respuesta de la llamada anterior como valor de--starting-token
. Repita el procedimiento hastaNextToken
que no aparezca en la respuesta.aws resource-explorer-2 list-supported-resource-types \ --max-items
10
\ --starting-tokeneyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=
Salida:
{ "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 obtener más información sobre los índices, consulte Comprobar qué AWS regiones tienen activado el Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte ListSupportedResourceTypes
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar list-tags-for-resource
.
- AWS CLI
-
Para enumerar las etiquetas adjuntas a una vista o índice del Explorador de recursos
En el siguiente
list-tags-for-resource
ejemplo, se muestran los pares de etiquetas, claves y valores adjuntos a la vista con los especificadosARN. Debe llamar a la operación desde la AWS región que contiene el 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
Salida:
{ "Tags": { "application": "MainCorpApp", "department": "1234" } }
Para obtener más información sobre el etiquetado de vistas, consulte Etiquetar vistas para el control de acceso en la Guía del usuario de AWS Resource Explorer.
-
Para API obtener más información, consulte la Referencia ListTagsForResource
de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar list-views
.
- AWS CLI
-
Para ver una lista de las vistas del explorador de recursos disponibles en una AWS región
En el siguiente
list-views
ejemplo, se enumeran todas las vistas disponibles en la región en la que se invoca la operación.aws resource-explorer-2 list-views
Salida:
{ "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 obtener más información sobre las vistas, consulte Acerca de las vistas del Explorador de recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte ListViews
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar search
.
- AWS CLI
-
Ejemplo 1: Para buscar utilizando la vista por defecto
En el siguiente
search
ejemplo, se muestran todos los recursos de los especificados que están asociados al servicio. La búsqueda utiliza la vista predeterminada de la región. La respuesta de ejemplo incluye unNextToken
valor que indica que hay más resultados disponibles para recuperar con llamadas adicionales.aws resource-explorer-2 search \ --query-string
"service:iam"
Salida:
{ "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" }
Ejemplo 2: Para buscar mediante una vista específica
El siguiente
search
ejemplo de búsqueda muestra todos los recursos («*») de la AWS región especificada que están visibles a través de la vista especificada. Los resultados incluyen solo los recursos asociados EC2 a Amazon debido a los filtros adjuntos a la vista.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
Salida:
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 obtener más información, consulte Uso del Explorador de AWS recursos para buscar recursos en la Guía del usuario del Explorador de AWS recursos.
-
Para API obtener más información, consulte Buscar
en la referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar tag-resource
.
- AWS CLI
-
Para etiquetar una vista del explorador de recursos
En el siguiente
tag-resource
ejemplo, se agrega la clave de etiqueta «entorno» con el valor «producción» a la vista con el valor 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 no genera ninguna salida.
Para obtener más información, consulte Etiquetar vistas para el control de acceso en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte TagResource
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar untag-resource
.
- AWS CLI
-
Para eliminar una etiqueta de una vista del Explorador de recursos
En el siguiente
untag-resource
ejemplo, se elimina cualquier etiqueta con el nombre clave «entorno» de la vista con el valor 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 no genera ninguna salida.
Para obtener más información, consulte Etiquetar vistas para el control de acceso en la Guía del usuario AWS de Resource Explorer.
-
Para API obtener más información, consulte UntagResource
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar update-index-type
.
- AWS CLI
-
Para cambiar el tipo de índice de Resource Explorer
En el siguiente
update-index-type
ejemplo, se convierte el índice especificado de un tipolocal
aggregator
a otro para activar la posibilidad de buscar recursos en todas AWS las regiones de la cuenta. Debe enviar la solicitud a la AWS región que contiene el índice que desea actualizar.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
Salida:
{ "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 obtener más información sobre cómo cambiar el tipo de un índice, consulte Activar la búsqueda entre regiones mediante la creación de un índice agregador en la Guía del usuario de AWS Resource Explorer.
-
Para API obtener más información, consulte la Referencia UpdateIndexType
de AWS CLI comandos.
-
En el siguiente ejemplo de código se muestra cómo usar update-view
.
- AWS CLI
-
Ejemplo 1: Para actualizar el IncludedProperties campo para una vista del explorador de recursos
En el siguiente
update-view
ejemplo, se actualiza la vista especificada agregándola`tags`
a la opcional`IncludedProperties`
. Tras ejecutar esta operación, las operaciones de búsqueda que utilizan esta vista incluyen información sobre las etiquetas adjuntas a los recursos que aparecen en los 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
Salida:
{ "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" } }
Ejemplo 2: Para actualizar los filtros adjuntos a una vista
En el siguiente
update-view
ejemplo, se actualiza la vista especificada para utilizar un filtro que limite los resultados únicamente a los tipos de recursos asociados al EC2 servicio de 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
Salida:
{ "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 obtener más información sobre las vistas, consulte Acerca de las vistas de Resource Explorer en la Guía del usuario de AWS Resource Explorer.
-
Para API obtener más información, consulte UpdateView
la Referencia de AWS CLI comandos.
-