パッケージの取得
get
/ic/api/integration/v1/packages
最終更新時間でソートされたすべてのパッケージに関する情報を取得します。
リクエスト
問合せパラメータ
- integrationInstance(required): string
これはサービス・インスタンスの名前です。 この値は、サービス・インスタンス・フィールドで指定した情報ページから取得できます。
- limit: integer(int32)
返される結果のページ区切りには、オフセット・パラメータを使用します。 この制限は、一度に返すアイテムの最大数です。 たとえば、offset=3&limit=16は、4番目のアイテムから始まるパッケージをリストすることを示し、リストには16個のアイテムが含まれます。
- offset: integer(int32)
戻される結果のページ区切りには、制限パラメータを使用します。 オフセットは、レコードを返す開始ポイントです。 たとえば、offset=3&limit=16は、4番目のアイテムから始まるパッケージをリストすることを示し、リストには16個のアイテムが含まれます。
- q: string
指定されたパラメータに基づいてフィルタされたパッケージのリストを返します。
有効なパラメータ:
- name: パッケージの名前。 完全一致または次をサポートします。 たとえば:
- パッケージ名の完全一致であるパッケージを取得するには、次を指定します:
q={name:'PackageName'}. - 指定した文字列がパッケージ名に含まれるすべてのパッケージを取得するには、次のように指定します:
q={name: /pack/}
- パッケージ名の完全一致であるパッケージを取得するには、次を指定します:
- type: パッケージのタイプ。 有効な値: PREBUILT, DEVELOPED.
- name: パッケージの名前。 完全一致または次をサポートします。 たとえば:
この操作のリクエスト本文がありません。
トップに戻るレスポンス
サポートされているメディア・タイプ
- application/json; charset=utf-8, application/vnd.oracle.resource+json;type=collection
200レスポンス
操作の成功
ルート・スキーマ : PackagesRs
型:
ソースを表示
object-
has-more: boolean
レコードが他に存在するかどうかを確認するフラグ
-
items: array items
パッケージのリスト
-
limit: integer (int32)
表示するレコードの制限
-
total-results: integer (int32)
結果合計
ネストされたスキーマ : PackageRs
型:
ソースを表示
object-
barta-built-by: string
BA (Business Accelerator) | R (レシピ) | TA (Technical Accelerator) builtBy
-
barta-type: string
タイプBA (Business Accelerator) | R (レシピ) | TA (Technical Accelerator)
-
count-of-integrations: integer (int32)
統合数
-
integrations: array integrations
統合リスト
-
is-clone-allowed: boolean
クローンの許可を確認するフラグ
-
is-view-allowed: boolean
表示可能かどうかをチェックするフラグ
-
name: string
パッケージ名
-
type: string
パッケージ・タイプ
ネストされたスキーマ : IntegrationBaseResource-allOf[2]
型:
ソースを表示
object-
apipId: string
-
code: string
-
created: string (date-time)
-
createdBy: string
-
dependencies: object IntegrationDependencyRs
-
description: string
-
docUrl: string
-
endPointURI: string
-
eventSubscriptionFlag: boolean
-
filmstrip: array filmstrip
-
keywords: string
-
lastUpdated: string (date-time)
-
lastUpdatedBy: string
-
lockedBy: string
-
lockedDate: string (date-time)
-
lockedFlag: boolean
-
name: string
-
pattern: string
-
patternDescription: string
-
payloadTracingEnabledFlag: boolean
-
proxyWSDL: string
-
publishFlag: boolean
-
reactivationStatus: string
-
scheduleApplicable: boolean
-
scheduleDefined: boolean
-
smartTags: string
-
status: string
-
style: string
-
styleDescription: string
-
tempCopyExists: boolean
-
tracingEnabledFlag: boolean
-
version: string
-
warningMsg: string
400レスポンス
パラメータの形式が正しくありません
500レスポンス
サーバー・エラー
例
次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、パッケージの詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。 エンドポイントURLの構造の詳細は、「リクエストの送信」を参照してください。
例: すべてのパッケージの取得
curl -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/packages?integrationInstance=service-instance例: どのような場合でも、パッケージ名にmyPackを含むパッケージのみを取得
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={name: /myPack/}" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/packages?integrationInstance=service-instance例: 戻されるパッケージのページ番号付け
limitおよびoffsetでページ区切りが行われます。 この例では、パッケージを4番目のアイテムから順にリストします。 リストには16アイテムが含まれます。
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" -d "offset=3&limit=16" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/packages?integrationInstance=service-instance例: パラメータを組み合せて、文字列を含むパッケージを取得し、結果のページを区切ります
問合せパラメータを組み合せるには、qで--data-urlencodeオプションを使用します。 その他のパラメータは、-dオプションの後に追加できます。
この例では、myPackを大文字または小文字で含み、タイプがDEVELOPEDのパッケージを取得しています。
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={name: /myPack/, type:'DEVELOPED'}" -d "offset=3&limit=16" https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/packages?integrationInstance=service-instance