Política de reintento, idempotencia y finalización de las 24 operaciones de Cloud Storage. 12 de ellas documentan códigos de error de negocio específicos del endpoint.
En operaciones que cambian el estado, un tiempo de espera HTTP es un resultado desconocido, no una prueba de que la operación falló. Consulta el estado actual antes de reintentar.
Consulta la Matriz de reintentos de endpoints para las definiciones de política y los demás productos, o el Manifiesto de comportamiento de operaciones legible por máquina.
| Operación | Política de reintento | Idempotencia | Finalización / recuperación |
|---|---|---|---|
GET /api/cloudstorage/infoqueryCloudStorageInfoLocal | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39001. |
POST /api/cloudstorage/file/pagepageCloudStorageFilesLocal | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /api/cloudstorage/upload/initbatchRequestCloudStoragePresignedUploadUrlsLocal | No reintentes automáticamente a menos que la documentación específica del endpoint diga que es seguro. | No hay ninguna garantía pública de idempotencia documentada. | Sube cada objeto a su URL prefirmada y luego llama a POST /cloudstorage/upload/complete. Errores de negocio documentados: 39001, 39037, 39044, 39045, 39047, 39050, 39051. |
POST /api/cloudstorage/upload/completeconfirmCloudStorageUploadCompleteLocal | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39001, 39011, 39014, 39041, 39046, 39047. |
POST /api/cloudstorage/file/delete/batchbatchDeleteCloudStorageFilesLocal | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011. |
POST /api/cloudstorage/file/tag/setsetCloudStorageFileTagsLocal | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011, 39048, 39049. |
POST /api/cloudstorage/file/tag/addaddCloudStorageFileTagsLocal | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011, 39048, 39049. |
POST /api/cloudstorage/file/tag/queryqueryCloudStorageFileTagsLocal | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
GET /api/cloudstorage/tag/allqueryAllCloudStorageFileTagsLocal | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /api/cloudstorage/tag/createcreateCloudStorageFileTagLocal | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /api/cloudstorage/tag/editeditCloudStorageFileTagLocal | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /api/cloudstorage/tag/delete/batchdeleteCloudStorageFileTagsLocal | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
| Operación | Política de reintento | Idempotencia | Finalización / recuperación |
|---|---|---|---|
GET /cloudstorage/infoqueryCloudStorageInfo | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39001. |
POST /cloudstorage/file/pagepageCloudStorageFiles | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /cloudstorage/upload/initbatchRequestCloudStoragePresignedUploadUrls | No reintentes automáticamente a menos que la documentación específica del endpoint diga que es seguro. | No hay ninguna garantía pública de idempotencia documentada. | Sube cada objeto a su URL prefirmada y luego llama a POST /cloudstorage/upload/complete. Errores de negocio documentados: 39001, 39037, 39044, 39045, 39047, 39050, 39051. |
POST /cloudstorage/upload/completeconfirmCloudStorageUploadComplete | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39001, 39011, 39014, 39041, 39046, 39047. |
POST /cloudstorage/file/delete/batchbatchDeleteCloudStorageFiles | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011. |
POST /cloudstorage/file/tag/setsetCloudStorageFileTags | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011, 39048, 39049. |
POST /cloudstorage/file/tag/addaddCloudStorageFileTags | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. Errores de negocio documentados: 39011, 39048, 39049. |
POST /cloudstorage/file/tag/queryqueryCloudStorageFileTags | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
GET /cloudstorage/tag/allqueryAllCloudStorageFileTags | Seguro con retroceso exponencial acotado y jitter. | Solo lectura; repetir la petición no debería cambiar el estado del recurso. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /cloudstorage/tag/createcreateCloudStorageFileTag | No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó. | No hay ningún contrato público de clave de idempotencia documentado. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /cloudstorage/tag/editeditCloudStorageFileTag | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |
POST /cloudstorage/tag/delete/batchdeleteCloudStorageFileTags | Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte. | El resultado puede haberse aplicado ya; la ejecución repetida no es idempotente por contrato. | La respuesta es la única señal de finalización documentada; no se especifica ningún contrato asíncrono. No hay errores de negocio específicos del endpoint documentados; usa el contrato de errores comunes. |