Access Connectors - List By Resource Group

Serviço:

Databricks

Versão da API:

2026-01-01

Obtém todos os Conectores de Acesso do Azure Databricks dentro de um grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/accessConnectors?api-version=2026-01-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
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	Description
200 OK	AccessConnectorListResult	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Lists Azure Databricks Access Connectors within a resource group

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/accessConnectors?api-version=2026-01-01

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "name": "myAccessConnector1",
      "type": "Microsoft.Databricks/accessConnectors",
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector1",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "5619ff16-afe1-47e5-ae67-8393c6c3223d",
        "tenantId": "e3fe3f22-4b98-4c04-82cc-d8817d1b17da"
      },
      "location": "West US",
      "properties": {
        "provisioningState": "Succeeded",
        "referedBy": []
      },
      "tags": {}
    },
    {
      "name": "myAccessConnector",
      "type": "Microsoft.Databricks/accessConnectors",
      "id": "/subscriptions/11111111-1111-1111-1111-111111111111/resourceGroups/rg/providers/Microsoft.Databricks/accessConnectors/myAccessConnector2",
      "identity": {
        "type": "SystemAssigned",
        "principalId": "7ad2bae1-37d0-413e-91f8-b0b7bef807fc",
        "tenantId": "e3fe3f22-4b98-4c04-82cc-d8817d1b17da"
      },
      "location": "West US",
      "properties": {
        "provisioningState": "Succeeded",
        "referedBy": []
      },
      "tags": {}
    }
  ]
}

Definições

Name	Description
AccessConnector	Informações sobre o Azure Databricks Access Connector.
AccessConnectorListResult	A resposta de uma operação de lista AccessConnector.
AccessConnectorProperties
ErrorDetail	Detalhes do erro.
ErrorInfo	O código e a mensagem para um erro.
ErrorResponse	Contém detalhes quando o código de resposta indica um erro.
ManagedServiceIdentity	Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
ProvisioningState	Status de provisionamento do espaço de trabalho.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

AccessConnector

Object

Informações sobre o Azure Databricks Access Connector.

Name	Tipo	Description
id	string	ID do recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	As identidades de serviço gerenciado atribuídas a este recurso.
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties	AccessConnectorProperties	Propriedades do Azure Databricks Access Connector
tags	object	Tags de recursos.
type	string	O tipo do recurso. Ex- Microsoft.Compute/virtualMachines ou Microsoft.Storage/storageAccounts.

AccessConnectorListResult

Object

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

Name	Tipo	Description
nextLink	string (uri)	O link para a próxima página de itens
value	AccessConnector[]	Os itens do AccessConnector nesta página

AccessConnectorProperties

Object

Name	Tipo	Description
provisioningState	ProvisioningState	Status de provisionamento do Access Connector.
referedBy	string[]	Lista de espaços de trabalho referentes a este Conector de Acesso.

ErrorDetail

Object

Detalhes do erro.

Name	Tipo	Description
code	string	O código do erro.
message	string	Uma mensagem de erro legível por humanos.
target	string	Indica qual propriedade na solicitação é responsável pelo erro.

ErrorInfo

Object

O código e a mensagem para um erro.

Name	Tipo	Description
code	string	Um código de erro legível por máquina.
details	ErrorDetail[]	detalhes do erro.
innererror	string	Detalhes do erro interno, se existirem.
message	string	Uma mensagem de erro legível por humanos.

ErrorResponse

Object

Contém detalhes quando o código de resposta indica um erro.

Name	Tipo	Description
error	ErrorInfo	Os detalhes do erro.

ManagedServiceIdentity

Object

Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)

Name	Tipo	Description
principalId	string (uuid)	O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
tenantId	string (uuid)	O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string,  UserAssignedIdentity>	User-Assigned Identidades O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Enumeração

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumeração

Status de provisionamento do espaço de trabalho.

Valor	Description
Accepted	Aceito
Running	Running
Ready	Pronto/a
Creating	Criação
Created	Criado
Deleting	Apagar
Deleted	Eliminados
Canceled	Cancelado
Failed	Falha
Succeeded	Succeeded
Updating	Atualização

UserAssignedIdentity

Object

Propriedades de identidade atribuídas pelo usuário

Name	Tipo	Description
clientId	string (uuid)	O ID do cliente da identidade atribuída.
principalId	string (uuid)	O ID principal da identidade atribuída.