Кожна з 212 задокументованих операцій має політику повторів, ідемпотентності та завершення. Політики виводяться з контракту OpenAPI консервативно. Бізнес-коди помилок, специфічні для ендпоінта, перелічуються лише там, де вони задокументовані в описі операції, і ніколи не вигадуються. До будь-якої операції додатково застосовується загальний контракт помилок.
Для операцій, що змінюють стан, тайм-аут HTTP означає невідомий результат, а не доказ невдачі. Перед повтором запитайте поточний стан.
Машинно-читне джерело — Маніфест поведінки операцій.
| Продукт | Операцій | З кодами, специфічними для ендпоінта | Матриця |
|---|---|---|---|
| Browser | 53 | 19 | Browser |
| Cloud Phone | 109 | 50 | Cloud Phone |
| Cloud Storage | 24 | 12 | Cloud Storage |
| Shared Resources | 26 | 12 | Shared Resources |
| Політика | Сенс |
|---|---|
| Безпечно з обмеженою експоненційною затримкою та дрижанням. | Операція лише для читання. Її повторення не змінює стан ресурсу. |
| Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Операція могла вже застосуватися. Прочитайте ресурс перед повторним надсиланням. |
| Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Операція щось створює і не має ключа ідемпотентності, тому сліпий повтор може продублювати результат. |
| Не повторюйте автоматично, якщо документація ендпоінта не каже, що це безпечно. | Контракт не дає достатньо даних для класифікації. Вважайте операцію небезпечною. |
Покриття генерації: 212 операцій; 93 мають задокументовані бізнес-коди, специфічні для ендпоінта, а 119 зараз опираються на загальний контракт помилок.