REST API for Oracle Database Exadata Cloud at Customer (Gen 1/OCI-C)

機械翻訳について

データベース・デプロイメントの作成

post

/paas/service/dbcs/api/v1.1/instances/{identityDomainId}

Exadata Cloud at Customerデータベース・デプロイメントを作成します。

リクエスト

サポートされているメディア・タイプ

application/vnd.com.oracle.oracloud.provisioning.Service+json

パス・パラメータ

identityDomainId: string
値は、リクエストを行うために使用されるExadata Cloud at Customerアカウントのタイプによって異なります:
- 「従来のクラウド・アカウント」には、サービスに関連付けられているIdentity Domain Nameを指定します。
- 「Identity Cloud Serviceを含むクラウド・アカウント」の場合は、サービスに関連付けられるIdentity Service Idを指定します。これは、idcs-で始まる文字列です。

ヘッダー・パラメータ

Authorization: string

リクエストを行ったユーザーのユーザー名とパスワードのBase64エンコード。詳細は、「セキュリティ、認証、認可」を参照してください。
X-ID-TENANT-NAME: string
値は、リクエストを行うために使用されるExadata Cloud at Customerアカウントのタイプによって異なります:
- 「従来のクラウド・アカウント」には、サービスに関連付けられているIdentity Domain Nameを指定します。
- 「Identity Cloud Serviceを含むクラウド・アカウント」の場合は、サービスに関連付けられるIdentity Service Idを指定します。これは、idcs-で始まる文字列です。
詳細は、「セキュリティ、認証、認可」を参照してください。

リクエスト本文は、リクエストの詳細を定義します。太字は必須の値を示します。

ルート・スキーマ : create-postrequest

型: object

リクエスト本文は、リクエストの詳細を定義します。

Show Source

clusterName(optional): string

Exadata Cloud at Customerデータベース・デプロイメントをサポートするクラスタの名前。
dbTemplate(optional): string
スタータ・データベースに使用するテンプレート:
- oltp - 大量のランダム・データ・アクセスに向けてバイアスをかけて、トランザクション・ワークロード用のスタータ・データベースを構成します。
- dw - デシジョン・サポートまたはデータ・ウェアハウスのワークロード用にスタータ・データベースを構成し、大規模なデータ・スキャン操作に偏っています。
このパラメータは、起動データベースを作成する場合にのみ含める。スタータ・データベースは、Exadataシステムで作成する最初のExadata Cloud at Customerデータベース・デプロイメントです。後続のデータベースは、標準化されたデータベース構成で作成されます。
description(optional): string

Exadata Cloud at Customerデータベース・デプロイメントの説明。
edition: string

Oracle Databaseソフトウェア版。 Exadata Cloud at Customerの場合、唯一の有効な値はEE_EPです。
exadataSystemName(optional): string

Exadata Cloud at Customerデータベース・デプロイメントを作成するExadataシステムの名前。
level: string

サービスレベル。 Exadata Cloud at Customerの場合、唯一の有効な値はPAAS_EXADATAです。
nodelist(optional): string

データベース・デプロイメントのデータベース・インスタンスをホストするコンピュート・ノードのリストを指定します。コンピュート・ノード名はコンマで区切ります。 nodelistが指定されていない場合、データベースはすべてのコンピュート・ノードにデプロイされます。
parameters: array parameters

追加のデータベース構成パラメータ。
serviceName: string
Exadata Cloud at Customerデータベース・デプロイメントの名前。
名:
- 50文字を超えることはできません。
- 文字で始まる必要があります。
- 文字、数字またはハイフンのみ使用できます。
- ハイフンで終わってはいけません。
- それ以外の特殊文字を含むことはできません。
- アイデンティティ・ドメイン内で一意である必要があります。
standbys(optional): array standbys

スタンバイ・データベースのパラメータ。この属性は、failoverDatabaseがyesに設定されている場合にのみ適用されます。
subscriptionType: string

請求頻度。 Exadata Cloud at Customerの場合、唯一の有効な値はMONTHLYです。
version: string

Oracle Databaseソフトウェア・バージョン。の一つ: 11.2.0.4、12.1.0.2または12.2.0.1。
vmPublicKeyText(optional): string

SSH公開キーのテキスト。
このキーは、SSHクライアントを使用してExadata Cloud at Customerに接続する際の認証に使用されます。 SSH公開キー/秘密キー・ペアは標準のSSHキー生成ツールを使用して生成します。「セキュア・シェル(SSH)公開キー/秘密キーペアの生成」と「セキュア・シェル(SSH)を介したコンピュート・ノードへの接続」を参照してください。

{
    "description":"The request body defines the details of the request.",
    "properties":{
        "serviceName":{
            "type":"string",
            "description":"<p>Name for the Exadata Cloud at Customer database deployment.</p><p>Name:<ul><li><p>Must not exceed 50 characters.</p></li><li><p>Must start with a letter.</p></li><li><p>Must contain only letters, numbers, or hyphens.</p></li><li><p>Must not end with a hyphen.</p></li><li><p>Must not contain any other special characters.</p></li><li><p>Must be unique within the identity domain.</p></li></ul></p>"
        },
        "description":{
            "type":"string",
            "description":"A description for the Exadata Cloud at Customer database deployment."
        },
        "vmPublicKeyText":{
            "type":"string",
            "description":"<p>The text of an SSH public key.</p><p>The key is used for authentication when connecting to Exadata Cloud at Customer using an SSH client. You generate an SSH public-private key pair using a standard SSH key generation tool. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/cloud-at-customer/exadata-cloud-at-customer/exacc&id=EXACC-GUID-4285B8CF-A228-4B89-9552-FE6446B5A673' target='_blank'>Generating a Secure Shell (SSH) Public/Private Key Pair</a> and <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/cloud-at-customer/exadata-cloud-at-customer/exacc&id=EXACC-GUID-C5DAB5B8-1FFA-4122-9181-189561F6E0F1' target='_blank'>Connecting to a Compute Node Through Secure Shell (SSH)</a>.</p>"
        },
        "subscriptionType":{
            "type":"string",
            "description":"The billing frequency. For Exadata Cloud at Customer the only valid value is <code>MONTHLY</code>."
        },
        "level":{
            "type":"string",
            "description":"The service level. For Exadata Cloud at Customer the only valid value is <code>PAAS_EXADATA</code>."
        },
        "version":{
            "type":"string",
            "description":"The Oracle Database software version; one of: <code>11.2.0.4</code>, <code>12.1.0.2</code> or <code>12.2.0.1</code>."
        },
        "edition":{
            "type":"string",
            "description":"The Oracle Database software edition. For Exadata Cloud at Customer the only valid value is <code>EE_EP</code>."
        },
        "exadataSystemName":{
            "type":"string",
            "description":"Name of the Exadata system on which to create the Exadata Cloud at Customer database deployment."
        },
        "clusterName":{
            "type":"string",
            "description":"Name of the cluster supporting the Exadata Cloud at Customer database deployment."
        },
        "nodelist":{
            "type":"string",
            "description":"Specifies the list of compute nodes that host database instances for the database deployment. Separate compute node names with a comma. If <code>nodelist</code> is not specified the database is deployed across all compute nodes."
        },
        "dbTemplate":{
            "type":"string",
            "description":"<p>The template to use for the starter database:<ul><li><p><code>oltp</code> - configures the starter database for a transactional workload, with a bias towards high volumes of random data access.</p></li><li><p><code>dw</code> - configures the starter database for a decision support or data warehouse workload, with a bias towards large data scanning operations.</p></li></ul></p><p>Include this parameter only when creating a starter database. The starter database is the first Exadata Cloud at Customer database deployment that you create on your Exadata system. Subsequent databases are created with a standardized database configuration.</p>"
        },
        "standbys":{
            "type":"array",
            "description":"Standby database parameters. This attribute is applicable only if <code>failoverDatabase</code> is set to <code>yes</code>.",
            "items":{
                "$ref":"#/definitions/standby-parameters"
            }
        },
        "parameters":{
            "type":"array",
            "description":"Additional database configuration parameters.",
            "items":{
                "$ref":"#/definitions/parameters"
            }
        }
    },
    "required":[
        "serviceName",
        "subscriptionType",
        "level",
        "version",
        "edition",
        "parameters"
    ]
}

ネストされたスキーマ: parameters

