# Trabalhar com versões de mecanismo personalizadas para o Amazon RDS Custom for Oracle
Uma *versão de mecanismo personalizada (CEV)* para o Amazon RDS Custom for Oracle é um snapshot de volume binário de um mecanismo de banco de dados e de uma imagem de máquina da Amazon (AMI) específica. Por padrão, o RDS Custom para Oracle usa a AMI mais recente disponível, gerenciada pelo RDS Custom, mas você pode especificar uma AMI que foi usada em uma CEV anterior. Você armazena seus arquivos de instalação do banco de dados no Amazon S3. O RDS Custom usa os arquivos de instalação e a AMI para criar a CEV para você.
**Topics**
+ [Preparar-se para criar uma CEV](custom-cev.preparing.md)
+ [Criar um CEV](custom-cev.create.md)
+ [Modificar o status da CEV](custom-cev.modify.md)
+ [Visualizar detalhes da CEV com o Amazon RDS Custom para Oracle](custom-cev.view.md)
+ [Excluir uma CEV](custom-cev.delete.md)
# Preparar-se para criar uma CEV
Para criar uma CEV, acesse os arquivos de instalação e os patches armazenados no bucket do Amazon S3 para qualquer uma das seguintes versões:
+ Oracle Database 19c
+ Oracle Database 18c
+ Oracle Database 12c Versão 2 (12.2)
+ Oracle Database 12c Versão 1 (12.1)
Por exemplo, é possível utilizar a RU/RUR de abril de 2021 para o Oracle Database 19c, ou qualquer combinação válida de arquivos de instalação e patches. Para ter mais informações sobre as regiões e as versões compatíveis com o RDS Custom para Oracle, consulte [RDS Custom with RDS for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.html#Concepts.RDS_Fea_Regions_DB-eng.Feature.RDSCustom.ora) (RDS Custom com RDS para Oracle).
**Topics**
+ [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates)
+ [Etapa 2: Baixar arquivos de instalação do banco de dados e patches do Oracle Software Delivery Cloud](#custom-cev.preparing.download)
+ [Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3](#custom-cev.preparing.s3)
+ [Etapa 4 (opcional): Compartilhar a mídia de instalação no S3 entreContas da AWS](#custom-cev.preparing.accounts)
+ [Etapa 5: Preparar o manifesto CEV](#custom-cev.preparing.manifest)
+ [Etapa 6 (opcional): Validar o manifesto CEV](#custom-cev.preparing.validating)
+ [Etapa 7: Adicionar permissões do IAM necessárias](#custom-cev.preparing.iam)
## Etapa 1 (opcional): Baixar os modelos de manifesto
Um *manifesto CEV* é um documento JSON que inclui a lista de arquivos .zip de instalação do banco de dados para sua CEV. Para criar uma CEV, faça o seguinte:
1. Identifique os arquivos de instalação do banco de dados Oracle que você deseja incluir em sua CEV.
1. Baixe os arquivos de instalação.
1. Crie um manifesto JSON que liste os arquivos de instalação.
O RDS Custom para Oracle fornece modelos de manifesto JSON com nossos arquivos .zip recomendados para cada versão compatível do Oracle Database. Por exemplo, o modelo a seguir é para a RU 19.17.0.0.0.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p34419443_190000_Linux-x86-64.zip",
"p34411846_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
"p28852325_190000_Linux-x86-64.zip",
"p29997937_190000_Linux-x86-64.zip",
"p31335037_190000_Linux-x86-64.zip",
"p32327201_190000_Linux-x86-64.zip",
"p33613829_190000_Linux-x86-64.zip",
"p34006614_190000_Linux-x86-64.zip",
"p34533061_190000_Linux-x86-64.zip",
"p34533150_190000_Generic.zip",
"p28730253_190000_Linux-x86-64.zip",
"p29213893_1917000DBRU_Generic.zip",
"p33125873_1917000DBRU_Linux-x86-64.zip",
"p34446152_1917000DBRU_Linux-x86-64.zip"
]
}
```
Cada modelo tem um arquivo leiame associado que inclui instruções para baixar os patches, os URLs para os arquivos .zip e somas de verificação de arquivos. Você pode usar esses modelos como estão ou modificá-los com seus próprios patches. Para revisar os modelos, baixe o [custom-oracle-manifest.zip](samples/custom-oracle-manifest.zip) em seu disco local e abra-o com uma aplicação de arquivamento de arquivos. Para ter mais informações, consulte [Etapa 5: Preparar o manifesto CEV](#custom-cev.preparing.manifest).
## Etapa 2: Baixar arquivos de instalação do banco de dados e patches do Oracle Software Delivery Cloud
Depois de identificar os arquivos de instalação que deseja para sua CEV, baixe-os para o sistema local. Os patches e arquivos de instalação do Oracle Database estão hospedados na Oracle Software Delivery Cloud. Cada CEV exige uma versão de base, como o Oracle Database 19c ou o Oracle Database 12c Versão 2 (12.2) e uma lista opcional de patches.
**Como baixar os arquivos de instalação do banco de dados para o Oracle Database**
1. Acesse [https://edelivery.oracle.com/](https://edelivery.oracle.com/) e faça login.
1. Na caixa, insira **Oracle Database Enterprise Edition** ou **Oracle Database Standard Edition 2** e selecione **Pesquisar**.
1. Selecione uma das seguintes versões de base:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Escolha **Continuar**.
1. Limpe a caixa de diálogo **Download Queue** (Baixar fila).
1. Selecione a opção que corresponde à sua versão de base:
+ **Oracle Database 19.3.0.0.0: Long Term Release**.
+ **Oracle Database 18.0.0.0.0**
+ **Oracle Database 12.2.0.1.0**.
+ **Oracle Database 12.1.0.2.0**.
1. Escolha **Linux x86-64** em **Platform/Languages** (Plataforma/Idiomas).
1. Selecione **Continuar** e, depois, assine o Contrato de Licença da Oracle.
1. Selecione o arquivo .zip que corresponde à sua versão de base:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. Baixe os patches Oracle desejados de `updates.oracle.com` ou `support.oracle.com` para seu sistema local. Você pode encontrar os URLs dos patches nos seguintes locais:
+ Os arquivos leiame no arquivo .zip que você baixou em [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates)
+ Os patches listados em cada atualização de versão (RU) em [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes)
## Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3
Carregue seus arquivos de patch e instalação do Oracle no Amazon S3 utilizando a AWS CLI. O bucket do S3 que contém seus arquivos de instalação deve estar na mesma região da AWS que a CEV.
Os exemplos nesta seção usam os seguintes espaços reservados:
+ `install-or-patch-file.zip` – Arquivo de mídia de instalação do Oracle. Por exemplo, p32126828\$1190000\$1Linux-x86-64.zip é um patch.
+ `amzn-s3-demo-destination-bucket` – Seu bucket do Amazon S3 designado aos seus arquivos de instalação carregados.
+ `123456789012/cev1`: um prefixo opcional no bucket do Amazon S3.
+ `amzn-s3-demo-source-bucket`: um bucket do Amazon S3 no qual há a opção de preparar arquivos.
**Topics**
+ [Etapa 3a: Verifique se o bucket do S3 está no local correto Região da AWS](#custom-cev.preparing.s3.verify-region)
+ [Etapa 3b: Certifique-se de que sua política de bucket do S3 tenha as permissões corretas](#custom-cev.preparing.s3.verify-policy)
+ [Etapa 3c: Carregue seus arquivos usando os comandos cp ou sync](#custom-cev.preparing.s3.upload)
+ [Etapa 3: Listar os arquivos no bucket do S3](#custom-cev.preparing.s3.list)
### Etapa 3a: Verifique se o bucket do S3 está no local correto Região da AWS
Verifique se o bucket do S3 está na região do AWS na qual você planeja executar o comando `create-custom-db-engine-version`.
```
aws s3api get-bucket-location --bucket amzn-s3-demo-destination-bucket
```
### Etapa 3b: Certifique-se de que sua política de bucket do S3 tenha as permissões corretas
É possível criar uma CEV do zero ou a partir de uma CEV de origem. Se você planeja criar um novo CEV a partir dos CEVs de origem, certifique-se de que sua política de bucket do S3 tenha as permissões corretas:
1. Identificar o bucket do S3, reservado pelo RDS Custom. O nome do bucket tem o formato`do-not-delete-rds-custom-account-region-string`. Por exemplo, ele pode ser `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE`.
1. Certifique-se de que a permissão a seguir esteja anexada à sua política de bucket do S3. Substitua `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` pelo nome do seu bucket.
```
{
"Sid": "AWSRDSCustomForOracleCustomEngineVersionGetObject",
"Effect": "Allow",
"Principal": {
"Service": "custom.rds.amazonaws.com"
},
"Action": [
"s3:GetObject",
"s3:GetObjectTagging"
],
"Resource": "arn:aws:s3:::do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE/CustomEngineVersions/*"
}, ...
```
### Etapa 3c: Carregue seus arquivos usando os comandos cp ou sync
Escolha uma das seguintes opções:
+ Use `aws s3 cp` para carregar um único arquivo .zip.
Carregue cada arquivo .zip de instalação separadamente. Não combine os arquivos .zip em um único arquivo .zip.
+ Use `aws s3 sync` para carregar um diretório.
**Example**
O exemplo a seguir carrega `install-or-patch-file.zip` na pasta `123456789012/cev1` do bucket do Amazon S3 do RDS Custom. Execute um comando `aws s3` separado para cada .zip que você deseja carregar.
Para Linux, macOS ou Unix:
```
1. aws s3 cp install-or-patch-file.zip \
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:
```
1. aws s3 cp install-or-patch-file.zip ^
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
O exemplo a seguir carrega os arquivos da pasta *cev1* local na pasta *123456789012/cev1* do seu bucket do Amazon S3.
Para Linux, macOS ou Unix:
```
aws s3 sync cev1 \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:
```
aws s3 sync cev1 ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
O exemplo a seguir faz upload de todos os arquivos em `amzn-s3-demo-source-bucket` na pasta **`123456789012/cev1`** em seu bucket do Amazon S3.
Para Linux, macOS ou Unix:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Para Windows:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
### Etapa 3: Listar os arquivos no bucket do S3
O exemplo a seguir usa o `s3 ls` comando para listar os arquivos no bucket do Amazon S3 do RDS Custom.
```
aws s3 ls \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
## Etapa 4 (opcional): Compartilhar a mídia de instalação no S3 entreContas da AWS
Para os fins desta seção, o bucket do Amazon S3 que contém os arquivos de instalação do Oracle enviados é seu *bucket de mídia*. Sua organização pode usar várias Contas da AWS em uma Região da AWS. Se sim, você pode optar por usar uma Conta da AWS para preencher o bucket de mídia e outra Conta da AWS para criar CEVs. Se você não pretende compartilhar o bucket de mídia, vá para a próxima seção.
Esta seção supõe o seguinte:
+ Você tem acesso à conta que criou o bucket de mídia e a uma conta diferente na qual pretende criar CEVs.
+ Você pretende criar CEVs em uma única Região da AWS. Se você pretende usar várias regiões, crie um bucket de mídia em cada região.
+ Você está usando a CLI. Se estiver usando o console do Amazon S3, adapte as etapas a seguir.
**Como configurar o bucket de mídia para compartilhamento entre Contas da AWS**
1. Faça login na Conta da AWS que contém o bucket do S3 no qual você fez upload da mídia de instalação.
1. Comece com um modelo de política JSON em branco ou com uma política existente que você possa adaptar.
O comando a seguir recupera uma política existente e a salva como *my-policy.json*. Neste exemplo, o bucket do S3 que contém os arquivos de instalação é chamado de *amzn-s3-demo-bucket*.
```
aws s3api get-bucket-policy \
--bucket amzn-s3-demo-bucket \
--query Policy \
--output text > my-policy.json
```
1. Edite as permissões do bucket de mídia da seguinte forma:
+ No elemento `Resource` do modelo, especifique o bucket do S3 no qual você fez upload dos arquivos de instalação do Oracle Database.
+ No elemento `Principal`, especifique os ARNs de todas as Contas da AWS que você pretende usar para criar CEVs. Você pode adicionar a raiz, um usuário ou um perfil à lista de permissões do bucket do S3. Para ter mais informações, consulte [Identificadores do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html) no *Manual do usuário do AWS Identity and Access Management*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "GrantAccountsAccess",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::111122223333:root",
"arn:aws:iam::444455556666:user/user-name-with-path",
"arn:aws:iam::123456789012:role/role-name-with-path"
]
},
"Action": [
"s3:GetObject",
"s3:GetObjectAcl",
"s3:GetObjectTagging",
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
1. Associe a política ao bucket de mídia.
No exemplo a seguir, *amzn-s3-demo-bucket* é o nome do bucket do S3 que contém os arquivos de instalação e *my-policy.json* é o nome do arquivo JSON.
```
aws s3api put-bucket-policy \
--bucket amzn-s3-demo-bucket \
--policy file://my-policy.json
```
1. Faça login em uma Conta da AWS na qual pretende criar CEVs.
1. Verifique se essa conta pode acessar o bucket de mídia na Conta da AWS que o criou.
```
aws s3 ls --query "Buckets[].Name"
```
Para ter mais informações, consulte [aws s3 ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) na *Referência de comandos da AWS CLI*.
1. Crie uma CEV seguindo as etapas em [Criar um CEV](custom-cev.create.md).
## Etapa 5: Preparar o manifesto CEV
Um manifesto de CEV é um documento JSON que inclui o seguinte conteúdo:
+ (Obrigatório) A lista de arquivos .zip carregados no Amazon S3. O RDS Custom aplica os patches na ordem em que eles estão listados no manifesto.
+ (Opcional) Parâmetros de instalação que definem valores não padrão para a base do Oracle, o Oracle home e o ID e o nome do usuário e grupo do UNIX/Linux. Lembre-se de que você não pode modificar os parâmetros de instalação de uma CEV existente ou de uma instância de banco de dados existente. Você também não pode realizar a atualização uma para outra CEV quando os parâmetros de instalação têm configurações diferentes.
Para obter exemplos de manifestos CEV, consulte os modelos JSON que você baixou em [Etapa 1 (opcional): Baixar os modelos de manifesto](#custom-cev.preparing.templates). Também é possível revisar os exemplos em [Exemplos de manifesto de CEV](#custom-cev.preparing.manifest.examples).
**Topics**
+ [Campos JSON no manifesto de CEV](#custom-cev.preparing.manifest.fields)
+ [Criar o manifesto de CEV](#custom-cev.preparing.manifest.creating)
+ [Exemplos de manifesto de CEV](#custom-cev.preparing.manifest.examples)
### Campos JSON no manifesto de CEV
A tabela a seguir descreve os campos JSON no manifesto.
| Campo JSON | Descrição |
| --- | --- |
| `MediaImportTemplateVersion` | Versão do manifesto de CEV. A data deve estar no formato `YYYY-MM-DD`. |
| `databaseInstallationFileNames` | Lista ordenada de arquivos de instalação do banco de dados. |
| `opatchFileNames` | Lista ordenada de instaladores OPatch utilizados para o mecanismo de banco de dados Oracle. Apenas um valor é válido. Valores para `opatchFileNames` devem começar com `p6880880_`. |
| `psuRuPatchFileNames` | Os patches PSU e RU desse banco de dados. Se você incluir `psuRuPatchFileNames`, `opatchFileNames` será obrigatório. Valores para `opatchFileNames` devem começar com `p6880880_`. |
| `OtherPatchFileNames` | Os patches que não estão na lista de patches PSU e RU. O RDS Custom aplicará esses patches após a aplicação dos patches PSU e RU. Se você incluir `OtherPatchFileNames`, `opatchFileNames` será obrigatório. Valores para `opatchFileNames` devem começar com `p6880880_`. |
| `installationParameters` | Configurações não padrão para a base do Oracle, o Oracle Home e o ID e o nome do usuário e do grupo do UNIX/Linux. É possível definir os seguintes parâmetros: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/custom-cev.preparing.html) |
Cada versão do Oracle Database tem uma lista diferente de arquivos de instalação compatíveis. Ao criar seu manifesto de CEV, especifique somente os arquivos que são compatíveis com o RDS Custom para Oracle. Caso contrário, a criação da CEV falhará com um erro. Todos os patches listados em [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) são compatíveis.
### Criar o manifesto de CEV
**Como criar um manifesto de CEV**
1. Liste todos os arquivos de instalação que você planeja aplicar, na ordem em que deseja aplicá-los.
1. Correlacione os arquivos de instalação com os campos JSON descritos em [Campos JSON no manifesto de CEV](#custom-cev.preparing.manifest.fields).
1. Realize um dos procedimentos a seguir:
+ Crie o manifesto de CEV como um arquivo de texto JSON.
+ Edite o modelo de manifesto de CEV ao criar a CEV no console. Para ter mais informações, consulte [Criar um CEV](custom-cev.create.md).
### Exemplos de manifesto de CEV
Os exemplos a seguir mostram arquivos de manifesto de CEV para diferentes versões do Oracle Database. Se você incluir um campo JSON no manifesto, nunca deixe-o vazio. Por exemplo, o manifesto de CEV a seguir é inválido porque `otherPatchFileNames` está vazio.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
]
}
```
**Tópicos**
+ [Sample CEV manifest for Oracle Database 12c Release 1 (12.1)](#oracle-cev-manifest-12.1)
+ [Sample CEV manifest for Oracle Database 12c Release 2 (12.2)](#oracle-cev-manifest-12.2)
+ [Sample CEV manifest for Oracle Database 18c](#oracle-cev-manifest-18c)
+ [Sample CEV manifest for Oracle Database 19c](#oracle-cev-manifest-19c)
**Example Exemplo de manifesto de CEV para Oracle Database 12c versão 1 (12.1)**
No exemplo a seguir para a PSU de julho de 2021 do Oracle Database 12c versão 1 (12.1), o RDS Custom aplica os patches na sequência especificada. Assim, o RDS Custom aplica p32768233, depois p32876425, depois p18759211 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V46095-01_1of2.zip",
"V46095-01_2of2.zip"
],
"opatchFileNames":[
"p6880880_121010_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p32768233_121020_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p32876425_121020_Linux-x86-64.zip",
"p18759211_121020_Linux-x86-64.zip",
"p19396455_121020_Linux-x86-64.zip",
"p20875898_121020_Linux-x86-64.zip",
"p22037014_121020_Linux-x86-64.zip",
"p22873635_121020_Linux-x86-64.zip",
"p23614158_121020_Linux-x86-64.zip",
"p24701840_121020_Linux-x86-64.zip",
"p25881255_121020_Linux-x86-64.zip",
"p27015449_121020_Linux-x86-64.zip",
"p28125601_121020_Linux-x86-64.zip",
"p28852325_121020_Linux-x86-64.zip",
"p29997937_121020_Linux-x86-64.zip",
"p31335037_121020_Linux-x86-64.zip",
"p32327201_121020_Linux-x86-64.zip",
"p32327208_121020_Generic.zip",
"p17969866_12102210119_Linux-x86-64.zip",
"p20394750_12102210119_Linux-x86-64.zip",
"p24835919_121020_Linux-x86-64.zip",
"p23262847_12102201020_Linux-x86-64.zip",
"p21171382_12102201020_Generic.zip",
"p21091901_12102210720_Linux-x86-64.zip",
"p33013352_12102210720_Linux-x86-64.zip",
"p25031502_12102210720_Linux-x86-64.zip",
"p23711335_12102191015_Generic.zip",
"p19504946_121020_Linux-x86-64.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.12.1.0.2",
"oracleBase": "/home/oracle"
}
}
```
**Example Exemplo de manifesto de CEV para Oracle Database 12c versão 2 (12.2)**
No exemplo a seguir para a PSU de outubro de 2021 do Oracle Database 12c versão 2 (12.2), o RDS Custom aplica p33261817, depois p33192662, depois p29213893 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V839960-01.zip"
],
"opatchFileNames":[
"p6880880_122010_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p33261817_122010_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p33192662_122010_Linux-x86-64.zip",
"p29213893_122010_Generic.zip",
"p28730253_122010_Linux-x86-64.zip",
"p26352615_12201211019DBOCT2021RU_Linux-x86-64.zip",
"p23614158_122010_Linux-x86-64.zip",
"p24701840_122010_Linux-x86-64.zip",
"p25173124_122010_Linux-x86-64.zip",
"p25881255_122010_Linux-x86-64.zip",
"p27015449_122010_Linux-x86-64.zip",
"p28125601_122010_Linux-x86-64.zip",
"p28852325_122010_Linux-x86-64.zip",
"p29997937_122010_Linux-x86-64.zip",
"p31335037_122010_Linux-x86-64.zip",
"p32327201_122010_Linux-x86-64.zip",
"p32327208_122010_Generic.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.12.2.0.1",
"oracleBase": "/home/oracle"
}
}
```
**Example Exemplo de manifesto de CEV para Oracle Database 18c**
No exemplo a seguir para a PSU de outubro de 2021 do Oracle Database 18c, o RDS Custom aplica p32126855, depois p28730253, depois p27539475 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.
```
{
"mediaImportTemplateVersion":"2020-08-14",
"databaseInstallationFileNames":[
"V978967-01.zip"
],
"opatchFileNames":[
"p6880880_180000_Linux-x86-64.zip"
],
"psuRuPatchFileNames":[
"p32126855_180000_Linux-x86-64.zip"
],
"otherPatchFileNames":[
"p28730253_180000_Linux-x86-64.zip",
"p27539475_1813000DBRU_Linux-x86-64.zip",
"p29213893_180000_Generic.zip",
"p29374604_1813000DBRU_Linux-x86-64.zip",
"p29782284_180000_Generic.zip",
"p28125601_180000_Linux-x86-64.zip",
"p28852325_180000_Linux-x86-64.zip",
"p29997937_180000_Linux-x86-64.zip",
"p31335037_180000_Linux-x86-64.zip",
"p31335142_180000_Generic.zip"
]
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/18.0.0.0.ru-2020-10.rur-2020-10.r1",
"oracleBase": "/home/oracle/"
}
}
```
**Example Exemplo de manifesto de CEV para Oracle Database 19c**
No exemplo a seguir do Oracle Database 19c, o RDS Custom aplica p32126828, depois p29213893 e depois p29782284 e assim por diante. O exemplo define novos valores para o usuário e o grupo do UNIX, o Oracle home e a base do Oracle.
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
"p29213893_1910000DBRU_Generic.zip",
"p29782284_1910000DBRU_Generic.zip",
"p28730253_190000_Linux-x86-64.zip",
"p29374604_1910000DBRU_Linux-x86-64.zip",
"p28852325_190000_Linux-x86-64.zip",
"p29997937_190000_Linux-x86-64.zip",
"p31335037_190000_Linux-x86-64.zip",
"p31335142_190000_Generic.zip"
],
"installationParameters": {
"unixGroupName": "dba",
"unixGroupId": 12345,
"unixUname": "oracle",
"unixUid": 12345,
"oracleHome": "/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1",
"oracleBase": "/home/oracle"
}
}
```
## Etapa 6 (opcional): Validar o manifesto CEV
Opcionalmente, verifique se o manifesto é um arquivo JSON válido executando o script Python `json.tool`. Por exemplo, se você mudar para o diretório que contém um manifesto CEV chamado `manifest.json`, execute o comando a seguir.
```
python -m json.tool < manifest.json
```
## Etapa 7: Adicionar permissões do IAM necessárias
Certifique-se de que o elemento principal do IAM que cria o CEV tenha as políticas necessárias descritas em [Etapa 5: Conceder as permissões necessárias ao usuário ou ao perfil do IAM](custom-setup-orcl.md#custom-setup-orcl.iam-user).
# Criar um CEV
É possível criar uma CEV usando o Console de gerenciamento da AWS ou a AWS CLI. Especifique a arquitetura multilocatário ou não multilocatário. Para ter mais informações, consulte [Considerações sobre arquitetura multilocatário](custom-creating.md#custom-creating.overview).
Em geral, criar um CEV demora cerca de duas horas. Depois que a CEV é criada, você pode usá-la para criar ou atualizar uma instância de banco de dados do RDS Custom. Para ter mais informações, consulte [Criar uma instância de banco de dados do RDS Custom for Oracle](custom-creating.md#custom-creating.create) e [Fazer upgrade de uma instância de banco de dados para o RDS Custom for Oracle](custom-upgrading-modify.md).
**nota**
Se sua instância de banco de dados atualmente usa o Oracle Linux 7.9, crie um novo CEV que use a AMI mais recente, que utiliza o Oracle Linux 8. Em seguida, modifique sua instância para usar o novo CEV.
Anote os seguintes requisitos e limitações para criação de uma CEV:
+ O bucket do Amazon S3 que contém os arquivos de instalação deve estar na mesma Região da AWS que a CEV. Caso contrário, o processo de criação falhará.
+ O nome da CEV deve estar no formato `major-engine-version.customized_string`, como em `19.cdb_cev1`.
+ O nome da CEV deve conter de 1 a 50 caracteres alfanuméricos, sublinhados, traços ou pontos.
+ O nome da CEV não pode conter pontos consecutivos, como em `19..cdb_cev1`.
## 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 uma CEV, a página estará vazia.
1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada).
1. Em **Opções de mecanismo**, faça o seguinte:
1. Para **Engine type** (Tipo de mecanismo), escolha **Oracle**.
1. Em **Configurações de arquitetura**, selecione **Arquitetura multilocatário** para criar uma CEV multilocatária, que usa o mecanismo de banco de dados `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Você pode criar um RDS Custom para Oracle CDB somente com uma CEV multilocatária. Se você não escolher essa opção, sua CEV não será de CDB, que usa o mecanismo `custom-oracle-ee` ou `custom-oracle-se2`.
**nota**
A arquitetura escolhida será uma característica permanente da CEV. Você não pode modificar sua CEV para usar uma arquitetura diferente posteriormente.
1. Escolha uma das seguintes opções:
+ **Crie um novo CEV** — Crie um CEV do zero. Nesse caso, você deve especificar um manifesto do JSON especificando os binários do banco de dados.
+ **Criar CEV a partir da fonte** — Em **Especificar o CEV que você deseja copiar**, escolha um CEV existente para usar como o CEV de origem. Nesse caso, você pode especificar uma nova Amazon Machine Image (AMI), mas não pode especificar diferentes binários de banco de dados.
1. Em **Versão principal**, selecione a versão principal do mecanismo.
1. Em **Detalhes da versão**, conclua o seguinte:
1. Insira um nome válido em **Nome da versão de mecanismo personalizada**. Por exemplo, é possível inserir o nome **19.cdb\$1cev1**.
1. (Opcional) Insira uma descrição para sua CEV.
1. Em **Mídia de instalação**, faça o seguinte:
1. (Opcional) Para **ID da AMI**, deixe o campo em branco para usar a AMI mais recente do serviço ou insira uma AMI que você usou anteriormente para criar uma CEV. Para obter IDs de AMI usando uma das seguintes técnicas:
+ No console, selecione **Versões personalizadas do mecanismo** no painel de navegação esquerdo e escolha o nome de uma CEV. O ID da AMI usado pela CEV é exibido na guia **Configuração**.
+ Na AWS CLI, use o comando `describe-db-engine-versions`. Pesquise a saída de `ImageID`.
1. Para **S3 location of manifest files** (Localização dos arquivos de manifesto no S3), insira o local do bucket do Amazon S3 que você especificou em [Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). Por exemplo, digite **s3://my-custom-installation-files/123456789012/cev1/**.
**nota**
A região da na qual você executa deve estar na mesma região da que o bucket.
1. Em **Manifesto de CEV**, insira o manifesto JSON que você criou em [Criar o manifesto de CEV](custom-cev.preparing.md#custom-cev.preparing.manifest.creating).
1. Na seção **Chave do KMS**, selecione **Inserir um ARN de chave** para listar as chaves do AWS KMS disponíveis. Em seguida, selecione sua chave do KMS na lista.
Uma chave do AWS KMS é necessária para o RDS Custom. Para ter mais informações, consulte [Etapa 1: Criar ou reutilizar uma chave AWS KMS de criptografia simétrica](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Opcional) Selecione **Adicionar nova tag** para criar um par de chave/valor para sua CEV.
1. Escolha **Create custom engine version** (Criar versão de mecanismo personalizada).
Se o manifesto CEV tiver um formulário inválido, o console exibirá **Error validating the CEV manifest**. Corrija os problemas e tente novamente.
A página **Custom engine versions** (Versões de mecanismo personalizadas) é exibida. Sua CEV é mostrada com o status **Creating** (Criando). O processo para criar o CEV demora aproximadamente duas horas.
## 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`: especifique o tipo de mecanismo. Para um que seja de CDB, especifique `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Para um que não seja de CDB, especifique `custom-oracle-ee` ou `custom-oracle-se2`. É possível criar CDBs somente com base em uma CEV criada com `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. É possível criar não CDBs somente com base em uma CEV criada com `custom-oracle-ee` ou `custom-oracle-se2`.
+ `--engine-version`— Especifique a versão do motor. O formato é a versão do *major-engine-version*.*customized\$1string*. O nome da CEV deve conter de 1 a 50 caracteres alfanuméricos, sublinhados, traços ou pontos. O nome da CEV não pode conter pontos consecutivos, como em `19..cdb_cev1`.
+ `--kms-key-id` – Especifique um AWS KMS key.
+ `--manifest` – Especifique `manifest_json_string` ou `--manifest file:file_name`. Caracteres de nova linha não são permitidos em `manifest_json_string`. Certifique-se de fazer o escape das aspas duplas (“) no código JSON, prefixando-as com uma barra invertida (\$1).
O exemplo a seguir mostra o `manifest_json_string` para 19c de [Etapa 5: Preparar o manifesto CEV](custom-cev.preparing.md#custom-cev.preparing.manifest). O exemplo define novos valores para a base Oracle, o Oracle Home e o ID e o nome do usuário e do grupo do UNIX/Linux. Se você copiar essa string, remova todos os caracteres de nova linha antes de colá-la no comando.
`"{\"mediaImportTemplateVersion\": \"2020-08-14\",\"databaseInstallationFileNames\": [\"V982063-01.zip\"],\"opatchFileNames\": [\"p6880880_190000_Linux-x86-64.zip\"],\"psuRuPatchFileNames\": [\"p32126828_190000_Linux-x86-64.zip\"],\"otherPatchFileNames\": [\"p29213893_1910000DBRU_Generic.zip\",\"p29782284_1910000DBRU_Generic.zip\",\"p28730253_190000_Linux-x86-64.zip\",\"p29374604_1910000DBRU_Linux-x86-64.zip\",\"p28852325_190000_Linux-x86-64.zip\",\"p29997937_190000_Linux-x86-64.zip\",\"p31335037_190000_Linux-x86-64.zip\",\"p31335142_190000_Generic.zip\"]\"installationParameters\":{ \"unixGroupName\":\"dba\", \ \"unixUname\":\"oracle\", \ \"oracleHome\":\"/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1\", \ \"oracleBase\":\"/home/oracle/\"}}"`
+ `--database-installation-files-s3-bucket-name`— Especifique o mesmo nome de bucket que você especificou em[Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). A Região da AWS na qual você executa o `create-custom-db-engine-version` deve ser a mesma de seu bucket do Amazon S3.
Também é possível especificar as seguintes opções:
+ `--description`— Especifique uma descrição do seu CEV.
+ `--database-installation-files-s3-prefix`— Especifique o nome da pasta que você especificou em[Etapa 3: Fazer upload de seus arquivos de instalação no Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3).
+ `--image-id`— Especifique uma ID de AMI que deseja reutilizar. Para encontrar IDs válidos, execute o comando `describe-db-engine-versions` e, depois, pesquise a saída de `ImageID`. Por padrão, o RDS Custom para Oracle usa a AMI mais recente disponível.
O exemplo a seguir cria uma CEV multilocatária chamada `19.cdb_cev1`. O exemplo reutiliza uma AMI existente em vez de usar a AMI mais recente disponível. Certifique-se de que o nome do seu CEV comece 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-oracle-se2-cdb \
3. --engine-version 19.cdb_cev1 \
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
5. --database-installation-files-s3-prefix 123456789012/cev1 \
6. --kms-key-id my-kms-key \
7. --description "test cev" \
8. --manifest manifest_string \
9. --image-id ami-012a345678901bcde
```
Para Windows:
```
1. aws rds create-custom-db-engine-version ^
2. --engine custom-oracle-se2-cdb ^
3. --engine-version 19.cdb_cev1 ^
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
5. --database-installation-files-s3-prefix 123456789012/cev1 ^
6. --kms-key-id my-kms-key ^
7. --description "test cev" ^
8. --manifest manifest_string ^
9. --image-id ami-012a345678901bcde
```
**Example**
Obtenha detalhes sobre a sua CEV com o comando `describe-db-engine-versions`.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
A saída de exemplo parcial a seguir mostra o mecanismo, os grupos de parâmetros, o manifesto e outras informações.
```
1. {
2. "DBEngineVersions": [
3. {
4. "Engine": "custom-oracle-se2-cdb",
5. "EngineVersion": "19.cdb_cev1",
6. "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
7. "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
8. "DBEngineVersionDescription": "test cev",
9. "Image": {
10. "ImageId": "ami-012a345678901bcde",
11. "Status": "active"
12. },
13. "ValidUpgradeTarget": [],
14. "SupportsLogExportsToCloudwatchLogs": false,
15. "SupportsReadReplica": true,
16. "SupportedFeatureNames": [],
17. "Status": "available",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "MajorEngineVersion": "19",
21. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
22. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
23. "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
24. "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
25. "CreateTime": "2023-03-07T19:47:58.131000+00:00",
26. "TagList": [],
27. "SupportsBabelfish": false,
28. ...
```
## Falha ao criar um CEV
Se o processo de criação do CEV falhar, o RDS Custom emitirá `RDS-EVENT-0198` com a mensagem `Creation failed for custom engine version major-engine-version.cev_name` e incluirá detalhes sobre a falha. Por exemplo, o evento imprime arquivos ausentes.
Não é possível modificar uma CEV com falha. Você pode apenas excluí-la e tentar novamente criar uma CEV depois de corrigir as causas da falha. Para obter informações sobre como solucionar os motivos da falha na criação da CEV, consulte [Solucionar problemas com a criação de uma versão de mecanismo personalizado para o RDS Custom for Oracle](custom-troubleshooting.md#custom-troubleshooting.cev).
# Modificar o status da CEV
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 ou fazer upgrade de uma instância 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 a CEV de qualquer status com suporte para qualquer outro status com suporte. Você pode modificar o status para evitar o uso acidental de uma CEV ou tornar uma CEV descontinuada qualificada para uso novamente. Por exemplo, é possível alterar o status da CEV de `available` para `inactive` e de `inactive` de volta para `available`.
## 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-type`, em que o *tipo de mecanismo* é `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`.
+ `--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 `19.my_cev1` do status atual para `inactive`.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-oracle-se2 \
3. --engine-version 19.my_cev1 \
4. --status inactive
```
Para Windows:
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-oracle-se2 ^
3. --engine-version 19.my_cev1 ^
4. --status inactive
```
# Visualizar detalhes da CEV com o Amazon RDS Custom para Oracle
Você pode ver detalhes sobre seu manifesto da CEV e o comando usado para criar sua CEV com o uso do Console de gerenciamento da AWS ou da 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 parâmetros de instalação especificados em seu manifesto.
![\[Visualize os parâmetros de instalação de uma CEV.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/cev-configuration-tab.png)
1. Selecione **Manifest** (Manifesto) para visualizar os parâmetros de instalação especificados na opção `--manifest` do comando `create-custom-db-engine-version`. Você pode copiar esse texto, substituir valores conforme necessário e usá-los em um novo comando.
![\[Visualize o comando utilizado para criar a CEV.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/cev-manifest-tab.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).
São necessárias as seguintes opções:
+ `--engine engine-type`, em que o *tipo de mecanismo* é `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`.
+ `--engine-version major-engine-version.customized_string`
O exemplo a seguir cria uma CEV que não seja de CDB que usa a Enterprise Edition. O nome `19.my_cev1` da CVE começa com o número da versão principal do mecanismo, que é obrigatório.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Para Windows:
```
1. aws rds describe-db-engine-versions ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```
A saída de exemplo parcial a seguir mostra o mecanismo, os grupos de parâmetros, o manifesto e outras informações.
```
1. "DBEngineVersions": [
2. {
3. "Engine": "custom-oracle-ee",
4. "MajorEngineVersion": "19",
5. "EngineVersion": "19.my_cev1",
6. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-cev-customer-installation-files",
7. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
8. "CustomDBEngineVersionManifest": "{\n\"mediaImportTemplateVersion\": \"2020-08-14\",\n\"databaseInstallationFileNames\": [\n\"V982063-01.zip\"\n],\n\"installationParameters\": {\n\"oracleBase\":\"/tmp\",\n\"oracleHome\":\"/tmp/Oracle\"\n},\n\"opatchFileNames\": [\n\"p6880880_190000_Linux-x86-64.zip\"\n],\n\"psuRuPatchFileNames\": [\n\"p32126828_190000_Linux-x86-64.zip\"\n],\n\"otherPatchFileNames\": [\n\"p29213893_1910000DBRU_Generic.zip\",\n\"p29782284_1910000DBRU_Generic.zip\",\n\"p28730253_190000_Linux-x86-64.zip\",\n\"p29374604_1910000DBRU_Linux-x86-64.zip\",\n\"p28852325_190000_Linux-x86-64.zip\",\n\"p29997937_190000_Linux-x86-64.zip\",\n\"p31335037_190000_Linux-x86-64.zip\",\n\"p31335142_190000_Generic.zip\"\n]\n}\n",
9. "DBParameterGroupFamily": "custom-oracle-ee-19",
10. "DBEngineDescription": "Oracle Database server EE for RDS Custom",
11. "DBEngineVersionArn": "arn:aws:rds:us-west-2:123456789012:cev:custom-oracle-ee/19.my_cev1/0a123b45-6c78-901d-23e4-5678f901fg23",
12. "DBEngineVersionDescription": "test",
13. "KMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/ab1c2de3-f4g5-6789-h012-h3ijk4567l89",
14. "CreateTime": "2022-11-18T09:17:07.693000+00:00",
15. "ValidUpgradeTarget": [
16. {
17. "Engine": "custom-oracle-ee",
18. "EngineVersion": "19.cev.2021-01.09",
19. "Description": "test",
20. "AutoUpgrade": false,
21. "IsMajorVersionUpgrade": false
22. }
23. ]
```
# Excluir uma CEV
É possível excluir uma CEV usando o Console de gerenciamento da AWS ou a AWS CLI. Normalmente, a exclusão demora alguns minutos.
Para excluir uma CEV, ela não pode estar 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 engine-type`, em que o *tipo de mecanismo* é `custom-oracle-ee`, `custom-oracle-se2`, `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`.
+ `--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 `19.my_cev1`.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Para Windows:
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```