次の方法で共有

Items - Update Data Pipeline Definition

サービス:
DataPipeline
API バージョン:
v1

指定したデータ パイプラインの定義をオーバーライドします。
この API は、実行時間の長い操作 (LRO)をサポートします。

DataPipeline の定義を更新しても、その秘密度ラベルには影響しません。

権限

呼び出し元には、データ パイプラインの 読み取りと書き込みの アクセス許可が必要です。

必要な委任されたスコープ

DataPipeline.ReadWrite.All または Item.ReadWrite.All

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

アイデンティティ 支援
ユーザー イエス
サービス プリンシパルとマネージド ID イエス

インターフェイス

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataPipelines/{dataPipelineId}/updateDefinition
省略可能なパラメーターを含む: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataPipelines/{dataPipelineId}/updateDefinition?updateMetadata={updateMetadata}

URI パラメーター

名前 / 必須 型 説明
dataPipelineId
 path True

string (uuid)

データ パイプライン ID。
workspaceId
 path True

string (uuid)

ワークスペース ID。
updateMetadata
 query

boolean

true に設定され、.platform ファイルが定義の一部として提供されると、.platform ファイル内のメタデータを使用して項目のメタデータが更新されます。

要求本文

名前 必須 型 説明
definition True

DataPipelineDefinition

データ パイプラインのパブリック定義オブジェクト。

応答

名前 型 説明
200 OK

要求は正常に完了しました。
202 Accepted

要求は受け入れ済み。 更新の定義が進行中です。

ヘッダー

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

一般的なエラー コード:

  • OperationNotSupportedForItem - 要求された項目に対する操作はサポートされていません。

  • CorruptedPayload - 指定されたペイロードが破損しています。

例

Update a data pipeline public definition example

要求のサンプル

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/dataPipelines/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "pipeline-content.json",
        "payload": "ewogICJwcm9wZXJ0aWVzIjogewogICAgImFjdGl2aXRpZXMiOiBbCiAgICAgIHsKICAgICAgICAibmFtZSI6ICJXYWl0MSIsCiAgICAgICAgInR5cGUiOiAiV2FpdCIsCiAgICAgICAgImRlcGVuZHNPbiI6IFtdLAogICAgICAgICJ0eXBlUHJvcGVydGllcyI6IHsKICAgICAgICAgICJ3YWl0VGltZUluU2Vjb25kcyI6IDEKICAgICAgICB9CiAgICAgIH0KICAgIF0KICB9Cn0=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

応答のサンプル

状態コード:
200
状態コード:
202 
Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

定義

名前 説明
DataPipelineDefinition

データ パイプラインのパブリック定義オブジェクト。
DataPipelineDefinitionPart

データ パイプライン定義パーツ オブジェクト。
ErrorRelatedResource

エラー関連のリソース詳細オブジェクト。
ErrorResponse

エラー応答。
ErrorResponseDetails

エラー応答の詳細。
PayloadType

定義パーツペイロードの型。 追加のペイロードの種類は、時間の経過と同時に追加される場合があります。
UpdateDataPipelineDefinitionRequest

データ パイプラインのパブリック定義要求ペイロードを更新します。

DataPipelineDefinition

Object

データ パイプラインのパブリック定義オブジェクト。

名前 型 説明
format

string

項目定義の形式。
parts

DataPipelineDefinitionPart[]

定義パーツの一覧。

DataPipelineDefinitionPart

Object

データ パイプライン定義パーツ オブジェクト。

名前 型 説明
path

string

データ パイプライン パーツのパス。
payload

string

データ パイプライン パーツのペイロード。
payloadType

PayloadType

ペイロードの種類。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

名前 型 説明
resourceId

string

エラーに関係するリソース ID。
resourceType

string

エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message

string

エラーの人間が判読できる表現。
moreDetails

ErrorResponseDetails[]

その他のエラーの詳細の一覧。
relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。
requestId

string

エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message

string

エラーの人間が判読できる表現。
relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。

PayloadType

列挙

定義パーツペイロードの型。 追加のペイロードの種類は、時間の経過と同時に追加される場合があります。

値 説明
InlineBase64

インライン ベース 64。

UpdateDataPipelineDefinitionRequest

Object

データ パイプラインのパブリック定義要求ペイロードを更新します。

名前 型 説明
definition

DataPipelineDefinition

データ パイプラインのパブリック定義オブジェクト。