CreateRecord_边缘安全加速_API文档

2024-09-10

获取元数据获取 SDK

找不到 API ? 点击反馈吧

插件下载了解更多

VS Code 插件反馈

安装插件之前，确保已安装 VS Code

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.

JetBrains 插件反馈

安装插件之前，确保已安装 JetBrains IDE

Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI

The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为10/1(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

esa:CreateRecord	Create	Site acs:esa:{#regionId}:{#accountId}:site/{#SiteId}	无	无

请求参数

字段名称	字段详情
SiteIdinteger<int64>	站点 ID，可通过调用 ListSites 接口获取。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:1234567890123参考取值来源: ListSites CreateSite
RecordNamestring	记录名称。示例值:www.example.com参考取值来源: GetRecord ListRecords BatchCreateRecords CreateEdgeContainerAppRecord
Proxiedboolean	记录是否开启代理加速。只有 CNAME 记录与 A/AAAA 记录可以开启代理加速。取值：展开详情示例值:true
Typestring	记录的 DNS 类型。例如A/AAAA、CNAME、TXT 等。示例值:A/AAAA
SourceTypestring	CNAME 记录的源站类型。添加 CNAME 记录时，需要填写此参数。取值：展开详情示例值:OSS
BizNamestring	记录加速时的业务场景，不开启加速的记录不需要传，取值：展开详情示例值:web
Ttlinteger<int32>	记录的过期时间，单位秒。当取值为 1 时，表示记录的过期时间为自动。示例值:30
Dataobject	记录的 DNS 信息。不同类型的记录，该字段需要传的内容也不同，请参考展开详情示例值:{ "value":"2.2.2.2" }
Commentstring	记录的备注信息，最大长度为 100 字符。示例值:This is a remark.
AuthConfobject	CNAME 记录的源站鉴权信息。
HostPolicystring	回源 HOST 策略，记录类型为 CNAME 时生效，设置回源时带 HOST 的策略，有两种模式：展开详情示例值:follow_origin_domain枚举值:

请求说明

记录的 Data 部分，包括记录的 DNS 信息。不同类型的记录，该字段需要传的内容也不同。详细说明请参考说明文档。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:F61CDR30-E83C-4FDA-BF73-9A94CDD44229
RecordIdinteger<int64>	创建的记录 ID。注意请注意，该值为 Long 类型，在某些语言中可能存在精度丢失的风险，请小心使用。示例值:1234567890123

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidParameter	The specified parameter is invalid.	诊断
400	InvalidParameter.InvalidRecordName	The record name you entered does not meet the specifications. Change the record name according to the product documentation.	诊断
400	ServiceInvokeFailed	The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details.	诊断
400	InternalException	Failed to call the service. Try again later or contact technical support.	诊断
400	InvalidParameter.RecordData	Invalid record content. Adjust your configurations based on the API documentation.	诊断
400	InvalidParameter.RecordType	Invalid record type. Adjust your configurations based on the API documentation.	诊断
400	Instance.NotOnline	Your plan is unavailable due to an overdue payment. Complete the payment first.	诊断
400	QuotaExceed.RecordCount	The maximum number of records has been reached. Delete some and try again or upgrade your plan.	诊断
400	Record.Conflict	The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.	诊断
400	Site.ServiceBusy	This website is being configured. Try again later.	诊断
400	SourceCircleExist	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.	诊断
400	QuotaExceed.WildCardRecord	The maximum number of wildcard records has been reached. Delete some and try again.	诊断
400	WildcardRecordsExceedLimit	The number of pan records currently added has exceeded the system limit. If you want to add more pan records, please contact the background with a work order.	诊断
400	Record.NoResource	Failed to allocate resources for the record. Please submit a ticket for processing.	诊断

变更历史

	变更时间	变更内容概要	操作
	2025-03-28	变更错误码400
	2025-02-18	变更错误码400
	2024-11-05	变更错误码400
	2024-10-10	变更错误码400 变更请求参数HostPolicy
	2024-09-24	变更错误码400
	2024-09-23	变更错误码400 新增请求参数HostPolicy

相关示例