{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Матрица повторов и завершения операций"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"матрица-повторов-и-завершения-операций","__idx":0},"children":["Матрица повторов и завершения операций"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["У каждой из 212 задокументированных операций есть политика повторов, идемпотентности и завершения. Политики выводятся из контракта OpenAPI консервативно. Бизнес-коды ошибок, специфичные для эндпоинта, перечисляются только там, где они задокументированы в описании операции, и никогда не придумываются. К любой операции дополнительно применяется общий контракт ошибок."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Для операций, меняющих состояние, тайм-аут HTTP означает неизвестный результат, а не доказательство неудачи. Прежде чем повторять, запросите текущее состояние."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Машиночитаемый источник — ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/operation-behavior.c7be57979902d535863b8d6a0eef0e3fb4768f96d388fa815ab123af6ce6038f.ec0bf2e0.yaml"},"children":["Манифест поведения операций"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"матрицы-по-продуктам","__idx":1},"children":["Матрицы по продуктам"]},{"$$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":"Продукт"},"children":["Продукт"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Операций"},"children":["Операций"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"С кодами, специфичными для эндпоинта"},"children":["С кодами, специфичными для эндпоинта"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Матрица"},"children":["Матрица"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Browser"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["53"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["19"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/api-reference/browser/endpoint-behavior"},"children":["Browser"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cloud Phone"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["109"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["50"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/api-reference/cloud-phone/endpoint-behavior"},"children":["Cloud Phone"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cloud Storage"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["24"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["12"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/api-reference/cloud-storage/endpoint-behavior"},"children":["Cloud Storage"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shared Resources"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["26"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["12"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/api-reference/shared-resources/endpoint-behavior"},"children":["Shared Resources"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"как-читать-политику","__idx":2},"children":["Как читать политику"]},{"$$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":"Политика"},"children":["Политика"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Смысл"},"children":["Смысл"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Безопасно с ограниченной экспоненциальной задержкой и дрожанием."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Операция только для чтения. Её повторение не меняет состояние ресурса."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["После тайм-аута или сбоя передачи запросите текущее состояние перед повтором."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Операция могла уже примениться. Прочитайте ресурс перед повторной отправкой."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Не повторяйте автоматически; сначала выясните, был ли создан ресурс, загрузка или задача."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Операция что-то создаёт и не имеет ключа идемпотентности, поэтому слепой повтор может продублировать результат."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Не повторяйте автоматически, если документация эндпоинта не говорит, что это безопасно."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Контракт не даёт достаточно данных для классификации. Считайте операцию небезопасной."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Покрытие генерации: 212 операций; 93 имеют задокументированные бизнес-коды, специфичные для эндпоинта, а 119 сейчас опираются на общий контракт ошибок."]}]}]},"headings":[{"value":"Матрица повторов и завершения операций","id":"матрица-повторов-и-завершения-операций","depth":1},{"value":"Матрицы по продуктам","id":"матрицы-по-продуктам","depth":2},{"value":"Как читать политику","id":"как-читать-политику","depth":2}],"frontmatter":{"seo":{"title":"Матрица повторов и завершения операций"}},"lastModified":"2026-09-05T06:38:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/api-reference/getting-started/endpoint-behavior","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}