This article explains how to work with existing resource management private links. It shows API operations for getting and deleting existing resources.
If you need to create a resource management private link, see Use portal to create private link for managing Azure resources or Use APIs to create private link for managing Azure resources.
Resource management private links
To get a specific resource management private link, send the following request:
Example
# Login first with az login if not using Cloud Shell
az resourcemanagement private-link show --resource-group PrivateLinkTestRG --name NewRMPL
Example
# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL
REST call
GET https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01
The operation returns:
{
"properties": {
"privateEndpointConnections": []
},
"id": {rmplResourceId},
"name": {rmplName},
"type": "Microsoft.Authorization/resourceManagementPrivateLinks",
"location": {region}
}
To get all resource management private links in a subscription, use:
# Login first with az login if not using Cloud Shell
az resourcemanagement private-link list
# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink
REST call
GET
https://management.azure.com/subscriptions/{subscriptionID}/providers/Microsoft.Authorization/resourceManagementPrivateLinks?api-version=2020-05-01
The operation returns:
[
{
"properties": {
"privateEndpointConnections": []
},
"id": {rmplResourceId},
"name": {rmplName},
"type": "Microsoft.Authorization/resourceManagementPrivateLinks",
"location": {region}
},
{
"properties": {
"privateEndpointConnections": []
},
"id": {rmplResourceId},
"name": {rmplName},
"type": "Microsoft.Authorization/resourceManagementPrivateLinks",
"location": {region}
}
]
To delete a specific resource management private link, use:
Example
# Login first with az login if not using Cloud Shell
az resourcemanagement private-link delete --resource-group PrivateLinkTestRG --name NewRMPL
Example
# Login first with Connect-AzAccount if not using Cloud Shell
Remove-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL
REST call
DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01
The operation returns: Status 200 OK
.
Private link association
To get a specific private link association for a management group, use:
Example
# Login first with az login if not using Cloud Shell
az private-link association show --management-group-id fc096d27-0434-4460-a3ea-110df0422a2d --name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4
Example
# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzPrivateLinkAssociation -ManagementGroupId fc096d27-0434-4460-a3ea-110df0422a2d -Name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4 | fl
REST call
GET
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations?api-version=2020-05-01
The operation returns:
{
"value": [
{
"properties": {
"privateLink": {rmplResourceID},
"tenantId": {tenantId},
"scope": "/providers/Microsoft.Management/managementGroups/{managementGroupId}"
},
"id": {plaResourceId},
"type": "Microsoft.Authorization/privateLinkAssociations",
"name": {plaName}
}
]
}
To delete a private link association, use:
Example
# Login first with az login if not using Cloud Shell
az private-link association delete --management-group-id 24f15700-370c-45bc-86a7-aee1b0c4eb8a --name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4
Example
# Login first with Connect-AzAccount if not using Cloud Shell
Remove-AzPrivateLinkAssociation -ManagementGroupId 24f15700-370c-45bc-86a7-aee1b0c4eb8a -Name 1d7942d1-288b-48de-8d0f-2d2aa8e03ad4
REST call
DELETE
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations/{plaID}?api-version=2020-05-01
The operation returns: Status 200 OK
.
Next steps