Shared Private Link Resources - Get

Szolgáltatás:: Search Management

API-verzió:: 2026-11-01

Lekéri az adott erőforráscsoport keresési szolgáltatása által felügyelt megosztott privát kapcsolati erőforrás részleteit.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2026-11-01

URI-paraméterek

Név	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
searchServiceName	path	True	string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$	A megadott erőforráscsoporthoz társított Azure AI Keresés szolgáltatás neve.
sharedPrivateLinkResourceName	path	True	string	A megadott erőforráscsoporton belüli Azure AI Keresés szolgáltatás által felügyelt megosztott privát kapcsolatú erőforrás neve.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem fejléce

Név	Kötelező	Típus	Description
x-ms-client-request-id		string (uuid)	Egy ügyfél által létrehozott GUID-érték, amely azonosítja ezt a kérést. Ha meg van adva, ez a kérés nyomon követésének módjaként szerepelni fog a válaszinformációkban.

Válaszok

Név	Típus	Description
200 OK	SharedPrivateLinkResource	Az Azure működése sikeresen befejeződött.
Other Status Codes	CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

SharedPrivateLinkResourceGet

Mintakérelem

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2026-11-01

Mintaválasz

Állapotkód:: 200

{
  "name": "testResource",
  "type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
  "properties": {
    "groupId": "blob",
    "privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
    "requestMessage": "please approve",
    "resourceRegion": null,
    "status": "Pending"
  }
}

Definíciók

Név	Description
CloudError	Api-hibával kapcsolatos információkat tartalmaz.
CloudErrorBody	Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.
createdByType	Az erőforrást létrehozó identitás típusa.
SharedPrivateLinkResource	Leír egy megosztott privát link erőforrást, amelyet az Azure AI Keresés szolgáltatás kezel.
SharedPrivateLinkResourceProperties	Leírja egy meglévő megosztott privát link erőforrás tulajdonságait, amelyet az Azure AI Keresés szolgáltatás kezel.
SharedPrivateLinkResourceProvisioningState	A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos.
SharedPrivateLinkResourceStatus	A megosztott privát kapcsolat erőforrásának állapota. Az érvényes értékek függőben, jóváhagyva, elutasítva vagy leválasztva.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CloudError

Tárgy

Api-hibával kapcsolatos információkat tartalmaz.

Név	Típus	Description
error	CloudErrorBody	Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.
message	string	A hiba rövid leírása, amely arra utal, hogy mi történt (a részletekért/hibakeresési információkért tekintse meg a "error.message" tulajdonságot).

CloudErrorBody

Tárgy

Egy adott API-hibát ír le egy hibakóddal és egy üzenettel.

Név	Típus	Description
code	string	Hibakód, amely pontosabban írja le a hibafeltételt, mint egy HTTP-állapotkód. Adott hibaeseteket programozott módon is kezelhet.
details	CloudErrorBody[]	Beágyazott hibákat tartalmaz, amelyek ehhez a hibához kapcsolódnak.
message	string	A hibát részletesen leíró és hibakeresési információkat tartalmazó üzenet.
target	string	Az adott hiba célja (például a hibás tulajdonság neve).

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

SharedPrivateLinkResource

Tárgy

Leír egy megosztott privát link erőforrást, amelyet az Azure AI Keresés szolgáltatás kezel.

Név	Típus	Description
id	string (arm-id)	Az erőforrás teljesen minősített azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Az erőforrás neve
properties	SharedPrivateLinkResourceProperties	Az Azure AI Keresés szolgáltatás által felügyelt megosztott privát kapcsolatú erőforrás tulajdonságait ismerteti.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
type	string	Az erőforrás típusa. Például: "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Tárgy

Leírja egy meglévő megosztott privát link erőforrás tulajdonságait, amelyet az Azure AI Keresés szolgáltatás kezel.

Név	Típus	Description
groupId	string	Annak az erőforrásnak a csoportazonosítója, amelyre a megosztott privát kapcsolat erőforrása tartozik.
privateLinkResourceId	string	Annak az erőforrásnak az erőforrás-azonosítója, amelyre a megosztott privát kapcsolat erőforrása tartozik.
provisioningState	SharedPrivateLinkResourceProvisioningState	A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos.
requestMessage	string	A megosztott privát kapcsolat erőforrásának jóváhagyását kérő üzenet.
resourceRegion	string	Optional. Megadhatja annak az erőforrásnak az Azure Resource Manager-helyét, amelyhez megosztott privát hivatkozást hoz létre. Ez csak azokhoz az erőforrásokhoz szükséges, amelyek DNS-konfigurációja regionális (például Azure Kubernetes Service).
status	SharedPrivateLinkResourceStatus	A megosztott privát kapcsolat erőforrásának állapota. Az érvényes értékek függőben, jóváhagyva, elutasítva vagy leválasztva.

SharedPrivateLinkResourceProvisioningState

Felsorolás

A megosztott privát kapcsolati erőforrás kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres vagy Hiányos.

Érték	Description
Updating	A megosztott privát kapcsolati erőforrás létrehozása folyamatban van a többi erőforrással együtt, hogy teljes mértékben működőképes legyen.
Deleting	A megosztott privát kapcsolat erőforrásának törlése folyamatban van.
Failed	A megosztott privát kapcsolat erőforrását nem sikerült kiépíteni vagy törölni.
Succeeded	A megosztott privát kapcsolat erőforrása befejezte a kiépítést, és készen áll a jóváhagyásra.
Incomplete	A megosztott privát kapcsolati erőforrásra vonatkozó kiépítési kérelmet elfogadták, de a létrehozási folyamat még nem kezdődött el.

SharedPrivateLinkResourceStatus

Felsorolás

A megosztott privát kapcsolat erőforrásának állapota. Az érvényes értékek függőben, jóváhagyva, elutasítva vagy leválasztva.

Érték	Description
Pending	A megosztott privát kapcsolat erőforrása létrejött, és jóváhagyásra vár.
Approved	A megosztott privát kapcsolat erőforrása jóvá van hagyva, és használatra kész.
Rejected	A megosztott privát kapcsolat erőforrása elutasítva, és nem használható.
Disconnected	A megosztott privát kapcsolat erőforrása el lett távolítva a szolgáltatásból.

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Név	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.