型: array

追加のデータベース構成パラメータ。

Show Source

Array of: object parameters

{
    "type":"array",
    "description":"Additional database configuration parameters.",
    "items":{
        "$ref":"#/definitions/parameters"
    }
}

ネストされたスキーマ : standbys

型: array

スタンバイ・データベースのパラメータ。この属性は、failoverDatabaseがyesに設定されている場合にのみ適用されます。

Show Source

Array of: object standby-parameters

スタンバイ・データベースのパラメータ。

{
    "type":"array",
    "description":"Standby database parameters. This attribute is applicable only if <code>failoverDatabase</code> is set to <code>yes</code>.",
    "items":{
        "$ref":"#/definitions/standby-parameters"
    }
}

ネストされたスキーマ: parameters

型: object

Show Source

adminPassword: string
Exadata Cloud at Customerデータベース・デプロイメントの管理者パスワード。このパスワードは、Oracle Database管理者のユーザーsysおよびsystemに割り当てられます。
パスワードは:
- 長さは8〜30文字です。
- 少なくとも1つの小文字を含む
- 少なくとも1つの大文字が含まれています
- 少なくとも1つの番号を含む
- これらのシンボルのうち少なくとも1つを含む: _ (アンダースコア)、#(ハッシュ記号)、または - (ダッシュまたはマイナス記号)。
backupDestination: string
Exadata Cloud at Customerデータベース・デプロイメントのバックアップ構成:
- OSS - Oracle Storage Cloudコンテナへのバックアップを構成します。
- BOTH - ExadataシステムおよびOracle Storage Cloudコンテナのローカル・ストレージにバックアップを構成します。
- NONE - バックアップを構成しません。
charset(optional): string

Exadata Cloud at Customerデータベース・デプロイメント用の文字セット。デフォルト値は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(optional): string
既存のOracle Storage Cloud Serviceコンテナの名前:
```
instance-id_domain/container
```
instanceはOracle Storage Cloud Serviceインスタンスの名前、id_domainはアイデンティティ・ドメインの名前、containerはコンテナの名前です。
他の目的でExadata Cloud at Customerデータベースをクラウド・ストレージにバックアップするために使用しているOracle Storage Cloud Serviceコンテナを使用しないでください。たとえば、Oracle Java Cloud Serviceインスタンスをクラウド・ストレージにバックアップするためにも使用しないでください。複数の目的にコンテナを使用すると、請求のエラーが生じる可能性があります。
cloudStoragePwd(optional): string

cloudStorageUserで指定されたユーザーのパスワード。
cloudStorageUser(optional): string

cloudStorageContainerで指定されたコンテナへの読み取り/書き込みアクセス権を持つユーザーのユーザー名。
failoverDatabase(optional): string

プライマリ・データベースとスタンバイ・データベースを含むOracle Data Guard構成を作成する必要がある場合は、yesを指定します。デフォルト値はnoです。
goldenGate(optional): string

Oracle GoldenGate Cloud Serviceインスタンスのレプリケーション・データベースとして使用するようにデータベースを構成するかどうかを指定します。有効な値はyesおよびnoです。デフォルト値はnoです。
ibkup(optional): string

Oracle Database Backup Cloud Serviceを使用して作成された既存のクラウド・バックアップに格納されているデータベースを使用してデータベースをインスタンス化するかどうかを指定します。有効な値はyesおよびnoです。デフォルト値はnoです。
ibkupCloudStorageContainer(optional): string

既存のクラウド・バックアップが格納されているOracle Storage Cloud Serviceコンテナの名前。このパラメータは、ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合に必要です。
ibkupCloudStoragePassword(optional): string

ibkupCloudStorageUserで指定されたOracle Cloudユーザーのパスワード。このパラメータは、ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合に必要です。
ibkupCloudStorageUser(optional): string

ibkupCloudStorageContainerで指定されたコンテナへの読み取りアクセス権を持つOracle Cloudユーザーのユーザー名。このパラメータは、ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合に必要です。
ibkupDatabaseID(optional): string

既存のクラウド・バックアップが作成されたデータベースのデータベースID。このパラメータは、ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合に必要です。
ibkupDecryptionKey(optional): string

