Azure Classic v5.38.0, Mar 21 23

azure.privatelink.getService

Use this data source to access information about an existing Private Link Service.

Example Usage

using System.Collections.Generic;
using Pulumi;
using Azure = Pulumi.Azure;

return await Deployment.RunAsync(() => 
{
    var example = Azure.PrivateLink.GetService.Invoke(new()
    {
        Name = "myPrivateLinkService",
        ResourceGroupName = "PrivateLinkServiceRG",
    });

    return new Dictionary<string, object?>
    {
        ["privateLinkServiceId"] = example.Apply(getServiceResult => getServiceResult.Id),
    };
});

package main

import (
	"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/privatelink"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := privatelink.GetService(ctx, &privatelink.GetServiceArgs{
			Name:              "myPrivateLinkService",
			ResourceGroupName: "PrivateLinkServiceRG",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("privateLinkServiceId", example.Id)
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.privatelink.PrivatelinkFunctions;
import com.pulumi.azure.privatelink.inputs.GetServiceArgs;
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 = PrivatelinkFunctions.getService(GetServiceArgs.builder()
            .name("myPrivateLinkService")
            .resourceGroupName("PrivateLinkServiceRG")
            .build());

        ctx.export("privateLinkServiceId", example.applyValue(getServiceResult -> getServiceResult.id()));
    }
}

import pulumi
import pulumi_azure as azure

example = azure.privatelink.get_service(name="myPrivateLinkService",
    resource_group_name="PrivateLinkServiceRG")
pulumi.export("privateLinkServiceId", example.id)

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

const example = azure.privatelink.getService({
    name: "myPrivateLinkService",
    resourceGroupName: "PrivateLinkServiceRG",
});
export const privateLinkServiceId = example.then(example => example.id);

variables:
  example:
    fn::invoke:
      Function: azure:privatelink:getService
      Arguments:
        name: myPrivateLinkService
        resourceGroupName: PrivateLinkServiceRG
outputs:
  privateLinkServiceId: ${example.id}

Using getService

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 getService(args: GetServiceArgs, opts?: InvokeOptions): Promise<GetServiceResult>
function getServiceOutput(args: GetServiceOutputArgs, opts?: InvokeOptions): Output<GetServiceResult>

def get_service(name: Optional[str] = None,
                resource_group_name: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetServiceResult
def get_service_output(name: Optional[pulumi.Input[str]] = None,
                resource_group_name: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetServiceResult]

func GetService(ctx *Context, args *GetServiceArgs, opts ...InvokeOption) (*GetServiceResult, error)
func GetServiceOutput(ctx *Context, args *GetServiceOutputArgs, opts ...InvokeOption) GetServiceResultOutput

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

public static class GetService 
{
    public static Task<GetServiceResult> InvokeAsync(GetServiceArgs args, InvokeOptions? opts = null)
    public static Output<GetServiceResult> Invoke(GetServiceInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetServiceResult> getService(GetServiceArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: azure:privatelink/getService:getService
  arguments:
    # arguments dictionary

The following arguments are supported:

Name string: The name of the private link service.
ResourceGroupName string: The name of the resource group in which the private link service resides.

Name string: The name of the private link service.
ResourceGroupName string: The name of the resource group in which the private link service resides.

name String: The name of the private link service.
resourceGroupName String: The name of the resource group in which the private link service resides.

name string: The name of the private link service.
resourceGroupName string: The name of the resource group in which the private link service resides.

name str: The name of the private link service.
resource_group_name str: The name of the resource group in which the private link service resides.

name String: The name of the private link service.
resourceGroupName String: The name of the resource group in which the private link service resides.

getService Result

The following output properties are available:

Alias string: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
AutoApprovalSubscriptionIds List<string>: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
EnableProxyProtocol bool: Does the Private Link Service support the Proxy Protocol?
Id string: The provider-assigned unique ID for this managed resource.
LoadBalancerFrontendIpConfigurationIds List<string>: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
Location string: The supported Azure location where the resource exists.
Name string: The name of private link service NAT IP configuration.
NatIpConfigurations List<GetServiceNatIpConfiguration>: The nat_ip_configuration block as defined below.
ResourceGroupName string
Tags Dictionary<string, string>: A mapping of tags to assign to the resource.
VisibilitySubscriptionIds List<string>: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

Alias string: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
AutoApprovalSubscriptionIds []string: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
EnableProxyProtocol bool: Does the Private Link Service support the Proxy Protocol?
Id string: The provider-assigned unique ID for this managed resource.
LoadBalancerFrontendIpConfigurationIds []string: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
Location string: The supported Azure location where the resource exists.
Name string: The name of private link service NAT IP configuration.
NatIpConfigurations []GetServiceNatIpConfiguration: The nat_ip_configuration block as defined below.
ResourceGroupName string
Tags map[string]string: A mapping of tags to assign to the resource.
VisibilitySubscriptionIds []string: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

alias String: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
autoApprovalSubscriptionIds List<String>: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
enableProxyProtocol Boolean: Does the Private Link Service support the Proxy Protocol?
id String: The provider-assigned unique ID for this managed resource.
loadBalancerFrontendIpConfigurationIds List<String>: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
location String: The supported Azure location where the resource exists.
name String: The name of private link service NAT IP configuration.
natIpConfigurations List<GetServiceNatIpConfiguration>: The nat_ip_configuration block as defined below.
resourceGroupName String
tags Map<String,String>: A mapping of tags to assign to the resource.
visibilitySubscriptionIds List<String>: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

alias string: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
autoApprovalSubscriptionIds string[]: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
enableProxyProtocol boolean: Does the Private Link Service support the Proxy Protocol?
id string: The provider-assigned unique ID for this managed resource.
loadBalancerFrontendIpConfigurationIds string[]: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
location string: The supported Azure location where the resource exists.
name string: The name of private link service NAT IP configuration.
natIpConfigurations GetServiceNatIpConfiguration[]: The nat_ip_configuration block as defined below.
resourceGroupName string
tags {[key: string]: string}: A mapping of tags to assign to the resource.
visibilitySubscriptionIds string[]: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

alias str: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
auto_approval_subscription_ids Sequence[str]: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
enable_proxy_protocol bool: Does the Private Link Service support the Proxy Protocol?
id str: The provider-assigned unique ID for this managed resource.
load_balancer_frontend_ip_configuration_ids Sequence[str]: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
location str: The supported Azure location where the resource exists.
name str: The name of private link service NAT IP configuration.
nat_ip_configurations Sequence[GetServiceNatIpConfiguration]: The nat_ip_configuration block as defined below.
resource_group_name str
tags Mapping[str, str]: A mapping of tags to assign to the resource.
visibility_subscription_ids Sequence[str]: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

alias String: The alias is a globally unique name for your private link service which Azure generates for you. Your can use this alias to request a connection to your private link service.
autoApprovalSubscriptionIds List<String>: The list of subscription(s) globally unique identifiers that will be auto approved to use the private link service.
enableProxyProtocol Boolean: Does the Private Link Service support the Proxy Protocol?
id String: The provider-assigned unique ID for this managed resource.
loadBalancerFrontendIpConfigurationIds List<String>: The list of Standard Load Balancer(SLB) resource IDs. The Private Link service is tied to the frontend IP address of a SLB. All traffic destined for the private link service will reach the frontend of the SLB. You can configure SLB rules to direct this traffic to appropriate backend pools where your applications are running.
location String: The supported Azure location where the resource exists.
name String: The name of private link service NAT IP configuration.
natIpConfigurations List<Property Map>: The nat_ip_configuration block as defined below.
resourceGroupName String
tags Map<String>: A mapping of tags to assign to the resource.
visibilitySubscriptionIds List<String>: The list of subscription(s) globally unique identifiers(GUID) that will be able to see the private link service.

Supporting Types

GetServiceNatIpConfiguration

Name string: The name of the private link service.
Primary bool: Value that indicates if the IP configuration is the primary configuration or not.
PrivateIpAddress string: The private IP address of the NAT IP configuration.
PrivateIpAddressVersion string: The version of the IP Protocol.
SubnetId string: The ID of the subnet to be used by the service.

Name string: The name of the private link service.
Primary bool: Value that indicates if the IP configuration is the primary configuration or not.
PrivateIpAddress string: The private IP address of the NAT IP configuration.
PrivateIpAddressVersion string: The version of the IP Protocol.
SubnetId string: The ID of the subnet to be used by the service.

name String: The name of the private link service.
primary Boolean: Value that indicates if the IP configuration is the primary configuration or not.
privateIpAddress String: The private IP address of the NAT IP configuration.
privateIpAddressVersion String: The version of the IP Protocol.
subnetId String: The ID of the subnet to be used by the service.

name string: The name of the private link service.
primary boolean: Value that indicates if the IP configuration is the primary configuration or not.
privateIpAddress string: The private IP address of the NAT IP configuration.
privateIpAddressVersion string: The version of the IP Protocol.
subnetId string: The ID of the subnet to be used by the service.

name str: The name of the private link service.
primary bool: Value that indicates if the IP configuration is the primary configuration or not.
private_ip_address str: The private IP address of the NAT IP configuration.
private_ip_address_version str: The version of the IP Protocol.
subnet_id str: The ID of the subnet to be used by the service.

name String: The name of the private link service.
primary Boolean: Value that indicates if the IP configuration is the primary configuration or not.
privateIpAddress String: The private IP address of the NAT IP configuration.
privateIpAddressVersion String: The version of the IP Protocol.
subnetId String: The ID of the subnet to be used by the service.

Package Details

Repository: Azure Classic pulumi/pulumi-azure
License: Apache-2.0
Notes: This Pulumi package is based on the azurerm Terraform Provider.