attributeMapping リソースの種類

名前空間: microsoft.graph

重要

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

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

プロパティ

プロパティ 説明
defaultValue 文字列 ソース プロパティがnullと評価された場合に使用される既定値。 省略可能。
exportMissingReferences ブール型 内部使用のみ。
flowBehavior attributeFlowBehavior この属性をターゲット ディレクトリにエクスポートするタイミングを定義します。 指定できる値は、 FlowWhenChangedFlowAlways です。 既定値は 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"
}