组织资源类型

命名空间:microsoft.graph

重要

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

表示对用户或应用程序进行身份验证的Microsoft Entra租户。 此资源仅支持读取和更新操作。 继承自 directoryObject

方法

方法 返回类型 说明
列出 organizations organization 集合 读取 organization 对象的属性和关系。
获取组织 organization 集合 读取组织对象的属性和关系。
更新 organization 更新组织对象。

属性

属性 类型 说明
assignedPlans assignedPlan 集合 与租户相关的服务计划的集合。 不可为 null。
businessPhones 字符串集合 组织的电话号码。 虽然此属性是字符串集合,但只能设置一个数字。
城市 String 组织地址所在的城市名称。
country String 组织地址所在的国家/地区名称。
countryLetterCode 字符串 组织所在的国家/地区缩写,采用 ISO 3166-2 格式。
createdDateTime DateTimeOffset 组织的创建时间戳。 无法修改该值,并在创建组织时自动填充。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 只读。
defaultUsageLocation String 双字母 ISO 3166 国家/地区代码,指示组织的默认服务使用位置。
deletedDateTime DateTimeOffset 表示使用 ISO 8601 格式删除Microsoft Entra租户的日期和时间,并且始终采用 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 不可为空。
onPremisesLastPasswordSyncDateTime DateTimeOffset 上次收到租户的密码同步请求的时间。
onPremisesLastSyncDateTime DateTimeOffset 租户上次与本地目录同步的时间和日期。 时间戳类型表示采用 ISO 8601 格式的日期和时间信息,始终采用 UTC 时区。 例如,2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z
onPremisesSyncEnabled Boolean true 如果从本地目录同步此对象,则为 ; false 如果此对象最初从本地目录同步,但不再同步,则为 ;空。 null如果此对象未从本地 active directory 同步, (默认) 。
partnerTenantType partnerTenantType 此租户与 Microsoft 的合作关系类型。 可取值包括:microsoftSupportsyndicatePartnerbreadthPartnerbreadthPartnerDelegatedAdminresellerPartnerDelegatedAdminvalueAddedResellerPartnerDelegatedAdminunknownFutureValue。 可为 NULL。 有关可能的类型的详细信息,请参阅 partnerTenantType 值
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 不可为空。
tenantType String 不可为 null。 可以是以下类型之一:
  • AAD - 企业标识访问管理 (IAM) 服务,该服务为企业到员工和企业对企业 (B2B) 方案提供服务。
  • AAD B2C 标识访问管理 (IAM) 服务,该服务为企业到消费者 (B2C) 方案提供服务。
  • CIAM - 客户标识 & 访问管理 (CIAM) 解决方案,提供一个集成平台来为消费者、合作伙伴和公民方案提供服务。
  • verifiedDomains verifiedDomain 集合 与该租户相关联的域集合。 不可为 null。

    partnerTenantType 值

    成员 说明
    microsoftSupport 用于为所有客户租户提供管理支持的 Microsoft 旧版支持租户。
    breadthPartner 合作伙伴可以为其客户提供管理支持。 但是,不允许合作伙伴向客户转售或向客户请求委派的管理员权限。
    breadthPartnerDelegatedAdmin 与广度合作伙伴类似,但他们可以从客户租户请求委派管理员权限 (DAP) 。
    syndicatePartner 合作伙伴专门转售和管理 Microsoft 365,并为其客户Intune。 客户无法直接或通过其他 Microsoft 合作伙伴购买更多订阅。
    resellerPartnerDelegatedAdmin 可以转售和管理 Microsoft 365 并为其客户Intune的合作伙伴。 没有像联合合作伙伴那样的排他性条款。 客户可以直接从 Microsoft 或其他 Microsoft 合作伙伴购买更多订阅。
    valueAddedResellerPartnerDelegatedAdmin 他们是第 2 层合作伙伴。 他们是与另一个 Microsoft 合作伙伴(例如经销商)有关系的 Microsoft 合作伙伴。
    unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

    关系

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

    JSON 表示形式

    以下 JSON 表示形式显示了资源类型。

    {
      "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
      "businessPhones": ["String"],
      "city": "String",
      "companyLastDirSyncTime": "2019-02-07T20:33:52.942Z",
      "country": "String",
      "countryLetterCode": "String",
      "createdDateTime": "String (timestamp)",
      "defaultUsageLocation": "String",
      "deletedDateTime": "String (timestamp)",
      "directorySizeQuota": {"@odata.type": "microsoft.graph.directorySizeQuota"},
      "dirSyncEnabled": true,
      "displayName": "String",
      "id": "String (identifier)",
      "isMultipleDataLocationsForServicesEnabled": "Boolean",
      "marketingNotificationEmails": ["String"],
      "onPremisesLastPasswordSyncDateTime": "String (timestamp)",
      "onPremisesLastSyncDateTime": "String (timestamp)",
      "onPremisesSyncEnabled": true,
      "partnerTenantType": "String",
      "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"],
      "tenantType": "string",
      "verifiedDomains": [{"@odata.type": "microsoft.graph.verifiedDomain"}]
    }