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