customSecurityAttributeDefinition リソースの種類

[アーティクル]
06/02/2023

名前空間: microsoft.graph

重要

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

カスタムセキュリティ属性 (キーと値のペア) のスキーマを表します。たとえば、カスタムセキュリティ属性の名前、説明、データ型、および許可される値などです。

テナントには、最大 500 個のアクティブオブジェクトを定義できます。 customSecurityAttributeDefinition オブジェクトの名前を変更または削除することはできませんが、customSecurityAttributeDefinition の更新操作を使用して非アクティブ化できます。 attributeSet の一部である必要があります。

エンティティから継承します。

メソッド

メソッド	戻り値の種類	説明
customSecurityAttributeDefinitions を一覧表示する	customSecurityAttributeDefinition コレクション	customSecurityAttributeDefinition オブジェクトとそのプロパティの一覧を取得します。
customSecurityAttributeDefinition を取得する	customSecurityAttributeDefinition	customSecurityAttributeDefinition オブジェクトのプロパティとリレーションシップを読み取ります。
customSecurityAttributeDefinition を作成する	customSecurityAttributeDefinition	新しい customSecurityAttributeDefinition オブジェクトを作成します。
customSecurityAttributeDefinition を更新する	customSecurityAttributeDefinition	customSecurityAttributeDefinition オブジェクトのプロパティを更新します。

プロパティ

プロパティ	型	説明
attributeSet	String	属性セットの名前。大文字と小文字を区別しません。
説明	String	カスタムセキュリティ属性の説明。最大 128 文字の長さと Unicode 文字を含めることができます。後で変更できます。
id	String	カスタムセキュリティ属性の識別子。これは、属性セット名とカスタムセキュリティ属性名の組み合わせで、アンダースコア (`attributeSet`_`name`) で区切られます。 id プロパティは自動生成され、設定できません。大文字と小文字を区別しません。エンティティから継承されます。
isCollection	ブール型	カスタムセキュリティ属性に複数の値を割り当てることができるかどうかを示します。後で変更することはできません。 type がに`Boolean`設定されている場合、isCollection をに`true`設定することはできません。
isSearchable	ブール型	属性値が割り当てられているオブジェクトを検索するために、カスタムセキュリティ属性値にインデックスを作成するかどうかを示します。後で変更することはできません。
name	String	カスタムセキュリティ属性の名前。属性セット内で一意である必要があります。最大 32 文字の長さと Unicode 文字を含めることができます。スペースまたは特殊文字を含めることはできません。後で変更することはできません。大文字と小文字を区別しません。
status	String	カスタムセキュリティ属性がアクティブか非アクティブかを指定します。許容される値は、 `Available` と `Deprecated`です。後で変更できます。
type	String	カスタムセキュリティ属性値のデータ型。サポートされる型は、 `Boolean`、、 `Integer`および `String`です。後で変更することはできません。
usePreDefinedValuesOnly	ブール型	定義済みの値のみをカスタムセキュリティ属性に割り当てることができるかどうかを示します。に設定すると `false`、自由形式の値が許可されます。後でからに`false`変更できますが、から `truefalse` に`true`変更することはできません。型がに`Boolean`設定されている場合、usePreDefinedValuesOnly をに`true`設定することはできません。

リレーションシップ

リレーションシップ	型	説明
allowedValues	allowedValue コレクション	このカスタムセキュリティ属性に対して定義済みの値。このナビゲーションプロパティは既定では返されず、クエリで指定する `$expand` 必要があります。たとえば、「 `/directory/customSecurityAttributeDefinitions?$expand=allowedValues` 」のように入力します。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "@odata.type": "#microsoft.graph.customSecurityAttributeDefinition",
  "attributeSet": "String",
  "description": "String",
  "id": "String (identifier)",
  "isCollection": "Boolean",
  "isSearchable": "Boolean",
  "name": "String",
  "status": "String",
  "type": "String",
  "usePreDefinedValuesOnly": "Boolean"
}