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
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 Search szolgáltatás neve.

sharedPrivateLinkResourceName
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.

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á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

SharedPrivateLinkResourceProperties

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

SharedPrivateLinkResource

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

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

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
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

Az Azure AI Search szolgáltatás által felügyelt megosztott privát kapcsolati erőforrás leírása.

SharedPrivateLinkResourceProperties

Az Azure AI Search szolgáltatás által felügyelt meglévő megosztott privát kapcsolati erőforrás tulajdonságait ismerteti.

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

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

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 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

SharedPrivateLinkResourceProperties

Az Azure AI Search 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. 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

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

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

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

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

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.