Organisation aktualisierenUpdate organization

Namespace: microsoft.graphNamespace: microsoft.graph

Mit dieser API können Sie die Eigenschaften der aktuell authentifizierten Organisation aktualisieren.Update the properties of the currently authenticated organization. In diesem Fall organization ist als eine Auflistung von genau einem Datensatz definiert, und daher muss seine ID in der Anforderung angegeben werden.In this case, organization is defined as a collection of exactly one record, and so its ID must be specified in the request. Die ID wird auch als Mandanten Kennung der Organisation bezeichnet.The ID is also known as the tenantId of the organization.

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) Organization. ReadWrite. all, Directory. AccessAsUser. allOrganization.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Organization.ReadWrite.AllOrganization.ReadWrite.All

HTTP-AnforderungHTTP request

PATCH /organization/{id}

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen.In the request body, supply the values for relevant fields that should be updated. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet.Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.For best performance, you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
marketingNotificationEmailsmarketingNotificationEmails String collectionString collection Hinweis: Lässt keine Nullwerte zu.Notes: not nullable.
privacyProfileprivacyProfile privacyProfileprivacyProfile Das Datenschutzprofil einer Organisation ( „statementUrl“ und „contactEmail“ festlegen).The privacy profile of an organization (set statementUrl and contactEmail).
securityComplianceNotificationMailssecurityComplianceNotificationMails String collectionString collection
securityComplianceNotificationPhonessecurityComplianceNotificationPhones String collectionString collection
technicalNotificationMailstechnicalNotificationMails String collectionString collection Hinweis: Lässt keine Nullwerte zu.Notes: not nullable.

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.

BeispielExample

AnforderungRequest

PATCH https://graph.microsoft.com/v1.0/organization/{id}
Content-type: application/json
Content-length: 411

{
  "marketingNotificationEmails" : ["marketing@contoso.com"],
  "privacyProfile" :
    {
      "contactEmail":"alice@contoso.com",
      "statementUrl":"https://contoso.com/privacyStatement"
    },
  "securityComplianceNotificationMails" : ["security@contoso.com"],
  "securityComplianceNotificationPhones" : ["(123) 456-7890"],
  "technicalNotificationMails" : ["tech@contoso.com"]
}

AntwortResponse

HTTP/1.1 204 No Content