BatchResult 類別

執行批次請求的結果。

每個提交的 HTTP 操作都會包含一個。BatchItemResponse 擴展為多個 HTTP 請求的操作(例如 add_columns 三欄)會貢獻三個條目。

範例:


   result = client.batch.new().execute()
   print(f"Succeeded: {len(result.succeeded)}, Failed: {len(result.failed)}")
   for guid in result.entity_ids:
       print(f"[OK] entity_id: {guid}")

建構函式

BatchResult(responses: ~typing.List[~PowerPlatform.Dataverse.models.batch.BatchItemResponse] = <factory>)

參數

名稱 Description
responses

所有回應依提交順序排列。

預設值: <factory>

屬性

entity_ids

OData-EntityId 成功回應的標頭中擷取的 GUID。

回傳任何成功(2xx)回應且包含 OData-EntityId 標頭的實體ID。 個別 POST 的(建立)與 PATCH (更新)操作都會回傳這個帶有記錄 GUID 的標頭。 GETDELETE 營運則不會。

Note

CreateMultiple 與 UpsertMultiple 動作回應則不具備

每筆記錄回傳 OData-EntityId 標頭。 他們的身分證在

JSON 回應主體(data[「Ids」))。 透過以下方式存取:

對於 resp 在 result.succeeded:

if resp.data and "Ids" in resp.data:

    bulk_ids = resp.data["Ids"]

failed

回覆中狀態碼非2xx。

has_errors

當任何回應的狀態碼非 2xx 時,這才是真的。

succeeded

回覆時有2xx個狀態碼。

responses

responses: List[BatchItemResponse]