1. Registry
  2. Packages
  3. Tencentcloud Provider
  4. API Docs
  5. getAntiddosDdosBlockRecords
Viewing docs for tencentcloud 1.83.38
published on Friday, Oct 23, 2026 by tencentcloudstack
tencentcloud
Viewing docs for tencentcloud 1.83.38
published on Friday, Oct 23, 2026 by tencentcloudstack

    Use this data source to query AntiDDoS DDoS block/unblock records and unblock quota info.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as tencentcloud from "@pulumi/tencentcloud";
    
    const example = tencentcloud.getAntiddosDdosBlockRecords({
        startTime: "2026-02-04T11:30:00+08:00",
        endTime: "2026-03-04T11:30:00+08:00",
        filters: [{
            name: "Status",
            values: ["Blocked"],
        }],
    });
    
    import pulumi
    import pulumi_tencentcloud as tencentcloud
    
    example = tencentcloud.get_antiddos_ddos_block_records(start_time="2026-02-04T11:30:00+08:00",
        end_time="2026-03-04T11:30:00+08:00",
        filters=[{
            "name": "Status",
            "values": ["Blocked"],
        }])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/tencentcloud/tencentcloud"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := tencentcloud.GetAntiddosDdosBlockRecords(ctx, &tencentcloud.GetAntiddosDdosBlockRecordsArgs{
    			StartTime: "2026-02-04T11:30:00+08:00",
    			EndTime:   "2026-03-04T11:30:00+08:00",
    			Filters: []tencentcloud.GetAntiddosDdosBlockRecordsFilter{
    				{
    					Name: "Status",
    					Values: []string{
    						"Blocked",
    					},
    				},
    			},
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Tencentcloud = Pulumi.Tencentcloud;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Tencentcloud.GetAntiddosDdosBlockRecords.Invoke(new()
        {
            StartTime = "2026-02-04T11:30:00+08:00",
            EndTime = "2026-03-04T11:30:00+08:00",
            Filters = new[]
            {
                new Tencentcloud.Inputs.GetAntiddosDdosBlockRecordsFilterInputArgs
                {
                    Name = "Status",
                    Values = new[]
                    {
                        "Blocked",
                    },
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.tencentcloud.TencentcloudFunctions;
    import com.pulumi.tencentcloud.inputs.GetAntiddosDdosBlockRecordsArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var example = TencentcloudFunctions.getAntiddosDdosBlockRecords(GetAntiddosDdosBlockRecordsArgs.builder()
                .startTime("2026-02-04T11:30:00+08:00")
                .endTime("2026-03-04T11:30:00+08:00")
                .filters(GetAntiddosDdosBlockRecordsFilterArgs.builder()
                    .name("Status")
                    .values("Blocked")
                    .build())
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: tencentcloud:getAntiddosDdosBlockRecords
          arguments:
            startTime: 2026-02-04T11:30:00+08:00
            endTime: 2026-03-04T11:30:00+08:00
            filters:
              - name: Status
                values:
                  - Blocked
    
    Example coming soon!
    

    API Reference

    This data source queries the following TencentCloud APIs:

    Using getAntiddosDdosBlockRecords

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getAntiddosDdosBlockRecords(args: GetAntiddosDdosBlockRecordsArgs, opts?: InvokeOptions): Promise<GetAntiddosDdosBlockRecordsResult>
    function getAntiddosDdosBlockRecordsOutput(args: GetAntiddosDdosBlockRecordsOutputArgs, opts?: InvokeOutputOptions): Output<GetAntiddosDdosBlockRecordsResult>
    def get_antiddos_ddos_block_records(end_time: Optional[str] = None,
                                        filters: Optional[Sequence[GetAntiddosDdosBlockRecordsFilter]] = None,
                                        id: Optional[str] = None,
                                        result_output_file: Optional[str] = None,
                                        start_time: Optional[str] = None,
                                        opts: Optional[InvokeOptions] = None) -> GetAntiddosDdosBlockRecordsResult
    def get_antiddos_ddos_block_records_output(end_time: pulumi.Input[Optional[str]] = None,
                                        filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetAntiddosDdosBlockRecordsFilterArgs]]]] = None,
                                        id: pulumi.Input[Optional[str]] = None,
                                        result_output_file: pulumi.Input[Optional[str]] = None,
                                        start_time: pulumi.Input[Optional[str]] = None,
                                        opts: Optional[InvokeOutputOptions] = None) -> Output[GetAntiddosDdosBlockRecordsResult]
    func GetAntiddosDdosBlockRecords(ctx *Context, args *GetAntiddosDdosBlockRecordsArgs, opts ...InvokeOption) (*GetAntiddosDdosBlockRecordsResult, error)
    func GetAntiddosDdosBlockRecordsOutput(ctx *Context, args *GetAntiddosDdosBlockRecordsOutputArgs, opts ...InvokeOption) GetAntiddosDdosBlockRecordsResultOutput

    > Note: This function is named GetAntiddosDdosBlockRecords in the Go SDK.

    public static class GetAntiddosDdosBlockRecords 
    {
        public static Task<GetAntiddosDdosBlockRecordsResult> InvokeAsync(GetAntiddosDdosBlockRecordsArgs args, InvokeOptions? opts = null)
        public static Output<GetAntiddosDdosBlockRecordsResult> Invoke(GetAntiddosDdosBlockRecordsInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetAntiddosDdosBlockRecordsResult> Invoke(GetAntiddosDdosBlockRecordsInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetAntiddosDdosBlockRecordsResult> getAntiddosDdosBlockRecords(GetAntiddosDdosBlockRecordsArgs args, InvokeOptions options)
    public static Output<GetAntiddosDdosBlockRecordsResult> getAntiddosDdosBlockRecords(GetAntiddosDdosBlockRecordsArgs args, InvokeOptions options)
    public static Output<GetAntiddosDdosBlockRecordsResult> getAntiddosDdosBlockRecords(GetAntiddosDdosBlockRecordsArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: tencentcloud:index/getAntiddosDdosBlockRecords:getAntiddosDdosBlockRecords
      arguments:
        # arguments dictionary
    data "tencentcloud_get_antiddos_ddos_block_records" "name" {
        # arguments
    }

    The following arguments are supported:

    EndTime string
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    StartTime string
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    Filters List<GetAntiddosDdosBlockRecordsFilter>
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    Id string
    ResultOutputFile string
    Used to save results.
    EndTime string
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    StartTime string
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    Filters []GetAntiddosDdosBlockRecordsFilter
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    Id string
    ResultOutputFile string
    Used to save results.
    end_time string
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    start_time string
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    filters list(object)
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    id string
    result_output_file string
    Used to save results.
    endTime String
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    startTime String
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    filters List<GetAntiddosDdosBlockRecordsFilter>
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    id String
    resultOutputFile String
    Used to save results.
    endTime string
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    startTime string
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    filters GetAntiddosDdosBlockRecordsFilter[]
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    id string
    resultOutputFile string
    Used to save results.
    end_time str
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    start_time str
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    filters Sequence[GetAntiddosDdosBlockRecordsFilter]
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    id str
    result_output_file str
    Used to save results.
    endTime String
    Query end time. (EndTime - StartTime) must be <= 31 days. Parameter format: 2026-03-04T11:30:00+08:00.
    startTime String
    Query start time. Parameter format: 2026-02-04T11:30:00+08:00.
    filters List<Property Map>
    Filter conditions. The upper limit of Filters.Values is 20. If not filled in, it returns the list of all blocked resources under the current appid.

    • Resource: filter by blocked IP or resource six-segment style.
    • Status: filter by block status (Blocked/Unblocking/Unblocked).
    id String
    resultOutputFile String
    Used to save results.

    getAntiddosDdosBlockRecords Result

    The following output properties are available:

    Supporting Types

    GetAntiddosDdosBlockRecordsBlockRecord

    BlockTime string
    Block time.
    Resource string
    Blocked resource, public network IP.
    Status string
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    BlockTime string
    Block time.
    Resource string
    Blocked resource, public network IP.
    Status string
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    block_time string
    Block time.
    resource string
    Blocked resource, public network IP.
    status string
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    blockTime String
    Block time.
    resource String
    Blocked resource, public network IP.
    status String
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    blockTime string
    Block time.
    resource string
    Blocked resource, public network IP.
    status string
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    block_time str
    Block time.
    resource str
    Blocked resource, public network IP.
    status str
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.
    blockTime String
    Block time.
    resource String
    Blocked resource, public network IP.
    status String
    Block/unblock status. Enum: Blocked, Unblocking, Unblocked.

    GetAntiddosDdosBlockRecordsFilter

    Name string
    Filter field name. Supported: Resource, Status.
    Values List<string>
    Filter field value.
    Name string
    Filter field name. Supported: Resource, Status.
    Values []string
    Filter field value.
    name string
    Filter field name. Supported: Resource, Status.
    values list(string)
    Filter field value.
    name String
    Filter field name. Supported: Resource, Status.
    values List<String>
    Filter field value.
    name string
    Filter field name. Supported: Resource, Status.
    values string[]
    Filter field value.
    name str
    Filter field name. Supported: Resource, Status.
    values Sequence[str]
    Filter field value.
    name String
    Filter field name. Supported: Resource, Status.
    values List<String>
    Filter field value.

    GetAntiddosDdosBlockRecordsUnblockQuotaInfo

    QuotaEndTime string
    Quota effective end time.
    QuotaStartTime string
    Quota effective start time.
    TotalQuota double
    Total unblock quota.
    UsedQuota double
    Used unblock quota.
    QuotaEndTime string
    Quota effective end time.
    QuotaStartTime string
    Quota effective start time.
    TotalQuota float64
    Total unblock quota.
    UsedQuota float64
    Used unblock quota.
    quota_end_time string
    Quota effective end time.
    quota_start_time string
    Quota effective start time.
    total_quota number
    Total unblock quota.
    used_quota number
    Used unblock quota.
    quotaEndTime String
    Quota effective end time.
    quotaStartTime String
    Quota effective start time.
    totalQuota Double
    Total unblock quota.
    usedQuota Double
    Used unblock quota.
    quotaEndTime string
    Quota effective end time.
    quotaStartTime string
    Quota effective start time.
    totalQuota number
    Total unblock quota.
    usedQuota number
    Used unblock quota.
    quota_end_time str
    Quota effective end time.
    quota_start_time str
    Quota effective start time.
    total_quota float
    Total unblock quota.
    used_quota float
    Used unblock quota.
    quotaEndTime String
    Quota effective end time.
    quotaStartTime String
    Quota effective start time.
    totalQuota Number
    Total unblock quota.
    usedQuota Number
    Used unblock quota.

    Package Details

    Repository
    tencentcloud tencentcloudstack/terraform-provider-tencentcloud
    License
    Notes
    This Pulumi package is based on the tencentcloud Terraform Provider.
    tencentcloud
    Viewing docs for tencentcloud 1.83.38
    published on Friday, Oct 23, 2026 by tencentcloudstack

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial