Microsoft Graph’ın gelişmiş kullanımı

Geliştiriciler için Azure Güvenliğini Uygulama

Anushika Agarwal

Cloud Data Engineer

Benzetim: market seferleri

Market poşetlerini küçük seferlerle taşı
Daha hafif, daha hızlı, daha güvenli

Market seferleri

Sayfalandırma

Büyük sonuçları küçük sayfalara böler
Daha hızlı yanıt, daha az zaman aşımı

Sonraki sayfalar nasıl alınır?
- Yanıtta bir devam bağlantısı vardır: `@odata.nextLink`

Sayfalandırma

Örnek: PeopleSphere sayfalandırma kullanımı

Binlerce çalışan kaydı yönetilebilir sayfalarla alınır

Örnek - PeopleSphere Sayfalandırma

Sunucu tarafı sayfalandırma

Hizmet, varsayılan sayfa boyutu seçer
İstemci boyutu belirtmez
Örnek
- GET /v1.0/users : (varsayılan) Sayfa başına 100 öğe döner

Sunucu Tarafı Sayfalandırma

İstemci tarafı sayfalandırma

İstemci, sayfa başına dönecek öğe sayısını belirtir

İstemci Tarafı Sayfalandırma

Sayfalandırma için sorgu parametreleri

Sorgu parametreleri
- $top: sayfa başına öğe sayısı

$skip: atlama; ilk N öğeden sonra başla

İstemci tarafı sayfalandırma örneği

Örnek:
- https://graph.microsoft.com/v1.0/groups?$top=2

İstemci Tarafı Sayfalandırma

Toplu istek benzetimi: çevrimiçi alışveriş sepeti

Bir sepette birden çok öğe
Tek ödeme, tek fiş

Benzetim - Çevrimiçi alışveriş sepeti

Toplu istek (Batching)

Birden çok Graph isteğini tek bir HTTP çağrısında birleştir
Tek yük -> tek yanıt, tüm sonuçlar birlikte
Yararları
- Daha az gidiş-dönüş, daha düşük gecikme
- Panolar için ideal
Sınır
- Her topluda en fazla 20 istek

Toplu işleme

Toplu istek uç noktası

Uç nokta
- Yöntem: POST
- Uç nokta:https://graph.microsoft.com/v1.0/$batch
users gibi belirli bir kaynak yerine $batch

Toplu istek uç noktası

Toplu istek gövdesi

Gövde bir JSON nesnesidir
Tek özellik içerir: requests
requests bir dizidir (en fazla 20 öğe)

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

İstek öğeleri ve üstbilgiler

Her istek öğesi şunları gerektirir
- id: yanıtla eşleştirilecek benzersiz etiket
- method: (GET/POST/PATCH/DELETE)
- url: göreli yol
Üstbilgiler: Content-Type: application/json

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

Toplu yanıt

Her kayıt bir isteği temsil eder

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

Her yanıtta neler var

Her yanıt öğesi şunları içerir
- id: özgün istekle eşleşir
- status: o öğe için HTTP durumu
  - 200: OK
  - 403: Yasak
- headers: (örn. Content-Type)
- body: veri veya hata nesnesi

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

Hadi pratik yapalım!

Geliştiriciler için Azure Güvenliğini Uygulama