Dela via


Role Assignments - List For Scope

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

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

URI-parametrar

Name I Obligatorisk Typ Description
scope
path True

string

Rolltilldelningarnas omfång.

vaultBaseUrl
path True

string

Valvnamnet, till exempel https://myvault.vault.azure.net.

api-version
query True

string

Klient-API-version.

$filter
query

string

Filtret som ska tillämpas på åtgärden. Använd $filter=atScope() för att returnera alla rolltilldelningar vid eller över omfånget. Använd $filter=principalId eq {id} för att returnera alla rolltilldelningar vid, ovanför eller under omfånget för det angivna huvudnamnet.

Svar

Name Typ Description
200 OK

RoleAssignmentListResult

OK – Returnerar en matris med rolltilldelningar.

Other Status Codes

KeyVaultError

Key Vault felsvar som beskriver varför åtgärden misslyckades.

Exempel

ListRoleAssignments

Exempelbegäran

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

Exempelsvar

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

Nyckelvalvsserverfelet.

KeyVaultError

Felfelet för nyckelvalvet.

RoleAssignment

Rolltilldelningar

RoleAssignmentListResult

Åtgärdsresultat för rolltilldelningslista.

RoleAssignmentPropertiesWithScope

Egenskaper för rolltilldelning med omfång.

RoleScope

Rollomfånget.

Error

Nyckelvalvsserverfelet.

Name Typ Description
code

string

Felkoden.

innererror

Error

Nyckelvalvsserverfelet.

message

string

Felmeddelandet.

KeyVaultError

Felfelet för nyckelvalvet.

Name Typ Description
error

Error

Nyckelvalvsserverfelet.

RoleAssignment

Rolltilldelningar

Name Typ Description
id

string

Rolltilldelnings-ID.

name

string

Rolltilldelningens namn.

properties

RoleAssignmentPropertiesWithScope

Egenskaper för rolltilldelning.

type

string

Rolltilldelningstypen.

RoleAssignmentListResult

Åtgärdsresultat för rolltilldelningslista.

Name Typ Description
nextLink

string

Url:en som ska användas för att hämta nästa uppsättning resultat.

value

RoleAssignment[]

Rolltilldelningslista.

RoleAssignmentPropertiesWithScope

Egenskaper för rolltilldelning med omfång.

Name Typ Description
principalId

string

Huvud-ID:t.

roleDefinitionId

string

Rolldefinitions-ID.

scope

RoleScope

Rollomfånget.

RoleScope

Rollomfånget.

Name Typ Description
/

string

Globalt omfång

/keys

string

Omfång för nycklar