zdns

package
v0.2.21 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 6, 2026 License: Apache-2.0 Imports: 1 Imported by: 2

Documentation

Overview

* Zenlayer.com Inc. * Copyright (c) 2014-2022 All Rights Reserved.

Index

Constants

View Source
const (
	APIVersion = "2025-11-01"
	SERVICE    = "zdns"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AddPrivateZoneRecordRequest

type AddPrivateZoneRecordRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// Type 解析记录类型。
	Type *string `json:"type,omitempty"`

	// RecordName 主机记录。主机记录就是域名前缀,常见用法有www、@、*(泛解析)、mail(常用于邮箱)。例如要解析@.example.com,主机记录要填写"@”,而不是空。
	RecordName *string `json:"recordName,omitempty"`

	// Value 解析记录值。
	Value *string `json:"value,omitempty"`

	// Weight 解析记录权重。
	Weight *int `json:"weight,omitempty"`

	// Ttl 域名本地缓存时间。单位秒,默认值60,可选值5-86400(一天)。
	Ttl *int `json:"ttl,omitempty"`

	// Priority MX记录的优先级。取值越小,优先级越高, 默认为1。
	Priority *int `json:"priority,omitempty"`

	// Remark 备注信息。最长不超过255个字符。
	Remark *string `json:"remark,omitempty"`

	// Line 解析请求来源。`default` 为默认,即全局。也可以指定某个节点ID,例如asia-east-1。
	Line *string `json:"line,omitempty"`

	// Status 解析记录的状态。
	Status *string `json:"status,omitempty"`
}

AddPrivateZoneRecordRequest

func NewAddPrivateZoneRecordRequest

func NewAddPrivateZoneRecordRequest() (request *AddPrivateZoneRecordRequest)

type AddPrivateZoneRecordResponse

type AddPrivateZoneRecordResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response *AddPrivateZoneRecordResponseParams `json:"response,omitempty"`
}

func NewAddPrivateZoneRecordResponse

func NewAddPrivateZoneRecordResponse() (response *AddPrivateZoneRecordResponse)

type AddPrivateZoneRecordResponseParams

type AddPrivateZoneRecordResponseParams struct {
	RequestId *string `json:"requestId,omitempty"`

	// RecordId 内网权威域名解析记录ID。
	RecordId *string `json:"recordId,omitempty"`
}

type AddPrivateZoneRequest

type AddPrivateZoneRequest struct {
	*common.BaseRequest

	// ZoneName 域名。格式必须域名,最长不超过252个字符,也可以是单独的不带点的域名后缀(长度2-63)。不区分大小写。
	ZoneName *string `json:"zoneName,omitempty"`

	// ProxyPattern 是否开启子域名递归代理。
	ProxyPattern *string `json:"proxyPattern,omitempty"`

	// VpcIds 要绑定的VPC ID列表。
	VpcIds []string `json:"vpcIds,omitempty"`

	// ResourceGroupId 资源组ID。
	ResourceGroupId *string `json:"resourceGroupId,omitempty"`

	// Remark 备注信息。最长不超过255个字符。
	Remark *string `json:"remark,omitempty"`

	// Tags 关联的标签。
	Tags *TagAssociation `json:"tags,omitempty"`
}

func NewAddPrivateZoneRequest

func NewAddPrivateZoneRequest() (request *AddPrivateZoneRequest)

type AddPrivateZoneResponse

type AddPrivateZoneResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response *AddPrivateZoneResponseParams `json:"response,omitempty"`
}

func NewAddPrivateZoneResponse

func NewAddPrivateZoneResponse() (response *AddPrivateZoneResponse)

type AddPrivateZoneResponseParams

type AddPrivateZoneResponseParams struct {
	RequestId *string `json:"requestId,omitempty"`

	// ZoneId 新增的内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`
}

type BindPrivateZoneVpcRequest

type BindPrivateZoneVpcRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// VpcIds 要绑定的VPC列表。
	VpcIds []string `json:"vpcIds,omitempty"`
}

func NewBindPrivateZoneVpcRequest

