1. Packages
  2. Bytepluscc Provider
  3. API Docs
  4. fwcenter
  5. DnsControlPolicy
bytepluscc v0.0.11 published on Wednesday, Jan 21, 2026 by Byteplus
bytepluscc logo
bytepluscc v0.0.11 published on Wednesday, Jan 21, 2026 by Byteplus

    域名黑名单访问控制策略。

    Example Usage

    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    Example coming soon!
    
    resources:
      fWCenterDnsControlPolicyDemo:
        type: bytepluscc:fwcenter:DnsControlPolicy
        name: FWCenterDnsControlPolicyDemo
        properties:
          description: FWCenterDnsControlPolicyDemo test
          destination: www.xxxx.com
          destinationType: domain
          internetFirewallId: ifw-yebxxxxx0iac7gxxxxx
          sources:
            - region: ap-southeast-1
              vpc_id: vpc-3rehw4xxxxk2ixxxxx
    

    Create DnsControlPolicy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DnsControlPolicy(name: string, args: DnsControlPolicyArgs, opts?: CustomResourceOptions);
    @overload
    def DnsControlPolicy(resource_name: str,
                         args: DnsControlPolicyArgs,
                         opts: Optional[ResourceOptions] = None)
    
    @overload
    def DnsControlPolicy(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         destination: Optional[str] = None,
                         destination_type: Optional[str] = None,
                         description: Optional[str] = None,
                         internet_firewall_id: Optional[str] = None,
                         sources: Optional[Sequence[DnsControlPolicySourceArgs]] = None,
                         status: Optional[bool] = None)
    func NewDnsControlPolicy(ctx *Context, name string, args DnsControlPolicyArgs, opts ...ResourceOption) (*DnsControlPolicy, error)
    public DnsControlPolicy(string name, DnsControlPolicyArgs args, CustomResourceOptions? opts = null)
    public DnsControlPolicy(String name, DnsControlPolicyArgs args)
    public DnsControlPolicy(String name, DnsControlPolicyArgs args, CustomResourceOptions options)
    
    type: bytepluscc:fwcenter:DnsControlPolicy
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args DnsControlPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DnsControlPolicyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DnsControlPolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DnsControlPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DnsControlPolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var dnsControlPolicyResource = new Bytepluscc.Fwcenter.DnsControlPolicy("dnsControlPolicyResource", new()
    {
        Destination = "string",
        DestinationType = "string",
        Description = "string",
        InternetFirewallId = "string",
        Sources = new[]
        {
            new Bytepluscc.Fwcenter.Inputs.DnsControlPolicySourceArgs
            {
                Region = "string",
                VpcId = "string",
            },
        },
        Status = false,
    });
    
    example, err := fwcenter.NewDnsControlPolicy(ctx, "dnsControlPolicyResource", &fwcenter.DnsControlPolicyArgs{
    	Destination:        pulumi.String("string"),
    	DestinationType:    pulumi.String("string"),
    	Description:        pulumi.String("string"),
    	InternetFirewallId: pulumi.String("string"),
    	Sources: fwcenter.DnsControlPolicySourceArray{
    		&fwcenter.DnsControlPolicySourceArgs{
    			Region: pulumi.String("string"),
    			VpcId:  pulumi.String("string"),
    		},
    	},
    	Status: pulumi.Bool(false),
    })
    
    var dnsControlPolicyResource = new DnsControlPolicy("dnsControlPolicyResource", DnsControlPolicyArgs.builder()
        .destination("string")
        .destinationType("string")
        .description("string")
        .internetFirewallId("string")
        .sources(DnsControlPolicySourceArgs.builder()
            .region("string")
            .vpcId("string")
            .build())
        .status(false)
        .build());
    
    dns_control_policy_resource = bytepluscc.fwcenter.DnsControlPolicy("dnsControlPolicyResource",
        destination="string",
        destination_type="string",
        description="string",
        internet_firewall_id="string",
        sources=[{
            "region": "string",
            "vpc_id": "string",
        }],
        status=False)
    
    const dnsControlPolicyResource = new bytepluscc.fwcenter.DnsControlPolicy("dnsControlPolicyResource", {
        destination: "string",
        destinationType: "string",
        description: "string",
        internetFirewallId: "string",
        sources: [{
            region: "string",
            vpcId: "string",
        }],
        status: false,
    });
    
    type: bytepluscc:fwcenter:DnsControlPolicy
    properties:
        description: string
        destination: string
        destinationType: string
        internetFirewallId: string
        sources:
            - region: string
              vpcId: string
        status: false
    

    DnsControlPolicy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The DnsControlPolicy resource accepts the following input properties:

    Destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    DestinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    Description string
    策略的描述信息。
    InternetFirewallId string
    互联网边界防火墙实例ID。
    Sources List<Byteplus.DnsControlPolicySource>
    Status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    Destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    DestinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    Description string
    策略的描述信息。
    InternetFirewallId string
    互联网边界防火墙实例ID。
    Sources []DnsControlPolicySourceArgs
    Status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    destination String
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationType String
    访问目的的类型。domain:域名;group:域名地址簿。
    description String
    策略的描述信息。
    internetFirewallId String
    互联网边界防火墙实例ID。
    sources List<DnsControlPolicySource>
    status Boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    description string
    策略的描述信息。
    internetFirewallId string
    互联网边界防火墙实例ID。
    sources DnsControlPolicySource[]
    status boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    destination str
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destination_type str
    访问目的的类型。domain:域名;group:域名地址簿。
    description str
    策略的描述信息。
    internet_firewall_id str
    互联网边界防火墙实例ID。
    sources Sequence[DnsControlPolicySourceArgs]
    status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    destination String
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationType String
    访问目的的类型。domain:域名;group:域名地址簿。
    description String
    策略的描述信息。
    internetFirewallId String
    互联网边界防火墙实例ID。
    sources List<Property Map>
    status Boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DnsControlPolicy resource produces the following output properties:

    AccountId string
    用户的唯一标识ID。
    DestinationGroupLists List<string>
    域名地址簿名称列表。
    DomainListV1s List<Byteplus.DnsControlPolicyDomainListV1>
    DomainLists List<string>
    域名列表。
    HitCnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    Id string
    The provider-assigned unique ID for this managed resource.
    LastHitTime int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    RuleId string
    访问控制策略的唯一标识ID。
    UseCount int
    该域名黑名单访问控制策略占用的策略数量。
    AccountId string
    用户的唯一标识ID。
    DestinationGroupLists []string
    域名地址簿名称列表。
    DomainListV1s []DnsControlPolicyDomainListV1
    DomainLists []string
    域名列表。
    HitCnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    Id string
    The provider-assigned unique ID for this managed resource.
    LastHitTime int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    RuleId string
    访问控制策略的唯一标识ID。
    UseCount int
    该域名黑名单访问控制策略占用的策略数量。
    accountId String
    用户的唯一标识ID。
    destinationGroupLists List<String>
    域名地址簿名称列表。
    domainListV1s List<DnsControlPolicyDomainListV1>
    domainLists List<String>
    域名列表。
    hitCnt Integer
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    id String
    The provider-assigned unique ID for this managed resource.
    lastHitTime Integer
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId String
    访问控制策略的唯一标识ID。
    useCount Integer
    该域名黑名单访问控制策略占用的策略数量。
    accountId string
    用户的唯一标识ID。
    destinationGroupLists string[]
    域名地址簿名称列表。
    domainListV1s DnsControlPolicyDomainListV1[]
    domainLists string[]
    域名列表。
    hitCnt number
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    id string
    The provider-assigned unique ID for this managed resource.
    lastHitTime number
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId string
    访问控制策略的唯一标识ID。
    useCount number
    该域名黑名单访问控制策略占用的策略数量。
    account_id str
    用户的唯一标识ID。
    destination_group_lists Sequence[str]
    域名地址簿名称列表。
    domain_list_v1s Sequence[DnsControlPolicyDomainListV1]
    domain_lists Sequence[str]
    域名列表。
    hit_cnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    id str
    The provider-assigned unique ID for this managed resource.
    last_hit_time int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    rule_id str
    访问控制策略的唯一标识ID。
    use_count int
    该域名黑名单访问控制策略占用的策略数量。
    accountId String
    用户的唯一标识ID。
    destinationGroupLists List<String>
    域名地址簿名称列表。
    domainListV1s List<Property Map>
    domainLists List<String>
    域名列表。
    hitCnt Number
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    id String
    The provider-assigned unique ID for this managed resource.
    lastHitTime Number
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId String
    访问控制策略的唯一标识ID。
    useCount Number
    该域名黑名单访问控制策略占用的策略数量。

    Look up Existing DnsControlPolicy Resource

    Get an existing DnsControlPolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: DnsControlPolicyState, opts?: CustomResourceOptions): DnsControlPolicy
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            account_id: Optional[str] = None,
            description: Optional[str] = None,
            destination: Optional[str] = None,
            destination_group_lists: Optional[Sequence[str]] = None,
            destination_type: Optional[str] = None,
            domain_list_v1s: Optional[Sequence[DnsControlPolicyDomainListV1Args]] = None,
            domain_lists: Optional[Sequence[str]] = None,
            hit_cnt: Optional[int] = None,
            internet_firewall_id: Optional[str] = None,
            last_hit_time: Optional[int] = None,
            rule_id: Optional[str] = None,
            sources: Optional[Sequence[DnsControlPolicySourceArgs]] = None,
            status: Optional[bool] = None,
            use_count: Optional[int] = None) -> DnsControlPolicy
    func GetDnsControlPolicy(ctx *Context, name string, id IDInput, state *DnsControlPolicyState, opts ...ResourceOption) (*DnsControlPolicy, error)
    public static DnsControlPolicy Get(string name, Input<string> id, DnsControlPolicyState? state, CustomResourceOptions? opts = null)
    public static DnsControlPolicy get(String name, Output<String> id, DnsControlPolicyState state, CustomResourceOptions options)
    resources:  _:    type: bytepluscc:fwcenter:DnsControlPolicy    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId string
    用户的唯一标识ID。
    Description string
    策略的描述信息。
    Destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    DestinationGroupLists List<string>
    域名地址簿名称列表。
    DestinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    DomainListV1s List<Byteplus.DnsControlPolicyDomainListV1>
    DomainLists List<string>
    域名列表。
    HitCnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    InternetFirewallId string
    互联网边界防火墙实例ID。
    LastHitTime int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    RuleId string
    访问控制策略的唯一标识ID。
    Sources List<Byteplus.DnsControlPolicySource>
    Status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    UseCount int
    该域名黑名单访问控制策略占用的策略数量。
    AccountId string
    用户的唯一标识ID。
    Description string
    策略的描述信息。
    Destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    DestinationGroupLists []string
    域名地址簿名称列表。
    DestinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    DomainListV1s []DnsControlPolicyDomainListV1Args
    DomainLists []string
    域名列表。
    HitCnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    InternetFirewallId string
    互联网边界防火墙实例ID。
    LastHitTime int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    RuleId string
    访问控制策略的唯一标识ID。
    Sources []DnsControlPolicySourceArgs
    Status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    UseCount int
    该域名黑名单访问控制策略占用的策略数量。
    accountId String
    用户的唯一标识ID。
    description String
    策略的描述信息。
    destination String
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationGroupLists List<String>
    域名地址簿名称列表。
    destinationType String
    访问目的的类型。domain:域名;group:域名地址簿。
    domainListV1s List<DnsControlPolicyDomainListV1>
    domainLists List<String>
    域名列表。
    hitCnt Integer
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    internetFirewallId String
    互联网边界防火墙实例ID。
    lastHitTime Integer
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId String
    访问控制策略的唯一标识ID。
    sources List<DnsControlPolicySource>
    status Boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    useCount Integer
    该域名黑名单访问控制策略占用的策略数量。
    accountId string
    用户的唯一标识ID。
    description string
    策略的描述信息。
    destination string
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationGroupLists string[]
    域名地址簿名称列表。
    destinationType string
    访问目的的类型。domain:域名;group:域名地址簿。
    domainListV1s DnsControlPolicyDomainListV1[]
    domainLists string[]
    域名列表。
    hitCnt number
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    internetFirewallId string
    互联网边界防火墙实例ID。
    lastHitTime number
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId string
    访问控制策略的唯一标识ID。
    sources DnsControlPolicySource[]
    status boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    useCount number
    该域名黑名单访问控制策略占用的策略数量。
    account_id str
    用户的唯一标识ID。
    description str
    策略的描述信息。
    destination str
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destination_group_lists Sequence[str]
    域名地址簿名称列表。
    destination_type str
    访问目的的类型。domain:域名;group:域名地址簿。
    domain_list_v1s Sequence[DnsControlPolicyDomainListV1Args]
    domain_lists Sequence[str]
    域名列表。
    hit_cnt int
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    internet_firewall_id str
    互联网边界防火墙实例ID。
    last_hit_time int
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    rule_id str
    访问控制策略的唯一标识ID。
    sources Sequence[DnsControlPolicySourceArgs]
    status bool
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    use_count int
    该域名黑名单访问控制策略占用的策略数量。
    accountId String
    用户的唯一标识ID。
    description String
    策略的描述信息。
    destination String
    访问目的,可以是域名或域名地址簿的唯一标识ID。当前仅支持一个地址簿。
    destinationGroupLists List<String>
    域名地址簿名称列表。
    destinationType String
    访问目的的类型。domain:域名;group:域名地址簿。
    domainListV1s List<Property Map>
    domainLists List<String>
    域名列表。
    hitCnt Number
    命中计数,表示该域名黑名单访问控制策略被触发的次数。
    internetFirewallId String
    互联网边界防火墙实例ID。
    lastHitTime Number
    最近命中时间戳,表示该域名黑名单访问控制策略最后一次被触发的时间。
    ruleId String
    访问控制策略的唯一标识ID。
    sources List<Property Map>
    status Boolean
    域名黑名单访问控制策略的开关状态。false:关闭;true:开启。
    useCount Number
    该域名黑名单访问控制策略占用的策略数量。

    Supporting Types

    DnsControlPolicyDomainListV1, DnsControlPolicyDomainListV1Args

    Address string
    具体地址信息。
    Description string
    描述信息。
    Type string
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。
    Address string
    具体地址信息。
    Description string
    描述信息。
    Type string
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。
    address String
    具体地址信息。
    description String
    描述信息。
    type String
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。
    address string
    具体地址信息。
    description string
    描述信息。
    type string
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。
    address str
    具体地址信息。
    description str
    描述信息。
    type str
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。
    address String
    具体地址信息。
    description String
    描述信息。
    type String
    地址类型。支持的取值如下所示。ip:IPv4 地址;ipv6:IPv6 地址;domain:域名;port:端口。

    DnsControlPolicySource, DnsControlPolicySourceArgs

    Region string
    VPC地域信息。
    VpcId string
    VPC ID。
    Region string
    VPC地域信息。
    VpcId string
    VPC ID。
    region String
    VPC地域信息。
    vpcId String
    VPC ID。
    region string
    VPC地域信息。
    vpcId string
    VPC ID。
    region str
    VPC地域信息。
    vpc_id str
    VPC ID。
    region String
    VPC地域信息。
    vpcId String
    VPC ID。

    Import

    $ pulumi import bytepluscc:fwcenter/dnsControlPolicy:DnsControlPolicy example "rule_id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    bytepluscc byteplus-sdk/pulumi-bytepluscc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the bytepluscc Terraform Provider.
    bytepluscc logo
    bytepluscc v0.0.11 published on Wednesday, Jan 21, 2026 by Byteplus
      Meet Neo: Your AI Platform Teammate