Update ProgrammUpdate program

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.

Aktualisieren Sie in der Funktion Azure AD Zugriffs Überprüfungen ein vorhandenes Programm Objekt.In the Azure AD access reviews feature, update an existing program object.

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.ReadWrite.AllProgramControl.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

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

HTTP-AnforderungHTTP request

PATCH /programs('{programId}')

AnforderungsheaderRequest headers

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

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung eines Program -Objekts an.In the request body, supply a JSON representation of a program object.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Aktualisieren eines Programms bereitgestellt werden können.The following table shows the properties that can be supplied when you update a program.

EigenschaftProperty TypType BeschreibungDescription
displayName String Der Name des Programms.The name of the program.
description String Die Beschreibung des Programms.The description of the program.

AntwortResponse

Wenn die Methode erfolgreich verläuft, 204, Accepted werden der Antwortcode und ein Programm Objekt im Antworttext zurückgegeben.If successful, this method returns a 204, Accepted response code and program object in the response body.

BeispielExample

AnforderungRequest

Geben Sie im Anforderungstext eine JSON-Darstellung der zu ändernden Parameter des Program -Objekts an.In the request body, supply a JSON representation of the program object parameters to change.

PATCH https://graph.microsoft.com/beta/programs/7e59d237-2fb0-4e5d-b7bb-d4f9f9129213
Content-type: application/json

{
    "displayName": "testprogram3 new name"
}
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 204 Accepted
Content-type: application/json

{
    "id": "7e59d237-2fb0-4e5d-b7bb-d4f9f9129213",
    "displayName": "testprogram3 new name",
    "description": "test description"
}

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.
Erstellen von programcontrolCreate programControl programcontrolprogramControl Hinzufügen eines programcontrol zu einem Programm.Add a programControl to a program.