组织资源类型

命名空间:microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示用户或应用程序所登录的 Azure Active Directory 租户。 只支持在此资源上执行读取和更新操作;不支持创建和删除操作。 继承自 directoryObject

使用此资源,可以使用扩展将自己的数据添加到自定义属性。

方法

方法 返回类型 说明
获取组织 organization 集合 读取 organization 对象的属性和关系。
更新 organization 组织 更新组织对象。唯一可以更新的属性是: marketingNotificationMailstechnicalNotificationMailssecurityComplianceNotificationMailssecurityComplianceNotificationPhonesprivacyProfile
获取组织设置 organizationSettings 读取组织设置对象。
开放扩展
创建开放扩展 openTypeExtension 创建开放扩展,并将自定义属性添加到新资源或现有资源。
获取开放扩展 openTypeExtension 集合 获取扩展名称标识的开放扩展。
架构扩展
添加架构扩展值 schemaExtension 创建架构扩展定义,然后使用它向资源添加自定义键入数据。
组织许可证
activateService (已弃用) 为组织激活服务。
组织品牌
Get organizationalBranding organizationalBranding 获取默认组织的品牌对象。
Update organizationalBranding organizationalBranding 更新默认组织的品牌对象。
创建 organizationalBrandingLocalization organizationalBrandingLocalization 创建新的本地化(特定语言的)品牌打造和默认品牌对象(如果不存在)。
List organizationalBrandingLocalization organizationalBrandingLocalization 集合 检索租户中的所有本地化品牌对象。
Get organizationalBrandingLocalization organizationalBrandingLocalization 读取本地化品牌对象的属性。
更新 organizationalBrandingLocalization organizationalBrandingLocalization 更新本地化品牌对象。
删除 organizationalBrandingLocalization organizationalBrandingLocalization 删除本地化品牌对象。

属性

属性 类型 说明
assignedPlans assignedPlan 集合 与租户相关的服务计划的集合。不可为空。
businessPhones String collection 组织的电话号码。虽然这是字符串集合,但是只能为该属性设置一个号码。
城市 String 组织地址所在的城市名称。
country String 组织地址所在的国家/地区名称。
countryLetterCode 字符串 组织所在的国家/地区缩写,采用 ISO 3166-2 格式。
createdDateTime DateTimeOffset 组织的创建时间戳。 值无法修改,并在组织创建时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
deletedDateTime DateTimeOffset 表示使用 ISO 8601 格式删除Azure AD租户的日期和时间,并且始终采用 UTC 时间。例如,2014 年 1 月 1 日午夜 UTC 2014-01-01T00:00:00Z。只读。
directorySizeQuota directorySizeQuota 组织的目录大小配额信息。
displayName String 租户的显示名称。
id 字符串 租户 ID,表示组织(或租户)的唯一标识符。 继承自 directoryObject。 键。 不可为 null。 只读。
isMultipleDataLocationsForServicesEnabled 布尔值 true 如果启用了多地理位置,则为组织; false 如果组织未启用多地理位置, null (默认) 。 只读。 有关详细信息,请参阅 OneDrive Online 多地理位置
marketingNotificationEmails String collection 不可为空。
onPremisesLastSyncDateTime DateTimeOffset 租户上次与本地目录同步的时间和日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
onPremisesSyncEnabled Boolean true 如果此对象是从本地目录同步的, false 如果此对象最初是从本地目录同步,但不再同步,空。 null 如果此对象从未从本地目录(默认)进行同步。
postalCode String 组织地址的邮政编码。
preferredLanguage String 组织的首选语言。 应遵循 ISO 639-1 代码;例如, en
privacyProfile privacyProfile 组织的隐私配置文件。
provisionedPlans provisionedPlan 集合 不可为 null。
securityComplianceNotificationMails String collection
securityComplianceNotificationPhones String collection
state String 组织地址所在的省/自治区/直辖市名称。
street String 组织地址所在的街道名称。
technicalNotificationMails String collection 不可为空。
verifiedDomains verifiedDomain 集合 与该租户相关联的域集合。不可为 null。

关系

关系 类型 说明
certificateBasedAuthConfiguration certificateBasedAuthConfiguration 集合 用于管理基于证书的身份验证配置的导航属性。 只能在集合中创建 certificateBasedAuthConfiguration 的单个实例。
extensions 扩展集合 为组织资源定义的开放扩展的集合。 可为 NULL。
品牌打造 organizationalBranding 集合 用于管理组织的默认品牌的资源。 可为 Null。
settings organizationSettings 检索 organizationSettings 对象的属性和关系。 可为 Null。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
  "businessPhones": ["String"],
  "city": "String",
  "country": "String",
  "countryLetterCode": "String",
  "createdDateTime": "String (timestamp)",
  "deletedDateTime": "String (timestamp)",
  "directorySizeQuota": {"@odata.type": "microsoft.graph.directorySizeQuota"},
  "displayName": "String",
  "id": "String (identifier)",
  "isMultipleDataLocationsForServicesEnabled": "Boolean",
  "marketingNotificationEmails": ["String"],
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": true,
  "postalCode": "String",
  "preferredLanguage": "String",
  "privacyProfile": {"@odata.type": "microsoft.graph.privacyProfile"},
  "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
  "securityComplianceNotificationMails": ["String"],
  "securityComplianceNotificationPhones": ["String"],
  "state": "String",
  "street": "String",
  "technicalNotificationMails": ["String"],
  "verifiedDomains": [{"@odata.type": "microsoft.graph.verifiedDomain"}],
  "companyLastDirSyncTime": "2019-02-07T20:33:52.942Z",
  "dirSyncEnabled": true
}

另请参阅