# Amazon RDS Custom for Oracle のカスタムエンジンバージョンでの作業
Amazon RDS Custom for Oracle の*カスタムエンジンバージョン (CEV)* は、データベースエンジンと特定の Amazon マシンイメージ (AMI) のバイナリボリュームスナップショットです。RDS Custom for Oracle はデフォルトで入手可能な最新の AMI を使用しますが、以前の CEV で使用していた AMI を指定できます。データベースのインストールファイルを Amazon S3 に保存します。RDS Custom は、インストールファイルと AMI を使用して CEV を作成します。
**Topics**
+ [CEV 作成の準備](custom-cev.preparing.md)
+ [CEV の作成](custom-cev.create.md)
+ [CEV ステータスの変更](custom-cev.modify.md)
+ [Amazon RDS Custom for Oracle の CEV 詳細を表示する](custom-cev.view.md)
+ [CEV の削除](custom-cev.delete.md)
# CEV 作成の準備
CEV を作成するには、次のいずれかのリリースの Amazon S3 バケットに保存されているインストールファイルおよびパッチにアクセスします。
+ Oracle Database 19c
+ Oracle Database 18c
+ Oracle Database 12c Release 2 (12.2)
+ Oracle Database 12c Release 1 (12.1)
例えば、Oracle Database 19c の 2021 年 4 月 RU/RUR、またはインストールファイルとパッチの有効な組み合わせを使用できます。RDS Custom for Oracle でサポートされているバージョンとリージョンの詳細については、「[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)」を参照してください。
**Topics**
+ [ステップ 1 (オプション): マニフェストテンプレートをダウンロードする](#custom-cev.preparing.templates)
+ [ステップ 2: Oracle Software Delivery Cloud からデータベースインストールファイルおよびパッチをダウンロードする](#custom-cev.preparing.download)
+ [ステップ 3: Amazon S3 へのインストールファイルをアップロードする](#custom-cev.preparing.s3)
+ [ステップ 4 (オプション): S3 にあるインストールメディアを AWS アカウント 間で共有する](#custom-cev.preparing.accounts)
+ [ステップ 5: CEV マニフェストを準備する](#custom-cev.preparing.manifest)
+ [ステップ 6 (オプション): CEV マニフェストを検証する](#custom-cev.preparing.validating)
+ [ステップ 7: 必要な IAM アクセス許可を追加する](#custom-cev.preparing.iam)
## ステップ 1 (オプション): マニフェストテンプレートをダウンロードする
*CEV マニフェスト*は、CEV のデータベースインストール .zip ファイルのリストを含む JSON ドキュメントです。CEV を作成するには、以下の手順を実行します。
1. CEV に含める Oracle データベースのインストールファイルを特定します。
1. インストールファイルをダウンロードします。
1. インストールファイルを一覧表示する JSON マニフェストを作成します。
RDS Custom for Oracle には、サポートされている Oracle データベースの各リリース用に、推奨する.zip ファイルが含まれた JSON マニフェストテンプレートが用意されています。例えば、次のテンプレートは 19.17.0.0.0 RU 用です。
```
{
"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"
]
}
```
各テンプレートには、パッチのダウンロード手順、.zip ファイルの URL、およびファイルチェックサムが記載された Readme が関連付けられています。これらのテンプレートはそのまま使用することも、独自のパッチで修正することもできます。テンプレートを確認するには、[custom-oracle-manifest.zip](samples/custom-oracle-manifest.zip) をローカルディスクにダウンロードし、ファイルアーカイブアプリケーションで開きます。詳細については、「[ステップ 5: CEV マニフェストを準備する](#custom-cev.preparing.manifest)」を参照してください。
## ステップ 2: Oracle Software Delivery Cloud からデータベースインストールファイルおよびパッチをダウンロードする
CEV に必要なインストールファイルを特定したら、ローカルシステムにダウンロードします。Oracle Database のインストールファイルおよびパッチは、Oracle Software Delivery Cloudでホストされています。各 CEV には Oracle Database 19c や Oracle Database 12c Release 2 (12.2) などのベースのリリースが必要です。
**Oracle Database のデータベースインストールファイルをダウンロードするには**
1. [https://edelivery.oracle.com/](https://edelivery.oracle.com/)に移動してサインインします。
1. 検索ボックスに「**Oracle Database Enterprise Edition**」または「**Oracle Database Standard Edition 2**」と入力し、**[検索]** を選択します。
1. 次のベースのリリースのいずれかを選択します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. [**続行**] をクリックしてください。
1. **[Download Queue]** (キューのダウンロード) チェックボックスをオフにします。
1. ベースのリリースに対応するオプションを選択します。
+ **Oracle Database 19.3.0.0.0 - 長期リリース**。
+ **Oracle Database 18.0.0.0.0**
+ **Oracle Database 12.2.0.1.0**.
+ **Oracle Database 12.1.0.2.0**.
1. **プラットフォーム/言語**で**Linux x86-64**を選択します。
1. **[続行]** を選択し、Oracle ライセンス契約に署名します。
1. データベースリリースに対応する.zip ファイルを選択します。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-cev.preparing.html)
1. 必要な Oracle パッチを `updates.oracle.com` または `support.oracle.com` からローカルシステムにダウンロードします。パッチの URL は次の場所にあります。
+ [ステップ 1 (オプション): マニフェストテンプレートをダウンロードする](#custom-cev.preparing.templates) でダウンロードした .zip ファイル内の Readme ファイル
+ [Release notes for Amazon Relational Database Service (Amazon RDS) for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) の 各 Release Update (RU) に一覧表示されているパッチ
## ステップ 3: Amazon S3 へのインストールファイルをアップロードする
AWS CLIを使用して、Oracle インストールファイルとパッチファイルを Amazon S3 にアップロードします。インストールファイルを含む S3 バケットはCEV と同じAWSリージョンにある必要があります。
このセクションの例では、次のプレースホルダを使用します。
+ `install-or-patch-file.zip` - Oracle インストールメディアファイルです。例えば、p32126828\$1190000\$1Linux-x86-64.zip はパッチです。
+ `amzn-s3-demo-destination-bucket` - アップロードされたインストールファイル用に設計された Amazon S3 バケットです。
+ `123456789012/cev1` – Amazon S3 バケット内のオプションのプレフィックスです。
+ `amzn-s3-demo-source-bucket` – オプションでファイルをステージングできる Amazon S3 バケットです。
**Topics**
+ [ステップ 3a: S3 バケットが正しい AWS リージョン にあることを確認する](#custom-cev.preparing.s3.verify-region)
+ [ステップ 3b: S3 バケットポリシーに正しい権限があることを確認する](#custom-cev.preparing.s3.verify-policy)
+ [ステップ 3c: cp コマンドまたは sync コマンドを使用してファイルをアップロードする](#custom-cev.preparing.s3.upload)
+ [ステップ 3 d: S3 バケットにあるファイルをリストする](#custom-cev.preparing.s3.list)
### ステップ 3a: S3 バケットが正しい AWS リージョン にあることを確認する
S3 バケットが、`create-custom-db-engine-version`コマンドを実行する予定のAWSリージョンにあることを確認します。
```
aws s3api get-bucket-location --bucket amzn-s3-demo-destination-bucket
```
### ステップ 3b: S3 バケットポリシーに正しい権限があることを確認する
CEV はゼロから作成することも、ソース CEV から作成することもできます。ソース CEV から新しい CEV を作成する場合は、S3 バケットポリシーに正しい権限があることを確認してください。
1. RDS Custom によって予約されている S3 バケットを特定します。バケットの形式は `do-not-delete-rds-custom-account-region-string` になります。例えば、バケットには `do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` という名前が付けられる可能性があります。
1. S3 バケットポリシーに次の権限が追加されていることを確認してください。`do-not-delete-rds-custom-123456789012-us-east-1-abc123EXAMPLE` をバケットの名前に置き換えます。
```
{
"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/*"
}, ...
```
### ステップ 3c: cp コマンドまたは sync コマンドを使用してファイルをアップロードする
次のいずれかのオプションを選択します。
+ `aws s3 cp`を使用して、単一の.zip ファイルをアップロードします。
各インストール.zip ファイルを個別にアップロードします。.zip ファイルを単一の.zip ファイルに結合しないでください。
+ `aws s3 sync`を使用して、ディレクトリをアップロードします。
**Example**
次の例では、`install-or-patch-file.zip`をRDS Custom Amazon S3 バケット内のフォルダ`123456789012/cev1`にアップロードします。アップロードする .zip ごとに`aws s3`コマンドを実行します。
Linux、macOS、Unix の場合:
```
1. aws s3 cp install-or-patch-file.zip \
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Windows の場合:
```
1. aws s3 cp install-or-patch-file.zip ^
2. s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
以下の例では、ローカルの*cev1*フォルダのファイルを、Amazon S3 バケットの*123456789012/cev1*フォルダにアップロードします。
Linux、macOS、Unix の場合:
```
aws s3 sync cev1 \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Windows の場合:
```
aws s3 sync cev1 ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
**Example**
次の例では、`amzn-s3-demo-source-bucket` のすべてのファイルを Amazon S3 バケット内の **`123456789012/cev1`** フォルダにアップロードしています。
Linux、macOS、Unix の場合:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
Windows の場合:
```
aws s3 sync s3://amzn-s3-demo-source-bucket/ ^
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
### ステップ 3 d: S3 バケットにあるファイルをリストする
次の例では、`s3 ls`コマンドを使用して、RDS Custom Amazon S3 バケットにあるファイルを指定します。
```
aws s3 ls \
s3://amzn-s3-demo-destination-bucket/123456789012/cev1/
```
## ステップ 4 (オプション): S3 にあるインストールメディアを AWS アカウント 間で共有する
このセクションでは、アップロードした Oracle インストールファイルを含む Amazon S3 バケットを*メディアバケット*とします。組織では、AWS リージョン で複数の AWS アカウント を使用する場合があります。その場合、メディアバケットに埋め込むために1つの AWS アカウント を使用し、CEV を作成するために別の AWS アカウント を使用する場合もあります。メディアバケットを共有する予定がない場合は、次のセクションにスキップしてください。
このセクションでは、以下を想定しています。
+ メディアバケットを作成したアカウントと、CEV を作成する予定の別のアカウントにアクセスできます。
+ CEV を 1 つの AWS リージョン だけで作成します。複数のリージョンを使用する場合は、リージョンごとにメディアバケットを作成してください。
+ CLI を使用しています。Amazon S3 コンソールを使用している場合は、次のステップを適用します。
**メディアバケットを AWS アカウント 全体で共有するように設定するには**
1. インストールメディアをアップロードした S3 バケットを含む AWS アカウント にログインします。
1. 空白の JSON ポリシーテンプレートまたは適用可能な既存のポリシーから開始します。
次のコマンドは、既存のポリシーを取得して *my-policy.json* として保存します。この例では、インストールファイルを含む S3 バケットに *amzn-s3-demo-bucket* という名前を付けています。
```
aws s3api get-bucket-policy \
--bucket amzn-s3-demo-bucket \
--query Policy \
--output text > my-policy.json
```
1. メディアバケットの権限を次のように編集します。
+ テンプレートの `Resource` で、Oracle Database インストールファイルをアップロードした S3 バケットを指定します。
+ `Principal` 要素で、CEV を作成するために使用する予定のすべての AWS アカウント の ARN を指定します。ルート、ユーザー、またはロールを S3 バケット許可リストに追加できます。詳細については、*AWS Identity and Access Management ユーザーガイド*の「[IAM ID](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html)」を参照してください。
------
#### [ 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. ポリシーをメディアバケットにアタッチします。
次の例では、*amzn-s3-demo-bucket* は、インストールファイルを含む S3 バケットの名前であり、*my-policy.json* は JSON ファイルの名前です。
```
aws s3api put-bucket-policy \
--bucket amzn-s3-demo-bucket \
--policy file://my-policy.json
```
1. CEV を作成する AWS アカウント にログインします。
1. このアカウントが、メディアバケットを作成した AWS アカウント でアクセスできることを確認します。
```
aws s3 ls --query "Buckets[].Name"
```
詳細については、*AWS CLI コマンドリファレンス*の「[aws s3 ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html)」を参照してください。
1. [CEV の作成](custom-cev.create.md) のステップに従って、CEV を作成します。
## ステップ 5: CEV マニフェストを準備する
CEV マニフェストは、以下を含む JSON ドキュメントです。
+ (必須) Amazon S3 にアップロードされたインストールの .zip ファイルのリスト。RDS Custom は、マニフェストにリストされている順にパッチを適用します。
+ (オプション) Oracle ベース、Oracle ホーム、および UNIX/Linux ユーザーとグループの ID と名前のデフォルト以外の値を設定するインストールパラメータ。既存の CEV または既存の DB インスタンスのインストールパラメータは変更できないことに注意してください。また、インストールパラメータの設定が異なる場合、ある CEV から別の CEV にアップグレードすることはできません。
CEV マニフェストのサンプルについては、[ステップ 1 (オプション): マニフェストテンプレートをダウンロードする](#custom-cev.preparing.templates) でダウンロードした JSON テンプレートを参照してください。[CEV マニフェストの例](#custom-cev.preparing.manifest.examples) でサンプルを確認することもできます。
**Topics**
+ [CEV マニフェストの JSON フィールド](#custom-cev.preparing.manifest.fields)
+ [CEV マニフェストの作成](#custom-cev.preparing.manifest.creating)
+ [CEV マニフェストの例](#custom-cev.preparing.manifest.examples)
### CEV マニフェストの JSON フィールド
次の表では、マニフェストの JSON フィールドについて説明します。
| JSON フィールド | 説明 |
| --- | --- |
| `MediaImportTemplateVersion` | CEV マニフェストのバージョンです。日付は `YYYY-MM-DD` 形式です。 |
| `databaseInstallationFileNames` | データベースのインストールファイルの順序一覧です。 |
| `opatchFileNames` | Oracle DB エンジンで使用される OPatch インストーラの順序一覧です。有効な値は 1 つだけです。`opatchFileNames` の値は `p6880880_` で始まる必要があります。 |
| `psuRuPatchFileNames` | このデータベースの PSU および RU パッチです。 `psuRuPatchFileNames` が含まれている場合は、`opatchFileNames` が必要です。`opatchFileNames` の値は `p6880880_` で始まる必要があります。 |
| `OtherPatchFileNames` | PSU および RU パッチのリストにないパッチです。RDS Custom は、PSU および RU パッチ適用後に、これらのパッチを適用します。 `OtherPatchFileNames` が含まれている場合は、`opatchFileNames` が必要です。`opatchFileNames` の値は `p6880880_` で始まる必要があります。 |
| `installationParameters` | Oracle ベース、Oracle ホーム、および UNIX/Linux ユーザーとグループの ID と名前のデフォルト以外の設定。以下のパラメータを設定できます。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/custom-cev.preparing.html) |
Oracle データベースのリリースごとに、サポートされるインストールファイルのリストは異なります。CEV マニフェストを作成するときは、RDS Custom for Oracle でサポートされているファイルのみを指定してください。そうしないと、CEV の作成はエラーで失敗します。[Release notes for Amazon Relational Database Service (Amazon RDS) for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes) で一覧表示されているすべてのパッチがサポートされています。
### CEV マニフェストの作成
**CEV マニフェストを作成するには**
1. 適用する予定のすべてのインストールファイルを、適用する順序で一覧表示します。
1. インストールファイルを、[CEV マニフェストの JSON フィールド](#custom-cev.preparing.manifest.fields) で説明されている JSON フィールドと関連付けます。
1. 次のいずれかを実行します。
+ CEV マニフェストを JSON テキストファイルとして作成します。
+ コンソールで CEV を作成するときに、CEV マニフェストテンプレートを編集します。(詳しくは、「[CEV の作成](custom-cev.create.md)」を参照してください。)
### CEV マニフェストの例
次の例は、さまざまな Oracle Database リリースの CEV マニフェストファイルを示しています。マニフェストに JSON フィールドを含める場合は、それが空でないことを確認してください。例えば、次の CEV マニフェストは `otherPatchFileNames` が空のため有効ではありません。
```
{
"mediaImportTemplateVersion": "2020-08-14",
"databaseInstallationFileNames": [
"V982063-01.zip"
],
"opatchFileNames": [
"p6880880_190000_Linux-x86-64.zip"
],
"psuRuPatchFileNames": [
"p32126828_190000_Linux-x86-64.zip"
],
"otherPatchFileNames": [
]
}
```
**トピック**
+ [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 Oracle Database 12c Release 1 (12.1) のサンプル CEV マニフェスト**
次の Oracle Database 12c Release 1 (12.1) の 2021 年 7 月 PSU の例では、RDS Custom は、指定された順序でパッチを適用します。したがって、RDS Custom は、p32768233、次に p32876425、次に p18759211 を適用することになります。この例では、UNIX ユーザーとグループ、Oracle ホームと 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 Oracle Database 12c Release 2 (12.2) のサンプル CEV マニフェスト**
次の Oracle Database 12c Release 1 (12.2) の 2021 年 10 月 PSU の例では、RDS Custom が p33261817、p33192662、p29213893 などを順に適用しています。この例では、UNIX ユーザーとグループ、Oracle ホームと 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 Oracle Database 18c のサンプル CEV マニフェスト**
次の Oracle Database 18c の 2021 年 10 月 PSU の例では、RDS Custom が p32126855、p28730253、p27539475 などを順に適用しています。この例では、UNIX ユーザーとグループ、Oracle ホームと 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 Oracle Database 19c のサンプル CEV マニフェスト**
次の Oracle Database 19c の例では、RDS Custom が p32126828、p29213893、p29782284、などを順に適用しています。この例では、UNIX ユーザーとグループ、Oracle ホームと 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"
}
}
```
## ステップ 6 (オプション): CEV マニフェストを検証する
オプションで、マニフェストが有効な JSON ファイルであることを`json.tool`Python スクリプトを実行して確認します。例えば、`manifest.json`という名前の CEV マニフェストを含むディレクトリに変更した場合、以下のコマンドを実行します。
```
python -m json.tool < manifest.json
```
## ステップ 7: 必要な IAM アクセス許可を追加する
CEV を作成する IAM プリンシパルに、[ステップ 5: IAM ユーザーまたはロールに必要なアクセス許可を付与する](custom-setup-orcl.md#custom-setup-orcl.iam-user) で説明されている必要なポリシーがあることを確認してください。
# CEV の作成
AWS マネジメントコンソールまたはAWS CLIを使用して、CEV を作成できます。マルチテナントまたは非マルチテナントアーキテクチャのいずれかを指定します。詳細については、「[マルチテナントアーキテクチャの考慮事項](custom-creating.md#custom-creating.overview)」を参照してください。
通常、CEV の作成には約 2 時間かかります。CEV を作成したら、それを使用して RDS Custom DB インスタンスを作成またはアップグレードできます。詳細については、[RDS Custom for Oracle DB インスタンスを作成する](custom-creating.md#custom-creating.create)および[RDS Custom for Oracle DB インスタンスのアップグレード](custom-upgrading-modify.md)を参照してください。
**注記**
DB インスタンスが現在 Oracle Linux 7.9 を使用している場合は、最新の AMI を使用する新しい CEV を作成して、Oracle Linux 8 を使用します。次に、新しい CEV を使用するようにインスタンスを変更します。
CEV の作成に関する次の要件と制限事項に注意してください。
+ インストールファイルを含む Amazon S3 バケットは CEV と同じ AWS リージョン にある必要があります。そうではない場合、作成プロセスは失敗します。
+ CEV 名は、`major-engine-version.customized_string` の形式にする必要があります (例: `19.cdb_cev1`)。
+ CEV 名には、1～50 個の英数字、アンダースコア、ダッシュ、またはピリオドを含める必要があります。
+ CEV 名には、`19..cdb_cev1` のように連続したピリオドを含めることはできません。
## コンソール
**CEV を作成するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
**カスタムエンジンバージョン**ページには、現在存在するすべての CEV が表示されます。CEV をまだ作成していない場合、ページは空です。
1. 「**カスタムエンジンバージョンの作成**」を選択します。
1. **[エンジンオプション]** で、次の操作を行います。
1. **[エンジンのタイプ]** で、**[Oracle]** を選択します。
1. **[アーキテクチャ設定]** で、オプションとして **[マルチテナントアーキテクチャ]** を選択し、DB エンジン `custom-oracle-ee-cdb` または `custom-oracle-se2-cdb` を使用する Oracle マルチテナント CEV を作成します。RDS Custom for Oracle CDB はマルチテナント CEV でのみ作成できます。このオプションを選択しない場合、CEV はエンジン `custom-oracle-ee` または `custom-oracle-se2` を使用する非 CDB です。
**注記**
選択したアーキテクチャは、CEV の永続的な特性になります。後で別のアーキテクチャを使用するように CEV を変更することはできません。
1. 次のいずれかのオプションを選択します。
+ **新規 CEV の作成** — CEV を最初から作成します。この場合、データベースバイナリを指定する JSON マニフェストを指定する必要があります。
+ **ソースからの CEV の作成** — **[コピーする CEV を指定してください]** で、ソース CEV として使用する既存の CEV を選択します。この場合、新しい Amazon マシンイメージ (AMI) を指定できますが、別のデータベースバイナリを指定することはできません。
1. **[エンジンバージョン]** で、エンジンのメジャーバージョンを選択します。
1. **[バージョンの詳細]** で次の操作を行います。
1. 有効な名前を **[カスタムエンジンバージョン名]** に入力します。例えば、 名前を**19.cdb\$1cev1**と入力します。
1. (オプション) CEV の説明を入力します。
1. **[インストールメディア]** で、次の操作を行います。
1. (オプション) **[AMI ID]** に、サービス提供の最新のAMIを使用する場合はフィールドを空白のままにするか、以前に CEV の作成に使用した AMI を入力します。有効な AMI ID を取得するには、次のいずれかの方法を使用します。
+ コンソールで、左側のナビゲーションペインで **[カスタムエンジンバージョン]** を選択し、CEV の名前を選択します。CEV が使用する AMI ID が **[設定]** タブに表示されます。
+ AWS CLI で、`describe-db-engine-versions` コマンドを使用します。`ImageID` の出力を検索します。
1. **マニフェストファイルの S3 の場所**で、[ステップ 3: Amazon S3 へのインストールファイルをアップロードする](custom-cev.preparing.md#custom-cev.preparing.s3)で指定した Amazon S3 バケットの場所を入力します。例えば、 **s3://my-custom-installation-files/123456789012/cev1/**と入力します。
**注記**
CEV を作成する AWS リージョン は、S3 バケットとしてのリージョンと同じである必要があります。
1. (新規 CEV のみを作成) **[CEV マニフェスト]** には、[CEV マニフェストの作成](custom-cev.preparing.md#custom-cev.preparing.manifest.creating) で作成した JSON マニフェストを入力します。
1. **[KMS キー]** セクションで、**[キー ARN の入力]** を選択し、利用可能な AWS KMS キーをリストアップします。次に、リストから KMS キーを選択します。
RDS Custom にはAWS KMSキーが必要です。詳細については、「[ステップ 1: 対称暗号化 AWS KMS キーを作成または再利用する](custom-setup-orcl.md#custom-setup-orcl.cmk)」を参照してください。
1. (オプション) **[新しいタグを追加]** を選択して、CEV のキーと値のペアを作成します。
1. **[カスタムエンジンバージョンの作成]** を選択します。
JSON マニフェストの形式が無効な場合は、コンソールに「**CEV マニフェストの検証中にエラーが発生しました**」と表示されます。問題を修正して、再試行してください。
**カスタムエンジンバージョン**ページが表示されます。CEV が**作成**ステータスとともに表示されます。CEV の作成プロセスは、約 2 時間継続します。
## AWS CLI
AWS CLI を使用して CEV を作成するには、[create-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html) コマンドを実行します。
以下のオプションは必須です。
+ `--engine` — エンジンタイプを指定します。CDB の場合は、`custom-oracle-ee-cdb` または `custom-oracle-se2-cdb` を指定します。非 CDB の場合は、`custom-oracle-ee` または `custom-oracle-se2` を指定します。CDB は、`custom-oracle-ee-cdb` または `custom-oracle-se2-cdb` で作成した CEV からのみ作成できます。非 CDB は、`custom-oracle-ee` または `custom-oracle-se2` で作成した CEV からのみ作成できます。
+ `--engine-version` — エンジンバージョンを指定します。形式は、*major-engine-version*、*customized\$1string* です。CEV 名には、1～50 個の英数字、アンダースコア、ダッシュ、またはピリオドを含める必要があります。CEV 名には、`19..cdb_cev1` のように連続したピリオドを含めることはできません。
+ `--kms-key-id` – AWS KMS key を指定します。
+ `--manifest` - `manifest_json_string` または `--manifest file:file_name` のいずれかを指定します。改行文字は、`manifest_json_string` で許可されていません。JSON コードでは、必ず、二重引用符 (") の前にバックスラッシュ (\$1) 付けてエスケープしてください。
次の例は、「[ステップ 5: CEV マニフェストを準備する](custom-cev.preparing.md#custom-cev.preparing.manifest)」の 19c の `manifest_json_string` について示しています。この例では、Oracle ベース、Oracle ホーム、UNIX/Linux ユーザーとグループの ID と名前に新しい値を設定します。次の文字列をコピーする場合は、コマンドに貼り付ける前にすべての改行文字を削除してください。
`"{\"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` — [ステップ 3: Amazon S3 へのインストールファイルをアップロードする](custom-cev.preparing.md#custom-cev.preparing.s3) で指定したのと同じバケット名を指定します。`create-custom-db-engine-version` を実行する AWS リージョン は、Amazon S3 バケットと同じリージョンにある必要があります。
また、以下のオプションを指定することもできます。
+ `--description` — CEV の説明を指定します。
+ `--database-installation-files-s3-prefix` — [ステップ 3: Amazon S3 へのインストールファイルをアップロードする](custom-cev.preparing.md#custom-cev.preparing.s3) で指定したのと同じフォルダー名を指定します。
+ `--image-id` — 再利用する AMI ID を指定します。有効な ID を見つけるには、`describe-db-engine-versions` コマンドを実行し、`ImageID` の出力を検索します。デフォルトでは、RDS Custom for Oracle は入手可能な最新の AMI を使用します。
次の例では、`19.cdb_cev1` という名前の Oracle マルチテナント CEV を作成します。この例では、入手可能な最新の AMI を使用するのではなく、既存の AMI を再利用しています。CEV の名前が、エンジンのメジャーバージョン番号で始まっていることを確認してください。
**Example**
Linux、macOS、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
```
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**
`describe-db-engine-versions`コマンドを実行してCEV に関する詳細を入手します。
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
次の部分出力例は、エンジン、パラメータグループ、マニフェストおよびその他の情報を示しています。
```
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. ...
```
## CEV 作成の失敗
CEV の作成プロセスが失敗した場合、RDS Custom はメッセージ `Creation failed for custom engine version major-engine-version.cev_name` を含む `RDS-EVENT-0198` を発行します。そこには、失敗に関する詳細が含まれています。例えば、イベントは不足ファイルを出力します。
障害が発生した CEV を変更することはできません。削除して、失敗の原因を解決してから再度 CEV の作成を試みるしか方法がありません。CEV 作成の障害発生理由のトラブルシューティングについては、[RDS Custom for Oracle のカスタムエンジンバージョン作成のトラブルシューティング](custom-troubleshooting.md#custom-troubleshooting.cev)を参照してください。
# CEV ステータスの変更
AWS マネジメントコンソールまたはAWS CLIを使用して CEV を変更できます。CEV の説明またはそのアベイラビリティーステータスを変更できます。CEV には、次のいずれかのステータス値があります。
+ `available` - この CEV を使用して、新しい RDS Custom DB インスタンスを作成するか、DB インスタンスをアップグレードできます。これは、新規作成された CEV のデフォルトステータスです。
+ `inactive` - この CEV で RDS Custom インスタンスを作成したいアップグレードしたりすることはできません。この CEV を使用して新しい RDS Custom DB インスタンスを作成するために、DB スナップショットを復元することはできません。
CEV は、サポート対象のステータスから、他のサポート対象ステータスに変更できます。ステータスを変更することで、CEV の誤用を防いだり、中止された CEV を再び使用したりできるようになります。例えば、CEV のステータスを`available`から`inactive`に、`inactive`から`available`に変更したりします。
## コンソール
**CEV を変更するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、「**カスタムエンジンバージョン**」 を選択します。
1. 説明またはステータスを変更する CEV を選択します。
1. **[アクション]** で、**[変更]** を選択します。
1. 次の変更のいずれか、あるいはすべてを実行します。
+ **CEV ステータス設定**で、新しいアベイラビリティーステータスを選択します。
+ **Version description** (バージョンの説明) ページで、新しい説明を入力します。
1. **[Modify State]** (状態の変更) を選択します。
CEV が使用中の場合は、コンソールに「**CEV ステータスを変更することはできません**」と表示されます。問題を修正して、再試行してください。
**カスタムエンジンバージョン**ページが表示されます。
## AWS CLI
AWS CLIを使用して CEV を変更するには、[modify-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-custom-db-engine-version.html)コマンドを実行します。[db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html)コマンドを実行して、変更するCEVを検索できます。
以下のオプションは必須です。
+ `--engine engine-type` (*engine-type* は `custom-oracle-ee`、`custom-oracle-se2`、`custom-oracle-ee-cdb`、または `custom-oracle-se2-cdb`)
+ *`cev`*が変更するカスタムエンジンバージョンの名前である`--engine-version cev`です。
+ *`status`*がCEV に割り当てるアベイラビリティーステータスを示す`--status`` status`です。
次の例では、`19.my_cev1` という名前の CEV を現在のステータスから `inactive` に変更します。
**Example**
Linux、macOS、Unix の場合:
```
1. aws rds modify-custom-db-engine-version \
2. --engine custom-oracle-se2 \
3. --engine-version 19.my_cev1 \
4. --status inactive
```
Windows の場合:
```
1. aws rds modify-custom-db-engine-version ^
2. --engine custom-oracle-se2 ^
3. --engine-version 19.my_cev1 ^
4. --status inactive
```
# Amazon RDS Custom for Oracle の CEV 詳細を表示する
AWS マネジメントコンソール またはAWS CLI を使用して、CEV マニフェストと CEV の作成に使用したコマンドの詳細を表示できます。
## コンソール
**CEV の詳細を表示するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
**カスタムエンジンバージョン**ページには、現在存在するすべての CEV が表示されます。CEV をまだ作成していない場合、ページは空です。
1. 表示する CEV の名前を選択します。
1. **[Configuration]** (設定) を選択して、マニフェストに指定されているインストールパラメータが表示を表示します。
![\[CEV のインストールパラメータが表示されます。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/cev-configuration-tab.png)
1. **[Manifest]** (マニフェスト) を選択して、`create-custom-db-engine-version` コマンドの `--manifest` オプションで指定されているインストールパラメータを表示します。このテキストをコピーし、必要に応じて値を置き換えて、新しいコマンドで使用できます。
![\[CEV の作成に使用したコマンドが表示されます。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/cev-manifest-tab.png)
## AWS CLI
AWS CLI を使用して CEV に関する詳細を表示するには、[describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) コマンドを実行します。
以下のオプションは必須です。
+ `--engine engine-type` (*engine-type* は `custom-oracle-ee`、`custom-oracle-se2`、`custom-oracle-ee-cdb`、または `custom-oracle-se2-cdb`)
+ `--engine-version major-engine-version.customized_string`
次の例では、Enterprise Edition を使用する非 CDB の CEV を作成します。CEV の名前 `19.my_cev1` は、メジャーエンジンバージョン番号で始めます (必須)。
**Example**
Linux、macOS、Unix の場合:
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Windows の場合:
```
1. aws rds describe-db-engine-versions ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```
次の部分出力例は、エンジン、パラメータグループ、マニフェストおよびその他の情報を示しています。
```
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. ]
```
# CEV の削除
AWS マネジメントコンソール またはAWS CLIを使用して、CEVを削除できます。これには通常数分かかります。
CEV を削除するには、CEVが次のいずれかで CEV を使用中であってはいけません。
+ RDS Custom DB インスタンスを停止します。
+ RDS Custom DB インスタンスのスナップショット
+ RDS Custom DB インスタンスの自動バックアップ
## コンソール
**CEV を削除するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) を開きます。
1. ナビゲーションペインで、[**カスタムエンジンバージョン**] を選択します。
1. 説明またはステータスを削除する CEV を選択します。
1. **[アクション]** で、**[削除]** を選択します。
**[Delete *cev\$1name*?]** (cev\$1name を削除しますか?) ダイアログボックスが表示されます。
1. 「**delete me**」と入力し、**[削除]** を選択します。
**カスタムエンジンバージョン**ページで、バナーに CEV が削除中であることが示されます。
## AWS CLI
AWS CLIを使用して CEV を削除するには、[delete-custom-db-engine-version](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-custom-db-engine-version.html)コマンドを実行します。
以下のオプションは必須です。
+ `--engine engine-type` (*engine-type* は `custom-oracle-ee`、`custom-oracle-se2`、`custom-oracle-ee-cdb`、または `custom-oracle-se2-cdb`)
+ *CEV*が削除するカスタムエンジンバージョンの名前である`--engine-version cev`です。
次の例では、`19.my_cev1` という名前の CEV を削除します。
**Example**
Linux、macOS、Unix の場合:
```
1. aws rds delete-custom-db-engine-version \
2. --engine custom-oracle-ee \
3. --engine-version 19.my_cev1
```
Windows の場合:
```
1. aws rds delete-custom-db-engine-version ^
2. --engine custom-oracle-ee ^
3. --engine-version 19.my_cev1
```