Update secureScoreControlProfilesUpdate secureScoreControlProfiles

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 eine bearbeitbare secureScoreControlProfiles -Eigenschaft in einer integrierten Lösung, um verschiedene Eigenschaften wie AssignedTo oder tenantNotezu ändern.Update an editable secureScoreControlProfiles property within any integrated solution to change various properties, such as assignedTo or tenantNote.

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

HTTP-AnforderungHTTP request

PATCH /security/secureScoreControlProfiles/{id}

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}.Bearer {code}. Erforderlich.Required.
PreferPrefer Return = Darstellung.return=representation.

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung der Werte für relevante Felder an, die aktualisiert werden sollen.In the request body, supply a JSON representation of the values for relevant fields that should be updated. In der folgenden Tabelle sind die Felder aufgeführt, die für eine secureScoreControlProfile aktualisiert werden können.The following table lists the fields that can be updated for a secureScoreControlProfile. Die Werte für vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, werden nicht geändert.The values for existing properties that are not included in the request body will not change. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.For best performance, don't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
assignedToassignedTo StringString Name des Analysten, dem das Steuerelement zur Selektierung, Implementierung oder Korrektur zugewiesen ist.Name of the analyst the control is assigned to for triage, implementation, or remediation.
tenantNotetenantNote StringString Analystenkommentare zum Steuerelement (für die Kunden Steuerungs Verwaltung).Analyst comments on the control (for customer control management).
controlStateUpdatescontrolStateUpdates StringString Analyse gesteuerte Einstellung für das Steuerelement.Analyst driven setting on the control. Mögliche Werte sind: ignore, thirdParty und reviewed.Possible values are: ignore, thirdParty, reviewed.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.If successful, this method returns a 204 No Content response code.

Wenn der optionale Anforderungsheader verwendet wird, gibt die Methode 200 OK den Antwortcode und das aktualisierte secureScoreControlProfiles -Objekt im Antworttext zurück.If the optional request header is used, the method returns a 200 OK response code and the updated secureScoreControlProfiles object in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

PATCH https://graph.microsoft.com/beta/security/secureScoreControlProfiles/AdminMFA
Content-type: application/json

{
  "controlStateUpdates": "controlStateUpdates-value"
}

AntwortResponse

Es folgt ein Beispiel für eine erfolgreiche Antwort.The following is an example of a successful response.

HTTP/1.1 204 No Content