Permissions Report - Create

Service:

Permissions Report

API Version:

6.1-preview.1

Anfordern eines Berechtigungsberichts zur asynchronen Erstellung

POST https://dev.azure.com/{organization}/_apis/permissionsreport?api-version=6.1-preview.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "6.1-preview.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name	Typ	Beschreibung
descriptors	string[]	Liste der Gruppen und Benutzer, für die Berechtigungen abgerufen werden sollen. Eine leere Liste ruft alle Gruppen und Benutzer im organization
reportName	string	Name des zu erstellenden Berichts, eindeutig machen
resources	PermissionsReportResource[]	Liste der Ressourcen, für die Berechtigungen abgerufen werden sollen

Antworten

Name	Typ	Beschreibung
200 OK	ReferenceLinks	Erfolgreicher Vorgang

Sicherheit

accessToken

Persönliches Zugriffstoken. Verwenden Sie einen beliebigen Wert für den Benutzernamen und das Token als Kennwort.

Type: basic

Definitionen

Name	Beschreibung
PermissionsReportRequest	Details zum Erstellen eines Berechtigungsberichts
PermissionsReportResource	Besonderheiten der Ressource für den Berechtigungsbericht
ReferenceLinks	Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
ResourceType	Geben Sie den Typ der Ressource an, für die Berechtigungen gemeldet werden sollen.

PermissionsReportRequest

Details zum Erstellen eines Berechtigungsberichts

Name	Typ	Beschreibung
descriptors	string[]	Liste der Gruppen und Benutzer, für die Berechtigungen abgerufen werden sollen. Eine leere Liste ruft alle Gruppen und Benutzer im organization
reportName	string	Name des zu erstellenden Berichts, eindeutig machen
resources	PermissionsReportResource[]	Liste der Ressourcen, für die Berechtigungen abgerufen werden sollen

PermissionsReportResource

Besonderheiten der Ressource für den Berechtigungsbericht

Name	Typ	Beschreibung
resourceId	string	GUID, Name oder Verweis für den angegebenen Ressourcentyp
resourceName	string	Für den Ressourcentyp des Repositorys ist der Ressourcenname der Name des Repositorys.
resourceType	ResourceType	Geben Sie den Typ der Ressource an, für die Berechtigungen gemeldet werden sollen.

ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.

ResourceType

Geben Sie den Typ der Ressource an, für die Berechtigungen gemeldet werden sollen.

Name	Typ	Beschreibung
projectGit	string	Verwenden für den Stammknoten "Git-Repositorys"
ref	string	Verwenden Sie Repository-/Branchknoten mit dem Ref-Format, z. B. RepoGuid/Refs/head/master, ProjectName/RepoName/Refs/head/master, ProjectGuid/RepoGuid/Refs/tags
release	string	Verwenden Sie für die Freigabeberechtigung. Beispiel: ProjectGuid, ProjectGuid/Path
repo	string	Berechtigungen für den primären Repositoryknoten. Die Ressourcen-ID sollte RepoGuid, ProjectId/RepoGuid oder ProjectId/RepoName sein.
tfvc	string	Verwenden Sie für die Team Foundation-Versionskontrolle-Berechtigung unter Verwendung des Elementpfads, z. B. $/test tfvc