Bookshelf Private Endpoint Connections - Create Or Update

Szolgáltatás:

Discovery

API-verzió:

2026-02-01-preview

Jóváhagyja vagy frissíti a megadott privát végpontkapcsolatot.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Discovery/bookshelves/{bookshelfName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2026-02-01-preview

URI-paraméterek

Name	In	Kötelező	Típus	Description
bookshelfName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	A könyvespolc neve
privateEndpointConnectionName	path	True	string	Az Azure erőforráshoz tartozó privát végpontkapcsolat neve.
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.
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 törzse

Name	Típus	Description
properties	PrivateEndpointConnectionProperties	Az erőforrás erőforrás-specifikus tulajdonságai.

Válaszok

Name	Típus	Description
200 OK	BookshelfPrivateEndpointConnection	A 'BookshelfPrivateEndpointConnection' erőforrás frissítési művelete sikeres
201 Created	BookshelfPrivateEndpointConnection	Resource 'BookshelfPrivateEndpointConnection' create operation succeeded Fejlécek Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow.

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

Hatókörök

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

Példák

BookshelfPrivateEndpointConnections_CreateOrUpdate_MaximumSet

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection?api-version=2026-02-01-preview

{
  "properties": {
    "privateEndpoint": {},
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    }
  }
}

Mintaválasz

Állapotkód:

200

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection",
  "name": "connection",
  "type": "Microsoft.Discovery/bookshelves/privateEndpointConnections",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "groupIds": [
      "nhws"
    ],
    "privateEndpoint": {
      "id": "vbt"
    },
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    },
    "provisioningState": "Succeeded"
  }
}

Állapotkód:

201

Azure-AsyncOperation: https://contoso.com/operationstatus
Retry-After: 10

{
  "id": "/subscriptions/C058B75F-64D2-4E9D-8B66-65339DCB22C7/resourceGroups/rgdiscovery/providers/Microsoft.Discovery/bookshelves/a65f3c23bf2baa5bd4/privateEndpointConnections/connection",
  "name": "connection",
  "type": "Microsoft.Discovery/bookshelves/privateEndpointConnections",
  "systemData": {
    "createdBy": "ly",
    "createdByType": "User",
    "createdAt": "2026-02-10T17:26:12.585Z",
    "lastModifiedBy": "xxc",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2026-02-10T17:26:12.586Z"
  },
  "properties": {
    "groupIds": [
      "nhws"
    ],
    "privateEndpoint": {
      "id": "vbt"
    },
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "lknyprq",
      "actionsRequired": "vgqhrxvmviabfgmafqtbej"
    },
    "provisioningState": "Succeeded"
  }
}

Definíciók

Name	Description
BookshelfPrivateEndpointConnection	A Bookshelf privát végpontkapcsolati forrása.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
PrivateEndpoint	A privát végpont erőforrása.
PrivateEndpointConnectionProperties	A privát végpontkapcsolat tulajdonságai.
PrivateEndpointConnectionProvisioningState	Az aktuális kiépítési állapot.
PrivateEndpointServiceConnectionStatus	A privát végpont kapcsolatának állapota.
PrivateLinkServiceConnectionState	A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

BookshelfPrivateEndpointConnection

Tárgy

A Bookshelf privát végpontkapcsolati forrása.

Name	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	PrivateEndpointConnectionProperties	Az erőforrás erőforrás-specifikus tulajdonságai.
systemData	systemData	Azure Resource Manager metaadat, amely createdBy és modifiedBy információkat tartalmaz.
type	string	Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok"

createdByType

Felsorolás

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

Érték	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Name	Típus	Description
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hiba célpontja.

ErrorResponse

Tárgy

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

PrivateEndpoint

Tárgy

A privát végpont erőforrása.

Name	Típus	Description
id	string	A privát végpont ARM-azonosítója.

PrivateEndpointConnectionProperties

Tárgy

A privát végpontkapcsolat tulajdonságai.

Name	Típus	Description
groupIds	string[]	A privát végpont erőforrásának csoportazonosítói.
privateEndpoint	PrivateEndpoint	A privát végpont erőforrása.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.
provisioningState	PrivateEndpointConnectionProvisioningState	A privát végpont kapcsolati erőforrásának kiépítési állapota.

PrivateEndpointConnectionProvisioningState

Felsorolás

Az aktuális kiépítési állapot.

Érték	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Felsorolás

A privát végpont kapcsolatának állapota.

Érték	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Tárgy

A szolgáltatásfelhasználó és a szolgáltató közötti kapcsolat állapotával kapcsolatos információk gyűjteménye.

Name	Típus	Description
actionsRequired	string	Üzenet, amely jelzi, hogy a szolgáltató módosításaihoz szükség van-e a fogyasztó frissítésére.
description	string	A kapcsolat jóváhagyásának/elutasításának oka.
status	PrivateEndpointServiceConnectionStatus	Azt jelzi, hogy a szolgáltatás tulajdonosa jóváhagyta/elutasította/eltávolította-e a kapcsolatot.

systemData

Tárgy

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

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