

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á.

# Encontrando um tipo de alteração, usando a opção de consulta
<a name="ug-find-ct-ex-section"></a>

Este exemplo demonstra como usar o console AMS para encontrar o tipo de alteração apropriado para o RFC que você deseja enviar.

Você pode usar o console ou o API/CLI para encontrar uma ID de tipo de alteração (CT) ou versão. Existem dois métodos: pesquisar ou escolher a classificação. Para ambos os tipos de seleção, você pode classificar a pesquisa escolhendo Usado **com mais frequência, Usado** **mais recentemente** ou **Alfabético**.

**YouTube Vídeo**: [Como faço para criar uma RFC usando a CLI do AWS Managed Services e onde posso encontrar o](https://www.youtube.com/watch?v=IluDFwnJJFU&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=3&t=150s) esquema de CT? 

No console do AMS, na página **RFCs**-> **Criar RFC**:
+ Com a opção **Procurar por tipo de alteração** selecionada (o padrão), você pode:
  + Use a área de **criação rápida** para selecionar entre as mais populares do AMS CTs. Clique em um rótulo e a página **Executar RFC** será aberta com a opção **Assunto** preenchida automaticamente para você. Preencha as opções restantes conforme necessário e clique em **Executar** para enviar a RFC. 
  + Ou desça até a área **Todos os tipos de alteração** e comece a digitar um nome de CT na caixa de opções, você não precisa ter o nome exato ou completo do tipo de alteração. Você também pode pesquisar uma tomografia computadorizada por ID do tipo de alteração, classificação ou modo de execução (automático ou manual) inserindo as palavras relevantes.

    Com a visualização padrão dos **cartões** selecionada, os cartões CT correspondentes aparecem conforme você digita, seleciona um cartão e clica em **Criar RFC**. Com a exibição **de tabela** selecionada, escolha o CT relevante e clique em **Criar RFC**. Ambos os métodos abrem a página **Executar RFC**.
+ Como alternativa, e para explorar as opções de tipo de alteração, clique em **Escolher por categoria** na parte superior da página para abrir uma série de caixas de opções suspensas.
+ Escolha uma **categoria**, uma **subcategoria**, um **item** e uma **operação**. A caixa de informações desse tipo de alteração aparece e um painel aparece na parte inferior da página.
+ Quando estiver pronto, pressione **Enter** e uma lista dos tipos de alteração correspondentes será exibida.
+ Escolha um tipo de alteração na lista. A caixa de informações desse tipo de alteração aparece na parte inferior da página.
+ Depois de ter o tipo de alteração correto, escolha **Criar RFC**.
**nota**  
A CLI do AMS deve estar instalada para que esses comandos funcionem. Para instalar a API ou a CLI do AMS, acesse a página **Recursos para desenvolvedores** do console AMS. Para obter material de referência sobre a API AMS CM ou a API AMS SKMS, consulte a seção Recursos de informação do AMS no Guia do usuário. Talvez seja necessário adicionar uma `--profile` opção para autenticação; por exemplo,`aws amsskms ams-cli-command --profile SAML`. Talvez você também precise adicionar a `--region` opção, pois todos os comandos do AMS saem de us-east-1; por exemplo. `aws amscm ams-cli-command --region=us-east-1`
**nota**  
Os endpoints AMS API/CLI (amscm e amsskms) estão na região da AWS Norte da Virgínia,. `us-east-1` Dependendo de como sua autenticação está configurada e em qual região da AWS sua conta e seus recursos estão, talvez seja necessário adicioná-la `--region us-east-1` ao emitir comandos. Talvez você também precise adicionar`--profile saml`, se esse for o seu método de autenticação.

Para pesquisar um tipo de alteração usando a API AMS CM (consulte [ListChangeTypeClassificationSummaries](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html)) ou a CLI:

Você pode usar um filtro ou uma consulta para pesquisar. A ListChangeTypeClassificationSummaries operação tem opções de [filtros](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html#amscm-ListChangeTypeClassificationSummaries-request-Filters) para `Category``Subcategory`,`Item`, e`Operation`, mas os valores devem corresponder exatamente aos valores existentes. Para obter resultados mais flexíveis ao usar a CLI, você pode usar a `--query` opção. 


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

1. Aqui estão alguns exemplos de classificações de tipo de alteração de listagem:

   O comando a seguir lista todas as categorias de tipo de alteração.

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

   O comando a seguir lista as subcategorias pertencentes a uma categoria especificada.

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

   O comando a seguir lista os itens pertencentes a uma categoria e subcategoria especificadas.

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

1. Aqui estão alguns exemplos de pesquisa de tipos de alteração com consultas CLI:

   O comando a seguir pesquisa resumos de classificação de CT para aqueles que contêm “S3" no nome do item e cria a saída da categoria, subcategoria, item, operação e ID do tipo de alteração em forma de tabela. 

   ```
   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. Em seguida, você pode usar o ID do tipo de alteração para obter o esquema de CT e examinar os parâmetros. O comando a seguir gera o esquema em um arquivo JSON chamado Creates3Params.schema.json.

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

   [Para obter informações sobre o uso de consultas CLI, consulte [Como filtrar a saída com a opção --query e a referência da](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html#controlling-output-filter) linguagem de consulta, Especificação. JMESPath ](http://jmespath.org/specification.html)

1. Depois de ter o ID do tipo de alteração, recomendamos verificar a versão do tipo de alteração para garantir que seja a versão mais recente. Use esse comando para encontrar a versão de um tipo de alteração especificado:

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

   Para encontrar o `AutomationStatus` para um tipo de alteração específico, execute este comando:

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

   Para encontrar o `ExpectedExecutionDurationInMinutes` para um tipo de alteração específico, execute este comando:

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