1. Packages
  2. Volcengine
  3. API Docs
  4. vpc
  5. getSubnets
Volcengine v0.0.38 published on Friday, Oct 31, 2025 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

volcengine.vpc.getSubnets

volcengine logo
Volcengine v0.0.38 published on Friday, Oct 31, 2025 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

    Use this data source to query detailed information of subnets

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as volcengine from "@pulumi/volcengine";

const default = volcengine.vpc.getSubnets({
    ids: ["subnet-274zsa5kfmj287fap8soo5e19"],
});

    import pulumi
import pulumi_volcengine as volcengine

default = volcengine.vpc.get_subnets(ids=["subnet-274zsa5kfmj287fap8soo5e19"])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/vpc"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vpc.GetSubnets(ctx, &vpc.GetSubnetsArgs{
			Ids: []string{
				"subnet-274zsa5kfmj287fap8soo5e19",
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcengine = Pulumi.Volcengine;

return await Deployment.RunAsync(() => 
{
    var @default = Volcengine.Vpc.GetSubnets.Invoke(new()
    {
        Ids = new[]
        {
            "subnet-274zsa5kfmj287fap8soo5e19",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.volcengine.vpc.VpcFunctions;
import com.pulumi.volcengine.vpc.inputs.GetSubnetsArgs;
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 default = VpcFunctions.getSubnets(GetSubnetsArgs.builder()
            .ids("subnet-274zsa5kfmj287fap8soo5e19")
            .build());

    }
}

    variables:
  default:
    fn::invoke:
      Function: volcengine:vpc:getSubnets
      Arguments:
        ids:
          - subnet-274zsa5kfmj287fap8soo5e19

    Using getSubnets

    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 getSubnets(args: GetSubnetsArgs, opts?: InvokeOptions): Promise<GetSubnetsResult>
function getSubnetsOutput(args: GetSubnetsOutputArgs, opts?: InvokeOptions): Output<GetSubnetsResult>
    def get_subnets(ids: Optional[Sequence[str]] = None,
                name_regex: Optional[str] = None,
                output_file: Optional[str] = None,
                route_table_id: Optional[str] = None,
                subnet_name: Optional[str] = None,
                subnet_owner_id: Optional[int] = None,
                tags: Optional[Sequence[GetSubnetsTag]] = None,
                vpc_id: Optional[str] = None,
                zone_id: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetSubnetsResult
def get_subnets_output(ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                name_regex: Optional[pulumi.Input[str]] = None,
                output_file: Optional[pulumi.Input[str]] = None,
                route_table_id: Optional[pulumi.Input[str]] = None,
                subnet_name: Optional[pulumi.Input[str]] = None,
                subnet_owner_id: Optional[pulumi.Input[int]] = None,
                tags: Optional[pulumi.Input[Sequence[pulumi.Input[GetSubnetsTagArgs]]]] = None,
                vpc_id: Optional[pulumi.Input[str]] = None,
                zone_id: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetSubnetsResult]
    func GetSubnets(ctx *Context, args *GetSubnetsArgs, opts ...InvokeOption) (*GetSubnetsResult, error)
func GetSubnetsOutput(ctx *Context, args *GetSubnetsOutputArgs, opts ...InvokeOption) GetSubnetsResultOutput

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

    public static class GetSubnets 
{
    public static Task<GetSubnetsResult> InvokeAsync(GetSubnetsArgs args, InvokeOptions? opts = null)
    public static Output<GetSubnetsResult> Invoke(GetSubnetsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetSubnetsResult> getSubnets(GetSubnetsArgs args, InvokeOptions options)
public static Output<GetSubnetsResult> getSubnets(GetSubnetsArgs args, InvokeOptions options)

    fn::invoke:
  function: volcengine:vpc/getSubnets:getSubnets
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Ids List<string>
    A list of Subnet IDs.
    NameRegex string
    A Name Regex of Subnet.
    OutputFile string
    File name where to save data source results.
    RouteTableId string
    The ID of route table which subnet associated with.
    SubnetName string
    The subnet name to query.
    SubnetOwnerId int
    The owner ID of the subnet.
    Tags List<GetSubnetsTag>
    Tags.
    VpcId string
    The ID of VPC which subnet belongs to.
    ZoneId string
    The ID of zone which subnet belongs to.
    Ids []string
    A list of Subnet IDs.
    NameRegex string
    A Name Regex of Subnet.
    OutputFile string
    File name where to save data source results.
    RouteTableId string
    The ID of route table which subnet associated with.
    SubnetName string
    The subnet name to query.
    SubnetOwnerId int
    The owner ID of the subnet.
    Tags []GetSubnetsTag
    Tags.
    VpcId string
    The ID of VPC which subnet belongs to.
    ZoneId string
    The ID of zone which subnet belongs to.
    ids List<String>
    A list of Subnet IDs.
    nameRegex String
    A Name Regex of Subnet.
    outputFile String
    File name where to save data source results.
    routeTableId String
    The ID of route table which subnet associated with.
    subnetName String
    The subnet name to query.
    subnetOwnerId Integer
    The owner ID of the subnet.
    tags List<GetSubnetsTag>
    Tags.
    vpcId String
    The ID of VPC which subnet belongs to.
    zoneId String
    The ID of zone which subnet belongs to.
    ids string[]
    A list of Subnet IDs.
    nameRegex string
    A Name Regex of Subnet.
    outputFile string
    File name where to save data source results.
    routeTableId string
    The ID of route table which subnet associated with.
    subnetName string
    The subnet name to query.
    subnetOwnerId number
    The owner ID of the subnet.
    tags GetSubnetsTag[]
    Tags.
    vpcId string
    The ID of VPC which subnet belongs to.
    zoneId string
    The ID of zone which subnet belongs to.
    ids Sequence[str]
    A list of Subnet IDs.
    name_regex str
    A Name Regex of Subnet.
    output_file str
    File name where to save data source results.
    route_table_id str
    The ID of route table which subnet associated with.
    subnet_name str
    The subnet name to query.
    subnet_owner_id int
    The owner ID of the subnet.
    tags Sequence[GetSubnetsTag]
    Tags.
    vpc_id str
    The ID of VPC which subnet belongs to.
    zone_id str
    The ID of zone which subnet belongs to.
    ids List<String>
    A list of Subnet IDs.
    nameRegex String
    A Name Regex of Subnet.
    outputFile String
    File name where to save data source results.
    routeTableId String
    The ID of route table which subnet associated with.
    subnetName String
    The subnet name to query.
    subnetOwnerId Number
    The owner ID of the subnet.
    tags List<Property Map>
    Tags.
    vpcId String
    The ID of VPC which subnet belongs to.
    zoneId String
    The ID of zone which subnet belongs to.

    getSubnets Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Subnets List<GetSubnetsSubnet>
    The collection of Subnet query.
    TotalCount int
    The total count of Subnet query.
    Ids List<string>
    NameRegex string
    OutputFile string
    RouteTableId string
    The route table ID.
    SubnetName string
    The Name of Subnet.
    SubnetOwnerId int
    Tags List<GetSubnetsTag>
    Tags.
    VpcId string
    The Vpc ID of Subnet.
    ZoneId string
    The ID of Zone.
    Id string
    The provider-assigned unique ID for this managed resource.
    Subnets []GetSubnetsSubnet
    The collection of Subnet query.
    TotalCount int
    The total count of Subnet query.
    Ids []string
    NameRegex string
    OutputFile string
    RouteTableId string
    The route table ID.
    SubnetName string
    The Name of Subnet.
    SubnetOwnerId int
    Tags []GetSubnetsTag
    Tags.
    VpcId string
    The Vpc ID of Subnet.
    ZoneId string
    The ID of Zone.
    id String
    The provider-assigned unique ID for this managed resource.
    subnets List<GetSubnetsSubnet>
    The collection of Subnet query.
    totalCount Integer
    The total count of Subnet query.
    ids List<String>
    nameRegex String
    outputFile String
    routeTableId String
    The route table ID.
    subnetName String
    The Name of Subnet.
    subnetOwnerId Integer
    tags List<GetSubnetsTag>
    Tags.
    vpcId String
    The Vpc ID of Subnet.
    zoneId String
    The ID of Zone.
    id string
    The provider-assigned unique ID for this managed resource.
    subnets GetSubnetsSubnet[]
    The collection of Subnet query.
    totalCount number
    The total count of Subnet query.
    ids string[]
    nameRegex string
    outputFile string
    routeTableId string
    The route table ID.
    subnetName string
    The Name of Subnet.
    subnetOwnerId number
    tags GetSubnetsTag[]
    Tags.
    vpcId string
    The Vpc ID of Subnet.
    zoneId string
    The ID of Zone.
    id str
    The provider-assigned unique ID for this managed resource.
    subnets Sequence[GetSubnetsSubnet]
    The collection of Subnet query.
    total_count int
    The total count of Subnet query.
    ids Sequence[str]
    name_regex str
    output_file str
    route_table_id str
    The route table ID.
    subnet_name str
    The Name of Subnet.
    subnet_owner_id int
    tags Sequence[GetSubnetsTag]
    Tags.
    vpc_id str
    The Vpc ID of Subnet.
    zone_id str
    The ID of Zone.
    id String
    The provider-assigned unique ID for this managed resource.
    subnets List<Property Map>
    The collection of Subnet query.
    totalCount Number
    The total count of Subnet query.
    ids List<String>
    nameRegex String
    outputFile String
    routeTableId String
    The route table ID.
    subnetName String
    The Name of Subnet.
    subnetOwnerId Number
    tags List<Property Map>
    Tags.
    vpcId String
    The Vpc ID of Subnet.
    zoneId String
    The ID of Zone.

    Supporting Types

    GetSubnetsSubnet

    AccountId string
    The account ID which the subnet belongs to.
    AvailableIpAddressCount int
    The count of available ip address.
    CidrBlock string
    The cidr block of Subnet.
    CreationTime string
    Creation time of Subnet.
    Description string
    The description of Subnet.
    Id string
    The ID of Subnet.
    Ipv6CidrBlock string
    The IPv6 CIDR block of the VPC.
    NetworkAclId string
    The ID of network acl which this subnet associate with.
    RouteTable GetSubnetsSubnetRouteTable
    The route table information.
    RouteTableId string
    The ID of route table which subnet associated with.
    RouteTableType string
    The route table type.
    Status string
    The Status of Subnet.
    SubnetName string
    The subnet name to query.
    Tags List<GetSubnetsSubnetTag>
    Tags.
    TotalIpv4Count int
    The Count of ipv4.
    UpdateTime string
    Update time of Subnet.
    VpcId string
    The ID of VPC which subnet belongs to.
    ZoneId string
    The ID of zone which subnet belongs to.
    AccountId string
    The account ID which the subnet belongs to.
    AvailableIpAddressCount int
    The count of available ip address.
    CidrBlock string
    The cidr block of Subnet.
    CreationTime string
    Creation time of Subnet.
    Description string
    The description of Subnet.
    Id string
    The ID of Subnet.
    Ipv6CidrBlock string
    The IPv6 CIDR block of the VPC.
    NetworkAclId string
    The ID of network acl which this subnet associate with.
    RouteTable GetSubnetsSubnetRouteTable
    The route table information.
    RouteTableId string
    The ID of route table which subnet associated with.
    RouteTableType string
    The route table type.
    Status string
    The Status of Subnet.
    SubnetName string
    The subnet name to query.
    Tags []GetSubnetsSubnetTag
    Tags.
    TotalIpv4Count int
    The Count of ipv4.
    UpdateTime string
    Update time of Subnet.
    VpcId string
    The ID of VPC which subnet belongs to.
    ZoneId string
    The ID of zone which subnet belongs to.
    accountId String
    The account ID which the subnet belongs to.
    availableIpAddressCount Integer
    The count of available ip address.
    cidrBlock String
    The cidr block of Subnet.
    creationTime String
    Creation time of Subnet.
    description String
    The description of Subnet.
    id String
    The ID of Subnet.
    ipv6CidrBlock String
    The IPv6 CIDR block of the VPC.
    networkAclId String
    The ID of network acl which this subnet associate with.
    routeTable GetSubnetsSubnetRouteTable
    The route table information.
    routeTableId String
    The ID of route table which subnet associated with.
    routeTableType String
    The route table type.
    status String
    The Status of Subnet.
    subnetName String
    The subnet name to query.
    tags List<GetSubnetsSubnetTag>
    Tags.
    totalIpv4Count Integer
    The Count of ipv4.
    updateTime String
    Update time of Subnet.
    vpcId String
    The ID of VPC which subnet belongs to.
    zoneId String
    The ID of zone which subnet belongs to.
    accountId string
    The account ID which the subnet belongs to.
    availableIpAddressCount number
    The count of available ip address.
    cidrBlock string
    The cidr block of Subnet.
    creationTime string
    Creation time of Subnet.
    description string
    The description of Subnet.
    id string
    The ID of Subnet.
    ipv6CidrBlock string
    The IPv6 CIDR block of the VPC.
    networkAclId string
    The ID of network acl which this subnet associate with.
    routeTable GetSubnetsSubnetRouteTable
    The route table information.
    routeTableId string
    The ID of route table which subnet associated with.
    routeTableType string
    The route table type.
    status string
    The Status of Subnet.
    subnetName string
    The subnet name to query.
    tags GetSubnetsSubnetTag[]
    Tags.
    totalIpv4Count number
    The Count of ipv4.
    updateTime string
    Update time of Subnet.
    vpcId string
    The ID of VPC which subnet belongs to.
    zoneId string
    The ID of zone which subnet belongs to.
    account_id str
    The account ID which the subnet belongs to.
    available_ip_address_count int
    The count of available ip address.
    cidr_block str
    The cidr block of Subnet.
    creation_time str
    Creation time of Subnet.
    description str
    The description of Subnet.
    id str
    The ID of Subnet.
    ipv6_cidr_block str
    The IPv6 CIDR block of the VPC.
    network_acl_id str
    The ID of network acl which this subnet associate with.
    route_table GetSubnetsSubnetRouteTable
    The route table information.
    route_table_id str
    The ID of route table which subnet associated with.
    route_table_type str
    The route table type.
    status str
    The Status of Subnet.
    subnet_name str
    The subnet name to query.
    tags Sequence[GetSubnetsSubnetTag]
    Tags.
    total_ipv4_count int
    The Count of ipv4.
    update_time str
    Update time of Subnet.
    vpc_id str
    The ID of VPC which subnet belongs to.
    zone_id str
    The ID of zone which subnet belongs to.
    accountId String
    The account ID which the subnet belongs to.
    availableIpAddressCount Number
    The count of available ip address.
    cidrBlock String
    The cidr block of Subnet.
    creationTime String
    Creation time of Subnet.
    description String
    The description of Subnet.
    id String
    The ID of Subnet.
    ipv6CidrBlock String
    The IPv6 CIDR block of the VPC.
    networkAclId String
    The ID of network acl which this subnet associate with.
    routeTable Property Map
    The route table information.
    routeTableId String
    The ID of route table which subnet associated with.
    routeTableType String
    The route table type.
    status String
    The Status of Subnet.
    subnetName String
    The subnet name to query.
    tags List<Property Map>
    Tags.
    totalIpv4Count Number
    The Count of ipv4.
    updateTime String
    Update time of Subnet.
    vpcId String
    The ID of VPC which subnet belongs to.
    zoneId String
    The ID of zone which subnet belongs to.

    GetSubnetsSubnetRouteTable

    RouteTableId string
    The ID of route table which subnet associated with.
    RouteTableType string
    The route table type.
    RouteTableId string
    The ID of route table which subnet associated with.
    RouteTableType string
    The route table type.
    routeTableId String
    The ID of route table which subnet associated with.
    routeTableType String
    The route table type.
    routeTableId string
    The ID of route table which subnet associated with.
    routeTableType string
    The route table type.
    route_table_id str
    The ID of route table which subnet associated with.
    route_table_type str
    The route table type.
    routeTableId String
    The ID of route table which subnet associated with.
    routeTableType String
    The route table type.

    GetSubnetsSubnetTag

    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.
    key string
    The Key of Tags.
    value string
    The Value of Tags.
    key str
    The Key of Tags.
    value str
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.

    GetSubnetsTag

    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    Key string
    The Key of Tags.
    Value string
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.
    key string
    The Key of Tags.
    value string
    The Value of Tags.
    key str
    The Key of Tags.
    value str
    The Value of Tags.
    key String
    The Key of Tags.
    value String
    The Value of Tags.

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Volcengine v0.0.38 published on Friday, Oct 31, 2025 by Volcengine
    Schema (JSON)
    volcengine/pulumi-volcengine
      Meet Neo: Your AI Platform Teammate