检索产品/服务

项目
06/14/2024

注意

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

检索发布者命名空间下的产品/服务汇总列表。

GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers?api-version=2017-10-31

URI 参数

Name	描述	Data type
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	产品/服务正在等待发布者批准。
运行	正在处理产品/服务提交。
成功	产品/服务提交已完成处理。
已取消	产品/服务提交已取消。
已失败	产品/服务提交失败。

通过