Gerenciar links privados de gerenciamento de recursos

Este artigo explica como trabalhar com links privados de gerenciamento de recursos existentes. Ele mostra as operações da API para obter e excluir recursos existentes.

Se você precisar criar um link privado de gerenciamento de recursos, confira Usar o portal para criar um link privado para gerenciar recursos do Azure ou Usar as APIs para criar um link privado para gerenciar recursos do Azure.

Links privados de gerenciamento de recursos

Para obter um específico link privado de gerenciamento de recursos, envie a seguinte solicitação:

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 retorna:

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

Para obter todos os links privados de gerenciamento de recursos em uma assinatura, use:

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 retorna:

[
  {
    "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 excluir o específico link privado de gerenciamento de recursos, use:

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 retorna: Status 200 OK.

Associação de link privado

Para obter uma específica associação de link privado para um grupo de gerenciamento, use:

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 retorna:

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

Para excluir uma associação de link privado, use:

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 retorna: Status 200 OK.

Próximas etapas

• Para saber mais sobre links privados, confira Link Privado do Azure.
• Para gerenciar seus pontos de extremidade privados, consulte Gerenciar pontos de extremidade privados.
• Para criar um link privado de gerenciamento de recursos, confira Usar o portal para criar um link privado para gerenciar recursos do Azure ou Usar a API REST para criar um link privado para gerenciar recursos do Azure.