Items - Update Notebook Definition

サービス:: Notebook

API バージョン:: v1

指定したノートブックの定義をオーバーライドします。
この API は、実行時間の長い操作 (LRO)をサポートします。

ノートブックの定義を更新しても、その秘密度ラベルには影響しません。

権限

呼び出し元には、ノートブックの 読み取りと書き込みの アクセス許可が必要です。

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

Notebook.ReadWrite.All または Item.ReadWrite.All

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

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

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

インターフェイス

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks/{notebookId}/updateDefinition

省略可能なパラメーターを含む:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks/{notebookId}/updateDefinition?updateMetadata={updateMetadata}

URI パラメーター

名前	/	必須	型	説明
notebookId	path	True	string (uuid)	ノートブック ID。
workspaceId	path	True	string (uuid)	ワークスペース ID。
updateMetadata	query		boolean	true に設定され、.platform ファイルが定義の一部として提供されると、.platform ファイル内のメタデータを使用して項目のメタデータが更新されます。

要求本文

名前	必須	型	説明
definition	True	NotebookDefinition	ノートブックのパブリック定義オブジェクト。ノートブックのパブリック定義を作成する方法の詳細については、この記事を参照してください。

応答

名前	型	説明
200 OK		要求は正常に完了しました。
202 Accepted		要求は受け入れ済み。更新の定義が進行中です。ヘッダー Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラーコード: OperationNotSupportedForItem - 要求された項目に対する操作はサポートされていません。 CorruptedPayload - 指定されたペイロードが破損しています。

名前

型

説明

200 OK

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

202 Accepted

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

ヘッダー

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

一般的なエラーコード:

OperationNotSupportedForItem - 要求された項目に対する操作はサポートされていません。
CorruptedPayload - 指定されたペイロードが破損しています。

例

Update a notebook definition in fabricGitSource format example

Update a notebook definition in ipynb format example

Update a notebook definition in fabricGitSource format example

要求のサンプル

HTTP

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

{
  "definition": {
    "parts": [
      {
        "path": "notebook-content.py",
        "payload": "IyBGYWJyaWMgbm90ZWJv...",
        "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

Update a notebook definition in ipynb format example

要求のサンプル

HTTP

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

{
  "definition": {
    "format": "ipynb",
    "parts": [
      {
        "path": "notebook-content.ipynb",
        "payload": "IyBGYWJyaWMgbm90ZWJv...",
        "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

定義

名前	説明
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
NotebookDefinition	ノートブックのパブリック定義オブジェクト。ノートブックのパブリック定義を作成する方法の詳細については、この記事を参照してください。
NotebookDefinitionPart	ノートブック定義パーツオブジェクト。
PayloadType	定義パーツペイロードの型。追加のペイロードの種類は、時間の経過と同時に追加される場合があります。
UpdateNotebookDefinitionRequest	ノートブックのパブリック定義要求ペイロードを更新します。

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	エラー関連のリソースの詳細。

NotebookDefinition

Object

ノートブックのパブリック定義オブジェクト。ノートブックのパブリック定義を作成する方法の詳細については、この記事を参照してください。

名前	型	説明
format	string	ノートブック定義の形式。サポートされている形式: `ipynb` と `fabricGitSource`。形式が指定されていない場合は、 `fabricGitSource` が使用されます。
parts	NotebookDefinitionPart[]	定義パーツの一覧。

NotebookDefinitionPart

Object

ノートブック定義パーツオブジェクト。

名前	型	説明
path	string	ノートブックパーツのパス。サポートされているノートブックコンテンツ拡張機能: `.ipynb`形式の`ipynb`、`.py`、`.scala`、`.r`、`.sql`形式の`fabricGitSource`。
payload	string	ノートブックパーツのペイロード。
payloadType	PayloadType	ペイロードの型。

PayloadType

列挙

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

値	説明
InlineBase64	インラインベース 64。

UpdateNotebookDefinitionRequest

Object

ノートブックのパブリック定義要求ペイロードを更新します。

名前	型	説明
definition	NotebookDefinition	ノートブックのパブリック定義オブジェクト。ノートブックのパブリック定義を作成する方法の詳細については、この記事を参照してください。

次の方法で共有

Items - Update Notebook Definition

権限

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

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

インターフェイス

URI パラメーター

要求本文

応答

例

Update a notebook definition in fabricGitSource format example

要求のサンプル

応答のサンプル

Update a notebook definition in ipynb format example

要求のサンプル

応答のサンプル

定義

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

NotebookDefinition

NotebookDefinitionPart

PayloadType

UpdateNotebookDefinitionRequest