DATASOURCE::DNS::DomainRecords

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