Private Endpoint Connections - Update By Host Pool

Servicio:: Desktop Virtualization

Versión de la API:: 2025-10-10

Aprobar o rechazar una conexión de punto de conexión privado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
hostPoolName	path	True	string minLength: 3 maxLength: 64 pattern: ^[A-Za-z0-9@.\-_ ]*$	El nombre del grupo de hosts dentro del grupo de recursos especificado
privateEndpointConnectionName	path	True	string	Nombre de la conexión de punto de conexión privado asociada al recurso Azure.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.privateLinkServiceConnectionState	True	PrivateLinkServiceConnectionState	Una recopilación de información sobre el estado de la conexión entre el consumidor de servicios y el proveedor.
properties.privateEndpoint		PrivateEndpoint	Recurso de punto de conexión privado.

Respuestas

Nombre	Tipo	Description
200 OK	PrivateEndpointConnectionWithSystemData	Se ha actualizado correctamente.
Other Status Codes	CloudError	Respuesta de error de automatización que describe por qué falló la operación.

Ejemplos

PrivateEndpointConnection_UpdateByHostPool

Solicitud de ejemplo

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

Respuesta de muestra

status code:: 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"
    }
  }
}

Definiciones

Nombre	Description
CloudError	Objeto de error en la nube.
CloudErrorProperties	Propiedades del objeto de error en la nube.
createdByType	Tipo de identidad que creó el recurso.
PrivateEndpoint	Recurso de punto de conexión privado.
PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento actual.
PrivateEndpointConnectionWithSystemData	El recurso Conexión de punto de conexión privado.
PrivateEndpointServiceConnectionStatus	Estado de conexión del punto de conexión privado.
PrivateLinkServiceConnectionState	Una recopilación de información sobre el estado de la conexión entre el consumidor de servicios y el proveedor.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Objeto

Objeto de error en la nube.

Nombre	Tipo	Description
error	CloudErrorProperties	Propiedades del objeto de error en la nube.

CloudErrorProperties

Objeto

Propiedades del objeto de error en la nube.

Nombre	Tipo	Description
code	string	Código de error
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

PrivateEndpoint

Objeto

Recurso de punto de conexión privado.

Nombre	Tipo	Description
id	string	Identificador de ARM para el punto de conexión privado.

PrivateEndpointConnectionProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor	Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointConnectionWithSystemData

Objeto

El recurso Conexión de punto de conexión privado.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties.groupIds	string[]	Identificadores de grupo para el recurso de punto de conexión privado.
properties.privateEndpoint	PrivateEndpoint	Recurso de punto de conexión privado.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Una recopilación de información sobre el estado de la conexión entre el consumidor de servicios y el proveedor.
properties.provisioningState	PrivateEndpointConnectionProvisioningState	Estado de aprovisionamiento del recurso de conexión de punto de conexión privado.
systemData	systemData	Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointServiceConnectionStatus

Enumeración

Estado de conexión del punto de conexión privado.

Valor	Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Objeto

Una recopilación de información sobre el estado de la conexión entre el consumidor de servicios y el proveedor.

Nombre	Tipo	Description
actionsRequired	string	Un mensaje que indica si los cambios en el proveedor de servicios requieren actualizaciones sobre el consumidor.
description	string	Motivo de aprobación o rechazo de la conexión.
status	PrivateEndpointServiceConnectionStatus	Indica si el propietario del servicio ha aprobado o rechazado o eliminado la conexión.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Private Endpoint Connections - Update By Host Pool

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

PrivateEndpointConnection_UpdateByHostPool

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CloudError

CloudErrorProperties

createdByType

PrivateEndpoint

PrivateEndpointConnectionProvisioningState

PrivateEndpointConnectionWithSystemData

PrivateEndpointServiceConnectionStatus

PrivateLinkServiceConnectionState

systemData