データベース・デプロイメントの作成
/paas/service/dbcs/api/v1.1/instances/{identityDomainId}
リクエスト
- application/vnd.com.oracle.oracloud.provisioning.Service+json
- identityDomainId
-
型:
string必須:trueExadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。
- Authorization
-
型:
string必須:trueリクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。 詳細は、セキュリティ、認証および認可を参照してください。- X-ID-TENANT-NAME
型:string必須:trueExadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。 詳細は、「セキュリティ、認証、認可」を参照してください。
- clusterName
-
型:
stringExadata Cloud Machineデータベース・デプロイメントをサポートするクラスタの名前。 - dbTemplate
-
型:
string初期データベースに使用するテンプレート:
oltp- 大量のランダム・データ・アクセスの多いトランザクション・ワークロード用に初期データベースを構成します。dw- 大規模なデータ・スキャニング操作の多い意思決定支援またはデータ・ウェアハウス・ワークロード用に初期データベースを構成します。
このパラメータは、起動データベースを作成する場合にのみ含める。 スタータ・データベースは、Exadataシステムで最初に作成するExadata Cloud Machineデータベース・デプロイメントです。 後続のデータベースは、標準化されたデータベース構成で作成されます。
- description
-
型:
stringExadata Cloud Machineデータベース・デプロイメントの説明。 - edition
-
型:
string必須:trueOracle Databaseソフトウェア版。 Exadata Cloud Machineの場合、唯一の有効な値はEE_EPです。 - exadataSystemName
-
型:
stringExadata Cloud Machineデータベース・デプロイメントを作成するExadataシステムの名前。 - level
-
型:
string必須:trueサービス・レベル。 Exadata Cloud Machineの場合、唯一の有効な値はPAAS_EXADATAです。 - parameters
-
型:
arrayparameters必須:true追加のデータベース構成パラメータ。 - serviceName
-
型:
string必須:trueExadata Cloud Machineデータベース・デプロイメントの名前。
名前には次の要件があります。
50文字を超えることはできません。
文字で始まる必要があります。
文字、数字またはハイフンのみ使用できます。
ハイフンで終わることはできません。
それ以外の特殊文字を含むことはできません。
アイデンティティ・ドメイン内で一意である必要があります。
- subscriptionType
-
型:
string必須:true請求の頻度。 Exadata Cloud Machineの場合、唯一の有効な値はMONTHLYです。 - version
-
型:
string必須:trueOracle Databaseソフトウェア・バージョン。次のいずれか:11.2.0.4、12.1.0.2または12.2.0.1。 - vmPublicKeyText
-
型:
string必須:trueSSH公開鍵のテキスト。
この鍵は、SSHクライアントを使用してExadata Cloud Machineに接続する際の認証に使用されます。 SSH公開鍵/秘密鍵ペアは標準のSSH鍵生成ツールを使用して生成します。 「セキュア・シェル(SSH)公開鍵/秘密鍵ペアの生成」と「セキュア・シェル(SSH)を介したコンピュート・ノードへの接続」を参照してください。
- adminPassword
-
型:
string必須:trueExadata Cloud Machineデータベース・デプロイメントの管理者パスワード。 このパスワードは、Oracle Database管理者のユーザー
sysおよびsystemに割り当てられます。パスワードには次の要件があります。
長さが8文字から30文字であること。
少なくとも1つの小文字を含むこと
少なくとも1つの大文字を含むこと
少なくとも1つの数字を含むこと
次の記号の少なくとも1つを含むこと: _(アンダースコア)、#(ハッシュ記号)または- (ダッシュまたはマイナス記号)。
- backupDestination
-
型:
string必須:trueExadata Cloud Machineデータベース・デプロイメントのバックアップ構成:
NFS- ネットワーク・ファイル・システム(NFS)のロケーションにバックアップを構成します。NONE- バックアップを構成しません。
- charset
-
型:
stringExadata 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
-
型:
stringcloudStorageUserで指定されたユーザーのパスワード。 - cloudStorageUser
-
型:
stringcloudStorageContainerに指定されたコンテナへの読取り/書込みアクセス権を持っているユーザーのユーザー名。 - goldenGate
-
型:
stringOracle GoldenGate Cloud Serviceインスタンスのレプリケーション・データベースとして使用するデータベースを構成するかどうかを指定します。 有効な値はyesおよびnoです。 デフォルト値はnoです。 - isRac
-
型:
string必須:trueExadata Cloud Machineはクラスタ・データベースのみをサポートしています。 Exadata Cloud Machineの場合、唯一の有効な値はyesです。 - ncharset
-
型:
stringExadata Cloud Machineデータベース・デプロイメント用の各国語キャラクタ・セット。 デフォルト値はAL16UTF16です。有効な値は
AL16UTF16およびUTF8です。 - pdbName
-
型:
stringExadata Cloud Machineデータベース・デプロイメント用のプラガブル・データベース(pdb)名。
このパラメータは、Oracle Database 12cを使用したデプロイメントにのみ有効です。
名前には次の要件があります。
8文字を超えることはできません。
文字で始まる必要があります。
文字および数字のみである必要があります。
デフォルト値は
pdb1です。 - sid
-
型:
string必須:trueExadata 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