既存のパスワードで暗号化されたクラウド・バックアップを作成するために使用されるパスワード。このパスワードは、バックアップの復号化に使用されます。バックアップを解読するには、ibkupDecryptionKeyまたはibkupWalletFileContentを指定します。 ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合は、復号キーまたはウォレットが必要です。
ibkupOnPremise(optional): boolean

このオプションを使用して、ソース・データベース・バックアップの起点を示します。バックアップの起点は、データベース・バックアップ・クラウド・サービスを使用してクラウド・ストレージにバックアップされた同じアイデンティティ・ドメインまたは別の(オンプレミス)データベース内の別のExadata Cloud at Customerデータベース・デプロイメントです。有効な値は、オンプレミス・データベース・バックアップの場合はtrue、別のExadata Cloud at Customerデータベース・バックアップの場合はfalseです。デフォルト値はtrueです。
ibkupServiceID(optional): string

Exadata Cloud at Customerバックアップがバックアップ操作のインスタンス化のソースとして使用されているデータベース・デプロイメント名。このパラメータは、ibkupがyesに設定され、ibkupOnPremiseがfalseに設定されている場合に必要です。
ibkupWalletFileContent(optional): string

ベース64でエンコードされたウォレット・ファイルのコンテンツ。このウォレットは、バックアップの復号化に使用されます。バックアップを解読するには、ibkupDecryptionKeyまたはibkupWalletFileContentを指定します。 ibkupがyesに設定され、ibkupOnPremiseがtrueに設定されている場合は、復号キーまたはウォレットが必要です。
isRac: string

Exadata Cloud at Customerはクラスタ・データベースのみをサポートしています。 Exadata Cloud at Customerの場合、唯一の有効な値はyesです。
ncharset(optional): string

Exadata Cloud at Customerデータベース・デプロイメントの各国語文字セット。デフォルト値はAL16UTF16です。
有効な値はAL16UTF16およびUTF8です。
oracleHomeName(optional): string

データベースのデプロイメントに使用するOracle Homeディレクトリのロケーションの名前。既存のOracle Homeディレクトリのロケーションの名前を指定した場合、useExistingOracleHomeもyesに設定されていれば、データベース・デプロイメントはそのロケーションにある既存のOracle Databaseバイナリを共有します。新しい名前を指定すると、新しいOracle Homeが作成されます。「Oracle Homesについての情報の表示」を参照してください。
pdbName(optional): string
Exadata Cloud at Customerデータベース・デプロイメントのプラガブル・データベース(PDB)名。
このパラメータは、Oracle Database 12cを使用するデプロイメントでのみ有効です。
名:
- 8文字を超えることはできません。
- 文字で始まる必要があります。
- 文字と数字のみを含まなければなりません。
デフォルト値はpdb1です。
sid: string
Exadata Cloud at Customerデータベース・デプロイメントのデータベース・システム識別子(SID)名。
名:
- 8文字を超えることはできません。
- 文字で始まる必要があります。
- 文字と数字のみを含まなければなりません。
デフォルト値はORCLです。
snapshotName(optional): string

新しいスナップショット・クローンのソースとして使用されている既存のスナップショット・マスターの名前。このパラメータは、sourceServiceNameが指定されている場合にのみ有効で、sourceServiceNameに指定されたものと同じ値に設定する必要があります。
sourceServiceName(optional): string

存在する場合は、データベース・デプロイメントをスナップショット・クローンとして作成する必要があることを示します。新しいスナップショット・クローンのソースとして使用されている既存のスナップショット・マスターの名前を入力します。
type: string

一連のパラメータが適用されるコンポーネント・タイプ。 Exadata Cloud at Customerの場合、唯一の有効な値はdbです。
useExistingOracleHome(optional): string

既存のOracle Homeディレクトリのロケーションにデータベース・デプロイメントを作成する場合、このパラメータはyesの値とともに必要です。デフォルト値はnoです。

