

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

# RDS Database Stack \$1 Atualização
<a name="management-advanced-rds-database-stack-update"></a>

Modifique as propriedades de uma instância de banco de dados Amazon Relational Database Service (RDS) criada usando ct-2z60dyvto9g6c, versão 3.0.

**Classificação completa:** Gerenciamento \$1 Componentes avançados da pilha \$1 Pilha de banco de dados RDS \$1 Atualização

## Detalhes do tipo de alteração
<a name="ct-12w49boaiwtzp-MARu-table"></a>


****  

|  |  | 
| --- |--- |
| ID do tipo de alteração | ct-12w49 boaiwtzp | 
| Versão atual | 3.0 | 
| Duração esperada da execução | 360 minutos | 
| Aprovação da AWS | Obrigatório | 
| Aprovação do cliente | Não obrigatório | 
| Modo de execução | Automatizado | 

## Informações adicionais
<a name="management-advanced-rds-database-stack-update-info"></a>

### Atualizar pilha de banco de dados
<a name="ex-rds-update-stack-col"></a>

#### Atualizando uma pilha RDS com o console
<a name="rds-update-con"></a>

Captura de tela desse tipo de alteração no console AMS:

![\[Alteração type details for updating an Amazon RDS database stack, including ID and version.\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/ctref/images/guiRdsStackUpdateCT.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.

#### Atualizando uma pilha RDS com a CLI
<a name="rds-update-cli"></a>

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-12w49boaiwtzp" --change-type-version "1.0" --title "RDS_UPDATE" --execution-parameters "{\"VpcId\":\"VPC_ID\",\"StackId\":\"STACK_ID\",\"Parameters\":{\"RDSBackups\":true,\"RDSInstanceType\":\"db.m3.medium\",\"RDSIOPS\":0,\"RDSMultiAZ\":true,\"RDSPreferredBackupWindow\":\"22:00-23:00\",\"RDSPreferredMaintenanceWindow\":\"wed:03:32-wed:04:02\",\"RDSStorageType\":\"gp2\"}}"
```

*CRIAÇÃO DE MODELO*:

1. Envie os parâmetros de execução desse tipo de alteração para um arquivo JSON chamado UpdateRdsParams .json.

   ```
   aws amscm get-change-type-version --change-type-id "ct-12w49boaiwtzp" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > UpdateRdsParams.json
   ```

1. Modifique e salve o arquivo JSON dos parâmetros de execução. Por exemplo, você pode substituir o conteúdo por algo assim:

   ```
   {
   "Description":          "Update-RDS-DB",
   "VpcId":                "VPC_ID",
   "StackId":              "STACK_ID",
   "Parameters":   {
       "RDSAllocatedStorage":      80,
       }
   }
   ```

1. Envie o modelo JSON para um arquivo na sua pasta atual; este exemplo o chama de UpdateRdsRfc .json:

   ```
   aws amscm create-rfc --generate-cli-skeleton > UpdateRdsRfc.json
   ```

1. Modifique e salve o UpdateRdsRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:

   ```
   {
   "ChangeTypeVersion":    "1.0",
   "ChangeTypeId":         "ct-12w49boaiwtzp",
   "Title":                "RDS-Update-RFC"
   }
   ```

1. Crie o RFC, especificando o arquivo de parâmetros de execução e o UpdateRdsRfc arquivo:

   ```
   aws amscm create-rfc --cli-input-json file://UpdateRdsRfc.json --execution-parameters file://UpdateRdsParams.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.

1. Para visualizar o RDS, veja o resultado da execução: Use o “stack\$1id” para visualizar o RDS no console do Cloud Formation.

1. Agora você pode gerenciar o banco de dados por meio de uma ferramenta de gerenciamento de banco de dados, como o SQL Server Management Studio. Você não precisa solicitar acesso do AMS.

#### Dicas
<a name="ex-rds-update-stack-tip"></a>

**nota**  
O AMS emprega a detecção de desvios em determinadas pilhas, incluindo pilhas RDS, para determinar se a configuração muda. O AMS proíbe atualizações em uma pilha do RDS que tenha sido determinada como tendo um desvio de configuração. O RFC falhará com a seguinte mensagem de erro: “A atualização não pode ser realizada nesta pilha, entre em contato com o AMS para obter mais assistência”.

Para saber mais sobre o Amazon RDS, incluindo recomendações de tamanho, consulte a documentação do [Amazon Relational Database Service](https://aws.amazon.com/documentation/rds/).

Para atualizar uma pilha do RDS para o Aurora, consulte. [Atualizar banco de dados (para Aurora)](management-advanced-rds-database-stack-update-for-aurora.md#ex-rds-update-aurora-stack-col)

## Parâmetros de entrada de execução
<a name="management-advanced-rds-database-stack-update-input"></a>

Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para o tipo de alteração ct-12w49boaiwtzp](schemas.md#ct-12w49boaiwtzp-schema-section).

## Exemplo: parâmetros obrigatórios
<a name="management-advanced-rds-database-stack-update-ex-min"></a>

```
{
  "VpcId": "vpc-01234567890abcdef",
  "StackId": "stack-a1b2c3d4e5f67890e",
  "Parameters": {
    "RDSAllocatedStorage": 50
  }
}
```

## Exemplo: Todos os parâmetros
<a name="management-advanced-rds-database-stack-update-ex-max"></a>

```
{
  "VpcId": "vpc-01234567",
  "StackId": "stack-a1b2c3d4e5f67890e",
  "Parameters": {
    "RDSAllocatedStorage": 50,
    "RDSAllowMajorVersionUpgrade": true,
    "RDSAutoMinorVersionUpgrade": true,
    "RDSBackupRetentionPeriod": 7,
    "RDSDBParameterGroupName": "default.sqlserver-ex-13.0",
    "RDSDeletionProtection": true,
    "RDSDomain": "d-1234567890",
    "RDSDomainIAMRoleName": "customer_amazon_rds_directory_service_access_role",
    "RDSBackups": true,
    "RDSEngineVersion": "5.6.27",
    "RDSInstanceType": "db.m3.medium",
    "RDSIOPS": 0,
    "RDSMasterUserPassword": "$tr0n9PA55w0Rd",
    "RDSMultiAZ": false,
    "RDSOptionGroupName": "default:sqlserver-ex-13-00",
    "RDSPerformanceInsights" : "true",
    "RDSPerformanceInsightsKMSKey":"arn:aws:kms:us-east-1:123456789012:key/2590cd3a-f979-49db-adec-d213775385af",
    "RDSPerformanceInsightsRetentionPeriod":"7",
    "RDSPreferredBackupWindow": "22:00-23:00",
    "RDSPreferredMaintenanceWindow": "wed:03:32-wed:04:02",
    "RDSStorageType": "gp2"
  }
}
```