次の方法で共有


組織を更新する

名前空間: microsoft.graph

現在認証されている組織のプロパティを更新します。 この場合、 organization は 1 つのレコードのコレクションとして定義されるため、その ID は 要求で指定する必要があります。 ID は、organizationの tenantId とも呼ばれます。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Organization.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Organization.ReadWrite.All 注意事項なし。

委任されたシナリオの場合、サインインしているユーザーは、次のMicrosoft Entraロールの少なくとも 1 つを持っている必要があります。

  • AdHoc ライセンス管理者
  • アプリケーション管理者
  • 認証管理者
  • Azure Information Protection 管理者
  • Azure Information Protection 管理者
  • 課金管理者
  • クラウド アプリケーション管理者
  • コンプライアンス データ管理者
  • カスタマー ロックボックス アクセス承認者
  • カスタマー ロックボックス アクセス承認者
  • Desktop Analytics管理者
  • ディレクトリ リーダー
  • ディレクトリレビュー担当者
  • ディレクトリ製作者
  • Dynamics 365管理者
  • Dynamics 365管理者
  • グローバル閲覧者
  • ゲスト ユーザー
  • ヘルプデスク管理者
  • Insights 管理者
  • Kaizala 管理者
  • ライセンス管理者
  • メールボックスの管理者
  • Microsoft マネージド デスクトップ管理者
  • ビジネス向け Microsoft Store ユーザー
  • モダン コマース管理者
  • Power BI 管理者
  • Power BI 管理者
  • 特権認証管理者
  • 特権ロール管理者
  • 制限付きゲスト ユーザー
  • セキュリティ管理者
  • セキュリティ オペレーター
  • セキュリティ閲覧者
  • サービス サポート管理者
  • Teams 管理者
  • Teams 通信管理者
  • Teams 通信サポート エンジニア
  • Teams 通信サポート スペシャリスト
  • User
  • ユーザー管理者
  • ボリューム ライセンス ビジネス センター ユーザー
  • ボリューム ライセンス Service Center ユーザー

User.Read アクセス許可が付与されたアプリケーションは、organizationの IDdisplayNameverifiedDomains プロパティのみを読み取ることが可能です。 他のすべてのプロパティは null 値を返します。 すべてのプロパティを読み取る場合は、少なくとも Organization.Read.All を使用します。

HTTP 要求

PATCH /organization/{id}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json

要求本文

要求本文で、更新する関連フィールドの値を指定します。 要求本文に含まれない既存のプロパティは、以前の値のままになるか、他のプロパティ値の変化に基づいて再計算されます。 最適なパフォーマンスを得るためには、変更されていない既存の値を含めないでください。

プロパティ 説明
marketingNotificationEmails String コレクション : Null は許容されません。
privacyProfile privacyProfile 組織のプライバシー プロファイル (statementUrl と contactEmail を設定します)。
securityComplianceNotificationMails String collection
securityComplianceNotificationPhones String コレクション
technicalNotificationMails String コレクション : Null は許容されません。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。

要求

PATCH https://graph.microsoft.com/v1.0/organization/84841066-274d-4ec0-a5c1-276be684bdd3
Content-type: application/json

{
  "marketingNotificationEmails" : ["marketing@contoso.com"],
  "privacyProfile" :
    {
      "contactEmail":"alice@contoso.com",
      "statementUrl":"https://contoso.com/privacyStatement"
    },
  "securityComplianceNotificationMails" : ["security@contoso.com"],
  "securityComplianceNotificationPhones" : ["(123) 456-7890"],
  "technicalNotificationMails" : ["tech@contoso.com"]
}

応答

HTTP/1.1 204 No Content