Skip to main content

private_link_services

Creates, updates, deletes, gets or lists a private_link_services resource.

Overview

Nameprivate_link_services
TypeResource
Idazure.network.private_link_services

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringResource ID.
namestringName of the resource.
etagstringA unique read-only string that changes whenever the resource is updated.
linkIdentifierstringThe consumer link id.
privateEndpointobjectThe resource of private end point.
privateEndpointLocationstringThe location of the private endpoint.
privateLinkServiceConnectionStateobjectA collection of information about the state of the connection between service consumer and provider.
provisioningStatestringThe provisioning state of the private endpoint connection resource. Known values are: "Failed", "Succeeded", "Canceled", "Creating", "Updating", and "Deleting". (Failed, Succeeded, Canceled, Creating, Updating, Deleting)
typestringResource type.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_private_endpoint_connectionselectresource_group_name, service_name, pe_connection_name, subscription_id$expandGet the specific private end point connection by specific private link service in the resource group.
getselectresource_group_name, service_name, subscription_id$expandGets the specified private link service by resource group.
list_auto_approved_private_link_services_by_resource_groupselectlocation, resource_group_name, subscription_idReturns all of the private link service ids that can be linked to a Private Endpoint with auto approved in this subscription in this region.
listselectresource_group_name, subscription_idGets all private link services in a resource group.
list_auto_approved_private_link_servicesselectlocation, subscription_idReturns all of the private link service ids that can be linked to a Private Endpoint with auto approved in this subscription in this region.
list_by_subscriptionselectsubscription_idGets all private link service in a subscription.
create_or_updateinsertresource_group_name, service_name, subscription_idCreates or updates an private link service in the specified resource group.
create_or_updatereplaceresource_group_name, service_name, subscription_idCreates or updates an private link service in the specified resource group.
deletedeleteresource_group_name, service_name, subscription_idDeletes the specified private link service.
list_private_endpoint_connectionsexecresource_group_name, service_name, subscription_idGets all private end point connections for a specific private link service.
update_private_endpoint_connectionexecresource_group_name, service_name, pe_connection_name, subscription_idApprove or reject private end point connection for a private link service in a subscription.
delete_private_endpoint_connectionexecresource_group_name, service_name, pe_connection_name, subscription_idDelete private end point connection for a private link service in a subscription.
check_private_link_service_visibilityexeclocation, subscription_idChecks whether the subscription is visible to private link service.
check_private_link_service_visibility_by_resource_groupexeclocation, resource_group_name, subscription_idChecks whether the subscription is visible to private link service in the specified resource group.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
locationstringThe location name. Required.
pe_connection_namestringThe name of the resource that is unique within a resource group. This name can be used to access the resource. Required.
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
service_namestringThe name of the private link service. Required.
subscription_idstring
$expandstringExpands referenced resources. Default value is None.

SELECT examples

Get the specific private end point connection by specific private link service in the resource group.

SELECT
id,
name,
etag,
linkIdentifier,
privateEndpoint,
privateEndpointLocation,
privateLinkServiceConnectionState,
provisioningState,
type
FROM azure.network.private_link_services
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND service_name = '{{ service_name }}' -- required
AND pe_connection_name = '{{ pe_connection_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
AND $expand = '{{ $expand }}'
;

INSERT examples

Creates or updates an private link service in the specified resource group.

INSERT INTO azure.network.private_link_services (
id,
location,
tags,
properties,
extendedLocation,
resource_group_name,
service_name,
subscription_id
)
SELECT
'{{ id }}',
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ extendedLocation }}',
'{{ resource_group_name }}',
'{{ service_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
extendedLocation,
location,
properties,
tags,
type
;

REPLACE examples

Creates or updates an private link service in the specified resource group.

REPLACE azure.network.private_link_services
SET
id = '{{ id }}',
location = '{{ location }}',
tags = '{{ tags }}',
properties = '{{ properties }}',
extendedLocation = '{{ extendedLocation }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND service_name = '{{ service_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
RETURNING
id,
name,
etag,
extendedLocation,
location,
properties,
tags,
type;

DELETE examples

Deletes the specified private link service.

DELETE FROM azure.network.private_link_services
WHERE resource_group_name = '{{ resource_group_name }}' --required
AND service_name = '{{ service_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
;

Lifecycle Methods

Gets all private end point connections for a specific private link service.

EXEC azure.network.private_link_services.list_private_endpoint_connections 
@resource_group_name='{{ resource_group_name }}' --required,
@service_name='{{ service_name }}' --required,
@subscription_id='{{ subscription_id }}' --required
;