检索产品/服务
注意
云合作伙伴门户 API 已与合作伙伴中心集成,并将继续在其中工作。 本次转换引入的变更很少。 请查阅云合作伙伴门户 API 参考中列出的更改,以确保代码在转换到合作伙伴中心后能够继续正常运行。 CPP API 应仅用于在转换到合作伙伴中心之前已经集成的现有产品;新产品应使用合作伙伴中心提交 API。
检索发布者命名空间下的产品/服务汇总列表。
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers?api-version=2017-10-31
URI 参数
Name | 描述 | 数据类型 |
---|---|---|
publisherId | 发布者标识符,例如 contoso |
字符串 |
api-version | API 的最新版本 | 日期 |
标头
Name | 值 |
---|---|
Content-Type | application/json |
授权 | Bearer YOUR_TOKEN |
正文示例
响应
200 OK
[
{
"offerTypeId": "microsoft-azure-virtualmachines",
"publisherId": "contoso",
"status": "published",
"id": "059afc24-07de-4126-b004-4e42a51816fe",
"version": 1,
"definition": {
"displayText": "Contoso Virtual Machine"
},
"changedTime":"2017-05-23T23:33:47.8802283Z"
}
]
响应正文属性
Name | 描述 |
---|---|
offerTypeId | 标识产品/服务的类型 |
publisherId | 唯一标识发布者的标识符 |
status | 产品/服务的状态。 有关可能值的列表,请参阅下面的产品/服务状态。 |
id | 唯一标识发布者命名空间中的产品/服务的 GUID。 |
版本 | 该产品/服务的当前版本。 客户端无法修改 version 属性。 它在每次发布后都会递增。 |
定义 | 包含工作负载实际定义的摘要视图。 若要获取详细定义,请使用检索特定产品/服务 API。 |
changedTime | 上次修改该产品/服务时的 UTC 时间 |
响应状态代码
代码 | 描述 |
---|---|
200 | OK - 已成功处理请求,发布者下的所有产品/服务都已返回给客户端。 |
400 | Bad/Malformed request - 错误响应正文可能包含更多信息。 |
403 | Forbidden - 客户端无法访问指定的命名空间。 |
404 | Not found - 指定的实体不存在。 |
产品/服务状态
Name | 描述 |
---|---|
NeverPublished | 产品/服务从未发布过。 |
NotStarted | 产品/服务是新的,但尚未启动。 |
WaitingForPublisherReview | 产品/服务正在等待发布者批准。 |
运行 | 正在处理产品/服务提交。 |
已成功 | 产品/服务提交已完成处理。 |
已取消 | 产品/服务提交已取消。 |
已失败 | 产品/服务提交失败。 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