Compartilhar via


Private Endpoint Connections - Get

Obtém a conexão de ponto de extremidade privado especificada.
Para saber mais sobre clusters privados, confira: https://docs.microsoft.com/azure/aks/private-clusters

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/privateEndpointConnections/{privateEndpointConnectionName}?api-version=2024-02-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
privateEndpointConnectionName
path True

string

O nome da conexão de ponto de extremidade privado.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

resourceName
path True

string

O nome do recurso de cluster gerenciado.

Padrão Regex: ^[a-zA-Z0-9]$|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$

subscriptionId
path True

string

uuid

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

A versão da API a ser usada para esta operação.

Respostas

Nome Tipo Description
200 OK

PrivateEndpointConnection

OK

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get Private Endpoint Connection

Solicitação de exemplo

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/privateEndpointConnections/privateendpointconnection1?api-version=2024-02-01

Resposta de exemplo

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedCluster/clustername1/privateEndpointConnections/privateendpointconnection1",
  "name": "privateendpointconnection1",
  "type": "Microsoft.Network/privateLinkServices/privateEndpointConnections",
  "properties": {
    "privateEndpoint": {
      "id": "/subscriptions/subid2/resourceGroups/rg2/providers/Microsoft.Network/privateEndpoints/pe2"
    },
    "privateLinkServiceConnectionState": {
      "status": "Approved"
    },
    "provisioningState": "Succeeded"
  }
}

Definições

Nome Description
CloudError

Uma resposta de erro do serviço contêiner.

CloudErrorBody

Uma resposta de erro do serviço contêiner.

ConnectionStatus

A conexão do serviço de link privado status.

PrivateEndpoint

Ponto de extremidade privado ao qual uma conexão pertence.

PrivateEndpointConnection

Uma conexão de ponto de extremidade privado

PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.

PrivateLinkServiceConnectionState

O estado de uma conexão de serviço de link privado.

CloudError

Uma resposta de erro do serviço contêiner.

Nome Tipo Description
error

CloudErrorBody

Detalhes sobre o erro.

CloudErrorBody

Uma resposta de erro do serviço contêiner.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

ConnectionStatus

A conexão do serviço de link privado status.

Nome Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PrivateEndpoint

Ponto de extremidade privado ao qual uma conexão pertence.

Nome Tipo Description
id

string

A ID do recurso do ponto de extremidade privado

PrivateEndpointConnection

Uma conexão de ponto de extremidade privado

Nome Tipo Description
id

string

A ID da conexão de ponto de extremidade privado.

name

string

O nome da conexão de ponto de extremidade privado.

properties.privateEndpoint

PrivateEndpoint

O recurso do ponto de extremidade privado.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Uma coleção de informações sobre o estado da conexão entre o consumidor de serviço e o provedor.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.

type

string

O tipo de recurso.

PrivateEndpointConnectionProvisioningState

O estado de provisionamento atual.

Nome Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateLinkServiceConnectionState

O estado de uma conexão de serviço de link privado.

Nome Tipo Description
description

string

A descrição da conexão do serviço de link privado.

status

ConnectionStatus

A conexão do serviço de link privado status.