通过

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

Role Assignments - List For Scope

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

获取范围的角色分配。

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01
具有可选参数: 
GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2025-07-01&$filter={$filter}

URI 参数

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

string

角色分配的范围。
vaultBaseUrl
 path True

string (uri)

api-version
 query True

string

minLength: 1

要用于此操作的 API 版本。
$filter
 query

string

要应用于作的筛选器。 使用 $filter=atScope（） 返回范围或范围以上的所有角色分配。 使用 $filter=principalId eq {id} 返回指定主体范围、高于或低于的所有角色分配。

响应

名称 类型 说明
200 OK

RoleAssignmentListResult

请求已成功。
Other Status Codes

KeyVaultError

意外的错误响应。

安全性

OAuth2Auth

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

作用域

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

示例

Get role assignments for a scope

示例请求

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

示例响应

状态代码:
200 
{
  "value": [
    {
      "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

角色分配
RoleAssignmentListResult

角色分配列表作结果。
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

角色分配类型。

RoleAssignmentListResult

Object

角色分配列表作结果。

名称 类型 说明
nextLink

string

用于获取下一组结果的 URL。
value

RoleAssignment[]

角色分配列表。

RoleAssignmentPropertiesWithScope

Object

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

名称 类型 说明
principalId

string

主体 ID。
roleDefinitionId

string

角色定义 ID。
scope

RoleScope

角色范围。

RoleScope

枚举

角色范围。

值 说明
/

全局范围
/keys

键范围