搜索 domain
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /v2/domain/search HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 body |
|
| name |
string |
否 |
要搜索的 domain 名称,支持模糊搜索 |
你好网盘 |
| marker |
string |
否 |
设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定,则从头开始返回数据。
|
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
| limit |
integer |
否 |
限定此次返回资源的数量,取值范围[0,100],默认 100 返回结果可以小于指定的数量,但不能多于指定的数量。 |
50 |
| order_by |
string |
否 |
排序规则,当前仅支持: created_at,创建时间 |
created_at |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
domain 列表以及遍历 marker |
||
| items |
array |
搜索命中的 domain 列表 |
|
| Domain |
domain 信息 |
||
| next_marker |
string |
用作下次遍历的 marker |
NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg |
示例
正常返回示例
JSON格式
{
"items": [
{
"parent_domain_id": "bj1",
"domain_id": "bj2",
"domain_name": "pdsdomain",
"description": "my domain",
"init_drive_enable": true,
"init_drive_size": 1073741824,
"updated_at": "2019-08-20T06:51:27.292Z",
"created_at": "2019-08-20T06:51:27.292Z",
"size_quota": 1099511627776,
"size_quota_used": 1099511627776,
"user_count_quota": 50,
"status": 1,
"used_size": 1099511627776,
"published_app_access_strategy": {
"effect": "deny",
"except_app_id_list": [
"8ovxCTRUDdbpVWBP"
]
},
"sharable": true,
"data_hash_name": "sha1",
"store_redundancy_type": "LRS"
}
],
"next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。