Oracle Metrik Bağlantısını Test Et

Hiçbir şey kaydetmeden, platformun gerçek okumalarda kullandığı okuyucuyla bir metrik sağlayıcısı bağlantısını dener. Bir sağlayıcıyı yapılandırırken, Oracle Metriği Oluştur ya da Oracle Metriğini Güncelle öncesinde kullanın.

• TOGG için code zorunludur ve yalnızca o seri okunur.
• SHEET için code gönderilmezse sekmenin tamamı yüklenip ayrıştırılır; code gönderilirse o satır okunur.

Kaynağa ulaşıp hatalı yanıt alan bir deneme yine 200 döner; ok: false olur ve neden error alanında yer alır. Yanıt, kaynağın döndürdüğü içeriği hiçbir zaman içermez: error yalnızca kaynağın yanıt verip vermediğini ve hangi durum koduyla verdiğini söyler.

Kayıtlı gizli değeri kullanmak. Bir sağlayıcıda kayıtlı gizli değerle denemek için oracle_metric_id gönderin ve connection.auth.secret alanını göndermeyin (ya da null gönderin). Kayıtlı gizli değer yalnızca kaydedildiği köke (şema, host ve port) gönderilir; başka bir kökü bu değerle denemek 10002 (domain 83) ile reddedilir. Başka bir host'u denemek için gizli değeri istekte gönderin.

İzin verilen hedefler. URL herkese açık https ya da ortamın listelediği bir küme içi host olmalıdır. İnternet üzerinde düz http, özel adresler ve bulut metadata endpoint'i, hiçbir şey gönderilmeden 10001 (domain 83) ile reddedilir.

Gerekli izin: oracle:update

İstek

POST /v2/admin/oracle-metrics/test-connection

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
oracle_metric_id	string | null	Hayır	Gizli değeri, gönderilmeyen connection.auth.secret yerine kullanılacak kayıtlı sağlayıcının ID'si
type	string	Evet	Kaynak tipi: TOGG ya da SHEET
code	string	Koşullu	Okunacak seri. TOGG için zorunlu; SHEET için isteğe bağlı
connection	object	Evet	Denenecek bağlantı; alanları Oracle Metriği Oluştur sayfasındakiyle aynıdır (url, timeout, cache_ttl_seconds, auth, headers)

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/admin/oracle-metrics/test-connection' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "oracle_metric_id": null,
    "type": "SHEET",
    "code": "",
    "connection": {
      "url": "https://docs.google.com/spreadsheets/d/1Q9xWmT4kLp7RzV2sN8bYc3HdF6gJ0aEu5iO/export?format=csv&gid=0",
      "timeout": 30,
      "cache_ttl_seconds": 300,
      "auth": { "type": "NONE" },
      "headers": []
    }
  }'

Yanıt

{
  "ok": true,
  "latency_ms": 356
}

Yanıt Alanları

Alan	Tip	Açıklama
ok	boolean	Denemenin sağlayıcının anladığı veriyi okuyup okumadığı
latency_ms	integer	Denemenin milisaniye cinsinden süresi
error	string	Yalnızca ok false olduğunda: the source answered HTTP <status>, the source could not be reached ya da the source answered, but not with data this provider can read

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın
400	10000	oracle_metric_id geçerli bir 24 karakterlik hex ID değil
400	10001	oracle_metric_id ile belirtilen sağlayıcı bulunamadı (domain 53)
400	-1	Bağlantı eksik (URL şeması ya da kimlik doğrulama şemasının name, username veya secret değeri yok) ya da TOGG için code eksik
400	10001	Hedef reddedildi: https değil, çözümlenemiyor ya da özel veya metadata adresine çözümleniyor (domain 83)
400	10002	Kayıtlı gizli değer, kaydedildiği host dışındaki bir host'a gönderilecekti (domain 83)

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.