func NewBindPrivateZoneVpcRequest() (request *BindPrivateZoneVpcRequest)

type BindPrivateZoneVpcResponse

type BindPrivateZoneVpcResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewBindPrivateZoneVpcResponse

func NewBindPrivateZoneVpcResponse() (response *BindPrivateZoneVpcResponse)

type Client

type Client struct {
	common.Client
}

func NewClient

func NewClient(config *common.Config, secretKeyId, secretKeyPassword string) (client *Client, err error)

func NewClientWithSecretKey

func NewClientWithSecretKey(secretKeyId, secretKeyPassword string) (client *Client, err error)

func (*Client) AddPrivateZone

func (c *Client) AddPrivateZone(request *AddPrivateZoneRequest) (response *AddPrivateZoneResponse, err error)

AddPrivateZone 创建内网权威域名。

func (*Client) AddPrivateZoneRecord

func (c *Client) AddPrivateZoneRecord(request *AddPrivateZoneRecordRequest) (response *AddPrivateZoneRecordResponse, err error)

AddPrivateZoneRecord 新增内网权威域名解析记录。

func (*Client) BindPrivateZoneVpc

func (c *Client) BindPrivateZoneVpc(request *BindPrivateZoneVpcRequest) (response *BindPrivateZoneVpcResponse, err error)

BindPrivateZoneVpc 内网权威域名额外绑定VPC。

func (*Client) DeletePrivateZone

func (c *Client) DeletePrivateZone(request *DeletePrivateZoneRequest) (response *DeletePrivateZoneResponse, err error)

DeletePrivateZone 删除内网权威域名。

func (*Client) DeletePrivateZoneRecord

func (c *Client) DeletePrivateZoneRecord(request *DeletePrivateZoneRecordRequest) (response *DeletePrivateZoneRecordResponse, err error)

DeletePrivateZoneRecord 删除内网权威域名解析记录。

func (*Client) DescribePrivateZoneRecords

func (c *Client) DescribePrivateZoneRecords(request *DescribePrivateZoneRecordsRequest) (response *DescribePrivateZoneRecordsResponse, err error)

DescribePrivateZoneRecords 查询内网权威域名的解析记录列表。

func (*Client) DescribePrivateZones

func (c *Client) DescribePrivateZones(request *DescribePrivateZonesRequest) (response *DescribePrivateZonesResponse, err error)

DescribePrivateZones 查询内网权威域名列表。

func (*Client) ModifyPrivateZone

func (c *Client) ModifyPrivateZone(request *ModifyPrivateZoneRequest) (response *ModifyPrivateZoneResponse, err error)

ModifyPrivateZone 修改内网权威域名信息。包括备注,是否开启子域名递归代理等。

func (*Client) ModifyPrivateZoneRecord

func (c *Client) ModifyPrivateZoneRecord(request *ModifyPrivateZoneRecordRequest) (response *ModifyPrivateZoneRecordResponse, err error)

ModifyPrivateZoneRecord 修改内网权威域名解析记录。

func (*Client) ModifyPrivateZoneRecordsStatus

func (c *Client) ModifyPrivateZoneRecordsStatus(request *ModifyPrivateZoneRecordsStatusRequest) (response *ModifyPrivateZoneRecordsStatusResponse, err error)

ModifyPrivateZoneRecordsStatus 修改内网权威域名解析记录的生效状态。

func (*Client) UnbindPrivateZoneVpc

func (c *Client) UnbindPrivateZoneVpc(request *UnbindPrivateZoneVpcRequest) (response *UnbindPrivateZoneVpcResponse, err error)

UnbindPrivateZoneVpc 内网权威域名解除VPC绑定。

type DeletePrivateZoneRecordRequest

type DeletePrivateZoneRecordRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// RecordIds 要删除的内网权威域名解析记录ID列表。
	RecordIds []string `json:"recordIds,omitempty"`
}

func NewDeletePrivateZoneRecordRequest

func NewDeletePrivateZoneRecordRequest() (request *DeletePrivateZoneRecordRequest)

type DeletePrivateZoneRecordResponse

type DeletePrivateZoneRecordResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewDeletePrivateZoneRecordResponse

