检索产品/服务

注意

云合作伙伴门户 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 产品/服务正在等待发布者批准。
运行 正在处理产品/服务提交。
成功 产品/服务提交已完成处理。
已取消 产品/服务提交已取消。
已失败 产品/服务提交失败。