Öğretici: Özel meta verileri tanımlama
Bu öğreticide API'lerinizi ve API merkezinizdeki diğer bilgileri düzenlemenize yardımcı olacak özel meta veriler tanımlayın. Arama ve filtreleme için özel ve yerleşik meta veriler kullanın ve kuruluşunuzda idare standartlarını zorunlu kılın.
Azure API Center'daki meta veriler hakkında arka plan bilgileri için bkz:
Bu öğreticide portalı kullanarak şunları yapmayı öğreneceksiniz:
- API merkezinizde özel meta veriler tanımlama
- Meta veri şemasını görüntüleme
Önkoşullar
- Azure aboneliğinizde bir API merkezi. Henüz oluşturmadıysanız bkz . Hızlı Başlangıç: API merkezinizi oluşturma.
Meta verileri tanımlama
Burada iki özel meta veri örneği tanımlarsınız: İş kolu ve Genel kullanıma yönelik; tercih ederseniz kendi meta verilerinizi tanımlayın. Envanterinize API'leri ve diğer bilgileri eklediğinizde veya güncelleştirdiğinizde, özel ve tüm yaygın yerleşik meta veriler için değerler ayarlarsınız.
Önemli
Tanımladığınız meta verilerin başlıklarına (adlar) hassas, gizli veya kişisel bilgiler eklemeyin. Bu başlıklar, Hizmetin işlevselliğini geliştirmek için Microsoft tarafından kullanılan izleme günlüklerinde görünür. Ancak, diğer meta veri ayrıntıları ve değerleri korumalı müşteri verilerinizdir.
Soldaki menüde, Varlıklar'ın altında Meta Veriler > + Yeni meta veriler'i seçin.
Ayrıntılar sekmesinde meta veriler hakkındaki bilgileri girin.
Başlık alanına İş kolu yazın.
İsteğe bağlı olarak bir Açıklama girin.
Önceden tanımlanmış seçenekler yazın ve Pazarlama, Finans, BT, Satış gibi seçenekler girin. İsteğe bağlı olarak Birden çok değerin seçilmesine izin ver'i etkinleştirin. İleri'yi seçin.
Atamalar sekmesinde API'ler için gerekli'yi seçin. Dağıtımlar ve Ortamlar için İsteğe Bağlı'ya tıklayın. (Bu varlıkları sonraki öğreticilerde ekleyeceksiniz.) İleri'yi seçin.
Gözden geçir ve oluştur sekmesinde ayarları gözden geçirin ve Oluştur'u seçin.
Meta veriler, Meta Veriler sayfasındaki listeye eklenir.
Başka bir örnek eklemek için + Yeni meta veriler'i seçin.
Ayrıntılar sekmesinde meta veriler hakkındaki bilgileri girin.
Başlık alanına Genel kullanıma yönelik yazın.
Boole türü'nü seçin.
Atamalar sekmesinde API'ler için gerekli'yi seçin. Dağıtımlar ve Ortamlar için geçerli değil'i seçin.
Gözden geçir ve oluştur sekmesinde ayarları gözden geçirin ve Oluştur'u seçin.
Meta veriler listeye eklenir.
Meta veri şemasını görüntüleme
API merkezinizde tanımlanan meta veriler için JSON şemasını görüntüleyebilir ve indirebilirsiniz. Şema yerleşik ve özel meta veriler içerir.
Soldaki menüde, Varlıklar'ın altında Meta Veri > Görünümü meta veri şeması'nı seçin.
Yerleşik ve özel meta veriler içeren API'lerin meta veri şemasını görmek için Meta veri şeması > API'lerini görüntüle'yi seçin. API merkezinizdeki dağıtımlar ve ortamlar için tanımlanan meta veri şemasını da görüntüleyebilirsiniz.
Sonraki adımlar
Bu öğreticide portalı kullanarak şunları yapmayı öğrendiniz:
- API merkezinizde özel meta veriler tanımlama
- Meta veri şemasını görüntüleme
Meta veri şemanızı hazırladığınıza göre API'leri API merkezinizdeki envantere ekleyin.