Shared Private Link Resources - Create Or Update

Szolgáltatás:: Search Management

API-verzió:: 2023-11-01

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=2023-11-01

URI-paraméterek

Név	In	Kötelező	Típus	Description
resourceGroupName	path	True	string	Az aktuális előfizetésen belüli erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
searchServiceName	path	True	string	A megadott erőforráscsoporthoz társított keresési szolgáltatás neve.
sharedPrivateLinkResourceName	path	True	string	A keresési 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	A Microsoft Azure-előfizetés egyedi azonosítója. Ezt az értéket az Azure Resource Manager API-ból, a parancssori eszközökből vagy a portálról szerezheti be.
api-version	query	True	string	Az egyes kérésekhez 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	A keresési 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 létrehozott vagy frissített megosztott privát kapcsolati erőforrás részletei.
202 Accepted		A megosztott privát kapcsolat erőforrás-létrehozási vagy frissítési művelete elfogadott, és aszinkron módon fog befejeződni.
Other Status Codes	CloudError	HTTP 400 (hibás kérés): A megadott megosztott privát kapcsolat erőforrásneve vagy a megosztott privát kapcsolat erőforrásdefiníciója érvénytelen; A részletekért tekintse meg a hibakódot és az üzenetet a válaszban. HTTP 404 (Nem található): Az előfizetés, az erőforráscsoport, a keresési szolgáltatás vagy a megosztott privát kapcsolat erőforrása nem található. HTTP 409 (Ütközés): A megadott előfizetés le van tiltva.

Biztonság

azure_auth

Microsoft Entra ID OAuth2 engedélyezési 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

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource?api-version=2023-11-01

{
  "properties": {
    "requestMessage": "please approve",
    "groupId": "blob",
    "privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
    "resourceRegion": null
  }
}

Mintaválasz

Állapotkód:: 202

Location: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchService/sharedPrivateLinkResources/testResource/operationStatuses/08586060559526078782?api-version=2023-11-01

Állapotkód:: 200

{
  "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
  }
}

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.
SharedPrivateLinkResource	A keresési szolgáltatás által felügyelt megosztott privát kapcsolati erőforrást ismerteti.
SharedPrivateLinkResourceProperties	A keresési 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.

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.

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 hiba tulajdonságának neve).

SharedPrivateLinkResource

Tárgy

A keresési szolgáltatás által felügyelt megosztott privát kapcsolati erőforrást ismerteti.

Név	Típus	Description
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties	SharedPrivateLinkResourceProperties	A keresési szolgáltatás által felügyelt megosztott privát kapcsolatú erőforrás tulajdonságait ismerteti.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

SharedPrivateLinkResourceProperties

Tárgy

A keresési 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 kíván létrehozni. 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
Deleting
Failed
Succeeded
Incomplete

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
Approved
Rejected
Disconnected