Bookshelf Private Endpoint Connections - Create Or Update

Layanan:

Discovery

Versi API:

2026-02-01-preview

Menyetujui atau memperbarui koneksi titik akhir privat yang ditentukan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
bookshelfName	path	True	string pattern: ^[a-zA-Z0-9-]{3,24}$	Nama Rak Buku
privateEndpointConnectionName	path	True	string	Nama koneksi titik akhir privat yang terkait dengan sumber daya Azure.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties	PrivateEndpointConnectionProperties	Properti khusus sumber daya untuk sumber daya ini.

Respons

Nama	Jenis	Deskripsi
200 OK	BookshelfPrivateEndpointConnection	Operasi pembaruan 'BookshelfPrivateEndpointConnection' sumber daya berhasil
201 Created	BookshelfPrivateEndpointConnection	Sumber daya 'BookshelfPrivateEndpointConnection' membuat operasi berhasil Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

BookshelfPrivateEndpointConnections_CreateOrUpdate_MaximumSet

Permintaan sampel

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

Respon sampel

Kode status:

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

Kode status:

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

Definisi

Nama	Deskripsi
BookshelfPrivateEndpointConnection	Sumber daya Koneksi Titik Akhir Privat untuk Rak Buku.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
PrivateEndpoint	Sumber daya titik akhir privat.
PrivateEndpointConnectionProperties	Properti koneksi titik akhir privat.
PrivateEndpointConnectionProvisioningState	Status provisi saat ini.
PrivateEndpointServiceConnectionStatus	Status koneksi titik akhir privat.
PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

BookshelfPrivateEndpointConnection

Objek

Sumber daya Koneksi Titik Akhir Privat untuk Rak Buku.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	PrivateEndpointConnectionProperties	Properti khusus sumber daya untuk sumber daya ini.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

PrivateEndpoint

Objek

Sumber daya titik akhir privat.

Nama	Jenis	Deskripsi
id	string	Pengidentifikasi ARM untuk titik akhir privat.

PrivateEndpointConnectionProperties

Objek

Properti koneksi titik akhir privat.

Nama	Jenis	Deskripsi
groupIds	string[]	Id grup untuk sumber daya titik akhir privat.
privateEndpoint	PrivateEndpoint	Sumber daya titik akhir privat.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
provisioningState	PrivateEndpointConnectionProvisioningState	Status provisi sumber daya koneksi titik akhir privat.

PrivateEndpointConnectionProvisioningState

Enumerasi

Status provisi saat ini.

Nilai	Deskripsi
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Enumerasi

Status koneksi titik akhir privat.

Nilai	Deskripsi
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Objek

Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.

Nama	Jenis	Deskripsi
actionsRequired	string	Pesan yang menunjukkan apakah perubahan pada penyedia layanan memerlukan pembaruan pada konsumen.
description	string	Alasan persetujuan/penolakan koneksi.
status	PrivateEndpointServiceConnectionStatus	Menunjukkan apakah koneksi telah Disetujui/Ditolak/Dihapus oleh pemilik layanan.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Stempel waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.