Partilhar via


Private Endpoints - PrivateEndpointConnections Get

Obtenha propriedades de ligação de ponto final privado para o ponto final privado especificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DigitalTwins/digitalTwinsInstances/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2023-01-31

Parâmetros do URI

Name Em Necessário Tipo Description
privateEndpointConnectionName
path True

string

O nome da ligação de ponto final privado.

resourceGroupName
path True

string

O nome do grupo de recursos que contém o DigitalTwinsInstance.

resourceName
path True

string

O nome do DigitalTwinsInstance.

Regex pattern: ^(?!-)[A-Za-z0-9-]{3,63}(?<!-)$

subscriptionId
path True

string

O identificador da subscrição.

api-version
query True

string

Versão da API de Gestão digitalTwinsInstance.

Respostas

Name Tipo Description
200 OK

PrivateEndpointConnection

O corpo contém as propriedades de ligação do ponto final privado.

Other Status Codes

ErrorResponse

Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Representar a sua conta de utilizador

Exemplos

Get private endpoint connection properties for the given private endpoint

Sample Request

GET https://management.azure.com/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection?api-version=2023-01-31

Sample Response

{
  "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourcegroups/resRg/providers/Microsoft.DigitalTwins/digitalTwinsInstances/myDigitalTwinsService/privateEndpointConnections/myPrivateConnection",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/50016170-c839-41ba-a724-51e9df440b9e/resourceGroups/resRg/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
    },
    "groupIds": [
      "digitalTwinsInstance"
    ],
    "privateLinkServiceConnectionState": {
      "status": "Pending",
      "description": "Please approve my request, thanks.",
      "actionsRequired": "None"
    }
  }
}

Definições

Name Description
ConnectionProperties

As propriedades de uma ligação de ponto final privado.

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

createdByType

O tipo de identidade que criou o recurso.

ErrorDefinition

Definição de erro.

ErrorResponse

Resposta de erro.

PrivateEndpoint

A propriedade de ponto final privado de uma ligação de ponto final privado.

PrivateEndpointConnection

A ligação de ponto final privado de um Duplo Digital.

PrivateLinkServiceConnectionState

O estado da ligação.

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

SystemData

Metadados relativos à criação e última modificação do recurso.

ConnectionProperties

As propriedades de uma ligação de ponto final privado.

Name Tipo Description
groupIds

string[]

A lista de IDs de grupo para a ligação de ponto final privado.

privateEndpoint

PrivateEndpoint

O ponto final privado.

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

O estado da ligação.

provisioningState

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

ConnectionPropertiesProvisioningState

O estado de aprovisionamento.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorDefinition

Definição de erro.

Name Tipo Description
code

string

Código de erro específico do serviço que serve como o subtatus para o código de erro HTTP.

details

ErrorDefinition[]

Detalhes de erro internos.

message

string

Descrição do erro.

ErrorResponse

Resposta de erro.

Name Tipo Description
error

ErrorDefinition

Descrição do erro

PrivateEndpoint

A propriedade de ponto final privado de uma ligação de ponto final privado.

Name Tipo Description
id

string

O identificador de recursos.

PrivateEndpointConnection

A ligação de ponto final privado de um Duplo Digital.

Name Tipo Description
id

string

O identificador de recursos.

name

string

O nome do recurso.

properties

ConnectionProperties

As propriedades da ligação.

systemData

SystemData

Metadados relativos à criação e última modificação da ligação de ponto final privado.

type

string

O tipo de recurso.

PrivateLinkServiceConnectionState

O estado da ligação.

Name Tipo Description
actionsRequired

string

Ações necessárias para uma ligação de ponto final privado.

description

string

A descrição do estado atual de uma ligação de ponto final privado.

status

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

PrivateLinkServiceConnectionStatus

O estado de uma ligação de ponto final privado.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

SystemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.