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á.
# Janela de patch \$1 Definir status
Ative ou desative uma janela de patch existente do AWS Systems Manager (SSM). Se a janela estiver ativada, qualquer tarefa associada a ela será executada na próxima ocorrência da janela de manutenção. Se desativada, qualquer ocorrência futura da janela não será mais executada. As ocorrências da janela que já estão em execução continuam sendo executadas até serem concluídas.
**Classificação completa:** Gerenciamento \$1 Aplicação de patches \$1 Janela de patches \$1 Definir status
## Detalhes do tipo de alteração
****
| | |
| --- |--- |
| ID do tipo de alteração | ct-3vfxkiudtovm9 |
| Versão atual | 1,0 |
| Duração esperada da execução | 60 minutos |
| Aprovação da AWS | Obrigatório |
| Aprovação do cliente | Não obrigatório |
| Modo de execução | Automatizado |
## Informações adicionais
### Definir o status da janela SSM Patch
#### Defina o status da janela do SSM Patch com o console
O seguinte mostra esse tipo de alteração no console AMS.
![\[AWS Systems Manager patch window status settings with description, ID, and version.\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/ctref/images/guiPatchWindowSetStatusCT.png)
Como funciona:
1. Navegue até a página **Criar RFC**: No painel de navegação esquerdo do console AMS, clique **RFCs**para abrir a página da RFCs lista e, em seguida, clique em **Criar** RFC.
1. Escolha um tipo de alteração popular (CT) na visualização padrão **Procurar tipos de alteração** ou selecione uma CT na visualização **Escolher por categoria**.
+ **Navegar por tipo de alteração**: você pode clicar em um CT popular na área de **criação rápida** para abrir imediatamente a página **Executar RFC**. Observe que você não pode escolher uma versão mais antiga do CT com a criação rápida.
Para classificar CTs, use a área **Todos os tipos de alteração** na exibição **Cartão** ou **Tabela**. Em qualquer exibição, selecione uma CT e clique em **Criar RFC** para abrir a página **Executar RFC**. Se aplicável, a opção **Criar com uma versão mais antiga** aparece ao lado do botão **Criar RFC**.
+ **Escolha por categoria**: selecione uma categoria, subcategoria, item e operação e a caixa de detalhes do CT será aberta com a opção **Criar com uma versão mais antiga**, se aplicável. Clique em **Criar RFC** para abrir a página **Executar RFC**.
1. Na página **Executar RFC**, abra a área do nome do CT para ver a caixa de detalhes do CT. É necessário um **Assunto** (preenchido se você escolher seu CT na visualização **Procurar tipos de alteração**). Abra a área **Configuração adicional** para adicionar informações sobre o RFC.
Na área **Configuração de execução**, use as listas suspensas disponíveis ou insira valores para os parâmetros necessários. Para configurar parâmetros de execução opcionais, abra a área **Configuração adicional**.
1. Ao terminar, clique em **Executar**. Se não houver erros, a página **RFC criada com sucesso** será exibida com os detalhes da RFC enviada e a saída inicial de **execução**.
1. Abra a área **Parâmetros de execução** para ver as configurações que você enviou. Atualize a página para atualizar o status de execução do RFC. Opcionalmente, cancele a RFC ou crie uma cópia dela com as opções na parte superior da página.
#### Defina o status da janela SSM Patch com a CLI
Como funciona:
1. Use o Inline Create (você emite um `create-rfc` comando com todos os parâmetros de RFC e execução incluídos) ou o Template Create (você cria dois arquivos JSON, um para os parâmetros RFC e outro para os parâmetros de execução) e emita o `create-rfc` comando com os dois arquivos como entrada. Ambos os métodos são descritos aqui.
1. Envie o `aws amscm submit-rfc --rfc-id ID` comando RFC: com o ID RFC retornado.
Monitore o `aws amscm get-rfc --rfc-id ID` comando RFC:.
Para verificar a versão do tipo de alteração, use este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**
Você pode usar qualquer `CreateRfc` parâmetro com qualquer RFC, independentemente de eles fazerem parte do esquema para o tipo de alteração. Por exemplo, para receber notificações quando o status da RFC mudar, adicione essa linha `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` à parte dos parâmetros da RFC da solicitação (não aos parâmetros de execução). Para obter uma lista de todos os CreateRfc parâmetros, consulte a [Referência da API de gerenciamento de alterações do AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*CRIAÇÃO EM LINHA*:
Execute o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:
```
aws amscm create-rfc --change-type-id "ct-3vfxkiudtovm9" --change-type-version "1.0" --title "Set patch window status" --execution-parameters "{\"DocumentName\":\"AWSManagedServices-SetPatchenanceWindowStatus\",\"Region\":\"us-east-1\",\"Parameters\":{\"MaintenanceWindowId\":[\"mw-1234567890abcdef0\"],\"Enabled\":[true]}}"
```
*CRIAÇÃO DE MODELO*:
1. Exiba os parâmetros de execução desse tipo de alteração em um arquivo JSON; este exemplo o chama de SetPatchWinStatusParams .json:
```
aws amscm get-change-type-version --change-type-id "ct-3vfxkiudtovm9" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > SetPatchWinStatusParams.json
```
1. Modifique e salve o SetPatchWinStatusParams arquivo, mantendo somente os parâmetros que você deseja alterar. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"DocumentName": "AWSManagedServices-SetPatchenanceWindowStatus",
"Region": "us-east-1",
"Parameters":
{
"MaintenanceWindowId": [
"mw-1234567890abcdef0"
],
"Enabled": [
true
]
}
}
```
1. Envie o modelo RFC para um arquivo em sua pasta atual; este exemplo o chama de SetPatchWinStatusRfc .json:
```
aws amscm create-rfc --generate-cli-skeleton > SetPatchWinStatusRfc.json
```
1. Modifique e salve o SetPatchWinStatusRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"ChangeTypeVersion": "1.0",
"ChangeTypeId": "ct-3vfxkiudtovm9",
"Title": "Set patch window status"
}
```
1. Crie o RFC, especificando o SetPatchWinStatusRfc arquivo e o SetPatchWinStatusParams arquivo:
```
aws amscm create-rfc --cli-input-json file://SetPatchWinStatusRfc.json --execution-parameters file://SetPatchWinStatusParams.json
```
Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.
#### Dicas
Para saber mais sobre como fazer isso, consulte Janelas de [manutenção do AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-maintenance.html).
## Parâmetros de entrada de execução
Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para o tipo de alteração ct-3vfxkiudtovm9](schemas.md#ct-3vfxkiudtovm9-schema-section).
## Exemplo: parâmetros obrigatórios
```
{
"DocumentName" : "AWSManagedServices-SetSsmMaintenanceWindowStatus",
"Region" : "us-east-1",
"Parameters" : {
"MaintenanceWindowId" : [
"mw-1234567890abcdef0"
],
"Enabled" : [
true
]
}
}
```
## Exemplo: Todos os parâmetros
```
{
"DocumentName" : "AWSManagedServices-SetSsmMaintenanceWindowStatus",
"Region" : "us-east-1",
"Parameters" : {
"MaintenanceWindowId" : [
"mw-1234567890abcdef0"
],
"Enabled" : [
true
]
}
}
```