Gerir ligações privadas de gestão de recursos

Este artigo explica como trabalhar com ligações privadas de gestão de recursos existentes. Mostra operações de API para obter e eliminar recursos existentes.

Se precisar de criar uma ligação privada de gestão de recursos, veja Utilizar o portal para criar uma ligação privada para gerir recursos do Azure ou Utilizar APIs para criar uma ligação privada para gerir recursos do Azure.

Ligações privadas de gestão de recursos

Para obter uma ligação privada de gestão de recursos específica, envie o seguinte pedido:

CLI do Azure

Exemplo

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link show --resource-group PrivateLinkTestRG --name NewRMPL

PowerShell

Exemplo

# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL

REST

Chamada REST

  GET https://management.azure.com/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01 

A operação devolve:

{
  "properties": {
    "privateEndpointConnections": []
  },
  "id": {rmplResourceId},
  "name": {rmplName},
  "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
  "location": {region}
}

Para obter todas as ligações privadas de gestão de recursos numa subscrição, utilize:

CLI do Azure

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link list

PowerShell

# Login first with Connect-AzAccount if not using Cloud Shell
Get-AzResourceManagementPrivateLink

REST

Chamada REST

GET
https://management.azure.com/subscriptions/{subscriptionID}/providers/Microsoft.Authorization/resourceManagementPrivateLinks?api-version=2020-05-01

A operação devolve:

[
  {
    "properties": {
      "privateEndpointConnections": []
    },
    "id": {rmplResourceId},
    "name": {rmplName},
    "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
    "location": {region}
  },
  {
    "properties": {
      "privateEndpointConnections": []
    },
    "id": {rmplResourceId},
    "name": {rmplName},
    "type": "Microsoft.Authorization/resourceManagementPrivateLinks",
    "location": {region}
  }
]

Para eliminar uma ligação privada de gestão de recursos específica, utilize:

CLI do Azure

Exemplo

# Login first with az login if not using Cloud Shell
az resourcemanagement private-link delete --resource-group PrivateLinkTestRG --name NewRMPL

PowerShell

Exemplo

# Login first with Connect-AzAccount if not using Cloud Shell
Remove-AzResourceManagementPrivateLink -ResourceGroupName PrivateLinkTestRG -Name NewRMPL

REST

Chamada REST

DELETE
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/resourceManagementPrivateLinks/{rmplName}?api-version=2020-05-01

A operação devolve: Status 200 OK.

Associação de ligação privada

Para obter uma associação de ligação privada específica para um grupo de gestão, utilize:

CLI do Azure

Exemplo

# 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

PowerShell

Exemplo

# 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

Chamada REST

GET
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations?api-version=2020-05-01 

A operação devolve:

{
  "value": [
    {
      "properties": {
        "privateLink": {rmplResourceID},
        "tenantId": {tenantId},
        "scope": "/providers/Microsoft.Management/managementGroups/{managementGroupId}"
      },
      "id": {plaResourceId},
      "type": "Microsoft.Authorization/privateLinkAssociations",
      "name": {plaName}
    }
  ]
}

Para eliminar uma associação de ligação privada, utilize:

CLI do Azure

Exemplo

# 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

PowerShell

Exemplo

# 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

Chamada REST

DELETE 
https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupID}/providers/Microsoft.Authorization/privateLinkAssociations/{plaID}?api-version=2020-05-01

A operação devolve: Status 200 OK.

Passos seguintes

• Para saber mais sobre ligações privadas, consulte Azure Private Link.
• Para gerir os seus pontos finais privados, veja Gerir Pontos Finais Privados.
• Para criar ligações privadas de gestão de recursos, veja Utilizar o portal para criar uma ligação privada para gerir recursos do Azure ou Utilizar a API REST para criar uma ligação privada para gerir recursos do Azure.