Dela via


EntitiesListOptionalParams interface

Valfria parametrar.

Extends

Egenskaper

cacheControl

Anger om begäran ska använda några cacheminnen. Fyll i huvudet med värdet "ingen cache" för att kringgå befintliga cacheminnen.

filter

Med filterparametern kan du filtrera på namn- eller visningsnamnfälten. Du kan söka efter likhet i namnfältet (t.ex. namnet eq '{entityName}') och du kan söka efter delsträngar i antingen namn- eller visningsnamnfälten (t.ex. contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')). Observera att fälten {entityName} och {substringToSearch} är okänsliga.

groupName

Ett filter som gör att anropet hämta entiteter kan fokusera på en viss grupp (dvs. "$filter=name eq 'groupName'")

search

Parametern $search används tillsammans med parametern $filter för att returnera tre olika utdata beroende på vilken parameter som skickas. Med $search=AllowedParents returnerar API:et entitetsinformationen för alla grupper som den begärda entiteten kommer att kunna ange som den bestäms av användarens behörigheter. Med $search=AllowedChildren returnerar API:et entitetsinformation för alla entiteter som kan läggas till som underordnade till den begärda entiteten. Med $search=ParentAndFirstLevelChildren returnerar API:et den överordnade och första nivån av underordnade som användaren antingen har direkt åtkomst till eller indirekt åtkomst via någon av deras underordnade. Med $search=ParentOnly returnerar API:et endast gruppen om användaren har åtkomst till minst en av de underordnade i gruppen. Med $search=ChildrenOnly returnerar API:et endast den första nivån av underordnade till gruppentitetsinformationen som anges i $filter. Användaren måste ha direkt åtkomst till de underordnade entiteterna eller någon av dess underordnade enheter för att visas i resultatet.

select

Den här parametern anger vilka fält som ska ingå i svaret. Kan innehålla valfri kombination av Name,DisplayName,Type,ParentDisplayNameChain,ParentChain, t.ex. '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain'. När parametern $select anges kan den åsidosätta $skipToken.

skip

Antal entiteter som ska hoppa över vid hämtning av resultat. Om du skickar in detta åsidosätts $skipToken.

skiptoken

Sidfortsättningstoken används endast om en tidigare åtgärd returnerade ett partiellt resultat. Om ett tidigare svar innehåller ett nextLink-element innehåller värdet för nextLink-elementet en tokenparameter som anger en startpunkt som ska användas för efterföljande anrop.

top

Antal element som ska returneras när resultatet hämtas. Om du skickar in detta åsidosätts $skipToken.

view

Med vyparametern kan klienter filtrera den typ av data som returneras av getEntities-anropet.

Ärvda egenskaper

abortSignal

Den signal som kan användas för att avbryta begäranden.

onResponse

En funktion som ska anropas varje gång ett svar tas emot från servern när den begärda åtgärden utförs. Kan anropas flera gånger.

requestOptions

Alternativ som används när du skapar och skickar HTTP-begäranden för den här åtgärden.

serializerOptions

Alternativ för att åsidosätta serialiserings-/avserialiseringsbeteende.

tracingOptions

Alternativ som används när spårning är aktiverat.

Egenskapsinformation

cacheControl

Anger om begäran ska använda några cacheminnen. Fyll i huvudet med värdet "ingen cache" för att kringgå befintliga cacheminnen.

cacheControl?: string

Egenskapsvärde

string

filter

Med filterparametern kan du filtrera på namn- eller visningsnamnfälten. Du kan söka efter likhet i namnfältet (t.ex. namnet eq '{entityName}') och du kan söka efter delsträngar i antingen namn- eller visningsnamnfälten (t.ex. contains(name, '{substringToSearch}'), contains(displayName, '{substringToSearch')). Observera att fälten {entityName} och {substringToSearch} är okänsliga.

filter?: string

Egenskapsvärde

string

groupName

Ett filter som gör att anropet hämta entiteter kan fokusera på en viss grupp (dvs. "$filter=name eq 'groupName'")

groupName?: string

Egenskapsvärde

string

Parametern $search används tillsammans med parametern $filter för att returnera tre olika utdata beroende på vilken parameter som skickas. Med $search=AllowedParents returnerar API:et entitetsinformationen för alla grupper som den begärda entiteten kommer att kunna ange som den bestäms av användarens behörigheter. Med $search=AllowedChildren returnerar API:et entitetsinformation för alla entiteter som kan läggas till som underordnade till den begärda entiteten. Med $search=ParentAndFirstLevelChildren returnerar API:et den överordnade och första nivån av underordnade som användaren antingen har direkt åtkomst till eller indirekt åtkomst via någon av deras underordnade. Med $search=ParentOnly returnerar API:et endast gruppen om användaren har åtkomst till minst en av de underordnade i gruppen. Med $search=ChildrenOnly returnerar API:et endast den första nivån av underordnade till gruppentitetsinformationen som anges i $filter. Användaren måste ha direkt åtkomst till de underordnade entiteterna eller någon av dess underordnade enheter för att visas i resultatet.

search?: string

Egenskapsvärde

string

select

Den här parametern anger vilka fält som ska ingå i svaret. Kan innehålla valfri kombination av Name,DisplayName,Type,ParentDisplayNameChain,ParentChain, t.ex. '$select=Name,DisplayName,Type,ParentDisplayNameChain,ParentNameChain'. När parametern $select anges kan den åsidosätta $skipToken.

select?: string

Egenskapsvärde

string

skip

Antal entiteter som ska hoppa över vid hämtning av resultat. Om du skickar in detta åsidosätts $skipToken.

skip?: number

Egenskapsvärde

number

skiptoken

Sidfortsättningstoken används endast om en tidigare åtgärd returnerade ett partiellt resultat. Om ett tidigare svar innehåller ett nextLink-element innehåller värdet för nextLink-elementet en tokenparameter som anger en startpunkt som ska användas för efterföljande anrop.

skiptoken?: string

Egenskapsvärde

string

top

Antal element som ska returneras när resultatet hämtas. Om du skickar in detta åsidosätts $skipToken.

top?: number

Egenskapsvärde

number

view

Med vyparametern kan klienter filtrera den typ av data som returneras av getEntities-anropet.

view?: string

Egenskapsvärde

string

Information om ärvda egenskaper

abortSignal

Den signal som kan användas för att avbryta begäranden.

abortSignal?: AbortSignalLike

Egenskapsvärde

Ärvd från coreClient.OperationOptions.abortSignal

onResponse

En funktion som ska anropas varje gång ett svar tas emot från servern när den begärda åtgärden utförs. Kan anropas flera gånger.

onResponse?: RawResponseCallback

Egenskapsvärde

Ärvd från coreClient.OperationOptions.onResponse

requestOptions

Alternativ som används när du skapar och skickar HTTP-begäranden för den här åtgärden.

requestOptions?: OperationRequestOptions

Egenskapsvärde

Ärvt från coreClient.OperationOptions.requestOptions

serializerOptions

Alternativ för att åsidosätta serialiserings-/avserialiseringsbeteende.

serializerOptions?: SerializerOptions

Egenskapsvärde

Ärvt från coreClient.OperationOptions.serializerOptions

tracingOptions

Alternativ som används när spårning är aktiverat.

tracingOptions?: OperationTracingOptions

Egenskapsvärde

Ärvt från coreClient.OperationOptions.tracingOptions