huawei-cloud-api-definitions-DNS 0.1.20250117

Huawei Cloud API definitions, generated from OpenAPI spec
Documentation
1
{"base_path":"/","components":null,"consumes":"","definitions":{"CreateRecordSetRequestBody":{"properties":{"description":{"description":"可选配置,对域名的描述。\n\n长度不超过255个字符。\n\n默认值为空。","type":"string"},"name":{"description":"域名,后缀需以zone name结束且为FQDN(即以“.”号结束的完整主机名)。","type":"string"},"records":{"description":"解析记录的值。不同类型解析记录对应的值的规则不同。","items":{"type":"string"},"type":"array"},"status":{"description":"解析记录的状态。\n取值范围:\nENABLE:启用\nDISABLE:暂停\n默认值为ENABLE。","type":"string"},"tags":{"description":"资源标签。","items":{"$ref":"#/definitions/tag"},"type":"array"},"ttl":{"description":"解析记录在本地DNS服务器的缓存时间,缓存时间越长更新生效越慢,以秒为单位。\n如果您的服务地址经常更换,建议TTL值设置相对小些,反之,建议设置相对大些。","format":"int32","type":"integer"},"type":{"description":"Record Set的类型。\n\n公网域名场景的记录类型: A、AAAA、MX、CNAME、TXT、NS、SRV、CAA。\n\n内网域名场景的记录类型: A、AAAA、MX、CNAME、TXT、SRV。","type":"string"}},"required":["name","type","records"]},"CreateRecordSetResp":{"properties":{"create_at":{"description":"创建时间。\n格式:yyyy-MM-dd'T'HH:mm:ss.SSS","type":"string"},"default":{"description":"标识是否由系统默认生成,系统默认生成的Record Set不能删除。","type":"boolean"},"description":{"description":"Record Set的描述信息。","type":"string"},"id":{"description":"Record Set的ID。","type":"string"},"links":{"$ref":"#/definitions/pageLink","description":"指向当前资源或者其他资源的链接。当查询需要分页时,需要包含一个next链接指向下一页。"},"name":{"description":"Record Set的名称。","type":"string"},"project_id":{"description":"该Record Set所属的项目ID。","type":"string"},"records":{"description":"域名解析后的值。","items":{"type":"string"},"type":"array"},"status":{"description":"资源状态。","type":"string"},"ttl":{"description":"解析记录在本地DNS服务器的缓存时间,缓存时间越长更新生效越慢,以秒为单位。\n如果您的服务地址经常更换,建议TTL值设置相对小些,反之,建议设置相对大些。","format":"int32","type":"integer"},"type":{"description":"记录类型。\n\n公网域名场景的记录类型: A、AAAA、MX、CNAME、TXT、NS、SRV、CAA。\n\n内网域名场景的记录类型: A、AAAA、MX、CNAME、TXT、SRV。","type":"string"},"update_at":{"description":"更新时间。\n格式:yyyy-MM-dd'T'HH:mm:ss.SSS","type":"string"},"zone_id":{"description":"托管该记录的zone_id。","type":"string"},"zone_name":{"description":"托管该记录的zone_name。","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":"8567ab398f344b4babf25cd42e367c4f","info_version":"v2","method":"post","name":"CreateRecordSet","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/{zone_id}/recordsets":{"post":{"description":"创建单个Record Set","operationId":"CreateRecordSet","parameters":[{"$ref":"#/parameters/X-Auth-Token"},{"description":"创建RecordSet请求对象。","in":"body","name":"CreateRecordSetRequestBody","required":true,"schema":{"$ref":"#/definitions/CreateRecordSetRequestBody"}},{"description":"所属zone的ID。","in":"path","name":"zone_id","required":true,"type":"string"}],"produces":["application/json"],"responses":{"202":{"description":"创建RecordSet响应。","examples":{"application/json":{"create_at":"2016-11-17T12:03:17.827","default":false,"description":"This is an example record set.","id":"2c9eb155587228570158722b6ac30007","links":{"self":"https://Endpoint/v2/zones/2c9eb155587194ec01587224c9f90149/recordsets/2c9eb155587228570158722b6ac30007"},"name":"www.example.com.","project_id":"e55c6f3dc4e34c9f86353b664ae0e70c","records":["192.168.10.1","192.168.10.2"],"status":"PENDING_CREATE","ttl":300,"type":"A","update_at":null,"zone_id":"2c9eb155587194ec01587224c9f90149","zone_name":"example.com."}},"schema":{"$ref":"#/definitions/CreateRecordSetResp"}}},"summary":"创建单个Record Set","tags":["Record Set管理"],"x-is-registered":"Y","x-request-examples-description-1":"创建一个解析A类型的解析记录,设置TTL为3600秒,解析记录值为\"192.168.10.1\"、\"192.168.10.2\"。","x-request-examples-text-1":{"description":"This is an example record set.","name":"www.example.com.","records":["192.168.10.1","192.168.10.2"],"tags":[{"key":"key1","value":"value1"}],"ttl":3600,"type":"A"},"x-request-examples-url-1":"POST https://{endpoint}/v2/zones/{zone_id}/recordsets","x-support-sdk":"Y"}}},"product_short":"DNS","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"创建单个Record Set","tags":"Record Set管理","uri":null,"version":"2.0"}