Cluster Principal Assignments - Get

サービス:

Azure Kusto

API バージョン:

2025-02-14

Kusto クラスター プリンシパルの割り当てを取得します。

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

URI パラメーター

名前	/	必須	型	説明
clusterName	path	True	string pattern: ^.*$	Kusto クラスターの名前。
principalAssignmentName	path	True	string pattern: ^.*$	Kusto principalAssignment の名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソース グループの名前。 名前の大文字と小文字は区別されません。
subscriptionId	path	True	string minLength: 1	ターゲット サブスクリプションの ID。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	ClusterPrincipalAssignment	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザー アカウントを偽装する

例

KustoClusterPrincipalAssignmentsGet

要求のサンプル

HTTP

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

応答のサンプル

状態コード:

200

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

定義

名前	説明
ClusterPrincipalAssignment	クラスはクラスタープリンシパル課題を表します。
ClusterPrincipalRole	クラスター プリンシパル ロール。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
PrincipalType	プリンシパルの種類。
ProvisioningState	リソースのプロビジョニング済み状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

ClusterPrincipalAssignment

Object

クラスはクラスタープリンシパル課題を表します。

名前	型	説明
id	string	リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties.aadObjectId	string	AAD (Azure active directory) のサービス principal object id
properties.principalId	string	クラスター プリンシパルに割り当てられたプリンシパル ID。 ユーザーの電子メール、アプリケーション ID、またはセキュリティ グループ名を指定できます。
properties.principalName	string	主な名称
properties.principalType	PrincipalType	プリンシパルの種類。
properties.provisioningState	ProvisioningState	リソースのプロビジョニング済み状態。
properties.role	ClusterPrincipalRole	クラスター プリンシパル ロール。
properties.tenantId	string	プリンシパルのテナント ID
properties.tenantName	string	主体の借主名
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

ClusterPrincipalRole

列挙

クラスター プリンシパル ロール。

値	説明
AllDatabasesAdmin	AllDatabasesAdmin
AllDatabasesViewer	AllDatabasesViewer
AllDatabasesMonitor	AllDatabasesMonitor

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

PrincipalType

列挙

プリンシパルの種類。

値	説明
App	アプリケーション
Group	グループ
User	User

ProvisioningState

列挙

リソースのプロビジョニング済み状態。

値	説明
Running	Running
Creating	作成
Deleting	削除中
Succeeded	成功しました
Failed	失敗
Moving	涙ぐましい
Canceled	取り消し済み

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。