更新组织

更新当前经过身份验证的组织的属性。

权限

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) 不支持。
委派(个人 Microsoft 帐户) 不支持。
应用程序 不支持。

HTTP 请求

PATCH /organization

请求标头

名称 类型 说明
Authorization string Bearer {token}。必需。

请求正文

在请求正文中,提供应更新的相关字段的值。 请求正文中不包括的现有属性将保留其以前的值,或根据对其他属性值的更改重新计算。 为了实现最佳性能,不得添加尚未变化的现有值。

属性 类型 说明
assignedPlans AssignedPlan 与租户相关的服务计划的集合。 注意:不可为 null。
city String
companyLastDirSyncTime DateTimeOffset 租户上次与本地目录同步的时间和日期。
country String
countryLetterCode String
deletionTimestamp DateTimeOffset
dirSyncEnabled Boolean 如果此对象从本地目录同步,则为 true;如果此对象最初从本地目录同步,但以后不再同步,则为 false;如果此对象从未从本地目录同步,则为 null(默认值)。
displayName String 租户的显示名称。
marketingNotificationEmails String 注意:不可为 null。
objectType String 标识对象类型的字符串。 对于租户,值始终为“Company”。 继承自 directoryObject
postalCode String
preferredLanguage String
provisionedPlans ProvisionedPlan 注意:不可为 null。
provisioningErrors ProvisioningError 注意:不可为 null。
securityComplianceNotificationMails String
securityComplianceNotificationPhones String
state String
street String
technicalNotificationMails String 注意:不可为 null。
telephoneNumber String
verifiedDomains VerifiedDomain 与该租户相关联的域集合。 注意:不可为 null。

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和 organization 对象。

示例

请求

下面是一个请求示例。

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

{
  "assignedPlans": [
    {
      "assignedDateTime": "datetime-value",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "servicePlanId-value"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "country": "country-value",
  "countryLetterCode": "countryLetterCode-value",
  "displayName": "displayName-value"
}


响应

下面展示了示例响应。 注意:为简洁起见,可能会截断此处展示的响应对象。 将从实际调用中返回所有属性。

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

{
  "assignedPlans": [
    {
      "assignedDateTime": "datetime-value",
      "capabilityStatus": "capabilityStatus-value",
      "service": "service-value",
      "servicePlanId": "servicePlanId-value"
    }
  ],
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value",
  "country": "country-value",
  "countryLetterCode": "countryLetterCode-value",
  "displayName": "displayName-value"
}