取消操作
注意
云合作伙伴门户 API 已与合作伙伴中心集成，并将继续在其中工作。 本次转换引入的变更很少。 请查阅云合作伙伴门户 API 参考中列出的更改，以确保代码在转换到合作伙伴中心后能够继续正常运行。 CPP API 应仅用于在转换到合作伙伴中心之前已经集成的现有产品；新产品应使用合作伙伴中心提交 API。
此 API 会取消当前正在对产品/服务进行的操作。 使用检索操作 API 获取要传递给此 API 的 operationId。 取消通常是同步操作，但在一些复杂的方案中，可能需要新操作来取消现有操作。 在这种情况下，HTTP 响应正文包含应该用于查询状态的操作位置。
POST https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/cancel?api-version=2017-10-31
URI 参数
| Name | 描述 | Data type |
|---|---|---|
| publisherId | 发布者标识符，例如 contoso |
字符串 |
| offerId | 产品/服务标识符 | 字符串 |
| api-version | API 的当前版本 | 日期 |
头文件
| Name | 值 |
|---|---|
| Content-Type | application/json |
| 授权 | 持有者令牌 |
正文示例
请求
{
"metadata": {
"notification-emails": "jondoe@contoso.com"
}
}
请求正文属性
| Name | 描述 |
|---|---|
| notification-emails | 逗号分隔的电子邮件 ID 列表，用于接收发布操作进度的通知。 |
响应
已迁移的产品/服务
Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31
未迁移的产品/服务
Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31
响应标头
| Name | 值 |
|---|---|
| 位置 | 用于检索此操作状态的相对路径。 |
响应状态代码
| 代码 | 描述 |
|---|---|
| 200 | 正常。 请求已成功处理，并且已同步取消操作。 |
| 202 | 已接受。 请求已成功处理，并且正在取消操作。 取消操作的位置将在响应标头中返回。 |
| 400 | 错误/格式错误请求。 错误响应正文可以提供更多信息。 |
| 403 | 访问被禁止。 客户端无权访问请求中指定的命名空间。 |
| 404 | 未找到。 指定的实体不存在。 |