func NewDeletePrivateZoneRecordResponse() (response *DeletePrivateZoneRecordResponse)

type DeletePrivateZoneRequest

type DeletePrivateZoneRequest struct {
	*common.BaseRequest

	// ZoneId 要删除的内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`
}

func NewDeletePrivateZoneRequest

func NewDeletePrivateZoneRequest() (request *DeletePrivateZoneRequest)

type DeletePrivateZoneResponse

type DeletePrivateZoneResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewDeletePrivateZoneResponse

func NewDeletePrivateZoneResponse() (response *DeletePrivateZoneResponse)

type DescribePrivateZoneRecordsRequest

type DescribePrivateZoneRecordsRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// RecordIds 根据解析记录ID进行筛选。
	RecordIds []string `json:"recordIds,omitempty"`

	// RecordName 根据主机记录进行筛选。
	RecordName *string `json:"recordName,omitempty"`

	// Type 根据解析记录类型进行筛选。
	Type *string `json:"type,omitempty"`

	// Line 根据解析线路过滤。`default` 为默认,即全局。也可以指定某个节点ID,例如asia-east-1。
	Line *string `json:"line,omitempty"`

	// Status 根据解析记录状态进行筛选。
	Status *string `json:"status,omitempty"`

	// Value 根据记录值进行筛选。
	Value *string `json:"value,omitempty"`

	// PageSize 返回的分页大小,默认为20,最大为1000。
	PageSize *int `json:"pageSize,omitempty"`

	// PageNum 返回的分页数,默认为1。
	PageNum *int `json:"pageNum,omitempty"`
}

DescribePrivateZoneRecordsRequest

func NewDescribePrivateZoneRecordsRequest

func NewDescribePrivateZoneRecordsRequest() (request *DescribePrivateZoneRecordsRequest)

type DescribePrivateZoneRecordsResponse

type DescribePrivateZoneRecordsResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response *DescribePrivateZoneRecordsResponseParams `json:"response,omitempty"`
}

func NewDescribePrivateZoneRecordsResponse

func NewDescribePrivateZoneRecordsResponse() (response *DescribePrivateZoneRecordsResponse)

type DescribePrivateZoneRecordsResponseParams

type DescribePrivateZoneRecordsResponseParams struct {
	RequestId *string `json:"requestId,omitempty"`

	// TotalCount 满足过滤条件的内网权威域名解析记录总数。
	TotalCount *int `json:"totalCount,omitempty"`

	// DataSet 返回的内网权威域名解析记录列表数据。
	DataSet []*PrivateZoneRecord `json:"dataSet,omitempty"`
}

type DescribePrivateZonesRequest

type DescribePrivateZonesRequest struct {
	*common.BaseRequest

	// ZoneIds 根据内网权威域名ID列表过滤。最长不超过100个。
	ZoneIds []string `json:"zoneIds,omitempty"`

	// VpcIds 根据Zone绑定的VPC ID筛选过滤。最长不超过100个。
	VpcIds []string `json:"vpcIds,omitempty"`

	// ZoneName 根据内网权威域名过滤。
	ZoneName *string `json:"zoneName,omitempty"`

	// ResourceGroupId 根据资源组ID过滤。
	ResourceGroupId *string `json:"resourceGroupId,omitempty"`

	// PageSize 返回的分页大小,默认为20,最大为1000。
	PageSize *int `json:"pageSize,omitempty"`

	// PageNum 返回的分页数,默认为1。
	PageNum *int `json:"pageNum,omitempty"`

	// TagKeys 根据标签键进行搜索。 最长不得超过20个标签键。
	TagKeys []string `json:"tagKeys,omitempty"`

	// Tags 根据标签进行搜索。 最长不得超过20个标签。
	Tags []*Tag `json:"tags,omitempty"`
}

func NewDescribePrivateZonesRequest

func NewDescribePrivateZonesRequest() (request *DescribePrivateZonesRequest)

type DescribePrivateZonesResponse

type DescribePrivateZonesResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response *DescribePrivateZonesResponseParams `json:"response,omitempty"`
}

