Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/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 distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `associate-default-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-default-view`.
**AWS CLI**
**Para configurar una vista del Explorador de recursos como predeterminada para su AWS región**
El siguiente `associate-default-view` ejemplo establece una vista, según lo especificado por su ARN, 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [AssociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/associate-default-view.html)la *Referencia de AWS CLI comandos*.
### `batch-get-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-get-view`.
**AWS CLI**
**Para recuperar detalles sobre varias vistas del Resource Explorer**
En el siguiente `batch-get-view` ejemplo, se muestran los detalles de dos vistas especificadas por sus ARNs. 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 [About Resource Explorer views](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) en la *Guía del usuario de AWS Resource Explorer*.
+ *Para obtener más información sobre la API, consulte [BatchGetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/batch-get-view.html)la Referencia de comandos.AWS CLI *
### `create-index`
En el siguiente ejemplo de código, se muestra cómo utilizar `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. La AWS CLI genera automáticamente un valor de `client-token` parámetro aleatorio y lo incluye en la llamada a AWS si no se especifica un 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-type](https://docs.aws.amazon.com/cli/latest/reference/resource-explorer-2/update-index-type.html)comando.
Para obtener más información, consulte [Activar el explorador de recursos en una AWS región para indexar los recursos](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-register.html) en la *Guía del usuario del explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [CreateIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-index.html)la *Referencia de AWS CLI comandos*.
### `create-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `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 Tags opcional en los resultados devueltos. Como esta vista se crea en la región que contiene el índice agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice de Resource Explorer.
```
aws resource-explorer-2 create-view \
--view-name My-Main-View \
--included-properties Name=tags \
--region us-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: 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ón `us-east-1` que devuelve solo los recursos de la región que están asociados al servicio Amazon EC2. La vista incluye el campo `Tags` opcional en los resultados devueltos. Como esta vista se crea en la región que contiene el índice agregador, puede incluir los resultados de todas las regiones de la cuenta que contienen un índice de Resource Explorer.
```
aws resource-explorer-2 create-view \
--view-name My-EC2-Only-View \
--included-properties Name=tags \
--filters FilterString="service:ec2" \
--region us-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 [Creating views for search](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-create.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [CreateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/create-view.html)la *Referencia de AWS CLI comandos*.
### `delete-index`
En el siguiente ejemplo de código, se muestra cómo utilizar `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 \
--region us-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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-deregister.html) en la *Guía del usuario del Explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [DeleteIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-index.html)la *Referencia de AWS CLI comandos*.
### `delete-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-view`.
**AWS CLI**
**Para eliminar una vista de Resource Explorer**
En el siguiente ejemplo de `delete-view`, se elimina una vista especificada por su ARN.
```
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 [Deleting views](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-delete.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [DeleteView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/delete-view.html)la *Referencia de AWS CLI comandos*.
### `disassociate-default-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-default-view`.
**AWS CLI**
**Para eliminar la vista predeterminada del explorador de recursos de una AWS región**
A continuación, se `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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) *Guía del usuario del Explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [DisassociateDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/disassociate-default-view.html)la *Referencia de AWS CLI comandos*.
### `get-default-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-default-view`.
**AWS CLI**
**Para recuperar la vista del Explorador de recursos, que es la vista predeterminada para su AWS región**
El siguiente `get-default-view` ejemplo recupera el ARN de la vista que es el predeterminado para la región en AWS 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-set-default.html) del *usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [GetDefaultView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-default-view.html)la *Referencia de AWS CLI comandos*.
### `get-index`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-index`.
**AWS CLI**
**Ejemplo 1: recuperar los detalles de un índice agregador 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 enumera 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: 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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) la *Guía del usuario del Explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [GetIndex](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-index.html)la *Referencia de AWS CLI comandos*.
### `get-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-view`.
**AWS CLI**
**Para recuperar detalles sobre una vista del Resource Explorer**
En el siguiente ejemplo de `get-view`, se muestran los detalles sobre una vista especificada por sus ARN.
```
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 [About Resource Explorer views](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [GetView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/get-view.html)la *Referencia de AWS CLI comandos*.
### `list-indexes`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-indexes`.
**AWS CLI**
**Para enumerar las AWS regiones en las que Resource Explorer tiene índices**
El siguiente ejemplo de `list-indexes` 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 su ARN.
```
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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) la Guía del *usuario del Explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [ListIndexes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-indexes.html)la *Referencia de AWS CLI comandos*.
### `list-supported-resource-types`
En el siguiente ejemplo de código, se muestra cómo utilizar `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 un valor `NextToken` 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 use el valor de respuesta `NextToken` de la llamada anterior como el valor de `--starting-token`. Repita el procedimiento hasta que `NextToken` no aparezca en la respuesta.
```
aws resource-explorer-2 list-supported-resource-types \
--max-items 10 \
--starting-token eyJOZXh0VG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxMH0=
```
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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-service-check.html) la *Guía del usuario del Explorador de AWS recursos*.
+ Para obtener más información sobre la API, consulte [ListSupportedResourceTypes](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-supported-resource-types.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas adjuntas a una vista o índice de Resource Explorer**
En el siguiente ejemplo de `list-tags-for-resource`, se enumeran los pares de clave y valor asociados a la vista con el ARN especificado. 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 [Tagging views for access control](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) en la *Guía del usuario del AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `list-views`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-views`.
**AWS CLI**
**Para ver una lista de las vistas del explorador de recursos disponibles en una AWS región**
En el siguiente ejemplo de `list-views`, 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 [About Resource Explorer views](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [ListViews](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/list-views.html)la *Referencia de AWS CLI comandos*.
### `search`
En el siguiente ejemplo de código, se muestra cómo utilizar `search`.
**AWS CLI**
**Ejemplo 1: buscar mediante la vista predeterminada**
En el siguiente ejemplo de `search`, se muestran todos los recursos asociados con el servicio. La búsqueda utiliza la vista predeterminada para la región. La respuesta de ejemplo incluye un valor `NextToken` 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: buscar mediante una vista específica**
El siguiente `search` ejemplo de búsqueda muestra todos los recursos («\$1») de la AWS región especificada que están visibles en la vista especificada. Los resultados incluyen solo los recursos asociados a Amazon EC2 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:
{
"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](https://docs.aws.amazon.com/resource-explorer/latest/userguide/using-search.html) en la *Guía del usuario del Explorador de AWS recursos*.
+ Para obtener información sobre la API, consulte [Search](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/search.html) en la *Referencia de comandos de la AWS CLI *.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Para eliminar una vista de Resource Explorer**
En el siguiente ejemplo de `tag-resource`, se agrega la clave de etiqueta environment con el valor production a la vista con el ARN especificado.
```
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 \
--tags environment=production
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging views for access control](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Para eliminar una etiqueta de una vista de Resource Explorer**
El siguiente ejemplo de `untag-resource` elimina las etiquetas con la nombre de clave environment de la vista con el ARN especificado.
```
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-keys environment
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tagging views for access control](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-tag.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/untag-resource.html)la *Referencia de AWS CLI comandos*.
### `update-index-type`
En el siguiente ejemplo de código, se muestra cómo utilizar `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 tipo `local` `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 \
--type aggregator \
--region us-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 información sobre cambiar un tipo de índice, consulte [Turning on cross-Region search by creating an aggregator index](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-aggregator-region.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [UpdateIndexType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-index-type.html)la *Referencia de AWS CLI comandos*.
### `update-view`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-view`.
**AWS CLI**
**Ejemplo 1: Para actualizar el IncludedProperties campo para una vista del explorador de recursos**
En el siguiente ejemplo de `update-view`, se actualiza la vista especificada agregando ``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 asociadas a los recursos que aparecen en los resultados.
```
aws resource-explorer-2 update-view \
--included-properties Name=tags \
--view-arn arn: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: actualizar los filtros adjuntos a una vista**
En el siguiente ejemplo de `update-view`, se actualiza la vista especificada para utilizar un filtro que limite los resultados únicamente a los tipos de recursos asociados al servicio Amazon EC2.
```
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 [About Resource Explorer views](https://docs.aws.amazon.com/resource-explorer/latest/userguide/manage-views-about.html) en la *Guía del usuario de AWS Resource Explorer*.
+ Para obtener más información sobre la API, consulte [UpdateView](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/resource-explorer-2/update-view.html)la *Referencia de AWS CLI comandos*.