取消操作
注意
云合作伙伴门户 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 | 未找到。 指定的实体不存在。 |