Items - Update Mounted Data Factory Definition
指定したマウントされたデータ ファクトリの定義をオーバーライドします。
この API は、実行時間の長い操作 (LRO)をサポートします。
MountedDataFactory の定義を更新しても、その秘密度ラベルには影響しません。
権限
呼び出し元には、マウントされたデータ ファクトリの 読み取りと書き込みの アクセス許可が必要です。
必要な委任されたスコープ
MountedDataFactory.ReadWrite.All または Item.ReadWrite.All
Microsoft Entra でサポートされている ID
この API では、このセクションに記載されている Microsoft ID がサポートされています。
| アイデンティティ | 支援 |
|---|---|
| ユーザー | イエス |
| サービス プリンシパルとマネージド ID | イエス |
インターフェイス
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mountedDataFactories/{mountedDataFactoryId}/updateDefinition
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/mountedDataFactories/{mountedDataFactoryId}/updateDefinition?updateMetadata={updateMetadata}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
mounted
|
path | True |
string (uuid) |
MountedDataFactory ID。 |
|
workspace
|
path | True |
string (uuid) |
ワークスペース ID。 |
|
update
|
query |
boolean |
true に設定され、.platform ファイルが定義の一部として提供されると、.platform ファイル内のメタデータを使用して項目のメタデータが更新されます。 |
要求本文
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| definition | True |
MountedDataFactory パブリック定義オブジェクト。 MountedDataFactory パブリック定義を作成する方法の詳細については、この 記事 を参照してください。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は正常に完了しました。 |
|
| 202 Accepted |
要求は受け入れ済み。 更新の定義が進行中です。 ヘッダー
|
|
| Other Status Codes |
一般的なエラー コード:
|
例
Update a MountedDataFactory public definition example
要求のサンプル
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/mountedDataFactories/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True
{
"definition": {
"parts": [
{
"path": "mountedDataFactory-content.json",
"payload": "ewogICJkYXRhRmFjdG9yeVJlc291cmNlSWQiOiAiL3N1YnNjcmlwdGlvbnMvPHN1YnNjcmlwdGlvbklkPi9yZXNvdXJjZUdyb3Vwcy88cmVzb3VyY2VHcm91cD4vcHJvdmlkZXJzL01pY3Jvc29mdC5EYXRhRmFjdG9yeS9mYWN0b3JpZXMvPGZhY3RvcnlOYW1lPiIKfQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
応答のサンプル
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
定義
| 名前 | 説明 |
|---|---|
|
Error |
エラー関連のリソース詳細オブジェクト。 |
|
Error |
エラー応答。 |
|
Error |
エラー応答の詳細。 |
|
Mounted |
MountedDataFactory パブリック定義オブジェクト。 MountedDataFactory パブリック定義を作成する方法の詳細については、この 記事 を参照してください。 |
|
Mounted |
MountedDataFactory 定義パーツ オブジェクト。 |
|
Payload |
定義パーツペイロードの型。 追加のペイロードの種類は、時間の経過と同時に追加される場合があります。 |
|
Update |
MountedDataFactory パブリック定義要求ペイロードを更新します。 |
ErrorRelatedResource
エラー関連のリソース詳細オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| resourceId |
string |
エラーに関係するリソース ID。 |
| resourceType |
string |
エラーに関係するリソースの種類。 |
ErrorResponse
エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| moreDetails |
その他のエラーの詳細の一覧。 |
|
| relatedResource |
エラー関連のリソースの詳細。 |
|
| requestId |
string |
エラーに関連付けられている要求の ID。 |
ErrorResponseDetails
エラー応答の詳細。
| 名前 | 型 | 説明 |
|---|---|---|
| errorCode |
string |
エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。 |
| message |
string |
エラーの人間が判読できる表現。 |
| relatedResource |
エラー関連のリソースの詳細。 |
MountedDataFactoryDefinition
MountedDataFactory パブリック定義オブジェクト。 MountedDataFactory パブリック定義を作成する方法の詳細については、この 記事 を参照してください。
| 名前 | 型 | 説明 |
|---|---|---|
| format |
string |
項目定義の形式。 サポートされている形式: |
| parts |
定義パーツの一覧。 |
MountedDataFactoryDefinitionPart
MountedDataFactory 定義パーツ オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| path |
string |
MountedDataFactory パブリック定義パーツパス。 |
| payload |
string |
MountedDataFactory パブリック定義パーツペイロード。 |
| payloadType |
ペイロードの種類。 |
PayloadType
定義パーツペイロードの型。 追加のペイロードの種類は、時間の経過と同時に追加される場合があります。
| 値 | 説明 |
|---|---|
| InlineBase64 |
インライン ベース 64。 |
UpdateMountedDataFactoryDefinitionRequest
MountedDataFactory パブリック定義要求ペイロードを更新します。
| 名前 | 型 | 説明 |
|---|---|---|
| definition |
MountedDataFactory パブリック定義オブジェクト。 MountedDataFactory パブリック定義を作成する方法の詳細については、この 記事 を参照してください。 |