# 查询云商店引擎商品列表（SQL Server） - ListMarketplaceEngineProducts #### 功能介绍 查询云商店引擎商品列表。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=ListMarketplaceEngineProducts)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | rds:instance:listAll | read | - | - | rds:instance:list | - | #### URI - URI格式 GET /v3/{*project_id*}/business-partner/{bp_domain_id}?offset={offset}\&limit={limit}\&engine_id={engine_id} - 参数说明 表1参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | bp_domain_id | 是 | String | **参数解释：** 服务商ID。 **约束限制：** 不涉及。 **取值范围：** 该参数值可调用[查询云商店服务商列表](https://support.huaweicloud.com/api-rds/rds_06_0133.html)接口，通过[表3](https://support.huaweicloud.com/api-rds/rds_06_0133.html#rds_06_0133__zh-cn_topic_0000002352025001_table1379213118720)中的"bp_domain_id"获取。 **默认取值：** 不涉及。 | | offset | 否 | Integer | **参数解释：** 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 **约束限制：** 不涉及。 **取值范围：** 大于等于0的整数。 **默认取值：** 默认为0。偏移0条数据，表示从第一条数据开始查询。 | | limit | 否 | Integer | **参数解释：** 查询记录数。 **约束限制：** 不涉及。 **取值范围：** \[1, 100\] **默认取值：** 100 | | engine_id | 否 | String | **参数解释：** 按照引擎ID查询。 **约束限制：** 不涉及。 **取值范围：** 通过[表3](https://support.huaweicloud.com/api-rds/rds_06_0001.html#rds_06_0001__table66531170)中的"id"获取。 **默认取值：** 不涉及。 | #### 请求消息 无。 #### 请求示例 ``` GET https://{Endpoint}/v3/cbbb7403a51a40abaa3c35bf2cedf5b6/business-partner/83daad92429b4c0baf84883cfd01292f ``` #### 响应消息 - 正常响应要素说明 表2要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | marketplace_engine_products | Array of objects | **参数解释：** 云商店引擎商品列表。请参见[表3]。 | | total_count | Integer | **参数解释：** 云商店引擎商品总数。 **取值范围：** 不涉及。 | 表3marketplace_engine_products字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | engine_id | String | **参数解释：** 引擎ID。 **取值范围：** 不涉及。 | | engine_version | String | **参数解释：** 引擎版本。 **取值范围：** 不涉及。 | | spec_code | String | **参数解释：** 云商店规格ID。 **取值范围：** 不涉及。 | | product_id | String | **参数解释：** 云商店商品ID。 **取值范围：** 不涉及。 | | bp_name | String | **参数解释：** 服务商名称。 **取值范围：** 不涉及。 | | bp_domain_id | String | **参数解释：** 服务商ID。 **取值范围：** 不涉及。 | | instance_mode | String | **参数解释：** 支持的实例类型。 **取值范围：** - Single：单机实例。 - Ha：主备实例。 - Replica：只读实例。 - All：以上类型都支持。 | | image_id | String | **参数解释：** 镜像ID。 **取值范围：** 不涉及。 | | user_license_agreement | String | **参数解释：** 用户许可。 **取值范围：** 不涉及。 | | agreements | Array of objects | **参数解释：** 许可详情列表。详见[表4]。 | 表4agreements字段说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 许可ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 许可名称。 **取值范围：** 不涉及。 | | language | String | **参数解释：** 许可语言类型。 **取值范围：** 不涉及。 | | version | String | **参数解释：** 许可版本。 **取值范围：** 不涉及。 | | provision_url | String | **参数解释：** 许可链接。 **取值范围：** 不涉及。 | - 正常响应样例 ``` { "marketplace_engine_products": [ { "engine_id": "b832c9cf-ba23-11eb-b4c3-6c4b90b9e8cc", "engine_version": "2019_WEB", "spec_code": "d941aa2f-ebf9-48cd-b77f-19f5e6c25fd4", "product_id": "OFFI1070157414620106752", "bp_name": "深圳市伊登软件有限公司", "bp_domain_id": "83daad92429b4c0baf84883cfd01292f", "instance_mode": "All", "image_id": "3ba463ca-a09c-44eb-9e67-7de7b91ffc2e", "user_license_agreement": "https://marketplace.huaweicloud.com/end-user-license-agreement/3a33d9f9-c02d-440d-aff0-2e1c432918ee/?Microsoft+SQL+Server+2019+web%E7%89%88_v2", "agreements": [] } ], "total_count": 1 } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。