DATASOURCE::DNS::DomainRecords

更新时间:
复制 MD 格式

DATASOURCE::DNS::DomainRecords类型用于解析记录列表。

语法

{
  "Type": "DATASOURCE::DNS::DomainRecords",
  "Properties": {
    "Status": String,
    "OrderBy": String,
    "RRKeyWord": String,
    "DomainName": String,
    "TypeKeyWord": String,
    "Lang": String,
    "Direction": String,
    "GroupId": String,
    "Line": String,
    "Type": String,
    "ValueKeyWord": String,
    "KeyWord": String,
    "SearchMode": String,
    "RefreshOptions": String
  }
}

属性

属性名称

类型

必须

允许更新

描述

约束

Status

String

否

是

解析记录状态。

取值:

  • Enable:可用。

  • Disable:不可用。

OrderBy

String

否

是

排序方式。

按照解析添加的时间从新到旧排序。

RRKeyWord

String

否

是

主机记录的关键字。

按照RRKeyWord(前后模糊匹配)模式搜索,不区分大小写。

DomainName

String

是

是

域名名称。

无

TypeKeyWord

String

否

是

解析类型的关键字。

按照全匹配搜索,不区分大小写。

Lang

String

否

是

语言。

无

Direction

String

否

是

排序方向。

取值:

  • DESC:倒序。

  • ASC:正序。

GroupId

String

否

是

域名分组ID。

无

Line

String

否

是

解析线路。

默认值:default。

关于取值的更多信息,请参见解析线路枚举。

Type

String

否

是

解析记录类型。

关于取值的更多信息,请参见解析记录类型格式。

ValueKeyWord

String

否

是

记录值的关键字。

按照ValueKeyWord(前后模糊匹配)模式搜索,不区分大小写。

KeyWord

String

否

是

关键字。

按照全匹配搜索,不区分大小写。

SearchMode

String

否

是

搜索模式。

取值:

  • LIKE:请使用KeyWord参数(传入RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、Status参数无效)。

  • EXACT:请使用KeyWord参数(传入RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、Status参数无效)。

  • ADVANCED:请使用RRKeyWord、TypeKeyWord、ValueKeyWord、Type、Line、Status参数。

说明

如果不设置该参数。

  • keyWord传值,搜索模式取LIKE值。

  • keyWord不传值,RRKeyWord和ValueKeyWord支持模糊查询,TypeKeyWord和Type、Line、Status支持精确查询。

RefreshOptions

String

否

是

当资源栈更新时,数据源资源的刷新策略。

取值:

  • Never(默认值):更新堆栈时,从不刷新数据源资源。

  • Always:更新堆栈时,始终刷新数据源资源。

返回数据(Fn::GetAtt)

  • DomainRecordIds:解析记录ID列表。

  • DomainRecords:解析记录列表。

属性名称

类型

描述

约束

DomainRecordIds

List

解析记录ID列表。

无

DomainRecords

List

解析记录列表。

无

DomainName

String

域名名称。

无

Line

String

解析线路。

无

RecordId

String

解析记录ID。

无

Locked

Boolean

当前解析记录锁定状态。

无

Priority

Number

MX记录的优先级。

无

RR

String

主机记录。

无

Remark

String

备注。

无

Status

String

当前的解析记录状态。

无

TTL

Number

生存时间。

无

Type

String

记录类型。

无

Value

String

记录值。

无

Weight

Integer

负载均衡权重。

无

示例

JSON格式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DomainName": {
      "Type": "String",
      "Description": "The domain name for which you want to query DNS records."
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::DNS::DomainRecords",
      "Properties": {
        "DomainName": {
          "Ref": "DomainName"
        }
      }
    }
  },
  "Outputs": {
    "DomainRecordIds": {
      "Description": "The list of The DNS domain record ids.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DomainRecordIds"
        ]
      }
    },
    "DomainRecords": {
      "Description": "The information about DNS records.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DomainRecords"
        ]
      }
    }
  }
}

YAML格式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DomainName:
    Type: String
    Description: The domain name for which you want to query DNS records.
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::DNS::DomainRecords
    Properties:
      DomainName:
        Ref: DomainName
Outputs:
  DomainRecordIds:
    Description: The list of The DNS domain record ids.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DomainRecordIds
  DomainRecords:
    Description: The information about DNS records.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DomainRecords