取消作
注意
云合作伙伴门户 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 参数
名称 | 说明 | 数据类型 |
---|---|---|
publisherId | 发布者标识符,例如,contoso |
字符串 |
offerId | 产品/服务标识符 | 字符串 |
api-version | API 的当前版本 | 日期 |
页眉
名称 | 值 |
---|---|
Content-Type | application/json |
授权 | 持有者令牌 |
正文示例
请求
{
"metadata": {
"notification-emails": "jondoe@contoso.com"
}
}
请求正文属性
名称 | 说明 |
---|---|
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
响应标头
名称 | 值 |
---|---|
位置 | 检索此作状态的相对路径。 |
响应状态代码
Code | 说明 |
---|---|
200 | 还行。 请求已成功处理,作将同步取消。 |
202 | 接受。 请求已成功处理,作正在取消。 取消作的位置在响应标头中返回。 |
400 | 错误的/格式错误的请求。 错误响应正文可以提供更多信息。 |
403 | 访问被禁止。 客户端无权访问请求中指定的命名空间。 |
404 | 找不到。 指定的实体不存在。 |