{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cloud Storage Retry and Completion Matrix"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cloud-storage-retry-and-completion-matrix","__idx":0},"children":["Cloud Storage Retry and Completion Matrix"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retry, idempotency, and completion policy for the 24 Cloud Storage operations. 12 of them document endpoint-specific business error codes."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For state-changing operations, an HTTP timeout is an unknown outcome—not proof that the operation failed. Query current state before retrying."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/endpoint-behavior"},"children":["Endpoint Retry Matrix"]}," for the policy definitions and the other products, or the machine-readable ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/operation-behavior.c7be57979902d535863b8d6a0eef0e3fb4768f96d388fa815ab123af6ce6038f.ec0bf2e0.yaml"},"children":["Operation Behavior Manifest"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cloud-storage-local-api","__idx":1},"children":["Cloud Storage Local API"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Retry policy"},"children":["Retry policy"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Idempotency"},"children":["Idempotency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Completion / recovery"},"children":["Completion / recovery"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/cloudstorage/info"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryCloudStorageInfoLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/file/page"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageCloudStorageFilesLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/upload/init"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batchRequestCloudStoragePresignedUploadUrlsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically unless endpoint-specific documentation says it is safe."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency guarantee is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upload each object to its presigned URL, then call POST /cloudstorage/upload/complete. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39037"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39044"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39045"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39047"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39050"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39051"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/upload/complete"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmCloudStorageUploadCompleteLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39014"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39041"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39046"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39047"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/file/delete/batch"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batchDeleteCloudStorageFilesLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/file/tag/set"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["setCloudStorageFileTagsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39048"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39049"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/file/tag/add"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addCloudStorageFileTagsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39048"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39049"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/file/tag/query"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryCloudStorageFileTagsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/cloudstorage/tag/all"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryAllCloudStorageFileTagsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/tag/create"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createCloudStorageFileTagLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/tag/edit"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editCloudStorageFileTagLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudstorage/tag/delete/batch"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleteCloudStorageFileTagsLocal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cloud-storage-open-api","__idx":2},"children":["Cloud Storage Open API"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operation"},"children":["Operation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Retry policy"},"children":["Retry policy"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Idempotency"},"children":["Idempotency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Completion / recovery"},"children":["Completion / recovery"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /cloudstorage/info"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryCloudStorageInfo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/file/page"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageCloudStorageFiles"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/upload/init"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batchRequestCloudStoragePresignedUploadUrls"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically unless endpoint-specific documentation says it is safe."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency guarantee is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upload each object to its presigned URL, then call POST /cloudstorage/upload/complete. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39037"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39044"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39045"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39047"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39050"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39051"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/upload/complete"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmCloudStorageUploadComplete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39001"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39014"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39041"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39046"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39047"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/file/delete/batch"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["batchDeleteCloudStorageFiles"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/file/tag/set"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["setCloudStorageFileTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39048"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39049"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/file/tag/add"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addCloudStorageFileTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Documented business errors: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39011"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39048"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["39049"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/file/tag/query"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryCloudStorageFileTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /cloudstorage/tag/all"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queryAllCloudStorageFileTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Safe with bounded exponential backoff and jitter."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read-only; repeated requests should not change resource state."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/tag/create"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createCloudStorageFileTag"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not retry automatically; first query whether the resource, upload, or task was created."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No public idempotency-key contract is documented."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/tag/edit"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["editCloudStorageFileTag"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudstorage/tag/delete/batch"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deleteCloudStorageFileTags"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query current state before retrying after a timeout or transport failure."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Outcome may already have been applied; repeated execution is not contractually idempotent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The response is the only documented completion signal; no asynchronous contract is specified. Endpoint-specific business errors are not documented; use the common error contract."]}]}]}]}]}]},"headings":[{"value":"Cloud Storage Retry and Completion Matrix","id":"cloud-storage-retry-and-completion-matrix","depth":1},{"value":"Cloud Storage Local API","id":"cloud-storage-local-api","depth":2},{"value":"Cloud Storage Open API","id":"cloud-storage-open-api","depth":2}],"frontmatter":{"seo":{"title":"Cloud Storage Retry and Completion Matrix"}},"lastModified":"2026-09-02T11:22:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/cloud-storage/endpoint-behavior","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}