API 说明

API 名称：UpdateTemplate

API 域名：domain-openapi.volcengineapi.com

API 描述：更新一个信息模板中的字段值。

请求方法

POST

使用限制

节流限制：您每秒最多可以发送 20 个请求。

请求鉴权

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见请求鉴权。

公共参数

在调用该 API 时，您在请求中必须包含公共参数。在这些公共参数中，以下两个查询参数的取值说明如下：

参数名称	数据类型	必选	参数说明
Action	string	是	表示 API 的名称。该参数的取值是 UpdateTemplate。
Version	string	是	表示 API 的版本。该参数的取值是 2022-12-12。

请求参数

该 API 的请求参数的类型是请求正文参数。

在您调用该 API 更新一个信息模板时，您指定的字段内容会覆盖这些字段的当前值。如果您没有指定某个字段，表示将该字段的值设置为空。

您可以使用 GetTemplate 获取当前该信息模板中各字段的值。

参数名称	数据类型	必选	参数说明	示例
tag	string	是	表示需要更新的信息模板的 tag。您可以调用 ListTemplates 获取信息模板的 tag。	G0zM6RUUWLPysIuVPF7obA==
post_code	string	是	表示域名所有者地址的邮编。该参数只能包含数字，长度是 6 个字符。	163000
email	string	是	表示域名所有者的邮件地址。	abc@example.com
registrant_fn_zh	string	是	表示联系人中文姓名中的名。该参数必须包含中文汉字，可以包含字母和数字，长度在 1-64 个字符之间。	萌
registrant_ln_zh	string	是	表示联系人中文姓名中的姓。该参数必须包含中文汉字，可以包含字母和数字，长度在 1-64 个字符之间。	李
registrant_fn	string	是	表示联系人的英文名中的名，必须包含字母，可以包含数字，长度在 1-64 个字符之间。	Meng
registrant_ln	string	是	表示联系人的英文姓名中的姓，必须包含字母，可以包含数字，长度在 1-64 个字符之间。	Li
address_zh	string	是	表示域名所有者的中文地址。该参数必须包含中文汉字，可以包含字母和数字，长度不能超过 128 个字符。注意地址必须包含完整的中国省级行政区名称和城市名称。例如：辽宁省沈阳市不能写成辽宁沈阳，否则模板将审核失败。	黑龙江省大庆市萨尔图区拥军大街3-10号5门2室
address	string	是	表示域名所有者的英文地址，必须包含字母，可以包含数字，长度不能超过 128 个字符。	Hei Long Jiang Sheng Da Qing Shi Sa Er Tu Qu Yong Jun Da Jie 3-10 Hao 5 Men 2 Shi
state_zh	string	是	表示 address_zh 中的中国省级行政区。该参数只能包含中文汉字。	黑龙江省
state	string	是	表示 state_zh 的拼音。该参数必须包含字母，长度不能超过 64 个字符。	heilongjiangsheng
city_zh	string	是	表示 address_zh 中的城市。该参数只能包含中文汉字。	大庆市
city	string	是	表示 city_zh 的拼音。该参数必须包含字母，长度不能超过 64 个字符。	daqingshi
tel_country_code	string	是	表示联系人电话号码中的国家码。当前，该参数只能是 86。86 表示中国的国家码。	86
tel_area_code	string	否	表示联系人电话号码中的区号。该参数的说明如下：如果 tel_number 表示的是一个座机号码，该参数为必填。该参数只能包含数字，长度为 3 个或 4 个字符。如果 tel_number 表示的是一个手机号码，您无需填写该参数。注意区号必须匹配 address_zh 中的地区。	0459
tel_number	string	是	表示联系人电话号码。该参数只能包含数字，长度不超过 11 个字符。手机号码的长度是 11 位数字，座机号码的长度是 7-8 位数字。	12345678912
tel_extension	string	否	表示联系人电话号码的分机。该参数的说明如下：如果 tel_number 表示的是一个座机号码，该参数是可选的。该参数只能包含数字，长度为 1-4 个字符。如果 tel_number 表示的是一个手机号码，您无需填写该参数。	1234

返回参数

无。

请求示例

响应示例

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。

域名服务