EntitiesListOptionalParams interface

省略可能なパラメーター。

Extends

プロパティ

cacheControl

要求がキャッシュを利用する必要があるかどうかを示します。 既存のキャッシュをバイパスするには、ヘッダーに "キャッシュなし" 値を設定します。

filter

filter パラメーターを使用すると、名前フィールドまたは表示名フィールドをフィルター処理できます。 名前フィールド (例: name eq '{entityName}') で等しいかどうかを確認できます。また、名前フィールドまたは表示名フィールド (例: contains(name, '{substringToSearch}'))、 contains(displayName, '{substringToSearch')) の部分文字列を確認できます。 '{entityName}' フィールドと '{substringToSearch}' フィールドは大文字と小文字が区別されずにチェックされることに注意してください。

groupName

get エンティティ呼び出しで特定のグループにフォーカスを設定できるようにするフィルター (つまり、"$filter=name eq 'groupName")

search

$search パラメーターは、渡されたパラメーターに応じて 3 つの異なる出力を返すために、$filter パラメーターと組み合わせて使用されます。 $search=AllowedParents を使用すると、API は、ユーザーのアクセス許可によって決定された、要求されたエンティティが再親できるすべてのグループのエンティティ情報を返します。 $search=AllowedChildren では、API は要求されたエンティティの子として追加できるすべてのエンティティのエンティティ情報を返します。 $search=ParentAndFirstLevelChildren を使用すると、API は、ユーザーが直接アクセスできる子の親レベルと第 1 レベルの子、またはその子孫のいずれかを介した間接アクセスを返します。 $search=ParentOnly では、ユーザーがグループの少なくとも 1 つの子孫にアクセスできる場合、API はグループのみを返します。 $search=ChildrenOnly では、API は、$filterで指定されたグループ エンティティ情報の最初のレベルの子のみを返します。 結果に表示するには、ユーザーが子エンティティまたはその子孫に直接アクセスできる必要があります。

select

このパラメーターは、応答に含めるフィールドを指定します。 Name、DisplayName、Type、ParentDisplayNameChain、ParentChain の任意の組み合わせを含めることができます(例: '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain' など)。 指定した場合、$select パラメーターは、$skipTokenの選択をオーバーライドできます。

skip

結果を取得するときにスキップするエンティティの数。 これを渡すと、$skipTokenがオーバーライドされます。

skiptoken

ページ継続トークンは、前の操作で部分的な結果が返された場合にのみ使用されます。 前の応答に nextLink 要素が含まれている場合、nextLink 要素の値には、後続の呼び出しに使用する開始点を指定するトークン パラメーターが含まれます。

top

結果を取得するときに返す要素の数。 これを渡すと、$skipTokenがオーバーライドされます。

view

view パラメーターを使用すると、クライアントは getEntities 呼び出しによって返されるデータの種類をフィルター処理できます。

継承されたプロパティ

abortSignal

要求を中止するために使用できるシグナル。

onResponse

要求された操作の実行中にサーバーから応答を受信するたびに呼び出される関数。 複数回呼び出すことができます。

requestOptions

この操作の HTTP 要求を作成および送信するときに使用されるオプション。

serializerOptions

シリアル化/シリアル化解除の動作をオーバーライドするオプション。

tracingOptions

トレースが有効な場合に使用されるオプション。

プロパティの詳細

cacheControl

要求がキャッシュを利用する必要があるかどうかを示します。 既存のキャッシュをバイパスするには、ヘッダーに "キャッシュなし" 値を設定します。

cacheControl?: string

プロパティ値

string

filter

filter パラメーターを使用すると、名前フィールドまたは表示名フィールドをフィルター処理できます。 名前フィールド (例: name eq '{entityName}') で等しいかどうかを確認できます。また、名前フィールドまたは表示名フィールド (例: contains(name, '{substringToSearch}'))、 contains(displayName, '{substringToSearch')) の部分文字列を確認できます。 '{entityName}' フィールドと '{substringToSearch}' フィールドは大文字と小文字が区別されずにチェックされることに注意してください。

filter?: string

プロパティ値

string

groupName

get エンティティ呼び出しで特定のグループにフォーカスを設定できるようにするフィルター (つまり、"$filter=name eq 'groupName")

groupName?: string

プロパティ値

string

$search パラメーターは、渡されたパラメーターに応じて 3 つの異なる出力を返すために、$filter パラメーターと組み合わせて使用されます。 $search=AllowedParents を使用すると、API は、ユーザーのアクセス許可によって決定された、要求されたエンティティが再親できるすべてのグループのエンティティ情報を返します。 $search=AllowedChildren では、API は要求されたエンティティの子として追加できるすべてのエンティティのエンティティ情報を返します。 $search=ParentAndFirstLevelChildren を使用すると、API は、ユーザーが直接アクセスできる子の親レベルと第 1 レベルの子、またはその子孫のいずれかを介した間接アクセスを返します。 $search=ParentOnly では、ユーザーがグループの少なくとも 1 つの子孫にアクセスできる場合、API はグループのみを返します。 $search=ChildrenOnly では、API は、$filterで指定されたグループ エンティティ情報の最初のレベルの子のみを返します。 結果に表示するには、ユーザーが子エンティティまたはその子孫に直接アクセスできる必要があります。

search?: string

プロパティ値

string

select

このパラメーターは、応答に含めるフィールドを指定します。 Name、DisplayName、Type、ParentDisplayNameChain、ParentChain の任意の組み合わせを含めることができます(例: '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain' など)。 指定した場合、$select パラメーターは、$skipTokenの選択をオーバーライドできます。

select?: string

プロパティ値

string

skip

結果を取得するときにスキップするエンティティの数。 これを渡すと、$skipTokenがオーバーライドされます。

skip?: number

プロパティ値

number

skiptoken

ページ継続トークンは、前の操作で部分的な結果が返された場合にのみ使用されます。 前の応答に nextLink 要素が含まれている場合、nextLink 要素の値には、後続の呼び出しに使用する開始点を指定するトークン パラメーターが含まれます。

skiptoken?: string

プロパティ値

string

top

結果を取得するときに返す要素の数。 これを渡すと、$skipTokenがオーバーライドされます。

top?: number

プロパティ値

number

view

view パラメーターを使用すると、クライアントは getEntities 呼び出しによって返されるデータの種類をフィルター処理できます。

view?: string

プロパティ値

string

継承されたプロパティの詳細

abortSignal

要求を中止するために使用できるシグナル。

abortSignal?: AbortSignalLike

プロパティ値

coreClient.OperationOptions.abortSignal から継承

onResponse

要求された操作の実行中にサーバーから応答を受信するたびに呼び出される関数。 複数回呼び出すことができます。

onResponse?: RawResponseCallback

プロパティ値

coreClient.OperationOptions.onResponse から継承

requestOptions

この操作の HTTP 要求を作成および送信するときに使用されるオプション。

requestOptions?: OperationRequestOptions

プロパティ値

coreClient.OperationOptions.requestOptions から継承

serializerOptions

シリアル化/シリアル化解除の動作をオーバーライドするオプション。

serializerOptions?: SerializerOptions

プロパティ値

coreClient.OperationOptions.serializerOptions から継承

tracingOptions

トレースが有効な場合に使用されるオプション。

tracingOptions?: OperationTracingOptions

プロパティ値

coreClient.OperationOptions.tracingOptions から継承