パッチのリストの取得

このAPIを使用して、パッチのリストを取得します。

API

/cemli/v1/customers/{supportIdentifier}/services/{serviceType}/products/patches

スコープおよび認可

  • このAPIにアクセスするには、mcs:oci:api:Userスコープが必要です。
  • 顧客についてのみCEMLIパッチのリストを取得できます。
  • 顧客がCEMLI機能をオプトインしている場合のみ、CEMLIパッチAPIを使用できます。

ヘッダー

  • Authorization: Bearer <Token>

    <Token>は、認可サーバーによって返されるOAUTHトークン(JWTトークン)です。

  • Identifier: <JWKS Identifier>

    <JWKS Identifier>は、セルフサービス・プラットフォームでJWKS URIが顧客管理者によって設定されたときに生成されるGUIDです。

ベース・パス

/cemli/v1/

依存関係

機能

  • パッチのリストを取得します。
  • supportIdentifierは、ユーザーのすべてのCSIの取得の値の1つです。
  • serviceTypeは、特定のsupportIdentifierに対するCSIの構成の取得からの関連するtypeCode値です。
  • patchIdは、パッチの一意の識別子です。
  • nameは、パッチの名前です。
  • patchNumberは、バックエンドに格納されているパッチ番号です。
  • descriptionはパッチの説明です。
  • createdByは、パッチを作成したユーザーの電子メールIDです。
  • createdOnは、パッチが作成されたタイムスタンプです。
  • products.nameは、製品の名前です。
  • products.files.fileIdはファイルの一意の識別子で、ファイル詳細のフェッチに使用されます。
  • products.files.filenameは、ファイルの名前です。
  • products.files.descriptionは、指定されたファイルの説明です。
  • products.files.versionは、指定されたファイルのバージョン番号です。
  • products.files.fileTypeは、SQL、Java、XMLパブリッシャXLFファイルなどのファイルのタイプです。

動詞

GET

パラメータ

名前 タイプ 説明 必須 コメント
serviceType パス・パラメータ サービス・タイプ はい
supportIdentifier パス・パラメータ 顧客CSI はい
name 問合せパラメータ いいえ

渡された場合、このパラメータは、descriptionpatchFileName

includeContentおよびincludeDeletedPatchesなどの他のオプション・パラメータとともにAND条件で使用されます。

description 問合せパラメータ いいえ 渡された場合、このパラメータは、namepatchFileNameincludeContentincludeDeletedPatchesなどの他のオプション・パラメータとともにAND条件で使用されます。
patchFileName 問合せパラメータ いいえ 渡された場合、このパラメータは、namedescriptionincludeContentincludeDeletedPatchesなどの他のオプション・パラメータとともにAND条件で使用されます。
includeDetails 問合せパラメータ いいえ 渡された場合、有効な値(TRUEまたはFALSE)で製品詳細を返すか返さないかが示されます。
includeContent 問合せパラメータ いいえ 渡された場合、有効な値(TRUEまたはFALSE)で、PatchFileコンテンツをBase64値として返すか返さないかが示されます。
includeDeletedPatches 問合せパラメータ いいえ 渡された場合、このパラメータは、namedescriptionincludeContentincludeDeletedPatchesなどの他のオプション・パラメータとともにAND条件で使用されます。trueの場合、削除されたパッチがAPIによって返されます。
createdBy 問合せパラメータ いいえ 渡された場合、このパラメータは、namedescriptionpatchFileNameincludeDeletedPatchesなどの他のオプション・パラメータとともにAND条件で使用されます。
createdOn 問合せパラメータ いいえ 渡された場合、このパラメータは、namedescriptionpatchFileNameincludeContentなどの他のオプション・パラメータとともにAND条件で使用されます。
q 問合せパラメータ いいえ 渡された場合、namedescriptionpatchFileNameincludeContentincludeDeletedPatchesなどの他のオプション・パラメータがオーバーライドされ、ここで渡された値に基づいて検索が実行されます。一致は、バックエンドでnamedescriptionpatchFileNameincludeDetailsincludeContentおよびincludeDeletedPatchesにリストされているすべての検索フィールドに対してOR条件で行われます。
patchNumber 問合せパラメータ いいえ 1つ以上のパッチ番号を問合せパラメータとして渡すことができます(<URL>?patchNumber= 10000001923&patchNumber =10000001927&patchNumber =10000001922)
ノート

ページ区切りがサポートされています。詳細は、ページ区切りの項を参照してください。

サンプル・レスポンス

[
  {
    "patchId": 7386,
    "name": "MyManufacturingPatch",
    "patchNumber": 10000002386,
    "patchFileName": "p10000002386_US_R12_cmli.zip",
    "description": "Patch for the myManufacturing module",
    "createdBy": "<user's email ID>",
    "createdOn": "2020-08-26T10:53:51-07:00",
    "products": [
      {
        "name": "xbol",
        "files": [
          {
            "fileId": 10882,
            "fileName": "XxExpenseReportLineEO.xml",
            "description": "CEMLI XML XLF Patch File",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "first",
            "sequence": 1
          },
          {
            "fileId": 10886,
            "fileName": "XMLP_PUB_XLF_TILE.xmlp_xlf",
            "description": "CEMLI XML XLF Patch File Upload",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "last",
            "sequence": 2
          }
        ]
      },
      {
        "name": "xxeis",
        "files": [
          {
            "fileId": 10980,
            "fileName": "APXCCPUT_XML.xlf",
            "description": "CEMLI XML XLF",
            "version": "121.000001",
            "language": "US",
            "fileType": "xmlp_xlf",
            "phase": "first",
            "sequence": 5
          }
        ]
      }
    ]
  }
]