Private Link Resources - Get By Group Id

Dienst:

Purview

API-Version:

2021-12-01

Ruft eine privat verknüpfte Ressourcen für ein Konto mit angegebenem Gruppenbezeichner ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Purview/accounts/{accountName}/privateLinkResources/{groupId}?api-version=2021-12-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string minLength: 3 maxLength: 63 pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$	Der Name des Kontos.
groupId	path	True	string	Der Gruppenbezeichner.
resourceGroupName	path	True	string	Der Ressourcengruppenname.
subscriptionId	path	True	string	Der Abonnementbezeichner
api-version	query	True	string	Die zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	PrivateLinkResource	Erfolg
Other Status Codes	ErrorResponseModel	Eine vom Anbieter empfangene Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

PrivateLinkResources_GetByGroupId

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-12345678abc/resourceGroups/SampleResourceGroup/providers/Microsoft.Purview/accounts/account1/privateLinkResources/group1?api-version=2021-12-01

Beispiel für eine Antwort

Statuscode:

200

Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-request-id: d5496da4-9c52-402f-b067-83cc9ddea888
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-tenant-reads: 14999
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/SampleResourceGroup/providers/Microsoft.Purview/accounts/account1/privateLinkResources/plr1",
  "name": "plr1",
  "type": "Microsoft.Purview/accounts/privateLinkResources",
  "properties": {
    "groupId": "group1",
    "requiredMembers": [
      "group1"
    ],
    "requiredZoneNames": [
      "privatelinkzone1.service.azure.com"
    ]
  }
}

Definitionen

Name	Beschreibung
Error	Ruft den Fehler ab oder legt den Fehler fest.
ErrorModel	Standardfehlermodell
ErrorResponseModel	Standardfehlerantwortmodell
PrivateLinkResource	Eine privat verlinkbare Ressource.
PrivateLinkResourceProperties	Eine privat verlinkbare Ressourceneigenschaft.

Error

Objekt

Ruft den Fehler ab oder legt den Fehler fest.

Name	Typ	Beschreibung
code	string	Ruft den Code ab oder legt den Code fest.
details	ErrorModel[]	Ruft die Details ab oder legt diese fest.
message	string	Ruft die Nachrichten ab oder legt sie fest.
target	string	Ruft das Ziel ab oder legt es fest.

ErrorModel

Objekt

Standardfehlermodell

Name	Typ	Beschreibung
code	string	Ruft den Code ab oder legt den Code fest.
details	ErrorModel[]	Ruft die Details ab oder legt diese fest.
message	string	Ruft die Nachrichten ab oder legt sie fest.
target	string	Ruft das Ziel ab oder legt es fest.

ErrorResponseModel

Objekt

Standardfehlerantwortmodell

Name	Typ	Beschreibung
error	Error	Ruft den Fehler ab oder legt den Fehler fest.

PrivateLinkResource

Objekt

Eine privat verlinkbare Ressource.

Name	Typ	Beschreibung
id	string	Der Bezeichner für private Verknüpfungsressourcen.
name	string	Der Name der Ressource für private Verknüpfungen.
properties	PrivateLinkResourceProperties	Die Eigenschaften der privaten Verknüpfungsressource.
type	string	Der Ressourcentyp für private Verknüpfungen.

PrivateLinkResourceProperties

Objekt

Eine privat verlinkbare Ressourceneigenschaft.

Name	Typ	Beschreibung
groupId	string	Der Bezeichner für private Verknüpfungsressourcengruppen.
requiredMembers	string[]	Dies bedeutet, wie viele private IPs für jede privat verlinkbare Ressource erstellt werden sollen.
requiredZoneNames	string[]	Die erforderlichen Zonennamen für private Verknüpfungsressource.