并发控制

注意

云合作伙伴门户 API 已与合作伙伴中心集成，并将继续在其中工作。 本次转换引入的变更很少。 请查阅云合作伙伴门户 API 参考中列出的更改，以确保代码在转换到合作伙伴中心后能够继续正常运行。 CPP API 应仅用于在转换到合作伙伴中心之前已经集成的现有产品；新产品应使用合作伙伴中心提交 API。

对云合作伙伴门户发布 API 的每个调用都必须显式指定要使用哪个并发控制策略。 如果未提供 If-Match 标头，则会导致 HTTP 400 错误响应。 我们提供了两种并发控制策略。

• 乐观 - 执行更新的客户端将验证自上次读取数据以来数据是否已发生更改。
• 最后一个胜出 - 客户端直接更新数据，不管自上次读取以来其他应用程序是否已修改了数据。

乐观并发工作流

我们建议使用乐观并发策略以及以下工作流，以确保不会对你的资源造成意外编辑。

1. 使用 API 检索实体。 响应包括一个 ETag 值，它标识当前所存储的实体版本（在响应时）。
2. 在更新时，在必需的 If-Match 请求标头中包括此相同的 ETag 值。
3. API 会在一个原子事务中将在请求中收到的 ETag 值与实体的当前 ETag 值进行比较。
   • 如果两个 ETag 值不同，则 API 将返回一个 412 Precondition Failed HTTP 响应。 此错误表明，自客户端上次检索该实体以来，有其他进程已更新了实体，或者在请求中指定的 ETag 值不正确。
   • 如果两个 ETag 值相同，或者 If-Match 标头包含通配符星号字符 (*)，则 API 将执行所请求的操作。 API 操作还会更新实体的已存储 ETag 值。

注意

在 If-Match 标头中指定通配符 (*) 将导致 API 使用“最后一个胜出”并发策略。 在这种情况下，不会进行 ETag 比较，并且会在不执行任何检查的情况下更新资源。