Microsoft 365 でサポートされる属性とエラー処理

以下の表に、 Microsoft 365でサポートされる属性とエラー処理の値を示します。

サポートされる属性

表 1. 属性
属性名 定義 マップされたクラウド・ディレクトリー属性 (デフォルトのマッピング) タイプ 必須 変更可能
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 ライセンスをユーザーに割り当てるために必要な 2 文字の ISO 標準 3166 国別コード。 None ストリング いいえ

ライセンスの割り当てでのみ必須。

はい
email 招待するユーザーのEメールアドレス。 なし ストリング いいえ

ゲストユーザーのプロビジョニングにのみ必須。

はい
userType ディレクトリ内のユーザータイプを分類するために使用できる文字列値。 設定可能な値は MemberGuest なし ストリング いいえ

ゲストユーザーのプロビジョニングにのみ必須。

はい
inviteRedirectUrl 招待状が引き換えられた後に、ユーザーがリダイレクトされるべき URL。 なし ストリング いいえ

ゲストユーザーのプロビジョニングにのみ必須。

いいえ
sendInvitationMessage 招待されたユーザーに電子メールを送信するかどうかを示す。 デフォルトは false なし ブール いいえ

ゲストユーザーのプロビジョニングにのみ必須。

いいえ
customizedMessageBody デフォルトのメッセージが不要な場合に送信する、カスタマイズされたメッセージ本文。 プレーンテキストのみ可 なし ストリング いいえ

ゲストユーザーのプロビジョニングにのみ必須。

いいえ

エラー処理

表 2. エラー・コード
シリアル番号 状況コード 定義
1秒. 400 無効な入力エラー
2. 401 認証エラー
3. 403 アクセス禁止エラー
4. 404 リソース未検出エラー。
5. 409 リソース競合エラー
6. 429 レート制限到達エラー