Private Endpoint Connections - Update By Host Pool

Layanan:

Desktop Virtualization

Versi API:

2025-10-10

Menyetujui atau menolak koneksi titik akhir privat.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DesktopVirtualization/hostPools/{hostPoolName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2025-10-10

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	Nama kumpulan host dalam grup sumber daya yang ditentukan
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	Diperlukan	Jenis	Deskripsi
properties.privateLinkServiceConnectionState	True	PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
properties.privateEndpoint		PrivateEndpoint	Sumber daya titik akhir privat.

Respons

Nama	Jenis	Deskripsi
200 OK	PrivateEndpointConnectionWithSystemData	Berhasil diperbarui.
Other Status Codes	CloudError	Respons kesalahan otomatisasi yang menjelaskan mengapa operasi gagal.

Contoh

PrivateEndpointConnection_UpdateByHostPool

Permintaan sampel

HTTP

PUT https://management.azure.com/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostPools/hostPool1/privateEndpointConnections/hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b?api-version=2025-10-10

{
  "properties": {
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by admin@consoto.com",
      "actionsRequired": "None"
    }
  }
}

Respon sampel

Kode status:

200

{
  "name": "hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b",
  "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup1/providers/Microsoft.DesktopVirtualization/hostpools/hostPool1/privateEndpointConnections/hostPool1.377103f1-5179-4bdf-8556-4cdd3207cc5b",
  "type": "Microsoft.DesktopVirtualization/hostpools/privateEndpointConnections",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "privateEndpoint": {
      "id": "/subscriptions/daefabc0-95b4-48b3-b645-8a753a63c4fa/resourceGroups/resourceGroup2/providers/Microsoft.Network/privateEndpoints/endpointName1"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved",
      "description": "Approved by admin@consoto.com",
      "actionsRequired": "None"
    }
  }
}

Definisi

Nama	Deskripsi
CloudError	Objek kesalahan cloud.
CloudErrorProperties	Properti objek kesalahan cloud.
createdByType	Jenis identitas yang membuat sumber daya.
PrivateEndpoint	Sumber daya titik akhir privat.
PrivateEndpointConnectionProvisioningState	Status provisi saat ini.
PrivateEndpointConnectionWithSystemData	Sumber daya Koneksi Titik Akhir Privat.
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.

CloudError

Objek

Objek kesalahan cloud.

Nama	Jenis	Deskripsi
error	CloudErrorProperties	Properti objek kesalahan cloud.

CloudErrorProperties

Objek

Properti objek kesalahan cloud.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

PrivateEndpoint

Objek

Sumber daya titik akhir privat.

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

PrivateEndpointConnectionProvisioningState

Enumerasi

Status provisi saat ini.

Nilai	Deskripsi
Succeeded
Creating
Deleting
Failed

PrivateEndpointConnectionWithSystemData

Objek

Sumber daya Koneksi Titik Akhir Privat.

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.groupIds	string[]	Id grup untuk sumber daya titik akhir privat.
properties.privateEndpoint	PrivateEndpoint	Sumber daya titik akhir privat.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Kumpulan informasi tentang status koneksi antara konsumen layanan dan penyedia.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Status provisi sumber daya koneksi titik akhir privat.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

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 apa pun pada consumer.
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)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.