Managed Private Endpoints - Get Workspace Managed Private Endpoint

Servicio:: Core

Versión de la API:: v1

Obtiene el punto de conexión privado administrado especificado.

Nota:

Esta API forma parte de una versión preliminar y solo se proporciona con fines de evaluación y desarrollo. Puede cambiar en función de los comentarios y no se recomienda para su uso en producción.

Permissions

El autor de la llamada debe tener rol de área de trabajo o superior del visor.

Ámbitos delegados necesarios

Workspace.Read.All o Workspace.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity	Support
User	Yes
Entidad de servicio e Identidades administradas	Yes

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/managedPrivateEndpoints/{managedPrivateEndpointId}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
managedPrivateEndpointId	path	True	string (uuid)	Identificador de punto de conexión privado administrado.
workspaceId	path	True	string (uuid)	Identificador del área de trabajo.

Respuestas

Nombre	Tipo	Description
200 OK	ManagedPrivateEndpoint	Solicitud completada correctamente.
Other Status Codes	ErrorResponse	Códigos de error comunes: UnknownError: se produjo un error.

Nombre

Tipo

Description

200 OK

ManagedPrivateEndpoint

Solicitud completada correctamente.

Other Status Codes

ErrorResponse

Códigos de error comunes:

UnknownError: se produjo un error.

Ejemplos

Get managed private endpoint example

Solicitud de ejemplo

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/47482db6-4583-4672-86dd-999d0f8f4d7a/managedPrivateEndpoints/59a92b06-6e5a-468c-b748-e28c8ff28da3

Respuesta de muestra

status code:: 200

{
  "id": "59a92b06-6e5a-468c-b748-e28c8ff28da3",
  "name": "SqlPE",
  "targetPrivateLinkResourceId": "/subscriptions/e3bf3f1a-4d64-4e42-85e9-aa1b84e3874/resourceGroups/testRG/providers/Microsoft.SqlServer/SqlServer/sql1",
  "provisioningState": "Succeeded",
  "connectionState": {
    "status": "Approved",
    "description": "Endpoint approved"
  },
  "targetSubresourceType": "sqlServer"
}

Definiciones

Nombre	Description
ConnectionStatus	Estado de conexión del punto de conexión privado. El estado de conexión adicional se puede agregar a lo largo del tiempo.
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
ManagedPrivateEndpoint	Punto de conexión privado administrado.
PrivateEndpointConnectionState	Estado de conexión del punto de conexión privado
PrivateEndpointProvisioningState	Estado de aprovisionamiento del punto de conexión.

ConnectionStatus

Enumeración

Estado de conexión del punto de conexión privado. El estado de conexión adicional se puede agregar a lo largo del tiempo.

Valor	Description
Pending	Aprobación pendiente
Approved	Punto de conexión aprobado
Rejected	Punto de conexión rechazado
Disconnected	Punto de conexión desconectado

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.