{
    "properties":{
        "type":{
            "type":"string",
            "description":"The component type to which the set of parameters applies. For Exadata Cloud at Customer the only valid value is <code>db</code>."
        },
        "adminPassword":{
            "type":"string",
            "description":"<p>The administrator password for the Exadata Cloud at Customer database deployment. This password is assigned to the Oracle Database administrator users <code>sys</code> and <code>system</code>.</p><p>The password must:<ul><li><p>Be 8 to 30 characters in length.</p></li><li><p>Contain at least one lowercase letter</p></li><li><p>Contain at least one uppercase letter</p></li><li><p>Contain at least one number</p></li><li><p>Contain at least one of these symbols: _ (underscore), # (hash sign), or - (dash or minus sign).</p></li></ul></p>"
        },
        "sid":{
            "type":"string",
            "description":"<p>The database system identifier (SID) name for the Exadata Cloud at Customer database deployment.</p><p>Name:<ul><li><p>Must not exceed 8 characters.</p></li><li><p>Must start with a letter.</p></li><li><p>Must contain only letters and numbers.</p></li></ul></p><p>The default value is <code>ORCL</code>.</p>"
        },
        "pdbName":{
            "type":"string",
            "description":"<p>The pluggable database (PDB) name for the Exadata Cloud at Customer database deployment.</p><p>This parameter is only valid for deployments using Oracle Database 12c.</p><p>Name:<ul><li><p>Must not exceed 8 characters.</p></li><li><p>Must start with a letter.</p></li><li><p>Must contain only letters and numbers.</p></li></ul></p><p>The default value is <code>pdb1</code>.<p>"
        },
        "backupDestination":{
            "type":"string",
            "description":"<p>The backup configuration for the Exadata Cloud at Customer database deployment:<ul><li><p><code>OSS</code> - Configure backups to an Oracle Storage Cloud container.</p></li><li><p><code>BOTH</code> - Configure backups to local storage on the Exadata system and to an Oracle Storage Cloud container.</p></li><li><p><code>NONE</code> - Configure no backups.</p></li></ul></p>"
        },
        "cloudStorageContainer":{
            "type":"string",
            "description":"<p>Name of an existing Oracle Storage Cloud Service container in the format:</p><pre><i>instance</i>-<i>id_domain</i>/<i>container</i></pre><p>where <i><code>instance</code></i> is the name of the Oracle Storage Cloud Service instance, <i><code>id_domain</code></i> is the name of the identity domain, and <i><code>container</code></i> is the name of the container.</p><p>Do not use the Oracle Storage Cloud Service container that you are using to back up Exadata Cloud at Customer databases to cloud storage for any other purpose. For example, do not also use it to back up Oracle Java Cloud Service instances to cloud storage. Using the container for multiple purposes can result in billing errors.</p>"
        },
        "cloudStorageUser":{
            "type":"string",
            "description":"The user name of a user who has read/write access to the container specified in <code>cloudStorageContainer</code>."
        },
        "cloudStoragePwd":{
            "type":"string",
            "description":"The password of the user specified in <code>cloudStorageUser</code>."
        },
        "goldenGate":{
            "type":"string",
            "description":"Specify if the database is configured for use as the replication database of an Oracle GoldenGate Cloud Service instance. Valid values are <code>yes</code> and <code>no</code>. The default value is <code>no</code>."
        },
        "ncharset":{
            "type":"string",
            "description":"The National Character Set for the Exadata Cloud at Customer database deployment. The default value is <code>AL16UTF16</code>. <p>Valid values are <code>AL16UTF16</code> and <code>UTF8</code>."
        },
        "charset":{
            "type":"string",
            "description":"The Character Set for the Exadata Cloud at Customer database deployment. The default value is <code>AL32UTF8</code>. <p>Valid values are <code>AL32UTF8</code>, <code>AR8ADOS710</code>, <code>AR8ADOS720</code>, <code>AR8APTEC715</code>, <code>AR8ARABICMACS</code>, <code>AR8ASMO8X</code>, <code>AR8ISO8859P6</code>, <code>AR8MSWIN1256</code>, <code>AR8MUSSAD768</code>, <code>AR8NAFITHA711</code>, <code>AR8NAFITHA721</code>, <code>AR8SAKHR706</code>, <code>AR8SAKHR707</code>, <code>AZ8ISO8859P9E</code>, <code>BG8MSWIN</code>, <code>BG8PC437S</code>, <code>BLT8CP921</code>, <code>BLT8ISO8859P13</code>, <code>BLT8MSWIN1257</code>, <code>BLT8PC775</code>, <code>BN8BSCII</code>, <code>CDN8PC863</code>, <code>CEL8ISO8859P14</code>, <code>CL8ISO8859P5</code>, <code>CL8ISOIR111</code>, <code>CL8KOI8R</code>, <code>CL8KOI8U</code>, <code>CL8MACCYRILLICS</code>, <code>CL8MSWIN1251</code>, <code>EE8ISO8859P2</code>, <code>EE8MACCES</code>, <code>EE8MACCROATIANS</code>, <code>EE8MSWIN1250</code>, <code>EE8PC852</code>, <code>EL8DEC</code>, <code>EL8ISO8859P7</code>, <code>EL8MACGREEKS</code>, <code>EL8MSWIN1253</code>, <code>EL8PC437S</code>, <code>EL8PC851</code>, <code>EL8PC869</code>, <code>ET8MSWIN923</code>, <code>HU8ABMOD</code>, <code>HU8CWI2</code>, <code>IN8ISCII</code>, <code>IS8PC861</code>, <code>IW8ISO8859P8</code>, <code>IW8MACHEBREWS</code>, <code>IW8MSWIN1255</code>, <code>IW8PC1507</code>, <code>JA16EUC</code>, <code>JA16EUCTILDE</code>, <code>JA16SJIS</code>, <code>JA16SJISTILDE</code>, <code>JA16VMS</code>, <code>KO16KSC5601</code>, <code>KO16KSCCS</code>, <code>KO16MSWIN949</code>, <code>LA8ISO6937</code>, <code>LA8PASSPORT</code>, <code>LT8MSWIN921</code>, <code>LT8PC772</code>, <code>LT8PC774</code>, <code>LV8PC1117</code>, <code>LV8PC8LR</code>, <code>LV8RST104090</code>, <code>N8PC865</code>, <code>NE8ISO8859P10</code>, <code>NEE8ISO8859P4</code>, <code>RU8BESTA</code>, <code>RU8PC855</code>, <code>RU8PC866</code>, <code>SE8ISO8859P3</code>, <code>TH8MACTHAIS</code>, <code>TH8TISASCII</code>, <code>TR8DEC</code>, <code>TR8MACTURKISHS</code>, <code>TR8MSWIN1254</code>, <code>TR8PC857</code>, <code>US7ASCII</code>, <code>US8PC437</code>, <code>UTF8</code>, <code>VN8MSWIN1258</code>, <code>VN8VN3</code>, <code>WE8DEC</code>, <code>WE8DG</code>, <code>WE8ISO8859P1</code>, <code>WE8ISO8859P15</code>, <code>WE8ISO8859P9</code>, <code>WE8MACROMAN8S</code>, <code>WE8MSWIN1252</code>, <code>WE8NCR4970</code>, <code>WE8NEXTSTEP</code>, <code>WE8PC850</code>, <code>WE8PC858</code>, <code>WE8PC860</code>, <code>WE8ROMAN8</code>, <code>ZHS16CGB231280</code>, <code>ZHS16GBK</code>, <code>ZHT16BIG5</code>, <code>ZHT16CCDC</code>, <code>ZHT16DBT</code>, <code>ZHT16HKSCS</code>, <code>ZHT16MSWIN950</code>, <code>ZHT32EUC</code>, <code>ZHT32SOPS</code>, <code>ZHT32TRIS</code>."
        },
        "isRac":{
            "type":"string",
            "description":"Exadata Cloud at Customer supports cluster databases only. For Exadata Cloud at Customer the only valid value is <code>yes</code>."
        },
        "failoverDatabase":{
            "type":"string",
            "description":"Specify <code>yes</code> if an Oracle Data Guard configuration comprising a primary database and a standby database should be created. Default value is <code>no</code>."
        },
        "sourceServiceName":{
            "type":"string",
            "description":"When present, indicates that the database deployment should be created as a snapshot clone. Provide the name of the existing snapshot master being used as the source for the new snapshot clone."
        },
        "snapshotName":{
            "type":"string",
            "description":"Name of the existing snapshot master being used as the source for the new snapshot clone. This parameter is valid only if <code>sourceServiceName</code> is specified, and should be set to the same value as that supplied for <code>sourceServiceName</code>."
        },
        "ibkup":{
            "type":"string",
            "description":"Specify if the database should be instantiated using a database stored in an existing cloud backup that was created using Oracle Database Backup Cloud Service. Valid values are <code>yes</code> and <code>no</code>. Default value is <code>no</code>."
        },
        "ibkupOnPremise":{
            "type":"boolean",
            "description":"Use this option to indicate the origin of the source database backup. The origin of the backup may be another Exadata Cloud at Customer database deployment in the same identity domain or another (on-premise) database that was backed up to cloud storage using Database Backup Cloud Service. Valid values are <code>true</code> for an on-premise database backup and <code>false</code> for another Exadata Cloud at Customer database backup. Default value is <code>true</code>."
        },
        "ibkupDatabaseID":{
            "type":"string",
            "description":"Database id of the database from which the existing cloud backup was created. This parameter is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupDecryptionKey":{
            "type":"string",
            "description":"Password used to create the existing, password-encrypted cloud backup. This password is used to decrypt the backup. Specify either <code>ibkupDecryptionKey</code> or <code>ibkupWalletFileContent</code> for decrypting the backup. A decryption key or wallet is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupWalletFileContent":{
            "type":"string",
            "description":"Base 64 encoded wallet file content. This wallet is used to decrypt the backup. Specify either <code>ibkupDecryptionKey</code> or <code>ibkupWalletFileContent</code> for decrypting the backup. A decryption key or wallet is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupCloudStorageContainer":{
            "type":"string",
            "description":"Name of the Oracle Storage Cloud Service container where the existing cloud backup is stored. This parameter is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupCloudStorageUser":{
            "type":"string",
            "description":"User name of an Oracle Cloud user who has read access to the container specified in <code>ibkupCloudStorageContainer</code>. This parameter is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupCloudStoragePassword":{
            "type":"string",
            "description":"Password of the Oracle Cloud user specified in <code>ibkupCloudStorageUser</code>. This parameter is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>true</code>."
        },
        "ibkupServiceID":{
            "type":"string",
            "description":"Exadata Cloud at Customer database deployment name whose backup is being used as the source of the instantiate from backup operation. This parameter is required if <code>ibkup</code> is set to <code>yes</code> and <code>ibkupOnPremise</code> is set to <code>false</code>."
        },
        "oracleHomeName":{
            "type":"string",
            "description":"Name for the Oracle Home directory location that you want to use for the database deployment. If you specify the name for an existing Oracle Home directory location, then the database deployment shares the existing Oracle Database binaries at that location if <code>useExistingOracleHome</code> is also set to <code>yes</code>. If you specify a new name, then a new Oracle Home is created. See <a href='http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/cloud-at-customer/exadata-cloud-at-customer/exacc&id=EXACC-GUID-DB6B2FBA-B75E-4DE0-BDF1-B162F37BB917' target='_blank'>Viewing Information About Oracle Homes</a>."
        },
        "useExistingOracleHome":{
            "type":"string",
            "description":"This parameter is required with a value of <code>yes</code> if you want to create a database deployment in an existing Oracle Home directory location. Default value is <code>no</code>."
        }
    },
    "required":[
        "type",
        "adminPassword",
        "sid",
        "backupDestination",
        "isRac"
    ]
}

ネストされたスキーマ : standby-parameters

型: object

スタンバイ・データベースのパラメータ。

Show Source

clusterName(optional): string

Oracle Data Guardを使用するデータベース・デプロイメント用のスタンバイ・データベースを作成するクラスタの名前。
exadataSystemName(optional): string

Oracle Data Guardを使用するデータベース・デプロイメント用のスタンバイ・データベースを作成するExadataシステムの名前。
nodelist(optional): string

スタンバイ・データベースのデータベース・インスタンスをホストするコンピュート・ノードのリストを指定します。コンピュート・ノード名はコンマで区切ります。 nodelistが指定されていない場合、データベースはすべてのコンピュート・ノードにデプロイされます。

{
    "description":"The standby database parameters.",
    "properties":{
        "exadataSystemName":{
            "type":"string",
            "description":"Name of the Exadata system on which to create the standby database for a database deployment that uses Oracle Data Guard."
        },
        "clusterName":{
            "type":"string",
            "description":"Name of the cluster on which to create the standby database for a database deployment that uses Oracle Data Guard."
        },
        "nodelist":{
            "type":"string",
            "description":"Specifies the list of compute nodes that host database instances for the standby database. Separate compute node names with a comma. If <code>nodelist</code> is not specified the database is deployed across all compute nodes."
        }
    }
}

トップに戻る

レスポンス

202レスポンス

Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

Locationヘッダーは、「オペレーションのステータスの表示」で説明されているように、操作のステータスにアクセスするために使用できるREST URIを返します。

トップに戻る

例

次の例は、cURLを使用してRESTエンドポイントにPOSTリクエストを送信することによって、Exadata Cloud at Customerデータベース・デプロイメントを作成する方法を示しています。

この例では、アイデンティティ・ドメインはusexampleであり、Oracle Cloudユーザー名とパスワードはserviceadminとPa55_wordです。リクエスト本文は、exasysというExadataシステム上でdb12cという名前のインスタンスの作成を指定します。

cURLコマンド

次のcURLコマンドでは、リクエスト本文は-dオプションで提供され、@表記を使用して、ローカル・マシン上のcreaterequestbody.jsonファイルの内容を参照します。

curl -i -X POST --cacert ~/cacert.pem -u serviceadmin:Pa55_word -H "X-ID-TENANT-NAME:usexample" -H "Content-Type:application/json" -d @createrequestbody.json  https://dbaas.oraclecloud.com/paas/service/dbcs/api/v1.1/instances/usexample

リクエスト本文

createrequestbody.jsonファイルに含まれているリクエスト本文のリストです。

{
  "serviceName": "db12c",
  "description": "Example Exadata Cloud at Customer database deployment created using REST API",
  "edition": "EE_EP",
  "exadataSystemName": "exasys",
  "clusterName": "cluster1",
  "level": "PAAS_EXADATA",
  "subscriptionType": "MONTHLY",
  "version": "12.2.0.1",
  "vmPublicKeyText": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEA7QMRmWQuy09cQdrJd7h0VoWDIpNRmdRUHaCenu3RRRt2IGasAhLw7DI1yP9JXyJ9c2dKkteQXIB3FRYCAWj7T/r4yPLbzrMEpcuANdBRhkQvwyqDEbNWsqoQoxRBRDTcYEObiJ4PvcH7bV1MR++OtqDg2qBT2f+KwVglH8MuyB7yg/DGuP1j1Lwylwzy/Iw+TzLaWP0l3woZGL7KIZWkkXKUx+nvqY8iEb/4/YqN9ZK4GGK7vLCrrICK3RTjDhclHg1s+64Bb0IqceZpY38xAI8EW/4PNyv3Ag7IZEkiojOEd3znYexsZK3b78+VKWewOsffXqnVHrANAGzedLz/ew== rsa-key-20160712",
  "parameters": [
    {
      "adminPassword": "Pa55_word",
      "backupDestination": "OSS",
      "cloudStorageContainer": "Storage-usexample/ExaCSbackups",
      "cloudStorageUser": "serviceadmin",
      "cloudStoragePwd": "Pa55_word",
      "isRac": "yes",
      "pdbName": "DB12CP1",
      "sid": "DB12C",
      "type": "db"
    }
  ]
}

HTTPステータス・コードとレスポンス・ヘッダー

HTTP/2.0 202
server: Oracle-Application-Server-11g
strict-transport-security: max-age=31536000;includeSubDomains
location: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/status/create/job/12209047
content-language: en
access-control-allow-origin: *
access-control-allow-headers: Content-Type, api_key, Authorization, X-ID-TENANT-NAME, X-USER-IDENTITY-DOMAIN-NAME
retry-after: 60
access-control-allow-methods: GET, POST, DELETE, PUT, OPTIONS, HEAD
x-oracle-dms-ecid: 005K9zY1FEA6uHFpR05Eid0007dd00024l
x-oracle-dms-ecid: 005K9zY1FEA6uHFpR05Eid0007dd00024l
service-uri: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/db12c
x-frame-options: DENY
content-type: application/json
vary: user-agent
date: Mon, 29 May 2017 01:48:26 GMT

トップに戻る