Database Principal Assignments - Get

Serviço:

Azure Kusto

Versão da API:

2025-02-14

Obtém um banco de dados de cluster Kusto principalAssignment.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}/databases/{databaseName}/principalAssignments/{principalAssignmentName}?api-version=2025-02-14

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
clusterName	path	True	string pattern: ^.*$	O nome do cluster Kusto.
databaseName	path	True	string pattern: ^.*$	O nome do banco de dados no cluster Kusto.
principalAssignmentName	path	True	string pattern: ^.*$	O nome do Kusto principalAssignment.
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 minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	DatabasePrincipalAssignment	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

KustoDatabasePrincipalAssignmentsGet

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster/databases/Kustodatabase8/principalAssignments/kustoprincipal1?api-version=2025-02-14

Resposta da amostra

Código de estado:

200

{
  "name": "kustoCluster/Kustodatabase8/kustoprincipal1",
  "type": "Microsoft.Kusto/Clusters/Databases/PrincipalAssignments",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster/Databases/Kustodatabase8/PrincipalAssignments/kustoprincipal1",
  "properties": {
    "aadObjectId": "98765432-1234-1234-1234-123456789123",
    "principalId": "87654321-1234-1234-1234-123456789123",
    "principalName": "TestApp",
    "principalType": "App",
    "provisioningState": "Succeeded",
    "role": "Admin",
    "tenantId": "12345678-1234-1234-1234-123456789123",
    "tenantName": "tenantName"
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
DatabasePrincipalAssignment	A classe representa uma tarefa principal de base de dados.
DatabasePrincipalRole	Função principal do banco de dados.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
PrincipalType	Tipo principal.
ProvisioningState	O estado provisionado do recurso.
systemData	Metadados referentes à criação e última modificação do recurso.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DatabasePrincipalAssignment

Object

A classe representa uma tarefa principal de base de dados.

Name	Tipo	Description
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.aadObjectId	string	O ID do objeto principal do serviço no AAD (Azure Active Directory)
properties.principalId	string	O ID principal atribuído à entidade de banco de dados. Pode ser um e-mail de usuário, ID de aplicativo ou nome de grupo de segurança.
properties.principalName	string	O nome principal
properties.principalType	PrincipalType	Tipo principal.
properties.provisioningState	ProvisioningState	O estado provisionado do recurso.
properties.role	DatabasePrincipalRole	Função principal do banco de dados.
properties.tenantId	string	O ID do inquilino do principal
properties.tenantName	string	O nome do inquilino do diretor
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

DatabasePrincipalRole

Enumeração

Função principal do banco de dados.

Valor	Description
Admin	Administrador
Ingestor	Ingestor
Monitor	Monitor
User	User
UnrestrictedViewer	UnrestrictedViewer
Viewer	Visualizador

ErrorAdditionalInfo

Object

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

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
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

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

PrincipalType

Enumeração

Tipo principal.

Valor	Description
App	App
Group	Grupo
User	User

ProvisioningState

Enumeração

O estado provisionado do recurso.

Valor	Description
Running	Running
Creating	Criação
Deleting	Apagar
Succeeded	Succeeded
Failed	Falha
Moving	Mudança
Canceled	Cancelado

systemData

Object

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

Name	Tipo	Description
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.