# Trabalhar com versões de mecanismo personalizadas para o RDS Custom para SQL Server
Uma *versão de mecanismo personalizada (CEV)* para o RDS Custom para SQL Server é uma imagem de máquina da Amazon (AMI) que inclui o Microsoft SQL Server.
**As etapas básicas do fluxo de trabalho da CEV são as seguintes:**
1. Escolha uma AMI do AWS EC2 para Windows que será usada como imagem de base para uma CEV. Você tem a opção de usar o Microsoft SQL Server pré-instalado ou usar o modelo BYOM (traga sua própria mídia) para instalar o SQL Server por conta própria.
1. Instale outros softwares no sistema operacional (SO) e personalize a configuração do SO e do SQL Server para atender às necessidades da sua empresa.
1. Salve a AMI como uma imagem dourada.
1. Crie uma versão de mecanismo personalizada (CEV) com base na imagem dourada.
1. Crie instâncias de banco de dados do RDS Custom para SQL Server usando a CEV.
Depois, o Amazon RDS gerencia essas instâncias de banco de dados para você.
Uma CEV possibilita que você mantenha sua configuração de referência preferida do sistema operacional e do banco de dados. O uso de uma CEV garante que a configuração do host, como qualquer instalação de agente de terceiro ou outras personalizações do sistema operacional, permaneça nas instâncias de banco de dados do RDS Custom para SQL Server. Com uma CEV, é possível implantar rapidamente frotas de instâncias de banco de dados do RDS Custom para SQL Server com a mesma configuração.
**Topics**
+ [Preparar-se para criar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver.preparing.md)
+ [Criar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver.create.md)
+ [Modificar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver-modifying.md)
+ [Visualizar detalhes da CEV com o Amazon RDS Custom para SQL Server](custom-viewing-sqlserver.md)
+ [Excluir uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver-deleting.md)
# Preparar-se para criar uma CEV para RDS Custom para SQL Server
Você pode criar uma CEV usando uma imagem de máquina da Amazon (AMI) que contém o Microsoft SQL Server pré-instalado com licença inclusa (LI), ou com uma AMI na qual você usa sua própria mídia de instalação do SQL Server (BYOM).
## Preparar uma CEV
Use os procedimentos a seguir para criar uma CEV usando o modelo traga sua própria mídia (BYOM) ou o Microsoft SQL Server pré-instalado (LI).
### Preparar uma CEV usando o modelo BYOM (traga sua própria mídia)
As etapas a seguir usam uma AMI com **Windows Server 2019 Base** como exemplo.
**Como criar uma CEV usando o modelo BYOM**
1. No console do Amazon EC2, selecione **Iniciar instância**.
1. Em **Nome**, insira o nome da instância.
1. Em Início rápido, selecione **Windows**.
1. Selecione **Microsoft Windows Server 2019 Base**.
1. Selecione o tipo de instância, o par de chaves, as configurações de rede e armazenamento apropriados e inicie a instância.
1. Depois de iniciar ou criar a instância do EC2, garanta que a AMI correta do Windows tenha sido selecionada na Etapa 4:
1. Selecione a instância do EC2 no console do Amazon EC2.
1. Na seção **Detalhes**, confira a **Operação de uso** e garanta que ela esteja definida como **RunInstances:0002**.
![\[AMI do Windows usando RunInstances:0002 para BYOM.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/cev-sqlserver-byom-ec2runinstances.png)
1. Faça login na instância do EC2 e copie sua mídia de instalação do SQL Server para ela.
**nota**
Se você estiver criando uma CEV usando a edição SQL Server Developer, talvez seja necessário obter a mídia de instalação usando a [assinatura do Microsoft Visual Studio](https://my.visualstudio.com/Downloads?q=sqlserver%20developer).
1. Instale o SQL Server. Faça o seguinte:
1. Examine [Requisitos do modelo BYOM para o RDS Custom para SQL Server](custom-sqlserver.byom.md#custom-sqlserver.byom.requirements) e [Versões compatíveis com CEVs do RDS Custom para SQL Server](#custom-cev-sqlserver.preparing.VersionSupport).
1. Defina o diretório-raiz da instância como o padrão `C:\Program Files\Microsoft SQL Server\`. Não altere esse diretório.
1. Defina o nome da conta do mecanismo de banco de dados do SQL Server como `NT Service\MSSQLSERVER` ou `NT AUTHORITY\NETWORK SERVICE`.
1. Defina o modo de inicialização do SQL Server como **Manual**.
1. Escolha o modo de autenticação do SQL Server como **Misto**.
1. Mantenha as configurações atuais para os diretórios de dados padrão e os locais do TempDB.
1. Conceda ao perfil de servidor sysadmin (SA) do SQL Server o privilégio de `NT AUTHORITY\SYSTEM`:
```
1. USE [master]
2. GO
3. EXEC master..sp_addsrvrolemember @loginame = N'NT AUTHORITY\SYSTEM' , @rolename = N'sysadmin'
4. GO
```
1. Instale software adicional ou personalize a configuração do sistema operacional e do banco de dados para atender aos seus requisitos.
1. Execute o Sysprep na instância do EC2. Para ter mais informações, consulte [Criar uma AMI do Amazon EC2 usando o Sysprep do Windows](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html).
1. Salve a AMI que contém sua versão instalada do SQL Server, outros softwares e personalizações. Esta será sua imagem dourada.
1. Crie uma CEV fornecendo o ID da AMI da imagem que você criou. Para saber detalhes das etapas, consulte [Criar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver.create.md).
1. Crie uma instância de banco de dados do RDS Custom para SQL Server com o uso da CEV. Para saber detalhes das etapas, consulte [Criar uma instância de banco de dados do RDS Custom para SQL Server a partir de uma CEV](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance).
### Preparar uma CEV usando o SQL Server pré-instalado (LI)
As etapas a seguir para criar uma CEV usando o Microsoft SQL Server pré-instalado (LI) usam uma AMI com o número de versão `2023.05.10` do **SQL Server CU20** como exemplo. Ao criar uma CEV, escolha uma AMI com o número de versão mais recente. Isso garante que você esteja usando uma versão compatível do Windows Server e do SQL Server com a atualização cumulativa (CU) mais recente.
**Como criar uma CEV usando o Microsoft SQL Server pré-instalado (LI)**
1. Escolha a imagem de máquina da Amazon (AMI) do AWS EC2 para Windows mais recente disponível com Microsoft Windows Server e SQL Server com licença inclusa (LI).
1. Pesquise **CU20** no [histórico de versões de AMI para Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-windows-ami-version-history.html).
1. Anote o número da versão. Para o SQL Server 2019 CU20, o número da versão é `2023.05.10`.
![\[Resultado do histórico de versões de AMI para o SQL Server 2019 CU20.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_history_li_cu20.png)
1. Abra o console do Amazon EC2 em [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. No painel de navegação esquerdo do console do Amazon EC2, selecione **Images** (Imagens) e, depois, **AMIs**.
1. Escolha **Imagens públicas**.
1. Insira `2023.05.10` na caixa de pesquisa. Uma lista de AMIs é exibida.
1. Insira `Windows_Server-2019-English-Full-SQL_2019` na caixa de pesquisa para filtrar os resultados. Os resultados a seguir devem ser exibidos.
![\[AMIs compatíveis com SQL Server 2019 CU20.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_find_ami_li_cu.png)
1. Selecione a AMI com a edição do SQL Server que deseja usar.
1. Crie ou execute uma instância do EC2 a partir da AMI selecionada.
1. Faça login na instância do EC2 e instale software adicional ou personalize a configuração do sistema operacional e do banco de dados para atender aos seus requisitos.
1. Execute o Sysprep na instância do EC2. Para obter mais informações sobre como preparar uma AMI utilizando o Sysprep, consulte [Criar uma imagem de máquina da Amazon (AMI) padronizada usando o Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#sysprep-using-ec2launchv2).
1. Salve a AMI que contém sua versão instalada do SQL Server, outros softwares e personalizações. Esta será sua imagem dourada.
1. Crie uma CEV fornecendo o ID da AMI da imagem que você criou. Para saber as etapas detalhadas sobre a criação de uma CEV, consulte [Criar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver.create.md).
1. Crie uma instância de banco de dados do RDS Custom para SQL Server com o uso da CEV. Para saber detalhes das etapas, consulte [Criar uma instância de banco de dados do RDS Custom para SQL Server a partir de uma CEV](custom-cev-sqlserver.create.md#custom-cev-sqlserver.create.newdbinstance).
## Disponibilidade de regiões para CEVs do RDS Custom para SQL Server
O suporte à versão personalizada do mecanismo (CEV) para o RDS Custom para SQL Server está disponível nas seguintes Regiões da AWS:
+ Leste dos EUA (Ohio)
+ Leste dos EUA (N. da Virgínia)
+ Oeste dos EUA (Oregon)
+ Oeste dos EUA (N. da Califórnia)
+ Ásia-Pacífico (Mumbai)
+ Ásia-Pacífico (Osaka)
+ Ásia-Pacífico (Seul)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Sydney)
+ Ásia-Pacífico (Tóquio)
+ Canadá (Central)
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Europa (Paris)
+ Europa (Estocolmo)
+ América do Sul (São Paulo)
## Versões compatíveis com CEVs do RDS Custom para SQL Server
A criação de CEV para o RDS Custom para SQL Server é compatível com as seguintes AMIs do AWS EC2 para Windows:
+ Para CEVs que utilizam mídia pré-instalada, as AMIs do Windows do AWS EC2 com Microsoft Windows Server 2019 (SO) e SQL Server 2022 ou 2019 com licença inclusa (LI).
+ Para CEVs que utilizam o modelo BYOM (traga sua própria mídia), as AMIs do Windows do AWS EC2 com Microsoft Windows Server 2019 (SO).
A criação de CEV para o RDS Custom para SQL Server é compatível com as seguintes edições de sistema operacional (SO) e banco de dados:
+ Para CEVs que utilizam mídia pré-instalada:
+ SQL Server 2022 Enterprise, Standard ou Web, com CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22 e CU22-GDR.
+ SQL Server 2019 Enterprise, Standard ou Web, com CU8, CU17, CU18, CU20, CU24, CU26, CU28-GDR, CU29-GDR, CU30, CU32 e CU32-GDR.
+ Para CEVs que utilizam o modelo BYOM (traga sua própria mídia):
+ SQL Server 2022 Enterprise, Standard ou Developer, com CU9, CU13, CU14-GDR, CU15-GDR, CU16, CU17, CU18, CU19, CU19-GDR, CU20-GDR, CU21-GDR, CU22 e CU22-GDR.
+ SQL Server 2.019 Enterprise, Standard ou Developer, com CU8, CU17, CU18, CU20, CU24, CU26, CU28-GDR, CU29-GDR, CU30, CU32 e CU32-GDR.
+ Para CEVs que utilizam mídia pré-instalada ou o modelo traga a sua própria mídia (BYOM), o Windows Server 2019 é o único SO compatível.
Consulte mais informações em [AWS Windows AMI version history](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ec2-windows-ami-version-history.html).
## Requisitos para CEVs do RDS Custom para SQL Server
Os requisitos a seguir aplicam-se à criação de uma CEV para RDS Custom para SQL Server:
+ A AMI utilizada para criar uma CEV deve se basear em uma configuração de SO e banco de dados compatível com o RDS Custom para SQL Server. Para obter mais informações sobre configurações compatíveis, consulte [Requisitos e limitações do Amazon RDS Custom for SQL Server](custom-reqs-limits-MS.md).
+ A CEV deve ter um nome exclusivo. Não é possível criar uma CEV com o mesmo nome de uma CEV já existente.
+ Você deve nomear a CEV utilizando o padrão de nomenclatura exigido do SQL Server *versão principal \$1versão secundária \$1 string personalizada*. A *versão principal \$1 versão secundária* devem corresponder à versão do SQL Server fornecida com a AMI. Por exemplo, você pode nomear uma AMI com SQL Server 2019 CU17 como **15.00.4249.2.my\$1cevtest**.
+ Você deve preparar uma AMI com o uso do Sysprep. Para obter mais informações sobre como preparar uma AMI utilizando o Sysprep, consulte [Criar uma imagem de máquina da Amazon (AMI) padronizada usando o Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-create-win-sysprep.html).
+ Você é responsável por manter o ciclo de vida da AMI. Uma instância de banco de dados do RDS Custom para SQL Server criada a partir de uma CEV não armazena uma cópia da AMI. Ela mantém um ponteiro para a AMI que você utilizou para criar a CEV. Deve existir uma AMI para que uma instância de banco de dados do RDS Custom para SQL Server permaneça funcional.
## Limitações para CEVs do RDS Custom para SQL Server
As limitações a seguir se aplicam às versões de mecanismo personalizadas com RDS Custom para SQL Server:
+ Você não poderá excluir uma CEV se houver recursos, como instâncias de banco de dados ou snapshots de banco de dados, associados a ela.
+ Para criar uma instância de banco de dados do RDS Custom para SQL Server, uma CEV deve ter o status `pending-validation`, `available`, `failed` ou `validating`. Não é possível criar uma instância de banco de dados do RDS Custom para SQL Server utilizando uma CEV se o status da CEV for `incompatible-image-configuration`.
+ Para modificar uma instância de banco de dados do RDS Custom para SQL Server para utilizar uma nova CEV, a CEV deve ter o status `available`.
+ Não é possível criar uma AMI ou CEV utilizando uma instância de banco de dados existente do RDS Custom para SQL Server.
+ Não é possível modificar uma CEV existente para usar uma AMI diferente. No entanto, é possível modificar uma instância de banco de dados existente do RDS Custom para SQL Server para utilizar uma CEV diferente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do RDS Custom for SQL Server](custom-managing.modify-sqlserver.md).
+ Não há suporte para criptografar uma AMI ou uma CEV com uma chave do KMS gerenciada pelo cliente diferente da chave do KMS fornecida durante a criação da instância de banco de dados.
+ A cópia entre regiões de CEVs não é compatível.
+ A cópia entre contas de CEVs não é compatível.
+ Não é possível restaurar ou recuperar uma CEV depois de excluí-la. No entanto, é possível criar uma CEV utilizando a mesma AMI.
+ Uma instância de banco de dados do RDS Custom para SQL Server armazena seus arquivos de banco de dados do SQL Server na unidade *D:\$1*. A AMI associada a uma CEV deve armazenar os arquivos de banco de dados do sistema Microsoft SQL Server na unidade *C:\$1*.
+ Uma instância de banco de dados do RDS Custom para SQL Server retém as alterações de configuração feitas no SQL Server. As alterações de configuração feitas no SO em uma instância de banco de dados do RDS Custom para SQL Server em execução usando uma CEV não são retidas. Se você precisar fazer uma alteração permanente na configuração do sistema operacional e retê-la como sua nova configuração de referência, crie uma CEV e modifique a instância de banco de dados para utilizá-la.
**Importante**
A modificação de uma instância de banco de dados do RDS Custom para SQL Server para utilizar uma nova CEV é uma operação off-line. Você pode realizar a modificação imediatamente ou programá-la para ocorrer durante uma janela de manutenção semanal.
+ Quando você modifica uma CEV, o Amazon RDS não envia essas modificações para nenhuma instância de banco de dados associada do RDS Custom para SQL Server. Modifique cada instância de banco de dados do RDS Custom para SQL Server para usar uma CEV nova ou atualizada. Para obter mais informações, consulte [Modificar uma instância de banco de dados do RDS Custom for SQL Server](custom-managing.modify-sqlserver.md).
+
**Importante**
Se uma AMI utilizada por uma CEV for excluída, ocorrerá uma falha em qualquer modificação que possa exigir a substituição do host, por exemplo, escalar a computação. A instância de banco de dados do RDS Custom para SQL Server será então colocada fora do perímetro de suporte do RDS Custom para SQL Server. Recomendamos que você evite excluir qualquer AMI associada a uma CEV.
# Criar uma CEV para RDS Custom para SQL Server
Você pode criar uma versão de mecanismo personalizada (CEV) com o uso do Console de gerenciamento da AWS ou da AWS CLI. Depois disso, você pode utilizar a CEV para criar uma instância de banco de dados do RDS Custom para SQL Server.
A imagem de máquina da Amazon (AMI) está na mesma conta e região da AWS que sua CEV. Caso contrário, o processo de criação do CEV falhará.
Para ter mais informações, consulte [Criar e conectar-se a uma instância de banco de dados Amazon RDS Custom for SQL Server](custom-creating-sqlserver.md).
**Importante**
As etapas para criar uma CEV são as mesmas para AMIs criadas com o SQL Server pré-instalado e aquelas criadas usando o modelo BYOM (traga sua própria mídia).
## Console
**Para criar um CEV**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Custom engine versions** (Versões de mecanismos personalizadas).
A página **Custom engine versions** (Versões de mecanismo personalizadas) mostra todas as CEVs existentes. Se você não tiver criado nenhuma CEV, a tabela estará em branco.
1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada).
1. Em **Engine type** (Tipo de mecanismo), selecione **Microsoft SQL Server**.
1. Em **Edição**, selecione a edição do mecanismo de banco de dados que deseja usar.
1. Em **Major version** (Versão principal), selecione a versão principal do mecanismo que está instalada em sua AMI.
1. Em **Version details** (Detalhes da versão), digite um nome válido em **Custom engine version name** (Nome da versão de mecanismo personalizada).
O formato do nome é `major-engine-version.minor-engine-version.customized_string`. Você pode usar de 1 a 50 caracteres alfanuméricos, sublinhados, travessões e pontos. Por exemplo, é possível inserir o nome **15.00.4249.2.my\$1cevtest**.
Opcionalmente, insira uma descrição para a CEV.
1. Em **Installation Media** (Mídia de instalação), procure ou insira o ID da AMI a partir do qual você gostaria de criar a CEV.
1. Na seção **Tags**, adicione todas as tags para identificar a CEV.
1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada).
A página **Custom engine versions** (Versões de mecanismo personalizadas) é exibida. Sua CEV é mostrada com o status de **pending-validation** (validação pendente)
## AWS CLI
Para criar uma CEV utilizando a AWS CLI, execute o comando [create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
São necessárias as seguintes opções:
+ `--engine`
+ `--engine-version`
+ `--image-id`
Também é possível especificar as seguintes opções:
+ `--description`
+ `--region`
+ `--tags`
O exemplo a seguir cria uma CEV chamada `15.00.4249.2.my_cevtest`. O nome de sua CEV deve começar com o número da versão principal do mecanismo.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --image-id ami-0r93cx31t5r596482 \
5. --description "Custom SQL Server EE 15.00.4249.2 cev test"
```
A saída parcial a seguir mostra o mecanismo, os grupos de parâmetros e outras informações.
```
1. "DBEngineVersions": [
2. {
3. "Engine": "custom-sqlserver-ee",
4. "MajorEngineVersion": "15.00",
5. "EngineVersion": "15.00.4249.2.my_cevtest",
6. "DBEngineDescription": "Microsoft SQL Server Enterprise Edition for RDS Custom for SQL Server",
7. "DBEngineVersionArn": "arn:aws:rds:us-east-1::cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
8. "DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
9.
10. "Image": [
11. "ImageId": "ami-0r93cx31t5r596482",
12. "Status": "pending-validation"
13. ],
14. "CreateTime": "2022-11-20T19:30:01.831000+00:00",
15. "SupportsLogExportsToCloudwatchLogs": false,
16. "SupportsReadReplica": false,
17. "Status": "pending-validation",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "TagList": []
21. }
22. ]
```
Se o processo de criação de uma CEV falhar, o RDS Custom para SQL Server emitirá `RDS-EVENT-0198` com a mensagem `Creation failed for custom engine version major-engine-version.cev_name`. A mensagem inclui detalhes sobre a falha, por exemplo, o evento imprime arquivos ausentes. Para encontrar ideias de solução de problemas na criação da CEV, consulte [Solucionar erros de CEV para o RDS Custom para SQL Server](custom-troubleshooting-sqlserver.md#custom-troubleshooting-sqlserver.cev).
## Criar uma instância de banco de dados do RDS Custom para SQL Server a partir de uma CEV
Depois de criar uma CEV com êxito, o **CEV status** (Status da CEV) exibe `pending-validation`. Agora você pode criar uma instância de banco de dados do RDS Custom para SQL Server com o uso da CEV. Para criar uma instância de banco de dados do RDS Custom para SQL Server a partir de uma CEV, consulte [Criar uma instância de banco de dados do RDS Custom for SQL Server](custom-creating-sqlserver.md#custom-creating-sqlserver.create).
## Ciclo de vida de uma CEV
O ciclo de vida da CEV inclui os status a seguir.
****
| Status da CEV | Descrição | Sugestões de solução de problemas |
| --- | --- | --- |
| `pending-validation` | Uma CEV foi criada e está com a validação pendente da AMI associada. Uma CEV permanecerá em `pending-validation` até que uma instância de banco de dados do RDS Custom para SQL Server seja criada a partir dela. | Se não houver nenhuma tarefa existente, crie uma instância de banco de dados do RDS Custom para SQL Server a partir da CEV. Ao criar a instância de banco de dados do RDS Custom para SQL Server, o sistema tenta validar a AMI associada de uma CEV. |
| `validating` | Uma tarefa de criação da instância de banco de dados do RDS Custom para SQL Server com base em uma nova CEV está em andamento. Ao criar a instância de banco de dados do RDS Custom para SQL Server, o sistema tenta validar a AMI associada de uma CEV. | Aguarde a conclusão da tarefa de criação da instância de banco de dados existente do RDS Custom para SQL Server. Você pode usar o console do RDS EVENTS para revisar mensagens detalhadas de eventos para solução de problemas. |
| `available` | A CEV foi validada com êxito. Uma CEV entrará no status `available` quando uma instância de banco de dados do RDS Custom para SQL Server tiver sido criada com êxito a partir dela. | A CEV não exige nenhuma validação adicional. Ela pode ser usada para criar instâncias de banco de dados do RDS Custom para SQL Server ou modificar as existentes. |
| `inactive` | A CEV foi modificada para um estado inativo. | Você não pode criar nem atualizar uma instância de banco de dados do RDS Custom com essa CEV. Além disso, não é possível restaurar um snapshot de banco de dados para criar uma instância de banco de dados do RDS Custom com essa CEV. Para obter informações sobre como alterar o estado para `ACTIVE`, consulte [Modificar uma CEV para RDS Custom para SQL Server](custom-cev-sqlserver-modifying.md). |
| `failed` | A etapa de criação da instância de banco de dados falhou para essa CEV antes de ela validar a AMI. Como alternativa, a AMI subjacente usada pela CEV não está em um estado disponível. | Solucione a causa raiz do motivo pelo qual o sistema não conseguiu criar a instância de banco de dados. Veja a mensagem de erro detalhada e tente criar uma instância de banco de dados novamente. A AMI subjacente usada pela CEV não deve estar em um estado disponível. |
| `incompatible-image-configuration` | Houve um erro ao validar a AMI. | Veja os detalhes técnicos do erro. Você não pode tentar validar a AMI com essa CEV novamente. Analise o seguinte: recomendações: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev-sqlserver.create.html) Crie uma CEV com as informações corretas. Se necessário, crie uma instância do EC2 utilizando uma AMI compatível e execute o processo Sysprep nela. |
# Modificar uma CEV para RDS Custom para SQL Server
Você pode modificar uma CEV utilizando a Console de gerenciamento da AWS ou a AWS CLI. Você pode modificar a descrição da CEV ou seu status de disponibilidade. Sua CEV tem um dos seguintes valores de status:
+ `available` – Você pode utilizar essa CEV para criar uma nova instância de banco de dados do RDS Custom ou fazer upgrade de uma instância de banco de dados. Esse é o status padrão para uma CEV recém-criada.
+ `inactive`: você não pode criar nem atualizar uma instância de banco de dados do RDS Custom com essa CEV. Não é possível restaurar um DB snapshot para criar uma nova instância de banco de dados do RDS Custom com essa CEV.
Você pode alterar o status da CEV de `available` para `inactive` ou de `inactive` para `available`. Você pode alterar o status para `INACTIVE` para evitar o uso acidental de uma CEV ou tornar uma CEV descontinuada elegível para uso novamente.
## Console
**Para modificar uma CEV**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Custom engine versions** (Versões de mecanismos personalizadas).
1. Escolha uma CEV cuja descrição ou status você queira modificar.
1. Para **Actions (Ações)**, escolha **Modify (Modificar)**.
1. Faça uma ou todas as alterações a seguir:
+ Para **CEV status settings** (Configurações de status da CEV), escolha um novo status de disponibilidade.
+ Para **Version description** (Descrição da versão), insira uma nova descrição.
1. Selecione **Modify CEV** (Modificar CEV).
Se a CEV estiver em uso, o console exibirá **You can't modify the CEV status** (Não é possível modificar o status da CEV). Corrija os problemas e tente novamente.
A página **Custom engine versions** (Versões de mecanismo personalizadas) é exibida.
## AWS CLI
Para modificar uma CEV utilizando a AWS CLI, execute o comando [modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html). Você pode encontrar CEVs para modificar executando o comando [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
São necessárias as seguintes opções:
+ `--engine`
+ `--engine-version cev`, em que *`cev`* é o nome da versão de mecanismo personalizada que você deseja modificar
+ `--status`` status`, em que *`status`* é o status de disponibilidade que você deseja atribuir à CEV
O exemplo a seguir altera uma CEV chamada `15.00.4249.2.my_cevtest` do status atual para `inactive`.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest \
4. --status inactive
```
Para Windows:
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest ^
4. --status inactive
```
Para modificar uma instância de banco de dados do RDS Custom para SQL Server para usar uma nova CEV, consulte [Modificar uma instância de banco de dados do RDS Custom para SQL Server para usar uma nova CEV](custom-cev-sqlserver-modifying-dbinstance.md).
# Modificar uma instância de banco de dados do RDS Custom para SQL Server para usar uma nova CEV
Não é possível modificar uma instância de banco de dados existente do RDS Custom para SQL Server para usar uma CEV diferente. As alterações que você pode fazer são:
+ Alterar a CEV
+ Alterar a classe da instância de banco de dados
+ Alterar o período de retenção de backup e a janela de backup
+ Alterar a janela de manutenção
## Console
**Para modificar uma instância de banco de dados do RDS Custom for SQL Server**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Databases (Bancos de dados)**.
1. Escolha a instância de banco de dados que você deseja modificar.
1. Selecione **Modify**.
1. Faça as seguintes alterações, conforme necessário:
1. Em **DB engine version** (Versão do mecanismo de banco de dados), selecione outra CEV.
1. Altere o valor de **DB instance class** (Classe da instância de banco de dados). Para conhecer as classes com suporte, consulte [Compatibilidade com classes de instâncias de banco de dados do RDS Custom for SQL Server](custom-reqs-limits.instancesMS.md).
1. Altere o valor de **Backup retention period** (Período de retenção de backup).
1. Para **Backup window** (Janela de backup), defina valores para **Start time** (Horário de início) e **Duration** (Duração).
1. Para **DB instance maintenance window** (Janela de manutenção da instância de banco de dados), defina valores para **Start day** (Dia de início), **Start time** (Horário de início) e **Duration** (Duração).
1. Escolha **Continuar**.
1. Escolha **Apply immediately** (Aplicar imediatamente) ou **Apply during the next scheduled maintenance window** (Aplicar durante a próxima janela de manutenção programada).
1. Selecione **Modify DB instance (Modificar instância de banco de dados)**.
**nota**
Ao modificar uma instância de banco de dados de uma CEV para outra CEV, por exemplo, ao atualizar uma versão secundária, os bancos de dados do sistema do SQL Server, inclusive seus dados e configurações, permanecem na instância de banco de dados atual do RDS Custom para SQL Server.
## AWS CLI
Para modificar uma instância de banco de dados para usar outra CV utilizando a AWS CLI, execute o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html).
São necessárias as seguintes opções:
+ `--db-instance-identifier`
+ `--engine-version cev`, em que *`cev`* é o nome da versão de mecanismo personalizada que você deseja modificar
O exemplo a seguir modifica uma instância de banco de dados denominada `my-cev-db-instance` para usar uma CEV denominada `15.00.4249.2.my_cevtest_new` e aplica a alteração imediatamente.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds modify-db-instance \
2. --db-instance-identifier my-cev-db-instance \
3. --engine-version 15.00.4249.2.my_cevtest_new \
4. --apply-immediately
```
Para Windows:
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier my-cev-db-instance ^
3. --engine-version 15.00.4249.2.my_cevtest_new ^
4. --apply-immediately
```
# Visualizar detalhes da CEV com o Amazon RDS Custom para SQL Server
Você pode ver detalhes sobre sua CEV utilizando o Console de gerenciamento da AWS ou a AWS CLI.
## Console
**Como visualizar detalhes da CEV**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Custom engine versions** (Versões de mecanismos personalizadas).
A página **Custom engine versions** (Versões de mecanismo personalizadas) mostra todas as CEVs existentes. Se você não tiver criado uma CEV, a página estará vazia.
1. Selecione o nome da CEV que você deseja visualizar.
1. Selecione **Configuration** (Configuração) para visualizar os detalhes.
![\[Visualize os detalhes da configuração de uma CEV.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/rds_custom_sqlserver_cev_viewdetails.PNG)
## AWS CLI
Para ver detalhes sobre uma CEV com o uso da AWS CLI, execute o comando [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
Também é possível especificar as seguintes opções:
+ `--include-all`, para visualizar todas as CEVs com qualquer estado do ciclo de vida. Sem a opção `--include-all`, somente as CEVs em um estado de ciclo de vida `available` serão retornadas.
```
aws rds describe-db-engine-versions --engine custom-sqlserver-ee --engine-version 15.00.4249.2.my_cevtest --include-all
{
"DBEngineVersions": [
{
"Engine": "custom-sqlserver-ee",
"MajorEngineVersion": "15.00",
"EngineVersion": "15.00.4249.2.my_cevtest",
"DBParameterGroupFamily": "custom-sqlserver-ee-15.0",
"DBEngineDescription": "Microsoft SQL Server Enterprise Edition for custom RDS",
"DBEngineVersionArn": "arn:aws:rds:us-east-1:{my-account-id}:cev:custom-sqlserver-ee/15.00.4249.2.my_cevtest/a1234a1-123c-12rd-bre1-1234567890",
"DBEngineVersionDescription": "Custom SQL Server EE 15.00.4249.2 cev test",
"Image": {
"ImageId": "ami-0r93cx31t5r596482",
"Status": "pending-validation"
},
"DBEngineMediaType": "AWS Provided",
"CreateTime": "2022-11-20T19:30:01.831000+00:00",
"ValidUpgradeTarget": [],
"SupportsLogExportsToCloudwatchLogs": false,
"SupportsReadReplica": false,
"SupportedFeatureNames": [],
"Status": "pending-validation",
"SupportsParallelQuery": false,
"SupportsGlobalDatabases": false,
"TagList": [],
"SupportsBabelfish": false
}
]
}
```
Você pode utilizar filtros para visualizar CEVs com determinado status de ciclo de vida. Por exemplo, para visualizar CEVs com um status de ciclo de vida de `pending-validation`, `available` ou `failed`:
```
aws rds describe-db-engine-versions engine custom-sqlserver-ee
region us-west-2 include-all query 'DBEngineVersions[?Status == pending-validation ||
Status == available || Status == failed]'
```
# Excluir uma CEV para RDS Custom para SQL Server
É possível excluir uma CEV usando o Console de gerenciamento da AWS ou a AWS CLI. Normalmente, essa tarefa demora alguns minutos.
Antes de excluir uma CEV, verifique se ela não está em uso por nenhum dos seguintes procedimentos:
+ Uma instância de banco de dados do RDS Custom
+ Um snapshot de uma instância de banco de dados do RDS Custom
+ Um backup automatizado da sua instância de banco de dados do RDS Custom
## Console
**Para excluir uma CEV**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. No painel de navegação, escolha **Custom engine versions** (Versões de mecanismos personalizadas).
1. Escolha uma CEV cuja descrição ou status você deseja excluir.
1. Em **Ações**, escolha **Excluir**.
A caixa de diálogo **Delete *cev\$1name*?** (Excluir cev\$1name?) é exibida.
1. Insira **delete me** e escolha **Delete (Excluir)**.
Na página **Custom engine versions** (Versões de mecanismos personalizadas), o banner mostra que sua CEV está sendo excluída.
## AWS CLI
Para excluir uma CEV utilizando a AWS CLI, execute o comando [delete-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html).
São necessárias as seguintes opções:
+ `--engine custom-sqlserver-ee`
+ `--engine-version cev`, em que *cev* é o nome da versão de mecanismo personalizada a ser excluída
O exemplo a seguir exclui uma CEV chamada `15.00.4249.2.my_cevtest`.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-sqlserver-ee \
3. --engine-version 15.00.4249.2.my_cevtest
```
Para Windows:
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-sqlserver-ee ^
3. --engine-version 15.00.4249.2.my_cevtest
```