パッケージの取得
get
/ic/api/integration/v1/packages
最終更新時間でソートされたすべてのパッケージに関する情報を取得します。
リクエスト
サポートされているメディア・タイプ
- application/json; charset=utf-8
問合せパラメータ
- 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レスポンス
操作の成功
ネストされたスキーマ : IntegrationBaseResource
型:
ソースを表示
object- code: string
- dependencies: object IntegrationDependencyRs
- id: string
- links: array links
- lockedFlag: boolean
デフォルト値:
false - name: string
- pattern: string
- patternDescription: string
- scheduleApplicable: boolean
デフォルト値:
false - scheduleDefined: boolean
デフォルト値:
false - status: string
- style: string
- styleDescription: string
- version: string
400レスポンス
パラメータの形式が正しくありません
500レスポンス
サーバー・エラー
例
次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって、パッケージの詳細を取得する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。 エンドポイントURLの構造の詳細は、「リクエストの送信」を参照してください。
例: すべてのパッケージの取得
curl -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" https://integration.us.oraclecloud.com/ic/api/integration/v1/packages例: どのような場合でも、パッケージ名にmyPackを含むパッケージのみを取得
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" --data-urlencode "q={name: /myPack/}" https://integration.us.oraclecloud.com/ic/api/integration/v1/packages例: 戻されるパッケージのページ番号付け
limitおよびoffsetでページ区切りが行われます。 この例では、パッケージを4番目のアイテムから順にリストします。 リストには16アイテムが含まれます。
curl -G -X GET -H 'Authorization: Bearer access_token' -H "Accept:application/json" -d "offset=3&limit=16" https://integration.us.oraclecloud.com/ic/api/integration/v1/packages 例: パラメータを組み合せて、文字列を含むパッケージを取得し、結果のページを区切ります
問合せパラメータを組み合せるには、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://integration.us.oraclecloud.com/ic/api/integration/v1/packages