Private Endpoint Connections - Update

Szolgáltatás:: Search Management

API-verzió:: 2024-03-01-preview

Frissíti a privát végpontkapcsolatot a keresési szolgáltatáshoz az adott erőforráscsoportban.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-03-01-preview

URI-paraméterek

Név	In	Kötelező	Típus	Description
privateEndpointConnectionName	path	True	string	Az Azure AI Search szolgáltatáshoz a megadott erőforráscsoporttal létesített privát végpontkapcsolat neve.
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 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.
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 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	PrivateEndpointConnectionProperties	Az Azure AI Search szolgáltatással létesített meglévő privát végpontkapcsolat tulajdonságait ismerteti.

Válaszok

Név	Típus	Description
200 OK	PrivateEndpointConnection	A meglévő privát végpont kapcsolatdefiníciója sikeresen frissült.
Other Status Codes	CloudError	HTTP 400 (hibás kérelem): A megadott privát végpont kapcsolat neve vagy a privát végpont kapcsolatdefiní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 privát végpont kapcsolata nem található. HTTP 409 (Ütközés): A megadott előfizetés le van tiltva.

Biztonság

azure_auth

Implicit engedélyezési folyamatot határoz meg a Microsoft Identity platformon támogatott módon.

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

PrivateEndpointConnectionUpdate

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546?api-version=2024-03-01-preview

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Rejected",
      "description": "Rejected for some reason."
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/privateEndpointConnections/testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
  "name": "testEndpoint.50bf4fbe-d7c1-4b48-a642-4f5892642546",
  "type": "Microsoft.Search/searchServices/privateEndpointConnections",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/privateEndpoints/testEndpoint"
    },
    "privateLinkServiceConnectionState": {
      "status": "Rejected",
      "description": "Rejected for some reason.",
      "actionsRequired": "None"
    }
  }
}

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.
PrivateEndpoint	A Microsoft.Network szolgáltató magánvégpont-erőforrása.
PrivateEndpointConnection	Az Azure AI Search szolgáltatás meglévő privát végpontkapcsolatát ismerteti.
PrivateEndpointConnectionProperties	A keresési szolgáltatással létesített meglévő privát végpontkapcsolat tulajdonságait ismerteti.
PrivateLinkServiceConnectionProvisioningState	A privát kapcsolat szolgáltatáskapcsolat kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres, Hiányos vagy Mégse.
PrivateLinkServiceConnectionState	Egy meglévő Azure Private Link-szolgáltatás privát végponthoz való kapcsolatának aktuális állapotát ismerteti.
PrivateLinkServiceConnectionStatus	A privát kapcsolat szolgáltatáskapcsolat á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.
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 hiba tulajdonságának neve).

PrivateEndpoint

Tárgy

A Microsoft.Network szolgáltató magánvégpont-erőforrása.

Név	Típus	Description
id	string	A Microsoft.Network szolgáltató magánvégpont-erőforrásának erőforrás-azonosítója.

PrivateEndpointConnection

Tárgy

Az Azure AI Search szolgáltatás meglévő privát végpontkapcsolatát 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	PrivateEndpointConnectionProperties	Az Azure AI Search szolgáltatással létesített meglévő privát végpontkapcsolat tulajdonságait ismerteti.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Tárgy

A keresési szolgáltatással létesített meglévő privát végpontkapcsolat tulajdonságait ismerteti.

Név	Típus	Description
groupId	string	Annak az Azure-erőforrásnak a csoportazonosítója, amelyhez a privát kapcsolati szolgáltatás tartozik.
privateEndpoint	PrivateEndpoint	A Microsoft.Network szolgáltató magánvégpont-erőforrása.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Egy meglévő Azure Private Link-szolgáltatás privát végponthoz való kapcsolatának aktuális állapotát ismerteti.
provisioningState	PrivateLinkServiceConnectionProvisioningState	A privát kapcsolat szolgáltatáskapcsolat kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres, Hiányos vagy Mégse.

PrivateLinkServiceConnectionProvisioningState

Felsorolás

A privát kapcsolat szolgáltatáskapcsolat kiépítési állapota. Az érvényes értékek: Frissítés, Törlés, Sikertelen, Sikeres, Hiányos vagy Mégse.

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

PrivateLinkServiceConnectionState

Tárgy

Egy meglévő Azure Private Link-szolgáltatás privát végponthoz való kapcsolatának aktuális állapotát ismerteti.

Név	Típus	Alapértelmezett érték	Description
actionsRequired	string	None	Az esetlegesen szükséges további műveletek leírása.
description	string		A privát kapcsolati szolgáltatás kapcsolati állapotának leírása.
status	PrivateLinkServiceConnectionStatus		A privát kapcsolat szolgáltatáskapcsolat állapota. Az érvényes értékek függőben, jóváhagyva, elutasítva vagy leválasztva.

PrivateLinkServiceConnectionStatus

Felsorolás

A privát kapcsolat szolgáltatáskapcsolat állapota. Az érvényes értékek függőben, jóváhagyva, elutasítva vagy leválasztva.

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