機械翻訳について

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

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

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

サポートされている言語

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

サポートされる言語は次のとおりです。

  • REST

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

  • Java
  • Python
  • Go
  • 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の起動

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

RESTは、エンドポイントとしてCreateIntegrationInstance、アクションとしてPOSTを使用して起動します。 エンドポイントの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
メッセージ・パック サブスクライブするメッセージ・パックの数を入力します。

Edit the Number of Message Packs Using the User Interfaceを参照してください。

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

Shapesを参照してください。

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

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

integrationInstanceType

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