{"base_path":"/","components":null,"consumes":"","definitions":{"ErrorResponse":{"description":"失败时返回的错误对象","properties":{"code":{"description":"错误码","maxLength":36,"minLength":8,"type":"string"},"message":{"description":"错误描述","maxLength":512,"minLength":2,"type":"string"}},"required":["code","message"]},"ListPublicZoneResp":{"properties":{"links":{"$ref":"#/definitions/pageLink"},"metadata":{"$ref":"#/definitions/metadata","description":"返回满足过滤条件的资源总数。"},"zones":{"description":"查询公网Zone的列表响应。","items":{"$ref":"#/definitions/PublicZoneResp"},"type":"array"}}},"PublicZoneResp":{"properties":{"created_at":{"description":"创建时间。","type":"string"},"description":{"description":"对zone的描述信息。","type":"string"},"email":{"description":"管理该zone的管理员邮箱,用于生成该Zone的SOA记录。","type":"string"},"enterprise_project_id":{"description":"域名关联的企业项目ID,长度不超过36个字符。","type":"string"},"id":{"description":"zone的ID,uuid形式的一个资源标识。","type":"string"},"links":{"$ref":"#/definitions/pageLink"},"masters":{"description":"主从模式中,从DNS服务器获取DNS信息。","items":{"type":"string"},"type":"array"},"name":{"description":"zone名称。","type":"string"},"pool_id":{"description":"托管该zone的pool,由系统分配。","type":"string"},"project_id":{"description":"zone所属的项目ID。","type":"string"},"record_num":{"description":"该zone下的recordset个数。","format":"int32","type":"integer"},"serial":{"description":"该zone下SOA记录中用于标识zone文件变更的序列值,用于主从节点同步。","format":"int32","type":"integer"},"status":{"description":"资源状态。","type":"string"},"tags":{"$ref":"#/definitions/tagArray"},"ttl":{"description":"该zone下SOA记录中的ttl值。","format":"int32","type":"integer"},"updated_at":{"description":"更新时间。","type":"string"},"zone_type":{"description":"zone类型,公网(public)。","type":"string"}}},"metadata":{"description":"返回满足过滤条件的资源总数。","properties":{"total_count":{"description":"满足查询条件的资源总数,不受分页(即limit、offset参数)影响。","format":"int32","type":"integer"}}},"pageLink":{"description":"指向当前资源或者其他资源的链接。当查询需要分页时,需要包含一个next链接指向下一页。","properties":{"next":{"description":"下一页资源的链接。","type":"string"},"self":{"description":"当前资源的链接。","type":"string"}}},"tag":{"properties":{"key":{"description":"键。最大长度36个unicode字符。 key不能为空。不能包含“=”,“*”,“<”,“>”,“\\”,“,”,“|”,“/”,且首尾字符不能为空格。","type":"string"},"value":{"description":"值。每个值最大长度43个unicode字符,可以为空字符串。 不能包含“=”,“*”,“<”,“>”,“\\”,“,”,“|”,“/”,且首尾字符不能为空格。","type":"string"}},"required":["key"]},"tagArray":{"description":"资源标签。","items":{"$ref":"#/definitions/tag"},"type":"array"}},"description":null,"group_id":"2ab479966f0f4e20b884fafa72e0161b","host":"dns.cn-north-4.myhuaweicloud.com","id":"48618a33452349c3afecd873bddb5a4a","info_version":"v2","method":"get","name":"ListPublicZones","parameters":{"X-Auth-Token":{"description":"用户Token。\n\n通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。","in":"header","name":"X-Auth-Token","required":true,"type":"string","x-example":"MIIDkgYJKoZIhvcNAQcCoIIDgzCCXXXXXX..."}},"paths":{"/v2/zones":{"get":{"description":"查询公网Zone列表","operationId":"ListPublicZones","parameters":[{"description":"待查询的zone的类型。\n\n取值范围:public\n默认值为空。","in":"query","name":"type","required":false,"type":"string"},{"description":"每页返回的资源个数。\n\n取值范围:0~500\n\n取值一般为10,20,50。默认值为500。","format":"int32","in":"query","name":"limit","required":false,"type":"integer"},{"description":"分页查询起始的资源ID,为空时为查询第一页。\n\n默认值为空。","in":"query","name":"marker","required":false,"type":"string"},{"description":"分页查询起始偏移量,表示从偏移量的下一个资源开始查询。\n\n取值范围:0~2147483647\n\n默认值为0。\n\n当前设置marker不为空时,以marker为分页起始标识。","format":"int32","in":"query","name":"offset","required":false,"type":"integer"},{"description":"资源标签。\n\n取值格式:key1,value1|key2,value2\n\n多个标签之间用\"|\"分开,每个标签的键值用英文逗号\",\"相隔。\n\n多个标签之间为“与”的关系。\n\n关于资源标签,请参见添加资源标签。\n\n搜索模式为精确搜索。如果资源标签值value是以*开头时,则按照*后面的值全模糊匹配。\n\n默认值为空。","in":"query","name":"tags","required":false,"type":"string"},{"description":"Zone名称。\n\n搜索模式默认为模糊搜索。","in":"query","name":"name","required":false,"type":"string"},{"description":"Zone ID。","in":"query","name":"id","required":false,"type":"string"},{"description":"资源状态。","in":"query","name":"status","required":false,"type":"string"},{"description":"查询条件搜索模式。\n\n取值范围:\n\nlike:模糊搜索\nequal:精确搜索","in":"query","name":"search_mode","required":false,"type":"string"},{"description":"查询结果中zone列表的排序字段。\n\n取值范围为:\n\nname:域名\ncreated_at:创建时间\nupdated_at:更新时间\n默认值为空,表示不排序。","in":"query","name":"sort_key","required":false,"type":"string"},{"description":"查询结果中zone列表的排序方式。\n\n取值范围:\n\ndesc:降序排序\nasc:升序排序\n默认值为空,表示不排序。","in":"query","name":"sort_dir","required":false,"type":"string"},{"description":"域名关联的企业项目ID,长度不超过36个字符。","in":"query","name":"enterprise_project_id","required":false,"type":"string"},{"$ref":"#/parameters/X-Auth-Token"}],"produces":["application/json"],"responses":{"200":{"description":"查询公网Zone的列表响应。","examples":{"application/json":{"links":{"next":"https://Endpoint/v2/zones?type=public&limit=10&marker=2c9eb155587194ec01587224c9f90149","self":"https://Endpoint/v2/zones?type=public&limit=10"},"metadata":{"total_count":2},"zones":[{"created_at":"2016-11-17T11:56:03.439","description":"This is an example zone.","email":"xx@example.com","id":"2c9eb155587194ec01587224c9f90149","links":{"self":"https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149"},"masters":[],"name":"example.com.","pool_id":"00000000570e54ee01570e9939b20019","project_id":"e55c6f3dc4e34c9f86353b664ae0e70c","record_num":2,"serial":0,"status":"ACTIVE","ttl":300,"updated_at":"2016-11-17T11:56:05.528","zone_type":"public"},{"created_at":"2016-11-17T12:01:17.996","description":"This is an example zone.","email":"xx@example.org","id":"2c9eb155587228570158722996c50001","links":{"self":"https://Endpoint/v2/zones/2c9eb155587228570158722996c50001"},"masters":[],"name":"example.org.","pool_id":"00000000570e54ee01570e9939b20019","project_id":"e55c6f3dc4e34c9f86353b664ae0e70c","record_num":2,"serial":0,"status":"PENDING_CREATE","ttl":300,"updated_at":"2016-11-17T12:01:18.528","zone_type":"public"}]}},"schema":{"$ref":"#/definitions/ListPublicZoneResp"}},"400":{"description":"接口错误响应。","schema":{"$ref":"#/definitions/ErrorResponse"}},"404":{"description":"接口错误响应。","schema":{"$ref":"#/definitions/ErrorResponse"}},"500":{"description":"接口错误响应。","schema":{"$ref":"#/definitions/ErrorResponse"}}},"summary":"查询公网Zone列表","tags":["公网Zone管理"],"x-is-registered":"Y","x-support-sdk":"Y"}}},"product_short":"DNS","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"查询公网Zone列表","tags":"公网Zone管理","uri":null,"version":"2.0"}