EntitiesListNextOptionalParams interface
Optionele parameters.
- Uitbreiding
Eigenschappen
cache |
Geeft aan of de aanvraag caches moet gebruiken. Vul de header in met de waarde 'no-cache' om bestaande caches te omzeilen. |
filter | Met de filterparameter kunt u filteren op de naam- of weergavenaamvelden. U kunt controleren op gelijkheid in het naamveld (bijvoorbeeld naam eq {entityName}) en u kunt controleren op subtekenreeksen op de naam- of weergavenaamvelden (bijvoorbeeld contains(name, {substringToSearch}), contains(displayName, {substringToSearch)). Houd er rekening mee dat de velden {entityName} en {substringToSearch} niet hoofdlettergevoelig worden gecontroleerd. |
group |
Een filter waarmee de get-entiteiten zich kunnen richten op een bepaalde groep (bijvoorbeeld "$filter=name eq 'groupName') |
search | De parameter $search wordt gebruikt in combinatie met de parameter $filter om drie verschillende uitvoer te retourneren, afhankelijk van de doorgegeven parameter. Met $search=AllowedParents retourneert de API de entiteitsgegevens van alle groepen waartoe de aangevraagde entiteit kan reparenten zoals bepaald door de machtigingen van de gebruiker. Met $search=Allowed Children retourneert de API de entiteitsgegevens van alle entiteiten die kunnen worden toegevoegd als onderliggende items van de aangevraagde entiteit. Met $search=ParentAndFirstLevel Children retourneert de API het bovenliggende en eerste niveau van onderliggende elementen dat de gebruiker directe toegang tot of indirecte toegang heeft via een van hun nakomelingen. Met $search=ParentOnly retourneert de API alleen de groep als de gebruiker toegang heeft tot ten minste één van de afstammelingen van de groep. Met $search=ChildrenOnly retourneert de API alleen het eerste niveau van onderliggende elementen van de groepsentiteitsgegevens die zijn opgegeven in $filter. De gebruiker moet directe toegang hebben tot de onderliggende entiteiten of een van de onderliggende entiteiten om deze weer te geven in de resultaten. |
select | Met deze parameter geeft u de velden op die moeten worden opgenomen in het antwoord. Kan elke combinatie van Naam, DisplayName, Type, ParentDisplayNameChain, ParentChain, bijvoorbeeld '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain', bevatten. Wanneer u de parameter $select opgeeft, kunt u de selectie in $skipToken overschrijven. |
skip | Het aantal entiteiten dat moet worden overgeslagen bij het ophalen van resultaten. Als u dit doorgeeft, wordt $skipToken overschreven. |
skiptoken | Het vervolgtoken van de pagina wordt alleen gebruikt als een vorige bewerking een gedeeltelijk resultaat heeft geretourneerd. Als een eerder antwoord een nextLink-element bevat, bevat de waarde van het nextLink-element een tokenparameter die een beginpunt aangeeft dat moet worden gebruikt voor volgende aanroepen. |
top | Aantal elementen dat moet worden geretourneerd bij het ophalen van resultaten. Als u dit doorgeeft, wordt $skipToken overschreven. |
view | Met de weergaveparameter kunnen clients het type gegevens filteren dat wordt geretourneerd door de aanroep Entiteiten ophalen. |
Overgenomen eigenschappen
abort |
Het signaal dat kan worden gebruikt om aanvragen af te breken. |
on |
Een functie die telkens wordt aangeroepen wanneer een antwoord van de server wordt ontvangen tijdens het uitvoeren van de aangevraagde bewerking. Kan meerdere keren worden aangeroepen. |
request |
Opties die worden gebruikt bij het maken en verzenden van HTTP-aanvragen voor deze bewerking. |
serializer |
Opties voor het overschrijven van serialisatie/deserialisatiegedrag. |
tracing |
Opties die worden gebruikt wanneer tracering is ingeschakeld. |
Eigenschapdetails
cacheControl
Geeft aan of de aanvraag caches moet gebruiken. Vul de header in met de waarde 'no-cache' om bestaande caches te omzeilen.
cacheControl?: string
Waarde van eigenschap
string
filter
Met de filterparameter kunt u filteren op de naam- of weergavenaamvelden. U kunt controleren op gelijkheid in het naamveld (bijvoorbeeld naam eq {entityName}) en u kunt controleren op subtekenreeksen op de naam- of weergavenaamvelden (bijvoorbeeld contains(name, {substringToSearch}), contains(displayName, {substringToSearch)). Houd er rekening mee dat de velden {entityName} en {substringToSearch} niet hoofdlettergevoelig worden gecontroleerd.
filter?: string
Waarde van eigenschap
string
groupName
Een filter waarmee de get-entiteiten zich kunnen richten op een bepaalde groep (bijvoorbeeld "$filter=name eq 'groupName')
groupName?: string
Waarde van eigenschap
string
search
De parameter $search wordt gebruikt in combinatie met de parameter $filter om drie verschillende uitvoer te retourneren, afhankelijk van de doorgegeven parameter. Met $search=AllowedParents retourneert de API de entiteitsgegevens van alle groepen waartoe de aangevraagde entiteit kan reparenten zoals bepaald door de machtigingen van de gebruiker. Met $search=Allowed Children retourneert de API de entiteitsgegevens van alle entiteiten die kunnen worden toegevoegd als onderliggende items van de aangevraagde entiteit. Met $search=ParentAndFirstLevel Children retourneert de API het bovenliggende en eerste niveau van onderliggende elementen dat de gebruiker directe toegang tot of indirecte toegang heeft via een van hun nakomelingen. Met $search=ParentOnly retourneert de API alleen de groep als de gebruiker toegang heeft tot ten minste één van de afstammelingen van de groep. Met $search=ChildrenOnly retourneert de API alleen het eerste niveau van onderliggende elementen van de groepsentiteitsgegevens die zijn opgegeven in $filter. De gebruiker moet directe toegang hebben tot de onderliggende entiteiten of een van de onderliggende entiteiten om deze weer te geven in de resultaten.
search?: string
Waarde van eigenschap
string
select
Met deze parameter geeft u de velden op die moeten worden opgenomen in het antwoord. Kan elke combinatie van Naam, DisplayName, Type, ParentDisplayNameChain, ParentChain, bijvoorbeeld '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain', bevatten. Wanneer u de parameter $select opgeeft, kunt u de selectie in $skipToken overschrijven.
select?: string
Waarde van eigenschap
string
skip
Het aantal entiteiten dat moet worden overgeslagen bij het ophalen van resultaten. Als u dit doorgeeft, wordt $skipToken overschreven.
skip?: number
Waarde van eigenschap
number
skiptoken
Het vervolgtoken van de pagina wordt alleen gebruikt als een vorige bewerking een gedeeltelijk resultaat heeft geretourneerd. Als een eerder antwoord een nextLink-element bevat, bevat de waarde van het nextLink-element een tokenparameter die een beginpunt aangeeft dat moet worden gebruikt voor volgende aanroepen.
skiptoken?: string
Waarde van eigenschap
string
top
Aantal elementen dat moet worden geretourneerd bij het ophalen van resultaten. Als u dit doorgeeft, wordt $skipToken overschreven.
top?: number
Waarde van eigenschap
number
view
Met de weergaveparameter kunnen clients het type gegevens filteren dat wordt geretourneerd door de aanroep Entiteiten ophalen.
view?: string
Waarde van eigenschap
string
Details van overgenomen eigenschap
abortSignal
Het signaal dat kan worden gebruikt om aanvragen af te breken.
abortSignal?: AbortSignalLike
Waarde van eigenschap
overgenomen van coreClient.OperationOptions.abortSignal
onResponse
Een functie die telkens wordt aangeroepen wanneer een antwoord van de server wordt ontvangen tijdens het uitvoeren van de aangevraagde bewerking. Kan meerdere keren worden aangeroepen.
onResponse?: RawResponseCallback
Waarde van eigenschap
overgenomen van coreClient.OperationOptions.onResponse
requestOptions
Opties die worden gebruikt bij het maken en verzenden van HTTP-aanvragen voor deze bewerking.
requestOptions?: OperationRequestOptions
Waarde van eigenschap
overgenomen van coreClient.OperationOptions.requestOptions
serializerOptions
Opties voor het overschrijven van serialisatie/deserialisatiegedrag.
serializerOptions?: SerializerOptions
Waarde van eigenschap
overgenomen van coreClient.OperationOptions.serializerOptions
tracingOptions
Opties die worden gebruikt wanneer tracering is ingeschakeld.
tracingOptions?: OperationTracingOptions
Waarde van eigenschap
overgenomen van coreClient.OperationOptions.tracingOptions