Encontrando um tipo de alteração, usando a opção de consulta - Guia do usuário avançado do AMS

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

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 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) ou a CLI:

Você pode usar um filtro ou uma consulta para pesquisar. A ListChangeTypeClassificationSummaries operação tem opções de filtros para CategorySubcategory,Item, eOperation, 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
Atributo Valores válidos Condição válida/padrão Observações

ChangeTypeId

Qualquer string representando um ChangeTypeId (por exemplo: ct-abc123xyz7890)

Igual

Para o tipo de alteração IDs, consulte a Referência do tipo de alteração.

Para o tipo de alteração IDs, consulte Encontrando um tipo de alteração ou CSIO.

Categoria

Qualquer texto de formato livre

Contém

Expressões regulares em cada campo individual não são suportadas. Pesquisa sem distinção entre maiúsculas e min

Subcategory

Item

Operação

  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

  2. 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|
+----------+-------------------------+--+------+----------------+

  3. 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 linguagem de consulta, Especificação. JMESPath

  4. 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}"