Role Assignments - List For Scope

Tjänst:

Key Vault

API-version:

2025-07-01

Hämtar rolltilldelningar för ett omfång.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
scope	path	True	string	Omfånget för rolltilldelningarna.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.
$filter	query		string	Filtret som ska tillämpas på åtgärden. Använd $filter=atScope() för att returnera alla rolltilldelningar på eller över omfånget. Använd $filter=principalId eq {id} för att returnera alla rolltilldelningar på, över eller under omfånget för den angivna huvudrollen.

Svar

Name	Typ	Description
200 OK	RoleAssignmentListResult	Begäran har slutförts.
Other Status Codes	KeyVaultError	Ett oväntat felsvar.

Säkerhet

OAuth2Auth

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
https://vault.azure.net/.default

Exempel

Get role assignments for a scope

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
Error
KeyVaultError	Felundantaget för nyckelvalvet.
RoleAssignment	Rolltilldelningar
RoleAssignmentListResult	Åtgärdsresultat för rolltilldelningslista.
RoleAssignmentPropertiesWithScope	Rolltilldelningsegenskaper med omfång.
RoleScope	Rollens omfång.

Error

Objekt

Name	Typ	Description
code	string	Felkoden.
innererror	Error	Felet på nyckelvalvsservern.
message	string	Felmeddelandet.

KeyVaultError

Objekt

Felundantaget för nyckelvalvet.

Name	Typ	Description
error	Error	Felet på nyckelvalvsservern.

RoleAssignment

Objekt

Rolltilldelningar

Name	Typ	Description
id	string	Rolltilldelnings-ID:t.
name	string	Namnet på rolltilldelningen.
properties	RoleAssignmentPropertiesWithScope	Egenskaper för rolltilldelning.
type	string	Typ av rolltilldelning.

RoleAssignmentListResult

Objekt

Åtgärdsresultat för rolltilldelningslista.

Name	Typ	Description
nextLink	string	Den URL som ska användas för att hämta nästa uppsättning resultat.
value	RoleAssignment[]	Lista över rolltilldelningar.

RoleAssignmentPropertiesWithScope

Objekt

Rolltilldelningsegenskaper med omfång.

Name	Typ	Description
principalId	string	Huvud-ID:t.
roleDefinitionId	string	Rolldefinitions-ID.
scope	RoleScope	Rollens omfång.

RoleScope

Uppräkning

Rollens omfång.

Värde	Description
/	Global räckvidd
/keys	Omfång för nycklar