Verwalten von privaten Verbindungen zur Ressourcenverwaltung

Dieser Artikel erklärt, wie Sie mit bestehenden privaten Verbindungen zur Ressourcenverwaltung arbeiten können. Er zeigt die API-Vorgänge zum Abrufen und Löschen vorhandener Ressourcen.

Wenn Sie private Verbindungen für die Ressourcenverwaltung erstellen müssen, lesen Sie Verwenden von Portal zum Erstellen einer privaten Verbindung zum Verwalten von Azure-Ressourcen oder Verwenden von APIs zum Erstellen einer privaten Verbindung zum Verwalten von Azure-Ressourcen.

Private Verbindungen der Ressourcenverwaltung

Zum Erhalt einer bestimmten Privaten Verbindung der Ressourcenverwaltung senden Sie die folgende Anforderung:

Azure-Befehlszeilenschnittstelle

Beispiel

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

PowerShell

Beispiel

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

REST

REST-Aufruf

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

Die Operation gibt zurück:

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

Zum Erhalt aller privaten Verbindungen der Ressourcenverwaltung in einem Abonnement, verwenden Sie:

Azure-Befehlszeilenschnittstelle

# 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

REST-Aufruf

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

Die Operation gibt zurück:

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

Zum Löschen einer bestimmten privaten Verbindung der Ressourcenverwaltung verwenden Sie:

Azure-Befehlszeilenschnittstelle

Beispiel

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

PowerShell

Beispiel

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

REST

REST-Aufruf

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

Der Vorgang gibt zurück: Status 200 OK.

Zuordnung einer privaten Verbindung

Zum Erhalt einer bestimmten Zuordnung einer privaten Verbindung für eine Verwaltungsgruppe, verwenden Sie:

Azure-Befehlszeilenschnittstelle

Beispiel

# 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

Beispiel

# 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

REST-Aufruf

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

Der Vorgang gibt zurück:

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

Zum Löscheneine privaten Verbindung verwenden Sie:

Azure-Befehlszeilenschnittstelle

Beispiel

# 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

Beispiel

# 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

REST-Aufruf

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

Der Vorgang gibt zurück: Status 200 OK.

Nächste Schritte

• Weitere Informationen zu privaten Verbindungen finden Sie unter Azure Private Link.
• Informationen zum Verwalten Ihrer privaten Endpunkte finden Sie unter Verwalten privater Endpunkte.
• Um eine privaten Verbindung der Ressourcenverwaltung zu erstellen, siehe Verwenden von Portal zum Erstellen einer privaten Verbindung zum Verwalten von Azure-Ressourcen oder Verwenden von REST API zum Erstellen einer privaten Verbindung zum Verwalten von Azure-Ressourcen.