Microsoft 365 支持的属性和错误处理

下表列出了 Microsoft™ 365 所支持的属性及错误处理值。

支持的属性

表 1. 属性
属性名称 定义 映射的 Cloud Directory 属性(缺省映射) 类型 必需 可修改
displayName 用户的显示名称 name 字符串
mailNickname 用户的昵称 None 字符串
userPrincipalName 此属性用于唯一性。 email 字符串
country 用户的国家或地区 work_country 字符串
department 用户的部门 department 字符串
jobTitle 用户的职位 job_title 字符串
preferredLanguage 用户首选语言 language 字符串
givenName 用户名 given_name 字符串
surname 用户的姓氏 family_name 字符串
mobilePhone 用户的手机号码 mobile_number 字符串
usageLocation 将许可证分配到用户所需的双字母 ISO 标准 3166 国家或地区代码。 None 字符串

仅对于许可证分配是必需的。

email 您要邀请的用户的电子邮件地址。 字符串

仅适用于访客用户配置。

userType 一个字符串值,可用于在您的目录中对用户类型进行分类。 可能的取值为 MemberGuest 字符串

仅适用于访客用户配置。

inviteRedirectUrl 用户兑换邀请后应被重定向至 URL。 字符串

仅适用于访客用户配置。

sendInvitationMessage 表示是否应向被邀请的用户发送电子邮件。 默认值是 false. Boolean

仅适用于访客用户配置。

customizedMessageBody 如果您不想使用默认消息,请在此处输入您希望发送的自定义消息正文。 仅允许纯文本 字符串

仅适用于访客用户配置。

错误处理

表 2. 错误代码
序号 状态码 定义
1 400® 无效输入错误
2. 401 认证错误
3. 403 已禁止错误
4. 404 找不到资源错误。
5. 409 资源冲突错误
6. 429 确认的速率限制错误