开发者社区 问答 正文

云解析怎么批量删除域名



描述


根据传入参数批量删除域名。使用HTTP POST请求。

请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:DeleteBatchDomains
DomainsString多个域名名称,以JSON字符串的形式提交(不包含回车换行符),最多支持5,000个域名


返回参数


公共返回参数,详见 公共返回参数
名称类型描述
RequestIdString唯一请求识别码
TraceIdString批量任务ID


错误码


对于所有接口的通用性错误,请参考 错误代码表
错误代码描述HTTP 状态码语义
IllegalUserThe user ID is illegal.400未被授权的用户ID
QuotaExceeded.BatchNumberYou Can’t finish this operation because the batch number has been out of MAX count.400批量操作的数量超过限制
OperationThreadInUsedYou Can’t finish this operation because the thread of operation has been in used.400批量操作的线程被其他用户占用
DataFormatErrorThe data format is error.400数据格式不正确


示例



请求示例

http://alidns.aliyuncs.com/?Action=DeleteDomain HTTP 1.1Domains={"Domains": [{"Index": "1","Domain": "abc.com"},{"Index": "2","Domain": "example.com"},{"Index": "10000","Domain": "news.com"}]}&<公共请求参数>

返回示例



XML格式

<DeleteBatchDomainsResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><TraceId>10001</TraceId></DeleteBatchDomainsResponse>

JSON示例

{"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","TraceId": "10001"}

展开
收起
boxti 2017-10-18 11:17:03 1988 分享 版权
阿里云 AI 助理回答

您描述的是使用阿里云DNS(Alibaba Cloud DNS,也称作阿里云域名解析服务)的API接口来批量删除域名的操作。下面是对您所提供信息的一个简要解析和补充说明:

请求方式及路径

  • HTTP Method: POST
  • Path: /
  • Endpoint: alidns.aliyuncs.com

Action 参数

  • Action: 必须参数,指定要执行的操作接口名称,在此场景中应为 DeleteBatchDomains 而非 DeleteDomain。确保在请求中将 Action 设为 DeleteBatchDomains 以正确调用批量删除域名的接口。

请求参数

  • Domains: 是一个JSON字符串,包含多个域名对象,每个对象至少需要包含域名名称 (Domain)。示例中还包含了索引 (Index),但根据常规的阿里云DNS API文档,批量删除操作通常只需提供域名名称列表即可,无需索引字段。因此,简化后的JSON格式可能仅需包含域名名称数组。

示例修正

正确的请求体内容应该只关注域名名称,例如:

{
    "Domains": ["abc.com", "example.com", "news.com"]
}

返回参数

  • RequestId: 每次API请求都会返回的唯一标识。
  • TraceId: 如果操作是异步的,会返回一个批量任务ID,用于追踪该操作的执行状态。

错误码

  • 提供的错误码解释了可能遇到的一些常见问题,如非法用户ID、超过最大批量操作数量限制、操作线程已被占用或数据格式错误等。

注意事项

  1. 权限验证: 实际调用时,还需要通过AccessKey ID和AccessKey Secret进行身份验证,这通常通过HTTP Header(如Authorization)或查询参数传递。
  2. API版本: 确保使用的API版本支持批量删除功能。阿里云API可能会有版本更新,请参考最新的官方文档。
  3. 限制与频率: 批量操作受特定限制,如示例中的5,000个域名上限,以及可能存在的操作频率限制,请查阅具体的服务文档了解详细规则。

请根据上述信息调整您的请求,并参考阿里云官方文档以获取最准确的操作指南和最新API详情。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答