func NewDescribePrivateZonesResponse

func NewDescribePrivateZonesResponse() (response *DescribePrivateZonesResponse)

type DescribePrivateZonesResponseParams

type DescribePrivateZonesResponseParams struct {
	RequestId *string `json:"requestId,omitempty"`

	// TotalCount 满足过滤条件的内网权威域名总数。
	TotalCount *int `json:"totalCount,omitempty"`

	// DataSet 返回的内网权威域名列表数据。
	DataSet []*PrivateZone `json:"dataSet,omitempty"`
}

type LineInfo added in v0.2.15

type LineInfo struct {

	// Line 解析来源。`default` 为默认,即全局。也可以指定某个节点ID,例如asia-east-1。
	Line *string `json:"line,omitempty"`

	// City 如果解析来源为节点,则该字段为节点所属的城市名称。
	City *string `json:"city,omitempty"`
}

LineInfo 描述解析来源的信息。

type ModifyPrivateZoneRecordRequest

type ModifyPrivateZoneRecordRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// RecordId 要修改的内网权威域名解析记录ID。
	RecordId *string `json:"recordId,omitempty"`

	// Value 解析记录值。
	Value *string `json:"value,omitempty"`

	// Weight 解析记录权重。仅A或者AAAA支持。
	Weight *int `json:"weight,omitempty"`

	// Ttl 域名本地缓存时间。单位秒,默认值60,可选值5-86400(一天)。
	Ttl *int `json:"ttl,omitempty"`

	// Priority MX记录的优先级。取值越小,优先级越高, 默认为1。
	Priority *int `json:"priority,omitempty"`

	// Remark 备注信息。最长不超过255个字符。
	Remark *string `json:"remark,omitempty"`
}

func NewModifyPrivateZoneRecordRequest

func NewModifyPrivateZoneRecordRequest() (request *ModifyPrivateZoneRecordRequest)

type ModifyPrivateZoneRecordResponse

type ModifyPrivateZoneRecordResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewModifyPrivateZoneRecordResponse

func NewModifyPrivateZoneRecordResponse() (response *ModifyPrivateZoneRecordResponse)

type ModifyPrivateZoneRecordsStatusRequest

type ModifyPrivateZoneRecordsStatusRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// RecordIds 要修改生效状态的内网权威域名解析记录ID。
	RecordIds []string `json:"recordIds,omitempty"`

	// Status 生效状态。
	Status *string `json:"status,omitempty"`
}

ModifyPrivateZoneRecordsStatusRequest

func NewModifyPrivateZoneRecordsStatusRequest

func NewModifyPrivateZoneRecordsStatusRequest() (request *ModifyPrivateZoneRecordsStatusRequest)

type ModifyPrivateZoneRecordsStatusResponse

type ModifyPrivateZoneRecordsStatusResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewModifyPrivateZoneRecordsStatusResponse

func NewModifyPrivateZoneRecordsStatusResponse() (response *ModifyPrivateZoneRecordsStatusResponse)

type ModifyPrivateZoneRequest

type ModifyPrivateZoneRequest struct {
	*common.BaseRequest

	// ZoneId 要修改的内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// Remark 备注信息。最长不超过255个字符。
	Remark *string `json:"remark,omitempty"`

	// ProxyPattern 是否开启子域名递归代理。
	ProxyPattern *string `json:"proxyPattern,omitempty"`
}

func NewModifyPrivateZoneRequest

func NewModifyPrivateZoneRequest() (request *ModifyPrivateZoneRequest)

type ModifyPrivateZoneResponse

type ModifyPrivateZoneResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewModifyPrivateZoneResponse

func NewModifyPrivateZoneResponse() (response *ModifyPrivateZoneResponse)

type PrivateZone

