在為資源屬性或Server & Workload Security保護設定值時,您應該注意幾件事情。
如何表示空值
要使用 API 表達
null
值,請使用 0
(零)。例如,當您使用 0
作為電腦防護的 policyID 時,它會被解釋為 null
,表示該電腦防護沒有分配的政策。請注意,這適用於直接使用 API 的情況。客戶端庫支援使用空值。
布林屬性的有效值
當您使用 API 時,必須使用
true
或 false
作為布林屬性的值。任何其他值都會返回錯誤。如果您不提供值(即 null),
false
是預設值。在修改資源時僅包含更改的值
當您使用操作來修改資源時,您只需提供需要更改的屬性。例如,要更改政策的名稱,您提供一個具有名稱屬性的政策對象,所有其他屬性為空或未指定。這種模式對於 REST API
是典型的。
當使用 Python、JavaScript 或 Java 等程式語言時,您可能習慣於獲取表示資源的物件、更改屬性,然後在更新調用中返回該物件。然而,當使用 Server & Workload Security保護 客戶端庫時,您需要創建一個物件,只設置您想要更改的值,然後在更新調用中使用該物件。在此範例中,僅更改了策略名稱:
policy = api.Policy() policy.name = policy_name policy_api = api.PoliciesApi() policy_api.modifyPolicy(policyID, policy, false, "v1")