{"base_path":"/","components":null,"consumes":"","definitions":{"CreatePrivateZoneReq":{"properties":{"description":{"description":"域名的描述信息。","type":"string"},"email":{"description":"管理该zone的管理员邮箱,用于生成该Zone的SOA记录。","type":"string"},"enterprise_project_id":{"description":"域名关联的企业项目ID,长度不超过36个字符。 默认值为0。","type":"string"},"name":{"description":"待创建的域名。","type":"string"},"proxy_pattern":{"description":"内网Zone的子域名递归解析代理模式。\n\n取值范围:\n\nAUTHORITY:当前Zone未开启递归解析代理\nRECURSIVE:当前Zone已开启递归解析代理","type":"string"},"router":{"$ref":"#/definitions/Router","description":"需要关联的Router(VPC)。"},"tags":{"description":"资源标签。","items":{"$ref":"#/definitions/tag"},"type":"array"},"ttl":{"description":"用于填写默认生成的SOA记录中有效缓存时间,以秒为单位。","format":"int32","type":"integer"},"zone_type":{"description":"域名类型。取值:private。","type":"string"}},"required":["name","zone_type","router"]},"CreatePrivateZoneResp":{"description":"创建单个内网Zone响应。","properties":{"created_at":{"description":"创建时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ","type":"string"},"description":{"description":"对zone的描述信息。","type":"string"},"email":{"description":"管理该zone的管理员邮箱,用于生成该Zone的SOA记录。","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"},"proxy_pattern":{"description":"内网Zone的子域名递归解析代理模式。\n\n取值范围:\n\nAUTHORITY:当前Zone未开启递归解析代理\nRECURSIVE:当前Zone已开启递归解析代理","type":"string"},"record_num":{"description":"该zone下的recordset个数。","format":"int32","type":"integer"},"router":{"$ref":"#/definitions/RouterWithStatus","description":"与该zone关联的Router(VPC)列表。"},"serial":{"description":"该zone下SOA记录中用于标识zone文件变更的序列值,用于主从节点同步。 该参数暂未使用。","format":"int32","type":"integer"},"status":{"description":"资源状态。","type":"string"},"ttl":{"description":"该zone下SOA记录中的ttl值。","format":"int32","type":"integer"},"updated_at":{"description":"更新时间。 采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ","type":"string"},"zone_type":{"description":"zone类型,内网(private)。","type":"string"}}},"ErrorResponse":{"description":"失败时返回的错误对象","properties":{"code":{"description":"错误码","maxLength":36,"minLength":8,"type":"string"},"message":{"description":"错误描述","maxLength":512,"minLength":2,"type":"string"}},"required":["code","message"]},"Router":{"properties":{"router_id":{"description":"关联VPC的ID。","type":"string"},"router_region":{"description":"关联VPC所在的region。","type":"string"},"status":{"description":"资源状态。","type":"string"}},"required":["router_id"]},"RouterWithStatus":{"properties":{"router_id":{"description":"关联VPC的ID。","type":"string"},"router_region":{"description":"关联VPC所在的region。","type":"string"},"status":{"description":"资源状态。","type":"string"}}},"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"]}},"description":null,"group_id":"2ab479966f0f4e20b884fafa72e0161b","host":"dns.cn-north-4.myhuaweicloud.com","id":"eb6c7e3c37fd44ce8f49df13e0bd7453","info_version":"v2","method":"post","name":"CreatePrivateZone","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":{"post":{"description":"创建单个内网Zone","operationId":"CreatePrivateZone","parameters":[{"$ref":"#/parameters/X-Auth-Token"},{"description":"创建单个内网Zone请求体。","in":"body","name":"CreatePrivateZoneReq","required":false,"schema":{"$ref":"#/definitions/CreatePrivateZoneReq"}}],"produces":["application/json"],"responses":{"202":{"description":"创建单个内网Zone响应。","examples":{"application/json":{"created_at":"2017-04-22T08:17:08.997","description":"This is an example zone.","email":"xx@example.com","id":"ff8080825b8fc86c015b94bc6f8712c3","links":{"self":"https://Endpoint/v2/zones/ff8080825b8fc86c015b94bc6f8712c3"},"masters":[],"name":"example.com.","pool_id":"ff8080825ab738f4015ab7513298010e","project_id":"e55c6f3dc4e34c9f86353b664ae0e70c","proxy_pattern":"AUTHORITY","record_num":0,"router":{"router_id":"19664294-0bf6-4271-ad3a-94b8c79c6558","router_region":"xx","status":"PENDING_CREATE"},"serial":1,"status":"PENDING_CREATE","ttl":300,"updated_at":null,"zone_type":"private"}},"schema":{"$ref":"#/definitions/CreatePrivateZoneResp"}},"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-request-examples-description-1":"创建一个内网域名,子域名递归解析代理模式设置为AUTHORITY。","x-request-examples-text-1":{"description":"This is an example zone.","email":"xx@example.org","name":"example.com.","proxy_pattern":"AUTHORITY","router":{"router_id":"19664294-0bf6-4271-ad3a-94b8c79c6558","router_region":"xx"},"tags":[{"key":"key1","value":"value1"}],"zone_type":"private"},"x-request-examples-url-1":"POST https://{endpoint}/v2/zones","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"}