type PrivateZone struct {

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// ZoneName 内网权威域名。
	ZoneName *string `json:"zoneName,omitempty"`

	// ProxyPattern 是否开启子域名递归代理。
	ProxyPattern *string `json:"proxyPattern,omitempty"`

	// Remark 备注信息。最长不超过255个字符。
	Remark *string `json:"remark,omitempty"`

	// RecordCount 解析记录数。
	RecordCount *int `json:"recordCount,omitempty"`

	// VpcIds 绑定的VPC ID列表。
	VpcIds []string `json:"vpcIds,omitempty"`

	// Tags 关联的标签。
	Tags *Tags `json:"tags,omitempty"`

	// ResourceGroup 内网权威域名所在的资源组信息。
	ResourceGroup *ResourceGroupInfo `json:"resourceGroup,omitempty"`

	// CreateTime 内网权威域名的创建时间。
	CreateTime *string `json:"createTime,omitempty"`
}

PrivateZone 描述内网权威域名的信息。

type PrivateZoneRecord

type PrivateZoneRecord struct {

	// RecordId 解析记录ID。
	RecordId *string `json:"recordId,omitempty"`

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// Type 解析记录类型。
	Type *string `json:"type,omitempty"`

	// RecordName 主机记录。
	RecordName *string `json:"recordName,omitempty"`

	// Value 解析记录值。
	Value *string `json:"value,omitempty"`

	// Weight 解析记录权重。
	Weight *int `json:"weight,omitempty"`

	// Ttl 域名本地缓存时间。单位秒。
	Ttl *int `json:"ttl,omitempty"`

	// Line 解析请求来源。`default` 为默认,即全局。也可以指定某个节点ID,例如asia-east-1。
	Line *string `json:"line,omitempty"`

	// LineInfo 解析请求来源详细信息。仅当line为节点时存在。
	LineInfo *LineInfo `json:"lineInfo,omitempty"`

	// Priority `MX`记录的优先级。取值越小,优先级越高。
	Priority *int `json:"priority,omitempty"`

	// Remark 备注信息。
	Remark *string `json:"remark,omitempty"`

	// Status 解析记录状态。
	Status *string `json:"status,omitempty"`

	// CreateTime 解析记录的创建时间。
	CreateTime *string `json:"createTime,omitempty"`
}

PrivateZoneRecord 描述内网权威域名解析记录的信息。

type ResourceGroupInfo

type ResourceGroupInfo struct {

	// ResourceGroupId 资源组ID。
	ResourceGroupId *string `json:"resourceGroupId,omitempty"`

	// ResourceGroupName 资源组名称。
	ResourceGroupName *string `json:"resourceGroupName,omitempty"`
}

ResourceGroupInfo 描述资源所在资源组的相关信息,包括资源组名称和ID。

type Tag

type Tag struct {

	// Key 标签键。长度限制:1~64个字符。
	Key *string `json:"key,omitempty"`

	// Value 标签值。长度限制:1~64个字符。
	Value *string `json:"value,omitempty"`
}

Tag 描述一个标签键值对的信息。

type TagAssociation

type TagAssociation struct {

	// Tags 标签对列表。
	Tags []*Tag `json:"tags,omitempty"`
}

TagAssociation 描述创建资源时同时绑定的标签对的信息。

type Tags

type Tags struct {

	// Tags 标签对列表。
	Tags []*Tag `json:"tags,omitempty"`
}

Tags 描述资源关联的标签信息。

type UnbindPrivateZoneVpcRequest

type UnbindPrivateZoneVpcRequest struct {
	*common.BaseRequest

	// ZoneId 内网权威域名ID。
	ZoneId *string `json:"zoneId,omitempty"`

	// VpcIds 要解除绑定的的VPC ID列表。
	VpcIds []string `json:"vpcIds,omitempty"`
}

func NewUnbindPrivateZoneVpcRequest

func NewUnbindPrivateZoneVpcRequest() (request *UnbindPrivateZoneVpcRequest)

type UnbindPrivateZoneVpcResponse

type UnbindPrivateZoneVpcResponse struct {
	*common.BaseResponse

	RequestId *string `json:"requestId,omitempty"`

	Response struct {
		RequestId string `json:"requestId,omitempty"`
	} `json:"response,omitempty"`
}

func NewUnbindPrivateZoneVpcResponse

func NewUnbindPrivateZoneVpcResponse() (response *UnbindPrivateZoneVpcResponse)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL