{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/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":"/zh/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":"/zh/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":"/zh/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":"/zh/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":"/zh/api-reference/getting-started/endpoint-behavior","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}