Pokročilé použití Microsoft Graph

Implementace zabezpečení Azure pro vývojáře

Anushika Agarwal

Cloud Data Engineer

Analogie: výlety pro nákupy

Přenášejte nákupy ve více výletech
Lehčí, rychlejší a bezpečnější

Výlety pro nákupy

Stránkování

Rozděluje velké výsledky na menší stránky
Rychlejší odpovědi a méně timeoutů

Jak se načítají další stránky?
- Odpověď obsahuje odkaz pro pokračování: `@odata.nextLink`

Stránkování

Příklad: PeopleSphere používá stránkování

Tisíce záznamů zaměstnanců načítané po zvladatelných stránkách

Příklad – stránkování PeopleSphere

Stránkování na straně serveru

Služba zvolí výchozí velikost stránky
Klient velikost neurčuje
Příklad
- GET /v1.0/users : (výchozí) Vrátí 100 položek na stránku

Stránkování na straně serveru

Stránkování na straně klienta

Klient určuje počet položek na stránku

Stránkování na straně klienta

Parametry dotazu pro stránkování

Parametry dotazu
- $top: počet položek na stránku.

$skip: posun; přeskočí prvních N položek

Příklad stránkování na straně klienta

Příklad:
- https://graph.microsoft.com/v1.0/groups?$top=2

Stránkování na straně klienta

Analogie dávkování: online nákupní košík

Více položek v jednom košíku
Jedno zaplacení, jeden doklad

Analogie – online nákupní košík

Dávkování

Více požadavků Graph v jednom HTTP volání
Jeden payload -> jedna odpověď se všemi výsledky
Výhody
- Méně požadavků, nižší latence
- Ideální pro řídicí panely.
Limit
- Až 20 požadavků na dávku

Dávkování

Endpoint dávkového požadavku

Endpoint
- Metoda: POST
- Endpoint:https://graph.microsoft.com/v1.0/$batch
$batch místo konkrétního zdroje, např. users

Endpoint dávkového požadavku

Tělo dávkového požadavku

Tělo je objekt JSON
Obsahuje jednu vlastnost: requests
requests je pole (až 20 položek)

{ "requests": 
   [ {
      "id": "1",
      "method": "GET",
      "url": "/me/memberOf"
    },
    {
      "id": "2",
      "method": "GET",
      "url": "/me/planner/tasks"
    } ]
}

Položky požadavku a hlavičky

Každá položka požadavku vyžaduje
- id: jedinečný identifikátor pro párování odpovědi
- method: (GET/POST/PATCH/DELETE)
- url: relativní cesta
Hlavičky: Content-Type: application/json

{ "requests": 
   [ {
      "id": "1",
      "method": "GET",
      "url": "/me/memberOf"
    },
    {
      "id": "2",
      "method": "GET",
      "url": "/me/planner/tasks"
    } ]
}

Dávková odpověď

Každá položka představuje jeden požadavek

{
  "responses": [
    {  "id": "1", 
        "status": 200, 
        "body": { "value": [/* ... */]}},
    { 
        "id": "2", 
        "status": 403, 
        "body": { "error": [/* ... */]}}
  ]
}

Obsah každé položky odpovědi

Každá položka odpovědi obsahuje
- id: odpovídá původnímu požadavku
- status: HTTP stav dané položky
  - 200: OK
  - 403: Zakázáno
- headers: (např. Content-Type)
- body: data nebo objekt chyby

{
  "responses": [
    {  "id": "1", 
        "status": 200, 
        "body": { "value": [/* ... */]}},
    { 
        "id": "2", 
        "status": 403, 
        "body": { "error": [/* ... */]}}
  ]
}

Pojďme si procvičit!

Implementace zabezpečení Azure pro vývojáře