Saltar al contenido

Matriz de reintentos y finalización de endpoints

Cada una de las 233 operaciones documentadas tiene una política de reintento, idempotencia y finalización. Las políticas se generan de forma conservadora a partir del contrato OpenAPI. Los códigos de error de negocio específicos del endpoint solo se listan cuando la descripción de la operación los documenta; nunca se inventan. Toda operación usa además el contrato de errores comunes.

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.

La fuente legible por máquina es el Manifiesto de comportamiento de operaciones.

Matrices por producto

ProductoOperacionesCon códigos de error específicosMatriz
Browser5319Browser
Cloud Phone13071Cloud Phone
Cloud Storage2412Cloud Storage
Shared Resources2612Shared Resources

Cómo leer una política

PolíticaSignificado
Seguro con retroceso exponencial acotado y jitter.Operación de solo lectura. Repetirla no cambia el estado del recurso.
Consulta el estado actual antes de reintentar tras un tiempo de espera o un fallo de transporte.La operación puede haberse aplicado ya. Lee el recurso antes de volver a enviarla.
No reintentes automáticamente; consulta primero si el recurso, la subida o la tarea se creó.La operación crea algo y no tiene clave de idempotencia, así que un reintento a ciegas puede duplicarlo.
No reintentes automáticamente a menos que la documentación específica del endpoint diga que es seguro.El contrato no dice lo suficiente para clasificar la operación. Trátala como insegura.

Cobertura generada: 233 operaciones; 114 tienen códigos de negocio documentados específicos del endpoint y 119 dependen actualmente del contrato de errores comunes.