Політика повторів, ідемпотентності та завершення для 24 операцій Cloud Storage. З них 12 документують бізнес-коди помилок, специфічні для ендпоінта.
Для операцій, що змінюють стан, тайм-аут HTTP означає невідомий результат, а не доказ невдачі. Перед повтором запитайте поточний стан.
Визначення політик та інші продукти див. у Матриці повторів ендпоінтів, машинно-читну версію — у Маніфесті поведінки операцій.
| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|---|---|---|---|
GET /api/cloudstorage/infoqueryCloudStorageInfoLocal | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39001. |
POST /api/cloudstorage/file/pagepageCloudStorageFilesLocal | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/cloudstorage/upload/initbatchRequestCloudStoragePresignedUploadUrlsLocal | Не повторюйте автоматично, якщо документація ендпоінта не каже, що це безпечно. | Публічних гарантій ідемпотентності не задокументовано. | Завантажте кожен об'єкт за його попередньо підписаним URL, потім викличте POST /cloudstorage/upload/complete. Задокументовані бізнес-помилки: 39001, 39037, 39044, 39045, 39047, 39050, 39051. |
POST /api/cloudstorage/upload/completeconfirmCloudStorageUploadCompleteLocal | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39001, 39011, 39014, 39041, 39046, 39047. |
POST /api/cloudstorage/file/delete/batchbatchDeleteCloudStorageFilesLocal | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011. |
POST /api/cloudstorage/file/tag/setsetCloudStorageFileTagsLocal | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011, 39048, 39049. |
POST /api/cloudstorage/file/tag/addaddCloudStorageFileTagsLocal | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011, 39048, 39049. |
POST /api/cloudstorage/file/tag/queryqueryCloudStorageFileTagsLocal | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
GET /api/cloudstorage/tag/allqueryAllCloudStorageFileTagsLocal | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/cloudstorage/tag/createcreateCloudStorageFileTagLocal | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/cloudstorage/tag/editeditCloudStorageFileTagLocal | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /api/cloudstorage/tag/delete/batchdeleteCloudStorageFileTagsLocal | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
| Операція | Політика повторів | Ідемпотентність | Завершення / відновлення |
|---|---|---|---|
GET /cloudstorage/infoqueryCloudStorageInfo | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39001. |
POST /cloudstorage/file/pagepageCloudStorageFiles | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /cloudstorage/upload/initbatchRequestCloudStoragePresignedUploadUrls | Не повторюйте автоматично, якщо документація ендпоінта не каже, що це безпечно. | Публічних гарантій ідемпотентності не задокументовано. | Завантажте кожен об'єкт за його попередньо підписаним URL, потім викличте POST /cloudstorage/upload/complete. Задокументовані бізнес-помилки: 39001, 39037, 39044, 39045, 39047, 39050, 39051. |
POST /cloudstorage/upload/completeconfirmCloudStorageUploadComplete | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39001, 39011, 39014, 39041, 39046, 39047. |
POST /cloudstorage/file/delete/batchbatchDeleteCloudStorageFiles | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011. |
POST /cloudstorage/file/tag/setsetCloudStorageFileTags | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011, 39048, 39049. |
POST /cloudstorage/file/tag/addaddCloudStorageFileTags | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Задокументовані бізнес-помилки: 39011, 39048, 39049. |
POST /cloudstorage/file/tag/queryqueryCloudStorageFileTags | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
GET /cloudstorage/tag/allqueryAllCloudStorageFileTags | Безпечно з обмеженою експоненційною затримкою та дрижанням. | Лише читання; повторні запити не повинні змінювати стан ресурсу. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /cloudstorage/tag/createcreateCloudStorageFileTag | Не повторюйте автоматично; спершу з'ясуйте, чи був створений ресурс, завантаження або задача. | Публічний контракт ключа ідемпотентності не задокументований. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /cloudstorage/tag/editeditCloudStorageFileTag | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |
POST /cloudstorage/tag/delete/batchdeleteCloudStorageFileTags | Після тайм-ауту або збою передавання запитайте поточний стан перед повтором. | Результат міг уже застосуватися; повторне виконання не ідемпотентне за контрактом. | Відповідь — єдиний задокументований сигнал завершення; асинхронний контракт не визначено. Бізнес-помилки, специфічні для ендпоінта, не задокументовані; використовуйте загальний контракт помилок. |