機械翻訳について

リクエストの送信

Developer API for Oracle Integration 3を使用してリクエストを送信する場合は、次のガイドラインを使用します。

Oracle Integration RESTリソースをコールするには、次のいずれかのURLを使用して必要なURLを作成する必要があります:

  • サービス・コンソールURL

    このURLを取得するには、Oracle Cloudコンソールにサインインし、必要なOracle Integrationインスタンスに移動します。 統合インスタンスの詳細ページで、「サービス・コンソールURL」フィールドの横にある「コピー」リンクをクリックして、このURLをコピーします。 このページへのアクセス方法の詳細は、「インスタンス詳細の表示」を参照してください。

  • 設計時URL

    このURLを取得するには、新しいブラウザ・ウィンドウにサービス・コンソールURLを貼り付けます。 統合インスタンスのログイン・ページが表示されたら、URLがデザインタイムURLに変わることに注意してください。 すべての設計時URLは、次の例に示すようにdesignという語で始まります:

    例 : https://design.integration.region.ocp.oraclecloud.com/?integrationInstance=NameOfServiceInstance

    URL https://design.integration.region.ocp.oraclecloud.comの最初の部分はrest-serverで、残りのURL integrationInstance=NameOfServiceInstanceにはサービス・インスタンスの名前が含まれます。

デザインタイムURLを使用したURLの作成

次のURL構造を使用して、Oracle Integration RESTリソースにアクセスします:

https://<rest-server>/<resource-path>?integrationInstance=<service-instance>

説明:

  • rest-server

    インスタンスの設計時のURLからこれを取得します。 たとえば、設計時のURLがhttps://design.integration.region.ocp.oraclecloud.com/?integrationInstance=NameOfServiceInstanceの場合、RESTサーバーは : design.integration.region.ocp.oraclecloud.com。

  • resource-path

    これは、RESTエンドポイントを定義する相対パスです。 RESTエンドポイントの完全なリストは、「すべてのRESTエンドポイント」を参照してください。

    • フィーチャAPIの場合: /ic/api/<component>/<version>/

    ここで、componentは機能コンポーネントであり、versionはREST APIバージョンです。

  • service-instance

    これは統合インスタンスの名前です。

curlコマンドの例:

curl -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000?integrationInstance=service-instance-name

サービス・コンソールURLを使用したURLの作成

サービス・コンソールURLを使用して統合RESTリソースをコールするには、次のURL構造を使用します:

https://<Service-console-URL>/<resource-path>

例:

https://testInstance-abcd-zx-ay.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000

ノート:

サービス・コンソールURLにサービス・インスタンス問合せパラメータが含まれていません。

curlコマンドの例:

curl -X GET -H 'Authorization: Bearer access_token' --location-trusted -H "Accept:application/json" https://testInstance-abcd-zx-ay.integration.region.ocp.oraclecloud.com//ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000

ノート:

curlコマンドには、curlオプション--location-trustedが含まれている必要があります。

サポートされるメソッド

次の表に示すように、標準のHTTPメソッド・リクエストを使用して、Oracle Integration Serviceリソースに対して基本的なCRUD操作(作成、読み取り、更新、および削除)を実行できます。

HTTPメソッド 説明
GET リソースに関する情報を取得します。
POST リソースを作成します。
PUT リソースの更新
DELETE リソースを削除します。

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

Oracle Integration REST APIでサポートされているメディアのタイプは次のとおりです:

  • application/json

サポートされているヘッダー

Oracle Integration REST APIは、HTTPリクエストまたはレスポンスのヘッダー・セクションで渡される可能性のある次のヘッダーをサポートしています。

ヘッダー 説明 例
Content-Type

リクエストの本体のメディア・タイプ。 POSTリクエストで必須。

Content-Type: application/json
Accept

レスポンス本体のメディア・タイプ。

 Accept: application/json
X-ID-TENANT-NAME

認証に使用される、サービスのアイデンティティ・ドメイン名。

 X-ID-TENANT-NAME:ExampleIdentityDomain