Shared Private Link Resources - Get
Ruft die Details der freigegebenen Private Link-Ressource ab, die vom Suchdienst in der angegebenen Ressourcengruppe verwaltet wird.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2023-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe im aktuellen Abonnement. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden. |
search
|
path | True |
string |
Der Name des Suchdiensts, der der angegebenen Ressourcengruppe zugeordnet ist. |
shared
|
path | True |
string |
Der Name der freigegebenen Private Link-Ressource, die vom Suchdienst innerhalb der angegebenen Ressourcengruppe verwaltet wird. |
subscription
|
path | True |
string |
Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement. Sie können diesen Wert über die Azure Resource Manager-API, Befehlszeilentools oder das Portal abrufen. |
api-version
|
query | True |
string |
Die API-Version, die für jede Anforderung verwendet werden soll. |
Anforderungsheader
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
x-ms-client-request-id |
string uuid |
Ein vom Client generierter GUID-Wert zur Identifizierung dieser Anforderung. Wenn angegeben, wird dies in die Antwortinformationen aufgenommen, um die Anforderung nachzuverfolgen. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Definition der freigegebenen Private Link-Ressource wurde erfolgreich abgerufen und befindet sich in der Antwort. |
|
Other Status Codes |
HTTP 404 (Nicht gefunden): Das Abonnement, die Ressourcengruppe, der Suchdienst oder die freigegebene Private Link-Ressource wurde nicht gefunden. |
Sicherheit
azure_auth
Microsoft Entra ID OAuth2-Autorisierungsflow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
SharedPrivateLinkResourceGet
Beispielanforderung
Beispiel für eine Antwort
{
"name": "testResource",
"type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"status": "Pending",
"resourceRegion": null
}
}
Definitionen
Name | Beschreibung |
---|---|
Cloud |
Enthält Informationen zu einem API-Fehler. |
Cloud |
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung. |
Shared |
Beschreibt eine freigegebene Private Link-Ressource, die vom Suchdienst verwaltet wird. |
Shared |
Beschreibt die Eigenschaften einer vorhandenen freigegebenen Private Link Ressource, die vom Suchdienst verwaltet wird. |
Shared |
Der Bereitstellungsstatus der freigegebenen Private Link-Ressource. Gültige Werte sind Aktualisieren, Löschen, Fehler, Erfolgreich oder Unvollständig. |
Shared |
Status der freigegebenen Private Link-Ressource. Gültige Werte sind Ausstehend, Genehmigt, Abgelehnt oder Getrennt. |
CloudError
Enthält Informationen zu einem API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
error |
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung. |
CloudErrorBody
Beschreibt einen bestimmten API-Fehler mit einem Fehlercode und einer Meldung.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Fehlercode, der die Fehlerbedingung genauer beschreibt als ein HTTP-status Code. Kann verwendet werden, um bestimmte Fehlerfälle programmgesteuert zu behandeln. |
details |
Enthält geschachtelte Fehler, die sich auf diesen Fehler beziehen. |
|
message |
string |
Eine Meldung, die den Fehler ausführlich beschreibt und Debuginformationen bereitstellt. |
target |
string |
Das Ziel des bestimmten Fehlers (z. B. der Name der -Eigenschaft im Fehler). |
SharedPrivateLinkResource
Beschreibt eine freigegebene Private Link-Ressource, die vom Suchdienst verwaltet wird.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Der Name der Ressource |
properties |
Beschreibt die Eigenschaften einer freigegebenen Private Link Ressource, die vom Suchdienst verwaltet wird. |
|
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Beschreibt die Eigenschaften einer vorhandenen freigegebenen Private Link Ressource, die vom Suchdienst verwaltet wird.
Name | Typ | Beschreibung |
---|---|---|
groupId |
string |
Die Gruppen-ID des Ressourcenanbieters, für den die freigegebene Private Link-Ressource verwendet wird. |
privateLinkResourceId |
string |
Die Ressourcen-ID der Ressource, für die die freigegebene Private Link-Ressource verwendet wird. |
provisioningState |
Der Bereitstellungsstatus der freigegebenen Private Link-Ressource. Gültige Werte sind Aktualisieren, Löschen, Fehler, Erfolgreich oder Unvollständig. |
|
requestMessage |
string |
Die Anforderungsnachricht zum Anfordern der Genehmigung der freigegebenen Private Link-Ressource. |
resourceRegion |
string |
Optional. Kann verwendet werden, um den Azure Resource Manager Speicherort der Ressource anzugeben, zu der eine freigegebene private Verbindung erstellt werden soll. Dies ist nur für Ressourcen erforderlich, deren DNS-Konfiguration regional ist (z. B. Azure Kubernetes Service). |
status |
Status der freigegebenen Private Link-Ressource. Gültige Werte sind Ausstehend, Genehmigt, Abgelehnt oder Getrennt. |
SharedPrivateLinkResourceProvisioningState
Der Bereitstellungsstatus der freigegebenen Private Link-Ressource. Gültige Werte sind Aktualisieren, Löschen, Fehler, Erfolgreich oder Unvollständig.
Name | Typ | Beschreibung |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Incomplete |
string |
|
Succeeded |
string |
|
Updating |
string |
SharedPrivateLinkResourceStatus
Status der freigegebenen Private Link-Ressource. Gültige Werte sind Ausstehend, Genehmigt, Abgelehnt oder Getrennt.
Name | Typ | Beschreibung |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |