attributeMapping リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

指定されたターゲット属性の値が同期中にどのように流れるかを定義します。 このオブジェクトは、objectMapping の attributeMappings プロパティで構成されます。

プロパティ

プロパティ 型 説明
defaultValue 文字列 ソース プロパティがnullと評価された場合に使用される既定値。 省略可能。
exportMissingReferences ブール型 内部使用のみ。
flowBehavior attributeFlowBehavior この属性をターゲット ディレクトリにエクスポートするタイミングを定義します。 指定できる値は、 FlowWhenChanged と FlowAlways です。 既定値は FlowWhenChanged です。
flowType attributeFlowType ターゲット ディレクトリでこの属性を更新するタイミングを定義します。 値は次のいずれかです。
  • Always (既定)
  • ObjectAddOnly - 新しいオブジェクトが作成されたときのみ
  • MultiValueAddOnly - 変更が複数値属性に新しい値を追加する場合のみ
  • ValueAddOnly - 現在の値がある場合は、「追加」操作のみが流れます。"削除" 操作は行われません
  • AttributeAddOnly - 現在の値がまったく存在しない場合にのみ、変更を伝搬します

    メモ: AD2AAD プロビジョニング ジョブでは、 flowType プロパティ値が考慮されません。
matchingPriority Int32 0 より大きい場合、この属性を使用して、ソース ディレクトリとターゲット ディレクトリ間でオブジェクトの初期照合を実行します。 同期エンジンは、一致する優先度が最も低い属性を使用して、一致するオブジェクトを見つけようとします。 見つからない場合は、次に一致する優先順位を持つ属性が使用され、一致する属性が見つかるか、一致する属性がなくなるまで続けられます。 メールなど、一意の値を持つことが予想される属性のみを、一致する属性として使用する必要があります。
source attributeMappingSource ソース オブジェクトから値を抽出 (または変換) する方法を定義します。
targetAttributeName 文字列 ターゲット オブジェクトの属性の名前。

リレーションシップ

なし。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.attributeMapping",
  "defaultValue": "String",
  "exportMissingReferences": "Boolean",
  "flowBehavior": "String",
  "flowType": "String",
  "matchingPriority": "Integer",
  "source": {
    "@odata.type": "microsoft.graph.attributeMappingSource"
  },
  "targetAttributeName": "String"
}