Managed Instance Private Endpoint Connections - List By Managed Instance

Obtém todas as conexões de ponto de extremidade privadas em um servidor.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/privateEndpointConnections?api-version=2025-01-01

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
managedInstanceName
path True

string

O nome da instância gerenciada.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

subscriptionId
path True

string (uuid)

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

api-version
query True

string

minLength: 1

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

Respostas

Name Tipo Descrição
200 OK

ManagedInstancePrivateEndpointConnectionListResult

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

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

Âmbitos

Name Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

Gets list of private endpoint connections on a server.

Pedido de amostra

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/test-cl/privateEndpointConnections?api-version=2025-01-01

Resposta da amostra

{
  "value": [
    {
      "name": "private-endpoint-connection-name",
      "type": "Microsoft.Sql/managedInstances/privateEndpointConnections",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/test-cl/privateEndpointConnections/private-endpoint-connection-name",
      "properties": {
        "privateEndpoint": {
          "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
        },
        "privateLinkServiceConnectionState": {
          "description": "Auto-approved",
          "actionsRequired": "None",
          "status": "Approved"
        },
        "provisioningState": "Ready"
      }
    },
    {
      "name": "private-endpoint-connection-name-2",
      "type": "Microsoft.Sql/managedInstances/privateEndpointConnections",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/test-cl/privateEndpointConnections/private-endpoint-connection-name-2",
      "properties": {
        "privateEndpoint": {
          "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name-2"
        },
        "privateLinkServiceConnectionState": {
          "description": "Auto-approved",
          "actionsRequired": "None",
          "status": "Approved"
        },
        "provisioningState": "Ready"
      }
    }
  ]
}

Definições

Name Descrição
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ManagedInstancePrivateEndpointConnection

Uma conexão de ponto de extremidade privada

ManagedInstancePrivateEndpointConnectionListResult

A resposta de uma operação de lista ManagedInstancePrivateEndpointConnection.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
systemData

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

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

ManagedInstancePrivateEndpointConnection

Uma conexão de ponto de extremidade privada

Name Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.privateEndpoint

ManagedInstancePrivateEndpointProperty

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

properties.privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Estado da Conexão da Conexão de Ponto Final Privado.

properties.provisioningState

string

Estado da Conexão de Ponto Final Privado.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

ManagedInstancePrivateEndpointConnectionListResult

A resposta de uma operação de lista ManagedInstancePrivateEndpointConnection.

Name Tipo Descrição
nextLink

string (uri)

O link para a próxima página de itens

value

ManagedInstancePrivateEndpointConnection[]

Os itens ManagedInstancePrivateEndpointConnection nesta página

ManagedInstancePrivateEndpointProperty

Name Tipo Descrição
id

string

ID do recurso do ponto de extremidade privado.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Tipo Descrição
actionsRequired

string

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

description

string

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

status

string

O status da conexão do serviço de link privado.

systemData

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

Name Tipo Descrição
createdAt

string (date-time)

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 (date-time)

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.