全部產品
Search
文件中心

Alibaba Cloud Model Studio:DeleteChunk - 刪除切片

更新時間:Apr 04, 2026

刪除知識庫中的指定文本切片,被刪的文本切片將無法被檢索和召回。

介面說明

警告 文本切片被刪除後無法恢複(硬刪除),請謹慎操作。

  • 許可權要求
    • RAM 使用者(子帳號):需先擷取阿里雲百鍊的 API 許可權(可使用AliyunBailianDataFullAccess策略,該策略已包含本介面所需的 sfm:DeleteChunk 許可權點),並加入一個業務空間後,才能調用本介面。
    • 阿里雲帳號(主帳號):預設擁有許可權,可直接調用。
  • 調用方式:推薦使用最新版阿里雲百鍊 SDK調用,SDK 已封裝複雜的簽名計算邏輯,可簡化您的調用過程。
  • 生效延遲:更新後通常立即生效,高峰期可能稍有延遲(秒級)。
  • 等冪性:本介面具有等冪性。對已成功刪除的文本切片進行重複操作時,介面將返回成功響應。

限流說明: 本介面頻繁調用會被限流,頻率請勿超過 10 次/秒。如遇限流,請稍後重試。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。
  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:
    • 對於必選的資源類型,用前面加 * 表示。
    • 對於不支援資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。
操作存取層級資源類型條件關鍵字關聯操作
sfm:DeleteChunkdelete
*全部資源
*

請求文法

POST /{WorkspaceId}/chunk/delete HTTP/1.1

請求參數

名稱類型必填描述樣本值
PipelineIdstring

知識庫 ID,即 CreateIndex 介面返回的Data.Id

79c0alxxxx
WorkspaceIdstring

知識庫所屬的業務空間 ID。擷取方式請參見如何使用業務空間

llm-3z7uw7fwz0vexxxx
ChunkIdsarray

需要刪除的文本切片列表(單次最多傳入 10 個文本切片 ID)。

string

文本切片 ID,即 ListChunks 介面返回的 Node 對象裡Metadata中的_id欄位。

llm-5ip55o1zrzxx_09fe52x_xxxxx_033b551e10024029992e79767b151fxx_10024xx_0

返回參數

名稱類型描述樣本值
object

Schema of Response

RequestIdstring

請求 ID。

35A267BF-xxxx-54DB-8394-AA3B0742D833
Codestring

錯誤狀態代碼。

Messagestring

錯誤資訊。

Successboolean

介面調用是否成功,可能值:

  • true:成功。
  • false:失敗。
true
Databoolean

請求成功返回的業務資料。

true
Statusstring

介面返回的狀態代碼。

200

樣本

正常返回樣本

JSON格式

{
  "RequestId": "35A267BF-xxxx-54DB-8394-AA3B0742D833\n",
  "Code": "",
  "Message": "",
  "Success": true,
  "Data": true,
  "Status": 200
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。