

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.

# Búsqueda de un tipo de cambio mediante la opción de consulta
<a name="ug-find-ct-ex-section"></a>

En este ejemplo se muestra cómo utilizar la consola AMS para encontrar el tipo de cambio adecuado para la RFC que desea enviar.

Puede utilizar la consola o la API/CLI para buscar un identificador de tipo de cambio (CT) o una versión. Existen dos métodos: buscar o seleccionar la clasificación. Para ambos tipos de selección, puede ordenar la búsqueda eligiendo Usado **con más frecuencia, Usado** **más recientemente** o **Alfabético**.

**YouTube Vídeo**: [¿Cómo creo un RFC mediante la CLI de AWS Managed Services y dónde puedo encontrar el esquema CT](https://www.youtube.com/watch?v=IluDFwnJJFU&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=3&t=150s)? 

En la consola AMS, en la página **RFCs**-> **Crear RFC**:
+ Con la opción **Buscar por tipo de cambio** seleccionada (opción predeterminada), puede hacer lo siguiente:
  + Usa el área de **creación rápida** para seleccionar una de las más populares de AMS CTs. Haga clic en una etiqueta y se abrirá la página **Ejecutar RFC** con la opción **Asunto** rellenada automáticamente. Complete las opciones restantes según sea necesario y haga clic en **Ejecutar** para enviar la RFC. 
  + O bien, desplácese hacia abajo hasta el área **Todos los tipos de cambios** y comience a escribir un nombre de CT en el cuadro de opciones; no es necesario que tenga el nombre exacto o completo del tipo de cambio. También puede buscar una tomografía computarizada por ID de tipo de cambio, clasificación o modo de ejecución (automática o manual) introduciendo las palabras correspondientes.

    Con la vista de **tarjetas** predeterminada seleccionada, las tarjetas CT coincidentes aparecen a medida que escribes, seleccionas una carta y haces clic en **Crear RFC**. Con la vista de **tabla** seleccionada, elige el CT correspondiente y haz clic en **Crear RFC**. Ambos métodos abren la página **Ejecutar RFC**.
+ Como alternativa, y para explorar las opciones de tipos de cambio, haga clic en **Elegir por categoría** en la parte superior de la página para abrir una serie de cuadros de opciones desplegables.
+ Elija una **categoría**, una **subcategoría**, un **elemento** y una **operación.** Aparece el cuadro de información para ese tipo de cambio y aparece un panel en la parte inferior de la página.
+ Cuando esté listo, presione **Entrar** y aparecerá una lista de los tipos de cambios coincidentes.
+ Elige un tipo de cambio de la lista. El cuadro de información para ese tipo de cambio aparece en la parte inferior de la página.
+ Una vez que tenga el tipo de cambio correcto, elija **Crear RFC**.
**nota**  
La CLI de AMS debe estar instalada para que estos comandos funcionen. Para instalar la API o CLI de AMS, vaya a la página de **recursos para desarrolladores** de la consola AMS. Para obtener material de referencia sobre la API AMS CM o la API AMS SKMS, consulte la sección Recursos de información de AMS en la Guía del usuario. Puede que necesite añadir una `--profile` opción de autenticación; por ejemplo,`aws amsskms ams-cli-command --profile SAML`. Es posible que también tengas que añadir la `--region` opción, ya que todos los comandos de AMS se ejecutan desde us-east-1, por ejemplo. `aws amscm ams-cli-command --region=us-east-1`
**nota**  
Los puntos de enlace AMS API/CLI (amscm y amsskms) se encuentran en la región de AWS del Norte de Virginia,. `us-east-1` En función de cómo esté configurada su autenticación y de la región de AWS en la que se encuentren su cuenta y sus recursos, es posible que tenga que `--region us-east-1` añadirlos al emitir comandos. Es posible que también necesite añadirlo`--profile saml`, si ese es su método de autenticación.

Para buscar un tipo de cambio mediante la API CM de AMS (consulte [ListChangeTypeClassificationSummaries](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html)) o la CLI:

Puede utilizar un filtro o una consulta para realizar la búsqueda. La ListChangeTypeClassificationSummaries operación tiene opciones de [filtros](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html#amscm-ListChangeTypeClassificationSummaries-request-Filters) para `Category``Subcategory`,`Item`, y`Operation`, pero los valores deben coincidir exactamente con los valores existentes. Para obtener resultados más flexibles al usar la CLI, puede usar la `--query` opción. 


**Cambie el tipo de filtrado con la API/CLI AMS CM**  
<a name="ct-filtering-table"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/managedservices/latest/userguide/ug-find-ct-ex-section.html)

1. Estos son algunos ejemplos de clasificaciones de tipos de cambio de listas:

   El siguiente comando muestra todas las categorías de tipos de cambio.

   ```
   aws amscm list-change-type-categories
   ```

   El siguiente comando muestra las subcategorías que pertenecen a una categoría específica.

   ```
   aws amscm list-change-type-subcategories --category CATEGORY
   ```

   El siguiente comando muestra los elementos que pertenecen a una categoría y subcategoría especificadas.

   ```
   aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY
   ```

1. Estos son algunos ejemplos de búsqueda de tipos de cambios con consultas CLI:

   El siguiente comando busca en los resúmenes de las clasificaciones de CT las que contienen «S3" en el nombre del elemento y crea el resultado de la categoría, la subcategoría, el elemento, la operación y el identificador del tipo de cambio en forma de tabla. 

   ```
   aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
   ```

   ```
   +---------------------------------------------------------------+
   |               ListChangeTypeClassificationSummaries           |
   +----------+-------------------------+--+------+----------------+
   |Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
   +----------+-------------------------+--+------+----------------+
   ```

1. A continuación, puede utilizar el identificador del tipo de cambio para obtener el esquema CT y examinar los parámetros. El siguiente comando envía el esquema a un archivo JSON denominado Creates3Params.schema.json.

   ```
   aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json
   ```

   Para obtener información sobre el uso de consultas CLI, consulte [Cómo filtrar la salida con la opción --query](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html#controlling-output-filter) y la referencia del lenguaje de consulta, [JMESPath Especificación](http://jmespath.org/specification.html).

1. Una vez que tengas el ID del tipo de cambio, te recomendamos que compruebes la versión del tipo de cambio para asegurarte de que es la última. Usa este comando para buscar la versión de un tipo de cambio específico:

   ```
   aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID
   ```

   Para `AutomationStatus` buscar el tipo de cambio específico, ejecute este comando:

   ```
   aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
   ```

   Para `ExpectedExecutionDurationInMinutes` buscar el tipo de cambio específico, ejecuta este comando:

   ```
   aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
   ```