Oracle Cloud Infrastructureドキュメント

APIを使用したインスタンスの作成

Oracle Integration管理APIを使用してOracle Integrationインスタンスをプロビジョニングできます。

インスタンスの作成を含むOracle Integrationのライフサイクル操作は、Oracle Integration管理APIの一部です。特に、CreateIntegrationInstance APIでは、新しいOracle Integrationインスタンスの作成がサポートされています。

サポートされている言語

REST APIのサポートに加えて、複数の言語バインディングもあります。

次の言語がサポートされています。

  • REST

    たとえば、PostmanやOracle Integrationで使用できます。

  • Java
  • Python
  • 移動
  • TypeScript
  • .NET
  • Ruby

ソフトウェア開発キットおよびコマンドライン・インタフェースのドキュメントでは、Oracle Integration管理APIを含むOracle Cloud Infrastructure (OCI) APIの様々な言語バインディングをインストールして使用する方法について説明します。

Oracle IntegrationフローからのCreateIntegrationInstanceのコール

CreateIntegrationInstance APIは、Oracle Integrationフロー内からRESTアダプタを使用してコールできます。この項では、呼出しアクションからAPIをコールするために必要なステップについて説明します。

REST接続の設定

CreateIntegrationInstance APIを呼び出すには、APIへの接続が必要です。RESTアダプタ接続を作成してAPIに接続し、OCI ServiceInvocationセキュリティ・ポリシーを使用できます。これは、OCIポリシーに基づいてアクセスが許可されることを意味します。そのためには、Oracle Integrationインスタンスが動的グループのメンバーである必要があります。RPSTおよびOCIサービス起動セキュリティ・ポリシーの使用を参照してください。

CreateIntegrationInstanceの起動

次に示すように、POST操作としてCreateIntegrationInstanceを起動できます。

エンドポイントとしてCreateIntegrationInstance、アクションとしてPOSTを使用したREST呼出し。エンドポイントのURIも示されていますが、この例には関係ありません。

CreateIntegrationInstanceを起動する場合は、次のサンプル・ペイロードを使用します。 

{
  "compartmentId": "string",
  "consumptionModel": "UCM|GOV|OIC4SAAS",
  "definedTags": {
    "tagNamespace1": {
      "tagKey1": "tagValue1",
      "tagKey2": "tagValue2"
    },
    "tagNamespace2": {
      "tagKey1": "tagValue1",
      "tagKey2": "tagValue2"
    }
  },
  "displayName": "string",
  "domainId": "string",
  "freeformTags": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "isByol": true,
  "isDisasterRecoveryEnabled": true,
  "messagePacks": 1,
  "networkEndpointDetails": {
    "allowlistedHttpIps": [
      "string",
      "string"
    ],
    "allowlistedHttpVcns": [
      {
        "allowlistedIps": [
          "string",
          "string"
        ],
        "id": "string"
      },
      {
        "allowlistedIps": [
          "string",
          "string"
        ],
        "id": "string"
      }
    ],
    "isIntegrationVcnAllowlisted": true,
    "networkEndpointType": "PUBLIC"
  },
  "shape": "DEVELOPMENT|PRODUCTION",
  "integrationInstanceType": "STANDARDX|ENTERPRISEX|HEALTHCARE"
}
パラメータの名前 説明 パラメータ
コンパートメント インスタンスを作成するコンパートメントを入力します。 compartmentId
消費モデル このパラメータは、サブスクリプション権限とUCM権限の両方がある場合にのみ必要です。 consumptionModel
ネームスペース・タグ ネームスペースにスコープ指定された事前定義キーを入力します。 definedTags
名前 このインスタンスの名前を入力します。名前は、インスタンスにアクセスするためのURLの一部になります。 displayName
アイデンティティ・ドメイン このパラメータは必須としてリストされていませんが、含める必要があります。インスタンスを関連付けるアイデンティティ・ドメインのOCIDを入力します。

テナンシ外部のアイデンティティ・ドメインは使用できません。

 domainId
フリーフォーム・タグ オプションで、テナンシ内のリソースの編成に役立つタグを追加します。

リソース・タグを参照してください。

freeformTags
ライセンス・タイプ 既存のOracle Fusion Middlewareライセンスを使用する場合は、このオプションをTRUEに設定します。

ライセンス・タイプを参照してください。

isByol

使用できる値はTRUEおよびFALSEです。

ディザスタ・リカバリ ディザスタ・リカバリを構成する場合は、このオプションをTRUEに設定します。これにより、あるリージョンにプライマリ・インスタンスがインストールされ、別のリージョンにセカンダリ・インスタンスがインストールされます。エディションとしてENTERPRISEXまたはHEALTHCAREを選択し、シェイプとしてPRODUCTIONを選択する必要があります。また、ディザスタ・リカバリのペアリングをサポートするリージョンにいる必要があります。

Oracle管理のディザスタ・リカバリの概要のOracle Integration 3用のOracle管理のディザスタ・リカバリ・ソリューションの構成を参照してください。

isDisasterRecoveryEnabled

使用できる値はTRUEおよびFALSEです。

ネットワーク・アクセス インスタンスの許可リストは構成します。インスタンスの許可リストの構成を参照してください。 networkEndpointDetails
メッセージ・パック サブスクライブするメッセージ・パックの数を入力します。

ユーザー・インタフェースを使用したメッセージ・パック数の編集を参照してください。

–message-packs
シェイプ このパラメータは必須ではありませんが、推奨されます。デフォルトは「本番」です。このインスタンスに使用するシェイプを入力します。

「シェイプ」を参照してください。

shape
エディション このインスタンスを配置するエディションを入力します。

Oracle Integrationのエディションを参照してください。

integrationInstanceType

CLIコマンドの–generate-full-command-json-inputオプションを使用して、任意のOCIコマンドのサンプルJSONロードを生成できます。