EntitiesListOptionalParams interface
Valfria parametrar.
- Extends
Egenskaper
cache |
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. |
group |
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
abort |
Den signal som kan användas för att avbryta begäranden. |
on |
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. |
request |
Alternativ som används när du skapar och skickar HTTP-begäranden för den här åtgärden. |
serializer |
Alternativ för att åsidosätta serialiserings-/avserialiseringsbeteende. |
tracing |
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
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.
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