Shared Private Link Resources - Create Or Update
Kezdeményezi egy megosztott privát kapcsolattal rendelkező erőforrás létrehozását vagy frissítését, amelyet a keresési szolgáltatás kezel az adott erőforráscsoportban.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources/{sharedPrivateLinkResourceName}?api-version=2025-05-01
URI-paraméterek
| Név | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
search
|
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 Search szolgáltatás neve. |
|
shared
|
path | True |
string |
Az Azure AI Search szolgáltatás által a megadott erőforráscsoporton belül felügyelt megosztott privát kapcsolatú erőforrás neve. |
|
subscription
|
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álandó 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. |
Kérelem törzse
| Név | Típus | Description |
|---|---|---|
| properties |
Az Azure AI Search szolgáltatás által felügyelt megosztott privát kapcsolatú erőforrás tulajdonságait ismerteti. |
Válaszok
| Név | Típus | Description |
|---|---|---|
| 200 OK |
A "SharedPrivateLinkResource" erőforrás frissítési művelete sikeres volt |
|
| 202 Accepted |
Az erőforrásművelet elfogadott. Fejlécek Azure-AsyncOperation: string |
|
| Other Status Codes |
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
SharedPrivateLinkResourceCreateOrUpdate
Mintakérelem
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2025-05-01
{
"properties": {
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"requestMessage": "please approve",
"resourceRegion": null
}
}
Mintaválasz
{
"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"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2025-05-01
Definíciók
| Név | Description |
|---|---|
|
Cloud |
Api-hibával kapcsolatos információkat tartalmaz. |
|
Cloud |
Egy adott API-hibát ír le egy hibakóddal és egy üzenettel. |
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Shared |
Az Azure AI Search szolgáltatás által felügyelt megosztott privát kapcsolati erőforrás leírása. |
|
Shared |
Az Azure AI Search szolgáltatás által felügyelt meglévő megosztott privát kapcsolati erőforrás tulajdonságait ismerteti. |
|
Shared |
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. |
|
Shared |
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. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
CloudError
Api-hibával kapcsolatos információkat tartalmaz.
| Név | Típus | Description |
|---|---|---|
| error |
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
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 |
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 hiba tulajdonságának neve). |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
SharedPrivateLinkResource
Az Azure AI Search szolgáltatás által felügyelt megosztott privát kapcsolati erőforrás leírása.
| Név | Típus | Description |
|---|---|---|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Az erőforrás neve |
| properties |
Az Azure AI Search szolgáltatás által felügyelt megosztott privát kapcsolatú erőforrás tulajdonságait ismerteti. |
|
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
| type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceProperties
Az Azure AI Search szolgáltatás által felügyelt meglévő megosztott privát kapcsolati erőforrás tulajdonságait ismerteti.
| 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 |
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 |
Opcionális. 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 |
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
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
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
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 |
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 |
Az erőforrást legutóbb módosító identitás típusa. |