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á.
# Quais são os tipos de mudança?
O tipo de alteração se refere à ação que uma solicitação de mudança (RFC) do AWS Managed Services (AMS) executa e engloba a ação de mudança em si e o tipo de alteração — manual versus automatizada. O AMS tem uma grande coleção de tipos de alteração não usados por outros serviços web da Amazon. Você usa esses tipos de alteração ao enviar uma solicitação de alteração (RFC) para implantar, gerenciar ou obter acesso a recursos.
**Topics**
+ [Automatizado e manual CTs](ug-automated-or-manual.md)
+ [Requisitos de aprovação do CT](constrained-unconstrained-ctis.md)
+ [Alterar versões do tipo](ct-versions.md)
+ [Crie tipos de alteração](ct-creates.md)
+ [Atualizar tipos de alteração](ct-updates.md)
+ [Tipos de alteração somente internos](ct-internals.md)
+ [Esquemas de tipo de alteração](ct-schemas.md)
+ [Gerenciando permissões para tipos de alteração](ct-permissions.md)
+ [Eliminação de informações confidenciais dos tipos de alteração](ct-redaction.md)
+ [Encontrando um tipo de alteração, usando a opção de consulta](ug-find-ct-ex-section.md)
# Automatizado e manual CTs
Uma restrição nos tipos de alteração é se eles são automatizados ou manuais. Esse é o `AutomationStatusId` atributo do tipo de alteração, chamado de **modo de execução** no console do AMS.
Os tipos de mudança automatizados têm resultados e tempos de execução esperados e são executados no sistema automatizado do AMS, geralmente em uma hora ou menos (isso depende muito dos recursos que a CT está fornecendo). Os tipos de alteração manual são incomuns, mas são tratados de forma diferente porque exigem que um operador do AMS atue na RFC antes que ela possa ser executada. Às vezes, isso significa comunicar-se com o remetente do RFC, portanto, os tipos de alteração manual exigem vários períodos de tempo para serem concluídos.
Para todos os agendados RFCs, um horário de término não especificado é escrito como o horário especificado `RequestedStartTime` mais o `ExpectedExecutionDurationInMinutes` atributo do tipo de alteração enviado. Por exemplo, se `ExpectedExecutionDurationInMinutes` for “60" (minutos) e o especificado `RequestedStartTime` for `2016-12-05T14:20:00Z` (5 de dezembro de 2016 às 4h20), o horário real de término seria definido como 5 de dezembro de 2016 às 5h20. 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 CHANGE_TYPE_ID --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
```
**nota**
Programado RFCs com o **modo de execução** = Manual, no console, deve ser configurado para ser executado pelo menos 24 horas no futuro.
**nota**
Ao usar o manual CTs, o AMS recomenda que você use a opção ASAP **Scheduling** (escolha **ASAP** no console, deixe as horas de início e término em branco na API/CLI), pois elas CTs exigem que um operador do AMS examine a RFC e, possivelmente, se comunique com você antes que ela possa ser aprovada e executada. Se você agendá-los RFCs, aguarde pelo menos 24 horas. Se a aprovação não ocorrer antes do horário de início programado, a RFC será rejeitada automaticamente.
O AMS visa responder a uma tomografia computadorizada manual em quatro horas e corresponderá o mais rápido possível, mas pode levar muito mais tempo para que a RFC seja realmente executada.
Para obter uma lista dos CTs que são manuais e precisam ser revisados pelo AMS, consulte o arquivo CSV do tipo de alteração, disponível na página **Recursos do desenvolvedor** do console.
**YouTube Vídeo**: [Como posso encontrar tipos de alteração automatizados para o AMS RFCs?](https://www.youtube.com/watch?v=sOzDuCCOduI&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=2&t=1s)
Para encontrar o **modo de execução** de um CT no console do AMS, você deve usar a opção de pesquisa **Procurar tipos de alteração**. Os resultados mostram o modo de execução do tipo de alteração correspondente ou dos tipos de alteração.
Para encontrar um tipo de alteração específico usando a CLI do AMS, execute este comando: `AutomationStatus`
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
```
Você também pode pesquisar os tipos de alteração na [Referência de tipo de alteração do AMS](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html), que fornece informações sobre todos os tipos de alteração do AMS.
**nota**
Atualmente, o AMS API/CLI não faz parte da AWSAPI/CLI. To access the AMS API/CLI. Você baixa o SDK do AMS por meio do console do AMS.
# Requisitos de aprovação do CT
O AMS CTs sempre tem duas condições de aprovação, **AwsApprovalId**CustomerApprovalId****que indicam se o RFC exige que o AMS ou você, ou qualquer pessoa, aprove a execução.
A condição de aprovação está um pouco relacionada ao modo de execução; para obter detalhes, consulte[Automatizado e manual CTs](ug-automated-or-manual.md).
Para descobrir a condição de aprovação de um CT, você pode consultar a [Referência de Tipo de Alteração do AMS](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html) ou executar [GetChangeTypeVersion](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_GetChangeTypeVersion.html). Ambos também oferecem o **modo CT `AutomationStatusId` ou Execução**.
Você pode aprovar RFCs usando o console AMS ou com o seguinte comando:
```
aws amscm approve-rfc --rfc-id RFC_ID
```
**Condição de aprovação do CT**
| Se a condição de aprovação do CT for | Requer aprovação de | E |
| --- | --- | --- |
| `AwsApprovalId: Required` | O sistema de mudança de tipo do AMS, | Nenhuma ação é necessária. Essa condição é típica de automação CTs. |
| `AwsApprovalId: NotRequiredIfSubmitter` | O sistema de tipo de alteração do AMS e mais ninguém, se o RFC enviado for para a conta contra a qual foi enviado, | Nenhuma ação é necessária. Essa condição é típica dos manuais CTs porque eles sempre serão revisados pelos operadores do AMS. |
| `CustomerApprovalId: NotRequired` | O sistema de mudança de tipo do AMS, | Se a RFC passar pelas verificações de sintaxe e parâmetros, ela será aprovada automaticamente. |
| `CustomerApprovalId: Required` | O sistema de mudança de tipo do AMS e você, | Uma notificação é enviada a você e você deve aprovar explicitamente a RFC, respondendo à notificação ou executando a operação. [ApproveRfc](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ApproveRfc.html) |
| `CustomerApprovalId: NotRequiredIfSubmitter` | O sistema de mudança de tipo do AMS e mais ninguém, se você enviou o RFC. | Se a RFC passar pelas verificações de sintaxe e parâmetros, ela será aprovada automaticamente. |
| Incidente ou patch de segurança urgente | AMS | É aprovado e implementado automaticamente. |
# Alterar versões do tipo
Os tipos de alteração são versionados e a versão muda quando uma atualização importante é feita no tipo de alteração.
Depois de selecionar um tipo de alteração usando o console AMS, você tem a opção de abrir a área **Configuração adicional** e selecionar uma versão do tipo de alteração. Você também pode especificar uma versão do tipo de alteração na linha de API/CLI comando. Talvez você queira fazer isso por vários motivos, incluindo:
+ Você sabe que a versão do tipo de alteração **Atualizar** que você deseja deve corresponder à versão do tipo **Criar** alteração que você usou para criar o recurso que agora deseja atualizar. Por exemplo, você pode ter uma instância do Elastic Load Balancer (ELB) criada com o tipo de alteração do ELB Create versão 1. Para atualizá-lo, escolha ELB Update version 1.
+ Você deseja usar uma versão do tipo de alteração que tenha opções diferentes do tipo de alteração mais recente. Não recomendamos isso porque as atualizações do AMS mudam de tipo principalmente por motivos de segurança e recomendamos que você sempre escolha a versão mais recente.
# Crie tipos de alteração
Os tipos de alteração de criação são combinados version-to-version com os tipos de alteração de atualização. Ou seja, a versão do tipo de alteração que você usa para provisionar um recurso deve corresponder à versão do tipo de alteração de atualização que você usaria posteriormente para modificar esse recurso. Por exemplo, se você criar um bucket do S3 com o tipo de alteração Create S3 Bucket versão 2.0 e, posteriormente, quiser enviar um RFC para modificar esse bucket do S3, você também deverá usar o tipo de alteração do Update S3 Bucket versão 2.0, mesmo que haja um tipo de alteração do Update S3 Bucket com a versão 3.0.
Recomendamos manter um registro da ID do tipo de alteração e da versão que você usa ao provisionar um recurso com o tipo Criar alteração, caso queira usar posteriormente um tipo de alteração Atualizar para modificá-lo.
# Atualizar tipos de alteração
O AMS fornece tipos de alteração de atualização para atualizar recursos que foram criados com Criar tipos de alteração. Os tipos de alteração Atualizar devem corresponder version-to-version ao tipo Criar alteração usado originalmente para provisionar o recurso.
Recomendamos manter um registro do ID do tipo de alteração e da versão que você usa ao provisionar um recurso para facilitar a atualização.
**YouTube Vídeo**: [Como uso CTs a atualização para alterar recursos em uma conta do AWS Managed Services (AMS)?](https://www.youtube.com/watch?v=dqb31yaAXhc&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=8&t=30s)
# Tipos de alteração somente internos
Você pode ver os tipos de alteração que são somente para uso interno. Isso é para que você saiba quais ações o AMS pode ou faz. Se houver um tipo de alteração somente interno que você gostaria de ter disponível para seu uso, envie uma solicitação de serviço.
Por exemplo, há um Gerenciamento \$1 Monitoramento e notificação \$1 supressão de CloudWatch alarme \$1 Atualizar CT que é somente interno. O AMS o usa para implantar atualizações de infraestrutura (como patches) para desativar as notificações de alarme que as atualizações possam acionar erroneamente. Quando esta CT for enviada, você notará a RFC da CT na sua lista de RFC. Qualquer CT somente interna implantada em uma RFC aparece na sua lista de RFC.
# Esquemas de tipo de alteração
Todos os tipos de alteração fornecem um esquema JSON para sua entrada na criação, modificação ou acesso de recursos. O esquema fornece os parâmetros e suas descrições para você criar uma solicitação de alteração (RFC).
A execução bem-sucedida de um RFC resulta na saída da execução. Para provisionamento RFCs, a saída da execução inclui um “stack\$1id” que representa a pilha CloudFormation e pode ser pesquisado no console. CloudFormation Às vezes, a saída da execução inclui a saída do ID da instância criada e esse ID pode ser usado para pesquisar a instância no console da AWS correspondente. Por exemplo, a saída de execução do Create ELB CT inclui um “stack\$1id” que pode ser pesquisado CloudFormation e gera um key=ELB value= que pode ser pesquisado no console da Amazon para o Elastic Load Balancing. EC2
Vamos examinar um esquema de tomografia computadorizada. Esse é o esquema do CodeDeploy Application Create, um esquema relativamente pequeno. Alguns esquemas têm `Parameter` áreas muito grandes.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/onboardingguide/ct-schemas.html)
**nota**
Esse esquema permite até sete tags; no entanto, EFS EC2, RDS e os esquemas de criação de várias camadas permitem até 50 tags.
# Gerenciando permissões para tipos de alteração
Você pode usar uma política personalizada para restringir quais tipos de alteração (CTs) estão disponíveis para diferentes grupos ou usuários.
Para saber mais sobre como fazer isso, consulte a seção [Configuração de permissões](https://docs.aws.amazon.com/managedservices/latest/userguide/setting-permissions.html) do Guia do Usuário do AMS.
# Eliminação de informações confidenciais dos tipos de alteração
Os esquemas de tipo de alteração do AMS oferecem um atributo de parâmetro, `"metadata":"ams:sensitive":"true"` que é usado para parâmetros que conteriam informações confidenciais, como uma senha. Quando esse atributo é definido, a entrada fornecida é obscurecida. Observe que você não pode definir esse atributo de parâmetro; no entanto, se estiver trabalhando com o AMS para criar um tipo de alteração e tiver um parâmetro que gostaria de ocultar na entrada, você pode solicitar isso.
# 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](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**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/onboardingguide/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}"
```