データベース・デプロイメントの作成
/paas/service/dbcs/api/v1.1/instances/{identityDomainId}
リクエスト
- application/vnd.com.oracle.oracloud.provisioning.Service+json
- identityDomainId
-
型:
string
必須:true
Exadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。
- Authorization
-
型:
string
必須:true
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。 詳細は、セキュリティ、認証および認可を参照してください。- X-ID-TENANT-NAME
型:string
必須:true
Exadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。 詳細は、「セキュリティ、認証、認可」を参照してください。
- clusterName
-
型:
string
Exadata Cloud Machineデータベース・デプロイメントをサポートするクラスタの名前。 - dbTemplate
-
型:
string
初期データベースに使用するテンプレート:
oltp
- 大量のランダム・データ・アクセスの多いトランザクション・ワークロード用に初期データベースを構成します。dw
- 大規模なデータ・スキャニング操作の多い意思決定支援またはデータ・ウェアハウス・ワークロード用に初期データベースを構成します。
このパラメータは、起動データベースを作成する場合にのみ含める。 スタータ・データベースは、Exadataシステムで最初に作成するExadata Cloud Machineデータベース・デプロイメントです。 後続のデータベースは、標準化されたデータベース構成で作成されます。
- description
-
型:
string
Exadata Cloud Machineデータベース・デプロイメントの説明。 - edition
-
型:
string
必須:true
Oracle Databaseソフトウェア版。 Exadata Cloud Machineの場合、唯一の有効な値はEE_EP
です。 - exadataSystemName
-
型:
string
Exadata Cloud Machineデータベース・デプロイメントを作成するExadataシステムの名前。 - level
-
型:
string
必須:true
サービス・レベル。 Exadata Cloud Machineの場合、唯一の有効な値はPAAS_EXADATA
です。 - parameters
-
型:
array
parameters必須:true
追加のデータベース構成パラメータ。 - serviceName
-
型:
string
必須:true
Exadata Cloud Machineデータベース・デプロイメントの名前。
名前には次の要件があります。
50文字を超えることはできません。
文字で始まる必要があります。
文字、数字またはハイフンのみ使用できます。
ハイフンで終わることはできません。
それ以外の特殊文字を含むことはできません。
アイデンティティ・ドメイン内で一意である必要があります。
- subscriptionType
-
型:
string
必須:true
請求の頻度。 Exadata Cloud Machineの場合、唯一の有効な値はMONTHLY
です。 - version
-
型:
string
必須:true
Oracle Databaseソフトウェア・バージョン。次のいずれか:11.2.0.4
、12.1.0.2
または12.2.0.1
。 - vmPublicKeyText
-
型:
string
必須:true
SSH公開鍵のテキスト。
この鍵は、SSHクライアントを使用してExadata Cloud Machineに接続する際の認証に使用されます。 SSH公開鍵/秘密鍵ペアは標準のSSH鍵生成ツールを使用して生成します。 「セキュア・シェル(SSH)公開鍵/秘密鍵ペアの生成」と「セキュア・シェル(SSH)を介したコンピュート・ノードへの接続」を参照してください。
- adminPassword
-
型:
string
必須:true
Exadata Cloud Machineデータベース・デプロイメントの管理者パスワード。 このパスワードは、Oracle Database管理者のユーザー
sys
およびsystem
に割り当てられます。パスワードには次の要件があります。
長さが8文字から30文字であること。
少なくとも1つの小文字を含むこと
少なくとも1つの大文字を含むこと
少なくとも1つの数字を含むこと
次の記号の少なくとも1つを含むこと: _(アンダースコア)、#(ハッシュ記号)または- (ダッシュまたはマイナス記号)。
- backupDestination
-
型:
string
必須:true
Exadata Cloud Machineデータベース・デプロイメントのバックアップ構成:
NFS
- ネットワーク・ファイル・システム(NFS)のロケーションにバックアップを構成します。NONE
- バックアップを構成しません。
- charset
-
型:
string
Exadata Cloud Machineデータベース・デプロイメント用の文字セット。 デフォルト値はAL32UTF8
です。有効な値は、
AL32UTF8
、AR8ADOS710
、AR8ADOS720
、AR8APTEC715
、AR8ARABICMACS
、AR8ASMO8X
、AR8ISO8859P6
、AR8MSWIN1256
、AR8MUSSAD768
、AR8NAFITHA711
、AR8NAFITHA721
、AR8SAKHR706
、AR8SAKHR707
、AZ8ISO8859P9E
、BG8MSWIN
、BG8PC437S
、BLT8CP921
、BLT8ISO8859P13
、BLT8MSWIN1257
、BLT8PC775
、BN8BSCII
、CDN8PC863
、CEL8ISO8859P14
、CL8ISO8859P5
、CL8ISOIR111
、CL8KOI8R
、CL8KOI8U
、CL8MACCYRILLICS
、CL8MSWIN1251
、EE8ISO8859P2
、EE8MACCES
、EE8MACCROATIANS
、EE8MSWIN1250
、EE8PC852
、EL8DEC
、EL8ISO8859P7
、EL8MACGREEKS
、EL8MSWIN1253
、EL8PC437S
、EL8PC851
、EL8PC869
、ET8MSWIN923
、HU8ABMOD
、HU8CWI2
、IN8ISCII
、IS8PC861
、IW8ISO8859P8
、IW8MACHEBREWS
、IW8MSWIN1255
、IW8PC1507
、JA16EUC
、JA16EUCTILDE
、JA16SJIS
、JA16SJISTILDE
、JA16VMS
、KO16KSC5601
、KO16KSCCS
、KO16MSWIN949
、LA8ISO6937
、LA8PASSPORT
、LT8MSWIN921
、LT8PC772
、LT8PC774
、LV8PC1117
、LV8PC8LR
、LV8RST104090
、N8PC865
、NE8ISO8859P10
、NEE8ISO8859P4
、RU8BESTA
、RU8PC855
、RU8PC866
、SE8ISO8859P3
、TH8MACTHAIS
、TH8TISASCII
、TR8DEC
、TR8MACTURKISHS
、TR8MSWIN1254
、TR8PC857
、US7ASCII
、US8PC437
、UTF8
、VN8MSWIN1258
、VN8VN3
、WE8DEC
、WE8DG
、WE8ISO8859P1
、WE8ISO8859P15
、WE8ISO8859P9
、WE8MACROMAN8S
、WE8MSWIN1252
、WE8NCR4970
、WE8NEXTSTEP
、WE8PC850
、WE8PC858
、WE8PC860
、WE8ROMAN8
、ZHS16CGB231280
、ZHS16GBK
、ZHT16BIG5
、ZHT16CCDC
、ZHT16DBT
、ZHT16HKSCS
、ZHT16MSWIN950
、ZHT32EUC
、ZHT32SOPS
、ZHT32TRIS
です。 - cloudStorageContainer
-
型:
string
既存のネットワーク・ファイル・システム(NFS)のロケーションの名前:
IP address:directory
IP address
はNFSサーバーのIPアドレスまたはホスト名、directory
は使用されているNFSディレクトリの名前です。 - cloudStoragePwd
-
型:
string
cloudStorageUser
で指定されたユーザーのパスワード。 - cloudStorageUser
-
型:
string
cloudStorageContainer
に指定されたコンテナへの読取り/書込みアクセス権を持っているユーザーのユーザー名。 - goldenGate
-
型:
string
Oracle GoldenGate Cloud Serviceインスタンスのレプリケーション・データベースとして使用するデータベースを構成するかどうかを指定します。 有効な値はyes
およびno
です。 デフォルト値はno
です。 - isRac
-
型:
string
必須:true
Exadata Cloud Machineはクラスタ・データベースのみをサポートしています。 Exadata Cloud Machineの場合、唯一の有効な値はyes
です。 - ncharset
-
型:
string
Exadata Cloud Machineデータベース・デプロイメント用の各国語キャラクタ・セット。 デフォルト値はAL16UTF16
です。有効な値は
AL16UTF16
およびUTF8
です。 - pdbName
-
型:
string
Exadata Cloud Machineデータベース・デプロイメント用のプラガブル・データベース(pdb)名。
このパラメータは、Oracle Database 12cを使用したデプロイメントにのみ有効です。
名前には次の要件があります。
8文字を超えることはできません。
文字で始まる必要があります。
文字および数字のみである必要があります。
デフォルト値は
pdb1
です。 - sid
-
型:
string
必須:true
Exadata Cloud Machineデータベース・デプロイメントのデータベース・システムID(sid)名。
名前には次の要件があります。
8文字を超えることはできません。
文字で始まる必要があります。
文字および数字のみである必要があります。
デフォルト値は
ORCL
です。 - type
-
型:
string
必須:true
一連のパラメータが適用されるコンポーネント・タイプ。 Exadata Cloud Machineの場合、唯一の有効な値はdb
です。
レスポンス
Locationヘッダーは、操作のステータスにアクセスする際に使用できるREST URIを返します(操作のステータスの表示を参照)。
例
次の例は、cURLを使用してRESTエンドポイントにPOSTリクエストを送信して、Exadata Cloud Machineデータベース・デプロイメントを作成する方法を示しています。
この例では、アイデンティティ・ドメインはusexampleで、Oracle Cloudユーザー名およびパスワードはserviceadminおよびPa55_wordです。 リクエスト本文で、exasysという名前のExadataシステムでのdb12cという名前のインスタンスの作成を指定します。
cURLコマンド
次のcURLコマンドでは、@表記を使用してローカル・マシン上のcreaterequestbody.jsonファイルのコンテンツを参照することで、リクエスト本文を--dataオプションで指定します。
curl --include --method POST \ --cacert ~/cacert.pem \ --user serviceadmin:Pa55_word \ --header "X-ID-TENANT-NAME:usexample" \ --header "Content-Type:application/json" \ --data @createrequestbody.json \ https://dbaas.oraclecloud.com/paas/service/dbcs/api/v1.1/instances/usexample
リクエスト本文
次に、createrequestbody.jsonファイルに含まれるリクエスト本文のリスト出力を示します。
{ "exadataSystemName": "exasys", "serviceName": "db12c", "level": "PAAS_EXADATA", "subscriptionType": "MONTHLY", "version": "12.1.0.2", "edition": "EE_EP", "description": "Example Exadata Cloud Machine database deployment", "clusterName": "dbcluster", "vmPublicKeyText": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQBpoeS7Iu202hKbBbzKBpYKxqNSLo1Y4O5UxWv2E2iibuAX4EKlveQMpZPJDhIMz3OqzfnjlbaBJ48CxE2F9lB8c3hIME6cjyiwzi9yOVRkHzmGWdMVFqi+0Mu+GUGisrqzKh1zjAbbHHlYSRR5QSZ8SwR7giS09swwhCsx5Luf1MPDkwGYBudoqo7taJfwPDUXDkE1ULR/JNx99YLam5RUVgF/4HBOEmYyyfUHqvjY4VcuHHeyMdDNS2dCUFvEgH3rQP0HqnoG3FB5fHesJwBaNNDRmuYaAJsDj9nEf3w8dYdFuBeexev0tQn9LHC+k6LQXCYgWYiccNZSsZim13aT rsa-key-20150211", "isRAC": "yes", "parameters": [ { "type": "db", "adminPassword": "Pa55_word", "sid": "ORCL", "pdbName": "PDB1", "backupDestination": "NONE" } ] }
HTTPステータス・コードおよびレスポンス・ヘッダー
HTTP/1.1 202 Accepted Server: Oracle-Application-Server-11g Location: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/status/create/job/6569699 X-ORACLE-DMS-ECID: id-string X-ORACLE-DMS-ECID: id-string X-Frame-Options: DENY Service-URI: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/db12c Vary: Accept-Encoding,User-Agent Retry-After: 60 Content-Language: en Content-Encoding: gzip Content-Length: 20 Content-Type: application/json Date: date-and-time Connection: keep-alive