We recommend using Azure Native.
Azure v6.10.0 published on Tuesday, Nov 19, 2024 by Pulumi
azure.network.getSubnet
Explore with Pulumi AI
Use this data source to access information about an existing Subnet within a Virtual Network.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";
const example = azure.network.getSubnet({
name: "backend",
virtualNetworkName: "production",
resourceGroupName: "networking",
});
export const subnetId = example.then(example => example.id);
import pulumi
import pulumi_azure as azure
example = azure.network.get_subnet(name="backend",
virtual_network_name="production",
resource_group_name="networking")
pulumi.export("subnetId", example.id)
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/network"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := network.LookupSubnet(ctx, &network.LookupSubnetArgs{
Name: "backend",
VirtualNetworkName: "production",
ResourceGroupName: "networking",
}, nil)
if err != nil {
return err
}
ctx.Export("subnetId", example.Id)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
var example = Azure.Network.GetSubnet.Invoke(new()
{
Name = "backend",
VirtualNetworkName = "production",
ResourceGroupName = "networking",
});
return new Dictionary<string, object?>
{
["subnetId"] = example.Apply(getSubnetResult => getSubnetResult.Id),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.network.NetworkFunctions;
import com.pulumi.azure.network.inputs.GetSubnetArgs;
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 = NetworkFunctions.getSubnet(GetSubnetArgs.builder()
.name("backend")
.virtualNetworkName("production")
.resourceGroupName("networking")
.build());
ctx.export("subnetId", example.applyValue(getSubnetResult -> getSubnetResult.id()));
}
}
variables:
example:
fn::invoke:
Function: azure:network:getSubnet
Arguments:
name: backend
virtualNetworkName: production
resourceGroupName: networking
outputs:
subnetId: ${example.id}
Using getSubnet
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 getSubnet(args: GetSubnetArgs, opts?: InvokeOptions): Promise<GetSubnetResult>
function getSubnetOutput(args: GetSubnetOutputArgs, opts?: InvokeOptions): Output<GetSubnetResult>
def get_subnet(name: Optional[str] = None,
resource_group_name: Optional[str] = None,
virtual_network_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetSubnetResult
def get_subnet_output(name: Optional[pulumi.Input[str]] = None,
resource_group_name: Optional[pulumi.Input[str]] = None,
virtual_network_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetSubnetResult]
func LookupSubnet(ctx *Context, args *LookupSubnetArgs, opts ...InvokeOption) (*LookupSubnetResult, error)
func LookupSubnetOutput(ctx *Context, args *LookupSubnetOutputArgs, opts ...InvokeOption) LookupSubnetResultOutput
> Note: This function is named LookupSubnet
in the Go SDK.
public static class GetSubnet
{
public static Task<GetSubnetResult> InvokeAsync(GetSubnetArgs args, InvokeOptions? opts = null)
public static Output<GetSubnetResult> Invoke(GetSubnetInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetSubnetResult> getSubnet(GetSubnetArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: azure:network/getSubnet:getSubnet
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
- Specifies the name of the Subnet.
- Resource
Group stringName - Specifies the name of the resource group the Virtual Network is located in.
- Virtual
Network stringName - Specifies the name of the Virtual Network this Subnet is located within.
- Name string
- Specifies the name of the Subnet.
- Resource
Group stringName - Specifies the name of the resource group the Virtual Network is located in.
- Virtual
Network stringName - Specifies the name of the Virtual Network this Subnet is located within.
- name String
- Specifies the name of the Subnet.
- resource
Group StringName - Specifies the name of the resource group the Virtual Network is located in.
- virtual
Network StringName - Specifies the name of the Virtual Network this Subnet is located within.
- name string
- Specifies the name of the Subnet.
- resource
Group stringName - Specifies the name of the resource group the Virtual Network is located in.
- virtual
Network stringName - Specifies the name of the Virtual Network this Subnet is located within.
- name str
- Specifies the name of the Subnet.
- resource_
group_ strname - Specifies the name of the resource group the Virtual Network is located in.
- virtual_
network_ strname - Specifies the name of the Virtual Network this Subnet is located within.
- name String
- Specifies the name of the Subnet.
- resource
Group StringName - Specifies the name of the resource group the Virtual Network is located in.
- virtual
Network StringName - Specifies the name of the Virtual Network this Subnet is located within.
getSubnet Result
The following output properties are available:
- Address
Prefix string - Address
Prefixes List<string> - The address prefixes for the subnet.
- Default
Outbound boolAccess Enabled - Is the default outbound access enabled for the subnet.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Network
Security stringGroup Id - The ID of the Network Security Group associated with the subnet.
- Private
Endpoint stringNetwork Policies - Enable or Disable network policies for the private endpoint on the subnet.
- Private
Link boolService Network Policies Enabled - Enable or Disable network policies for the private link service on the subnet.
- Resource
Group stringName - Route
Table stringId - The ID of the Route Table associated with this subnet.
- Service
Endpoints List<string> - A list of Service Endpoints within this subnet.
- Virtual
Network stringName
- Address
Prefix string - Address
Prefixes []string - The address prefixes for the subnet.
- Default
Outbound boolAccess Enabled - Is the default outbound access enabled for the subnet.
- Id string
- The provider-assigned unique ID for this managed resource.
- Name string
- Network
Security stringGroup Id - The ID of the Network Security Group associated with the subnet.
- Private
Endpoint stringNetwork Policies - Enable or Disable network policies for the private endpoint on the subnet.
- Private
Link boolService Network Policies Enabled - Enable or Disable network policies for the private link service on the subnet.
- Resource
Group stringName - Route
Table stringId - The ID of the Route Table associated with this subnet.
- Service
Endpoints []string - A list of Service Endpoints within this subnet.
- Virtual
Network stringName
- address
Prefix String - address
Prefixes List<String> - The address prefixes for the subnet.
- default
Outbound BooleanAccess Enabled - Is the default outbound access enabled for the subnet.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- network
Security StringGroup Id - The ID of the Network Security Group associated with the subnet.
- private
Endpoint StringNetwork Policies - Enable or Disable network policies for the private endpoint on the subnet.
- private
Link BooleanService Network Policies Enabled - Enable or Disable network policies for the private link service on the subnet.
- resource
Group StringName - route
Table StringId - The ID of the Route Table associated with this subnet.
- service
Endpoints List<String> - A list of Service Endpoints within this subnet.
- virtual
Network StringName
- address
Prefix string - address
Prefixes string[] - The address prefixes for the subnet.
- default
Outbound booleanAccess Enabled - Is the default outbound access enabled for the subnet.
- id string
- The provider-assigned unique ID for this managed resource.
- name string
- network
Security stringGroup Id - The ID of the Network Security Group associated with the subnet.
- private
Endpoint stringNetwork Policies - Enable or Disable network policies for the private endpoint on the subnet.
- private
Link booleanService Network Policies Enabled - Enable or Disable network policies for the private link service on the subnet.
- resource
Group stringName - route
Table stringId - The ID of the Route Table associated with this subnet.
- service
Endpoints string[] - A list of Service Endpoints within this subnet.
- virtual
Network stringName
- address_
prefix str - address_
prefixes Sequence[str] - The address prefixes for the subnet.
- default_
outbound_ boolaccess_ enabled - Is the default outbound access enabled for the subnet.
- id str
- The provider-assigned unique ID for this managed resource.
- name str
- network_
security_ strgroup_ id - The ID of the Network Security Group associated with the subnet.
- private_
endpoint_ strnetwork_ policies - Enable or Disable network policies for the private endpoint on the subnet.
- private_
link_ boolservice_ network_ policies_ enabled - Enable or Disable network policies for the private link service on the subnet.
- resource_
group_ strname - route_
table_ strid - The ID of the Route Table associated with this subnet.
- service_
endpoints Sequence[str] - A list of Service Endpoints within this subnet.
- virtual_
network_ strname
- address
Prefix String - address
Prefixes List<String> - The address prefixes for the subnet.
- default
Outbound BooleanAccess Enabled - Is the default outbound access enabled for the subnet.
- id String
- The provider-assigned unique ID for this managed resource.
- name String
- network
Security StringGroup Id - The ID of the Network Security Group associated with the subnet.
- private
Endpoint StringNetwork Policies - Enable or Disable network policies for the private endpoint on the subnet.
- private
Link BooleanService Network Policies Enabled - Enable or Disable network policies for the private link service on the subnet.
- resource
Group StringName - route
Table StringId - The ID of the Route Table associated with this subnet.
- service
Endpoints List<String> - A list of Service Endpoints within this subnet.
- virtual
Network StringName
Package Details
- Repository
- Azure Classic pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azurerm
Terraform Provider.