ProgramControls auflistenList programControls

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Listen Sie in der Feature Azure AD Access Reviews alle programcontrol -Objekte in allen Programmen im Mandanten auf.In the Azure AD access reviews feature, list all the programControl objects, across all programs in the tenant.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Programcontrol. Read. all, programcontrol. ReadWrite. allProgramControl.Read.All, ProgramControl.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Programcontrol. Read. all, programcontrol. ReadWrite. allProgramControl.Read.All, ProgramControl.ReadWrite.All

Der angemeldete Benutzer muss außerdem eine Verzeichnis Rolle aufweisen, die es Ihnen ermöglicht, ein Programm zu lesen.The signed in user must also be in a directory role that permits them to read a program.

HTTP-AnforderungHTTP request

GET /programControls

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Es sollte kein Anforderungstext angegeben werden.No request body should be supplied.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 200, OK werden der Antwortcode und ein Array von programcontrol -Objekten im Antworttext zurückgegeben.If successful, this method returns a 200, OK response code and an array of programControl objects in the response body.

BeispielExample

AnforderungRequest
GET https://graph.microsoft.com/beta/programControls
AntwortResponse

Hinweis: Das hier gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{

    "value": [
        {
            "id": "f6abf8ef-a05e-4788-adc9-5af909c400af",
            "controlId": "bc81d51d-be53-4606-a8c2-f90a2beb5f40",
            "programId": "673a7379-9c38-4f01-bd9d-4fda7260b807",
            "controlTypeId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
            "displayName": "guest user review",
            "status": "Completed",
            "createdDateTime": "2017-09-20T20:18:05.1318394Z"
        }
    ]
}

Siehe auchSee also

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Auflisten der programControls eines ProgrammsList programControls of a program programcontrol -AuflistungprogramControl collection Abrufen einer Auflistung der Steuerelemente eines Programms.Get a collection of the controls of a program.