identityProvider を更新する

名前空間: microsoft.graph

テナントで構成されている指定した ID プロバイダーのプロパティを更新します。

identityProviderBase から派生したプロバイダーの種類の中で、現在、idProviderリソースを更新Azure AD。 B2C Azure AD、この操作は現在、socialIdentityProviderまたはappleManagedIdentityProvider リソースを更新できます。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) IdentityProvider.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション IdentityProvider.ReadWrite.All

仕事または学校のアカウントは、次のいずれかの役割に属している必要があります。

  • グローバル管理者
  • 外部 ID プロバイダー管理者

HTTP 要求

PATCH /identity/identityProviders/{id}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。必須。
Content-Type application/json. Required.

要求本文

要求本文で、テナント内のsocialIdentityProviderオブジェクトに対して更新する必要がある 1 つ以上のプロパティを JSON オブジェクトAzure ADします。

B2C Azure AD、socialIdentityProviderまたはappleManagedIdentityProviderオブジェクトに対して更新する必要がある 1 つ以上のプロパティを JSON オブジェクトに提供します。

socialIdentityProvider オブジェクト

プロパティ 種類 説明
clientId String ID プロバイダーにアプリケーションを登録するときに取得したクライアント アプリケーションの識別子。
clientSecret String アプリケーションが ID プロバイダーに登録された際に取得したクライアント シークレットです。 これは、書き込み専用です。 読み取り操作を行うと、**** が返されます。
displayName String ID プロバイダーの表示名。

appleManagedIdentityProvider オブジェクト

プロパティ 種類 説明
displayName String ID プロバイダーの表示名。
developerId String Apple の開発者 ID。
serviceId String Apple のサービス ID。
keyId String Apple のキー識別子。
certificateData String 証明書からのテキストの長い文字列である証明書データは、null 値である可能性があります。

応答

成功した場合、このメソッドは 204 No Content 応答コードを返します。 失敗した場合、4xx エラーが詳細情報とともに返されます。

例 1: 特定のソーシャル ID プロバイダーを更新する (Azure ADまたは B2C Azure AD)

要求

要求の例を次に示します。

PATCH https://graph.microsoft.com/v1.0/identity/identityProviders/Amazon-OAUTH
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.socialIdentityProvider",
  "clientSecret": "1111111111111"
}

応答

HTTP/1.1 204 No Content

例 2: 特定の Apple ID プロバイダーを更新 する (B2C Azure ADのみ)

要求

要求の例を次に示します。

PATCH https://graph.microsoft.com/v1.0/identity/identityProviders/Apple-Managed-OIDC
Content-type: application/json

{
  "@odata.type": "#microsoft.graph.socialIdentityProvider",
  "displayName": "Apple"
}

応答

応答の例を次に示します。

HTTP/1.1 204 No Content