Role Assignments - List For Scope

Dienst:: Authorization

API-Version:: 2022-04-01

Listet alle Rollenzuweisungen auf, die für einen Bereich gelten.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

Mit optionalen Parametern:

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01&$filter={$filter}&tenantId={tenantId}&$skipToken={$skipToken}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
scope	path	True	string	Die vollständig qualifizierte Azure Resource Manager-Kennung der Ressource.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
$filter	query		string	Der filter, der auf den Vorgang angewendet werden soll. Verwenden Sie $filter=atScope(), um alle Rollenzuweisungen im Bereich oder oberhalb des Bereichs zurückzugeben. Verwenden Sie $filter=principalId eq {id}, um alle Rollenzuweisungen über oder unterhalb des Bereichs für den angegebenen Prinzipal zurückzugeben.
$skipToken	query		string	Das skipToken, das auf den Vorgang angewendet werden soll. Verwenden Sie $skipToken={skiptoken}, um seitenseitige Rollenzuweisungen nach dem übergebenen skipToken zurückzugeben. Wird nur für Anrufe auf Anbieterebene unterstützt.
tenantId	query		string	Mandanten-ID für mandantenübergreifende Anforderung

Antworten

Name	Typ	Beschreibung
200 OK	RoleAssignmentListResult	Die Anforderung ist erfolgreich.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Berechtigungen

Ihnen muss eine Rolle mit den folgenden Berechtigungen zugewiesen sein, damit Sie diese API aufrufen können. Weitere Informationen finden Sie unter Integrierte Azure-Rollen.

Microsoft.Authorization/roleAssignments/read

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

List role assignments for scope

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments?api-version=2022-04-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "name": "b0f43c54-e787-4862-89b1-a653fa9cf747",
      "type": "Microsoft.Authorization/roleAssignments",
      "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
      "properties": {
        "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
        "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
        "principalType": "User",
        "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
PrincipalType	Der Prinzipaltyp der zugewiesenen Prinzipal-ID.
RoleAssignment	Rollenzuweisungen
RoleAssignmentListResult	Ergebnis des Vorgangs der Rollenzuweisungsliste.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

PrincipalType

Enumeration

Der Prinzipaltyp der zugewiesenen Prinzipal-ID.

Wert	Beschreibung
User	Benutzer
Group	Gruppieren
ServicePrincipal	ServicePrincipal
ForeignGroup	ForeignGroup
Device	Gerät

RoleAssignment

Objekt

Rollenzuweisungen

Name	Typ	Standardwert	Beschreibung
id	string		Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string		Der Name der Ressource
properties.condition	string		Die Bedingungen für die Rollenzuweisung. Das begrenzt die Ressourcen, denen es zugewiesen werden kann. z.B.: @Resource[Microsoft. Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'
properties.conditionVersion	string		Version der Bedingung. Derzeit ist der einzige akzeptierte Wert "2,0"
properties.createdBy	string		ID des Benutzers, der die Aufgabe erstellt hat
properties.createdOn	string (date-time)		Erstellungszeit
properties.delegatedManagedIdentityResourceId	string		ID der delegierten verwalteten Identitätsressource
properties.description	string		Beschreibung der Rollenzuweisung
properties.principalId	string		Die Prinzipal-ID.
properties.principalType	PrincipalType	User	Der Prinzipaltyp der zugewiesenen Prinzipal-ID.
properties.roleDefinitionId	string		Die Rollendefinitions-ID.
properties.scope	string		Der Rollenzuweisungsbereich.
properties.updatedBy	string		ID des Benutzers, der die Aufgabe aktualisiert hat
properties.updatedOn	string (date-time)		Zeitpunkt der Aktualisierung
systemData	systemData		Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten.
type	string		Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten"

RoleAssignmentListResult

Objekt

Ergebnis des Vorgangs der Rollenzuweisungsliste.

Name	Typ	Beschreibung
nextLink	string (uri)	Der Link zur nächsten Seite der Elemente
value	RoleAssignment[]	Die Rollenzuweisungselemente auf dieser Seite

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Role Assignments - List For Scope

URI-Parameter

Antworten

Berechtigungen

Sicherheit

azure_auth

Bereiche

Beispiele

List role assignments for scope

Beispielanforderung

Beispiel für eine Antwort

Definitionen

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PrincipalType

RoleAssignment

RoleAssignmentListResult

systemData