查询自定义属性列表接口 - ListAttributes
功能介绍
查询自定义属性列表接口
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
GET /v1/attributes
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| cust_attr_name | 否 | String | 自定义属性名称 最大长度:32 |
| limit | 否 | Long | 分页查询时每页显示的记录数,默认值为10,取值范围为10-500的整数 最小值:10 最大值:500 缺省值:10 |
| offset | 否 | Long | 分页查询时的页码数,默认值为1,取值范围为1-1000000的整数 最小值:1 最大值:1000000 缺省值:1 |
| status | 否 | Integer | 自定义属性状态:0 未启用,1 已启用。 最小值:0 最大值:1 |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| limit | Long | 每页记录数 |
| offset | Long | 页码 |
| count | Long | 记录总数 |
| attributes | Array of CmAttributeVO objects | 自定义属性记录 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | Long | 自定义属性标识 |
| default_attr_name_cn | String | 默认属性名称中文 最大长度:32 |
| default_attr_name_en | String | 默认属性名称英文 最大长度:32 |
| cust_attr_name | String | 自定义属性名称 最大长度:32 |
| status | Integer | 自定义属性状态:0 未启用,1 已启用。 |
| create_time | String | 创建时间 |
| modify_time | String | 更新时间 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最大长度:64 |
| error_msg | String | 错误描述 最大长度:512 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最大长度:64 |
| error_msg | String | 错误描述 最大长度:512 |
请求示例
查询自定义属性列表,每页返回10条数据,从第1页开始。
GET https://{endpoint}/v1/attributes?offset=1&limit=10 响应示例
状态码:400
Bad Request
{
"error_code" : "GSL.00020004",
"error_msg" : "参数异常"
} 状态码:500
Internal Server Error
{
"error_code" : "GSL.00020003",
"error_msg" : "系统繁忙,请稍后重试。"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 500 | Internal Server Error |
错误码
请参见错误码。