Partager via


EntitiesListOptionalParams interface

Paramètres facultatifs.

Extends

Propriétés

cacheControl

Indique si la requête doit utiliser des caches. Remplissez l’en-tête avec la valeur « no-cache » pour contourner les caches existants.

filter

Le paramètre de filtre vous permet de filtrer les champs nom ou nom complet. Vous pouvez vérifier l’égalité sur le champ de nom (par exemple, nom eq '{entityName}') et vous pouvez rechercher des sous-chaînes sur les champs nom ou nom complet(par exemple, contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')). Notez que les champs « {entityName} » et « {substringToSearch} » sont cochés de manière insensible à la casse.

groupName

Filtre qui permet à l’appel d’entités get de se concentrer sur un groupe particulier (par exemple, « $filter=name eq 'groupName' »)

search

Le paramètre $search est utilisé conjointement avec le paramètre $filter pour retourner trois sorties différentes en fonction du paramètre passé. Avec $search=AllowedParents, l’API retourne les informations d’entité de tous les groupes auxquels l’entité demandée sera en mesure de réparer selon les autorisations de l’utilisateur. Avec $search=AllowedChildren, l’API renvoie les informations d’entité de toutes les entités qui peuvent être ajoutées en tant qu’enfants de l’entité demandée. Avec $search=ParentAndFirstLevelChildren, l’API renvoie le parent et le premier niveau d’enfants auxquels l’utilisateur a un accès direct ou indirect via l’un de ses descendants. Avec $search=ParentOnly, l’API retourne uniquement le groupe si l’utilisateur a accès à au moins un des descendants du groupe. Avec $search=ChildrenOnly, l’API retourne uniquement le premier niveau d’enfants de l’entité de groupe spécifiée dans $filter. L’utilisateur doit avoir un accès direct aux entités enfants ou à l’un de ses descendants pour qu’il s’affiche dans les résultats.

select

Ce paramètre spécifie les champs à inclure dans la réponse. Peut inclure n’importe quelle combinaison de Name,DisplayName,Type,ParentDisplayNameChain,ParentChain, par exemple « $select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain ». Quand le paramètre $select spécifié peut remplacer la sélection dans $skipToken.

skip

Nombre d’entités à ignorer lors de la récupération des résultats. La transmission de ce paramètre remplace $skipToken.

skiptoken

Le jeton de continuation de page est utilisé uniquement si une opération précédente a retourné un résultat partiel. Si une réponse précédente contient un élément nextLink, la valeur de l’élément nextLink inclut un paramètre de jeton qui spécifie un point de départ à utiliser pour les appels suivants.

top

Nombre d’éléments à retourner lors de la récupération des résultats. La transmission de ce paramètre remplace $skipToken.

view

Le paramètre d’affichage permet aux clients de filtrer le type de données retourné par l’appel getEntities.

Propriétés héritées

abortSignal

Signal qui peut être utilisé pour abandonner les demandes.

onResponse

Fonction à appeler chaque fois qu’une réponse est reçue du serveur lors de l’exécution de l’opération demandée. Peut être appelé plusieurs fois.

requestOptions

Options utilisées lors de la création et de l’envoi de requêtes HTTP pour cette opération.

serializerOptions

Options permettant de remplacer le comportement de sérialisation/de désérialisation.

tracingOptions

Options utilisées lorsque le suivi est activé.

Détails de la propriété

cacheControl

Indique si la requête doit utiliser des caches. Remplissez l’en-tête avec la valeur « no-cache » pour contourner les caches existants.

cacheControl?: string

Valeur de propriété

string

filter

Le paramètre de filtre vous permet de filtrer les champs nom ou nom complet. Vous pouvez vérifier l’égalité sur le champ de nom (par exemple, nom eq '{entityName}') et vous pouvez rechercher des sous-chaînes sur les champs nom ou nom complet(par exemple, contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')). Notez que les champs « {entityName} » et « {substringToSearch} » sont cochés de manière insensible à la casse.

filter?: string

Valeur de propriété

string

groupName

Filtre qui permet à l’appel d’entités get de se concentrer sur un groupe particulier (par exemple, « $filter=name eq 'groupName' »)

groupName?: string

Valeur de propriété

string

Le paramètre $search est utilisé conjointement avec le paramètre $filter pour retourner trois sorties différentes en fonction du paramètre passé. Avec $search=AllowedParents, l’API retourne les informations d’entité de tous les groupes auxquels l’entité demandée sera en mesure de réparer selon les autorisations de l’utilisateur. Avec $search=AllowedChildren, l’API renvoie les informations d’entité de toutes les entités qui peuvent être ajoutées en tant qu’enfants de l’entité demandée. Avec $search=ParentAndFirstLevelChildren, l’API renvoie le parent et le premier niveau d’enfants auxquels l’utilisateur a un accès direct ou indirect via l’un de ses descendants. Avec $search=ParentOnly, l’API retourne uniquement le groupe si l’utilisateur a accès à au moins un des descendants du groupe. Avec $search=ChildrenOnly, l’API retourne uniquement le premier niveau d’enfants de l’entité de groupe spécifiée dans $filter. L’utilisateur doit avoir un accès direct aux entités enfants ou à l’un de ses descendants pour qu’il s’affiche dans les résultats.

search?: string

Valeur de propriété

string

select

Ce paramètre spécifie les champs à inclure dans la réponse. Peut inclure n’importe quelle combinaison de Name,DisplayName,Type,ParentDisplayNameChain,ParentChain, par exemple « $select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain ». Quand le paramètre $select spécifié peut remplacer la sélection dans $skipToken.

select?: string

Valeur de propriété

string

skip

Nombre d’entités à ignorer lors de la récupération des résultats. La transmission de ce paramètre remplace $skipToken.

skip?: number

Valeur de propriété

number

skiptoken

Le jeton de continuation de page est utilisé uniquement si une opération précédente a retourné un résultat partiel. Si une réponse précédente contient un élément nextLink, la valeur de l’élément nextLink inclut un paramètre de jeton qui spécifie un point de départ à utiliser pour les appels suivants.

skiptoken?: string

Valeur de propriété

string

top

Nombre d’éléments à retourner lors de la récupération des résultats. La transmission de ce paramètre remplace $skipToken.

top?: number

Valeur de propriété

number

view

Le paramètre d’affichage permet aux clients de filtrer le type de données retourné par l’appel getEntities.

view?: string

Valeur de propriété

string

Détails de la propriété héritée

abortSignal

Signal qui peut être utilisé pour abandonner les demandes.

abortSignal?: AbortSignalLike

Valeur de propriété

héritée de coreClient.OperationOptions.abortSignal

onResponse

Fonction à appeler chaque fois qu’une réponse est reçue du serveur lors de l’exécution de l’opération demandée. Peut être appelé plusieurs fois.

onResponse?: RawResponseCallback

Valeur de propriété

héritée de coreClient.OperationOptions.onResponse

requestOptions

Options utilisées lors de la création et de l’envoi de requêtes HTTP pour cette opération.

requestOptions?: OperationRequestOptions

Valeur de propriété

héritée de coreClient.OperationOptions.requestOptions

serializerOptions

Options permettant de remplacer le comportement de sérialisation/de désérialisation.

serializerOptions?: SerializerOptions

Valeur de propriété

héritée de coreClient.OperationOptions.serializerOptions

tracingOptions

Options utilisées lorsque le suivi est activé.

tracingOptions?: OperationTracingOptions

Valeur de propriété

héritée de coreClient.OperationOptions.tracingOptions