如果 Google Cloud 資料夾 API 作業因違反資料夾限制而失敗，API 會傳回 PreconditionFailure 錯誤，說明違反的情況。如果是同步作業，API 會在 Status.details 欄位中傳回 PreconditionFailure 錯誤。如果是非同步作業，錯誤會顯示在 Operation.error 欄位中。錯誤代碼
字串會顯示在 Status.details 中 PreconditionFailure.Violation
訊息的 type 欄位中。
| 狀態字串 | 說明 |
|---|---|
ERROR_TYPE_UNSPECIFIED |
無法辨別或未指定錯誤類型。 |
ACTIVE_FOLDER_HEIGHT_VIOLATION |
這個動作會導致資料夾的樹狀結構深度超出上限 4。 |
MAX_CHILD_FOLDERS_VIOLATION |
這麼做會超過子資料夾數量上限 (300 個)。 |
FOLDER_NAME_UNIQUENESS_VIOLATION |
這項操作會導致本機資料夾 display_name 限制不符。 |
RESOURCE_DELETED_VIOLATION |
要移動的資源已遭刪除。 |
PARENT_DELETED_VIOLATION |
要新增資料夾的資源已遭刪除。 |
CYCLE_INTRODUCED_VIOLATION |
這個動作會在資源路徑中建立循環。 |
FOLDER_BEING_MOVED_VIOLATION |
這麼做會移動已在移動中的資料夾。 |
FOLDER_TO_DELETE_NON_EMPTY_VIOLATION |
呼叫端嘗試刪除的資料夾含有使用中的資源，或與防火牆政策相關聯。 |
DELETED_FOLDER_HEIGHT_VIOLATION |
這個動作會違反已刪除資料夾深度上限，其中完整資料夾樹狀結構的深度最多為 8 層 (包含已刪除的資料夾)。 |