Database Principal Assignments - Get

Služba:

Azure Kusto

Verze rozhraní API:

2025-02-14

Získá objekt zabezpečení databáze clusteru Kusto.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
clusterName	path	True	string pattern: ^.*$	Název clusteru Kusto.
databaseName	path	True	string pattern: ^.*$	Název databáze v clusteru Kusto.
principalAssignmentName	path	True	string pattern: ^.*$	Název objektu zabezpečení Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	DatabasePrincipalAssignment	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

KustoDatabasePrincipalAssignmentsGet

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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"
  }
}

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DatabasePrincipalAssignment	Třída představující hlavní úkol databáze.
DatabasePrincipalRole	Role instančního objektu databáze
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
PrincipalType	Typ objektu zabezpečení.
ProvisioningState	Zřízený stav prostředku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DatabasePrincipalAssignment

Objekt

Třída představující hlavní úkol databáze.

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.aadObjectId	string	Object ID služby v AAD (Azure Active Directory)
properties.principalId	string	ID objektu zabezpečení přiřazené k instančnímu objektu databáze. Může to být e-mail uživatele, ID aplikace nebo název skupiny zabezpečení.
properties.principalName	string	Hlavní název
properties.principalType	PrincipalType	Typ objektu zabezpečení.
properties.provisioningState	ProvisioningState	Zřízený stav prostředku.
properties.role	DatabasePrincipalRole	Role instančního objektu databáze
properties.tenantId	string	ID tenanta objektu zabezpečení
properties.tenantName	string	Nájemní jméno ředitele
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

DatabasePrincipalRole

Výčet

Role instančního objektu databáze

Hodnota	Description
Admin	Administrátor
Ingestor	Ingestor
Monitor	Monitor
User	User
UnrestrictedViewer	UnrestrictedViewer
Viewer	Prohlížeč

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

PrincipalType

Výčet

Typ objektu zabezpečení.

Hodnota	Description
App	Aplikace
Group	Skupina
User	User

ProvisioningState

Výčet

Zřízený stav prostředku.

Hodnota	Description
Running	Running
Creating	Vytváření
Deleting	Odstranit
Succeeded	Úspěch
Failed	Nezdařilo se
Moving	Dojemný
Canceled	Zrušeno

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.