通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Role Assignments - Get

服务:
Key Vault
API 版本:
2025-07-01

获取指定的角色分配。

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2025-07-01

URI 参数

名称 在 必需 类型 说明
roleAssignmentName
 path True

string

要获取的角色分配的名称。
scope
 path True

string

角色分配的范围。
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

要用于此操作的 API 版本。

响应

名称 类型 说明
200 OK

RoleAssignment

请求已成功。
Other Status Codes

KeyVaultError

意外的错误响应。

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
https://vault.azure.net/.default

示例

Get the specified role assignment

示例请求

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2025-07-01

示例响应

状态代码:
200 
{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

定义

名称 说明
Error
KeyVaultError

密钥保管库错误异常。
RoleAssignment

角色分配
RoleAssignmentPropertiesWithScope

具有作用域的角色分配属性。
RoleScope

角色范围。

Error

Object
名称 类型 说明
code

string

错误代码。
innererror

Error

密钥保管库服务器错误。
message

string

错误消息。

KeyVaultError

Object

密钥保管库错误异常。

名称 类型 说明
error

Error

密钥保管库服务器错误。

RoleAssignment

Object

角色分配

名称 类型 说明
id

string

角色分配 ID。
name

string

角色分配名称。
properties

RoleAssignmentPropertiesWithScope

角色分配属性。
type

string

角色分配类型。

RoleAssignmentPropertiesWithScope

Object

具有作用域的角色分配属性。

名称 类型 说明
principalId

string

主体 ID。
roleDefinitionId

string

角色定义 ID。
scope

RoleScope

角色范围。

RoleScope

枚举

角色范围。

值 说明
/

全局范围
/keys

键范围