EntitiesListNextOptionalParams interface
Optionale Parameter.
- Extends
Eigenschaften
cache |
Gibt an, ob die Anforderung Caches verwenden soll. Füllen Sie den Header mit dem Wert "no-cache" auf, um vorhandene Caches zu umgehen. |
filter | Mit dem Filterparameter können Sie nach den Feldern "Name" oder "Anzeigename" filtern. Sie können die Gleichheit des Namensfelds überprüfen (z. B. name eq '{entityName}'), und Sie können auf Teilzeichenfolgen für die Felder name oder Anzeigename (z. B. contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')) überprüfen. Beachten Sie, dass bei den Feldern "{entityName}" und "{substringToSearch}" die Groß-/Kleinschreibung nicht beachtet wird. |
group |
Ein Filter, der es dem Get-Entitätsaufruf ermöglicht, sich auf eine bestimmte Gruppe zu konzentrieren (d. h. "$filter=name eq 'groupName'"). |
search | Der parameter $search wird in Verbindung mit dem parameter $filter verwendet, um je nach übergebenem Parameter drei verschiedene Ausgaben zurückzugeben. Mit $search=AllowedParents gibt die API die Entitätsinformationen aller Gruppen zurück, an die die angeforderte Entität gemäß den Berechtigungen des Benutzers erneut wechseln kann. Mit $search=AllowedChildren gibt die API die Entitätsinformationen aller Entitäten zurück, die als untergeordnete Elemente der angeforderten Entität hinzugefügt werden können. Mit $search=ParentAndFirstLevelChildren gibt die API die übergeordnete und die erste Ebene von untergeordneten Elementen zurück, auf die der Benutzer entweder direkten Zugriff oder indirekten Zugriff über eines seiner Nachfolger hat. Mit $search=ParentOnly gibt die API nur die Gruppe zurück, wenn der Benutzer Zugriff auf mindestens einen der Nachfolger der Gruppe hat. Mit $search=ChildrenOnly gibt die API nur die erste Ebene untergeordneter Elemente der in $filter angegebenen Gruppenentitätsinformationen zurück. Der Benutzer muss direkten Zugriff auf die untergeordneten Entitäten oder eine seiner Nachfolger haben, damit er in den Ergebnissen angezeigt wird. |
select | Dieser Parameter gibt die Felder an, die in die Antwort eingeschlossen werden sollen. Kann eine beliebige Kombination aus Name, DisplayName, Type, ParentDisplayNameChain, ParentChain enthalten, z. B. '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain'. Wenn angegeben, kann der $select Parameter die Auswahl in $skipToken außer Kraft setzen. |
skip | Anzahl der Entitäten, die beim Abrufen von Ergebnissen übersprungen werden sollen. Durch die Übergabe in wird $skipToken überschrieben. |
skiptoken | Das Seitenfortsetzungstoken wird nur verwendet, wenn ein vorheriger Vorgang ein Teilergebnis zurückgegeben hat. Wenn eine vorherige Antwort ein nextLink-Element enthält, enthält der Wert des nextLink-Elements einen Tokenparameter, der einen Startpunkt angibt, der für nachfolgende Aufrufe verwendet werden soll. |
top | Anzahl der Elemente, die beim Abrufen von Ergebnissen zurückgegeben werden sollen. Durch die Übergabe in wird $skipToken überschrieben. |
view | Mit dem View-Parameter können Clients den Typ der Daten filtern, die vom getEntities-Aufruf zurückgegeben werden. |
Geerbte Eigenschaften
abort |
Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann. |
on |
Eine Funktion, die jedes Mal aufgerufen werden soll, wenn beim Ausführen des angeforderten Vorgangs eine Antwort vom Server empfangen wird. Kann mehrmals aufgerufen werden. |
request |
Optionen, die beim Erstellen und Senden von HTTP-Anforderungen für diesen Vorgang verwendet werden. |
serializer |
Optionen zum Überschreiben des Serialisierungs-/Deserialisierungsverhaltens. |
tracing |
Optionen, die verwendet werden, wenn die Ablaufverfolgung aktiviert ist. |
Details zur Eigenschaft
cacheControl
Gibt an, ob die Anforderung Caches verwenden soll. Füllen Sie den Header mit dem Wert "no-cache" auf, um vorhandene Caches zu umgehen.
cacheControl?: string
Eigenschaftswert
string
filter
Mit dem Filterparameter können Sie nach den Feldern "Name" oder "Anzeigename" filtern. Sie können die Gleichheit des Namensfelds überprüfen (z. B. name eq '{entityName}'), und Sie können auf Teilzeichenfolgen für die Felder name oder Anzeigename (z. B. contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')) überprüfen. Beachten Sie, dass bei den Feldern "{entityName}" und "{substringToSearch}" die Groß-/Kleinschreibung nicht beachtet wird.
filter?: string
Eigenschaftswert
string
groupName
Ein Filter, der es dem Get-Entitätsaufruf ermöglicht, sich auf eine bestimmte Gruppe zu konzentrieren (d. h. "$filter=name eq 'groupName'").
groupName?: string
Eigenschaftswert
string
search
Der parameter $search wird in Verbindung mit dem parameter $filter verwendet, um je nach übergebenem Parameter drei verschiedene Ausgaben zurückzugeben. Mit $search=AllowedParents gibt die API die Entitätsinformationen aller Gruppen zurück, an die die angeforderte Entität gemäß den Berechtigungen des Benutzers erneut wechseln kann. Mit $search=AllowedChildren gibt die API die Entitätsinformationen aller Entitäten zurück, die als untergeordnete Elemente der angeforderten Entität hinzugefügt werden können. Mit $search=ParentAndFirstLevelChildren gibt die API die übergeordnete und die erste Ebene von untergeordneten Elementen zurück, auf die der Benutzer entweder direkten Zugriff oder indirekten Zugriff über eines seiner Nachfolger hat. Mit $search=ParentOnly gibt die API nur die Gruppe zurück, wenn der Benutzer Zugriff auf mindestens einen der Nachfolger der Gruppe hat. Mit $search=ChildrenOnly gibt die API nur die erste Ebene untergeordneter Elemente der in $filter angegebenen Gruppenentitätsinformationen zurück. Der Benutzer muss direkten Zugriff auf die untergeordneten Entitäten oder eine seiner Nachfolger haben, damit er in den Ergebnissen angezeigt wird.
search?: string
Eigenschaftswert
string
select
Dieser Parameter gibt die Felder an, die in die Antwort eingeschlossen werden sollen. Kann eine beliebige Kombination aus Name, DisplayName, Type, ParentDisplayNameChain, ParentChain enthalten, z. B. '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain'. Wenn angegeben, kann der $select Parameter die Auswahl in $skipToken außer Kraft setzen.
select?: string
Eigenschaftswert
string
skip
Anzahl der Entitäten, die beim Abrufen von Ergebnissen übersprungen werden sollen. Durch die Übergabe in wird $skipToken überschrieben.
skip?: number
Eigenschaftswert
number
skiptoken
Das Seitenfortsetzungstoken wird nur verwendet, wenn ein vorheriger Vorgang ein Teilergebnis zurückgegeben hat. Wenn eine vorherige Antwort ein nextLink-Element enthält, enthält der Wert des nextLink-Elements einen Tokenparameter, der einen Startpunkt angibt, der für nachfolgende Aufrufe verwendet werden soll.
skiptoken?: string
Eigenschaftswert
string
top
Anzahl der Elemente, die beim Abrufen von Ergebnissen zurückgegeben werden sollen. Durch die Übergabe in wird $skipToken überschrieben.
top?: number
Eigenschaftswert
number
view
Mit dem View-Parameter können Clients den Typ der Daten filtern, die vom getEntities-Aufruf zurückgegeben werden.
view?: string
Eigenschaftswert
string
Geerbte Eigenschaftsdetails
abortSignal
Das Signal, das zum Abbrechen von Anforderungen verwendet werden kann.
abortSignal?: AbortSignalLike
Eigenschaftswert
Geerbt von coreClient.OperationOptions.abortSignal
onResponse
Eine Funktion, die jedes Mal aufgerufen werden soll, wenn beim Ausführen des angeforderten Vorgangs eine Antwort vom Server empfangen wird. Kann mehrmals aufgerufen werden.
onResponse?: RawResponseCallback
Eigenschaftswert
Geerbt von coreClient.OperationOptions.onResponse
requestOptions
Optionen, die beim Erstellen und Senden von HTTP-Anforderungen für diesen Vorgang verwendet werden.
requestOptions?: OperationRequestOptions
Eigenschaftswert
Geerbt von coreClient.OperationOptions.requestOptions
serializerOptions
Optionen zum Überschreiben des Serialisierungs-/Deserialisierungsverhaltens.
serializerOptions?: SerializerOptions
Eigenschaftswert
Geerbt von coreClient.OperationOptions.serializerOptions
tracingOptions
Optionen, die verwendet werden, wenn die Ablaufverfolgung aktiviert ist.
tracingOptions?: OperationTracingOptions
Eigenschaftswert
Geerbt von coreClient.OperationOptions.tracingOptions