● 帐号
用户注册时的帐号,帐号对其所拥有的资源及云服务具有完全的访问权限,可以 重置用户密码、分配用户权限等。由于帐号是付费主体,为了确保帐号安全,建 议您不要直接使用帐号进行日常管理工作,而是创建用户并使用他们进行日常管 理工作。
● 用户
由帐号在IAM中创建的用户,是云服务的使用人员,具有身份凭证(密码和访问 密钥)。
在我的凭证下,您可以查看帐号ID和IAM用户ID。通常在调用API的鉴权过程中,
您需要用到帐号、用户和密码等信息。
● 区域(Region)
从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象 存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属 Region,通用Region指面向公共租户提供通用云服务的Region;专属Region指只 承载同一类业务或只面向特定租户提供业务服务的专用Region。
详情请参见区域和可用区。
● 可用区(AZ,Availability Zone)
一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上 再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高 速光纤相连,以满足用户跨AZ构建高可用性系统的需求。
● 项目
区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计 算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您 帐号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默 认的项目中创建子项目,并在子项目中创建资源,然后以子项目为单位进行授 权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。
图1-1 项目隔离模型
同样在我的凭证下,您可以查看项目ID。
● 企业项目
企业项目是项目的升级版,针对企业不同项目间资源的分组和管理,是逻辑隔 离。企业项目中可以包含多个区域的资源,且项目中的资源可以迁入迁出。
关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理用户指 南》。
2 API 概览
云解析服务提供自研的REST接口。
通过使用云解析服务的接口,您可以完整的使用云解析服务的所有功能,包括对公网 域名、内网域名、记录集等资源的创建、查询、修改和删除。
云解析服务提供的具体API如表2-1所示。
表2-1 接口说明
子类型 说明
版本管理 DNS API的版本查询接口,支持查询所有API或者指
定API的版本号。
公网Zone管理 DNS API的公网域名管理接口,实现对公网域名的 创建、删除、修改以及查询。
内网Zone管理 DNS API的内网域名管理接口,实现对内网域名的 创建、删除、修改以及查询。
Record Set管理 DNS API的记录集管理接口,实现为公网域名和内 网域名创建、删除、修改以及查询解析记录。
Record Set多线路管理 DNS API的多线路解析管理接口,实现为公网域名 创建、删除、修改以及查询多线路解析的解析记 录。
PTR Record管理 DNS API的反向解析管理接口,实现创建、删除、
修改以及查询弹性IP到域名的反向解析记录。
TAG管理 DNS API的标签管理接口,实现为指定实例创建、
删除、修改以及查询标签,同时还支持为指定实例 批量创建或删除标签。
自定义线路管理 DNS API的自定义线路管理接口,实现自定义线路 的创建、删除、更新及查询。
名称服务器管理 DNS API的名称服务器管理接口,实现名称服务器 的查询。
版本管理接口
版本管理接口,用于查询所有DNS API版本的接口和查询指定DNS API版本的接口。
表2-2 版本管理接口
API 说明
查询版本号列表 查询所有DNS API接口的版本。
查询版本号 查询指定DNS API接口的版本。
公网 Zone 管理接口
公网Zone管理接口,用于创建、查询、删除以及修改公网Zone。
表2-3 公网 Zone 管理接口
API 说明
创建公网Zone 创建单个公网Zone。
查询公网Zone 查询单个公网Zone。
查询公网Zone列表 查询公网Zone列表。
查询公网Zone的名称服务
器 查询单个公网Zone的名称服务器。
删除公网Zone 删除单个公网Zone。
修改公网Zone 修改单个公网Zone。
设置Zone状态 设置单个公网Zone状态。
内网 Zone 管理接口
内网Zone管理接口,用于创建、查询、删除以及修改内网Zone。
表2-4 内网 Zone 管理接口
API 说明
创建内网Zone 查询单个内网Zone。
内网Zone关联VPC 为内网Zone关联VPC。
内网Zone解关联VPC 为内网Zone解关联VPC。
查询内网Zone 查询单个内网Zone。
查询内网Zone列表 查询内网Zone列表。
API 说明 查询内网Zone的名称服务
器 查询内网Zone的名称服务器。
删除内网Zone 删除单个内网Zone。
修改内网Zone 修改单个内网Zone。
Record Set 管理接口
Record Set管理接口,用于创建、查询、删除以及修改Record Set。
表2-5 Record Set 管理接口
API 说明
创建Record Set 创建单个Record Set。
查询Record Set 查询单个Record Set。
查询Record Set列表 查询租户Record Set资源列表。
查询单个Zone下Record
Set列表 查询单个Zone的Record Set列表。
删除Record Set 删除单个Record Set。
修改Record Set 修改单个Record Set。
Record Set 多线路管理接口
Record Set多线路管理接口,用于在多线路解析中创建、查询、删除以及修改Record Set。
表2-6 Record Set 多线路管理接口
API 说明
创建Record Set 创建单个Record Set。
查询Record Set 查询单个Record Set。
查询Record Set列表 查询租户Record Set资源列表。
查询单个Zone下Record
Set列表 查询单个Zone的Record Set列表。
删除Record Set 删除单个Record Set。
修改Record Set 修改单个Record Set。
设置Record Set状态 设置Record Set状态,包括启用或暂停解析。
PTR Record 管理接口
PTR Record管理接口,用于为弹性IP设置反向解析,包括设置、查询以及修改Record Set,并支持将弹性IP的PTR Record恢复为默认值。
表2-7 PTR Record 管理接口
API 说明
设置PTR Record 设置弹性IP的PTR Record。
查询PTR Record 查询单个弹性IP的PTR Record。
查询PTR Record列表 查询租户弹性IP的PTR Record列表。
恢复PTR Record默认值 将弹性IP的PTR Record恢复为默认值。
修改PTR Record 修改弹性IP的PTR Record。
TAG 管理接口
TAG管理接口,用于为资源或实例添加、删除以及查询标签。
表2-8 TAG 管理接口
API 说明
添加资源标签 为指定实例添加标签。一个资源上最多有10个标签。
删除资源标签 删除资源标签。
批量添加删除资源标签 为指定实例批量添加或删除标签。
查询资源标签 查询指定实例的标签信息。
查询项目标签 查询指定实例类型的所有标签集合。
查询资源实例 使用标签查询资源实例。资源实例按照创建时间倒
序。
自定义线路管理接口
自定义线路管理接口,用于创建、删除、更新以及查询自定义线路。
表2-9 自定义线路管理接口
API 说明
创建自定义线路 创建单个自定义线路。
删除自定义线路 删除单个自定义线路。
更新自定义线路 更新单个自定义线路。
API 说明
查询自定义线路 查询自定义线路。
名称服务器管理接口
名称服务器管理接口,用于查询名称服务器列表。
表2-10 名称服务器管理接口
API 说明
查询名称服务器列表 查询名称服务器列表。