Kılavuz: Özel meta verileri tanımlayın

Bu öğreticide API'lerinizi ve API merkezinizdeki diğer bilgileri düzenlemenize yardımcı olacak özel meta verilerin nasıl tanımlanacağı açıklanmaktadır. Arama ve filtreleme için özel ve yerleşik meta veriler kullanabilir ve kuruluşunuzda idare standartlarını zorunlu kılabilirsiniz.

Azure API Center'daki meta veriler hakkında daha fazla bilgi için bkz:

• Önemli kavramlar - Meta veriler
• API idaresi için meta verileri kullanma

Bu öğreticide, Azure portalını 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. Bir tane oluşturmak için 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; dilerseniz kendi meta verilerinizi de tanımlayabilirsiniz. Envanterinize API'ler ve diğer bilgileri eklediğinizde veya güncelleştirdiğinizde, özel ve tüm yaygın yerleşik meta veriler için değerleri ayarlayın.

Ö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.

1. Azure portalında oturum açın, ardından API merkezinize gidin.

2. Kenar çubuğu menüsündeki Varlıklar'ın altında Meta Veri>+ Yeni meta veriler'i seçin.

3. Ayrıntılar sekmesinde meta veriler hakkındaki bilgileri girin.

   1. Başlık alanına İş kolu yazın.

   2. İsteğe bağlı olarak bir Açıklama girin.

   3. Ö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. sonrakiseçin.

   

4. Atamalar sekmesinde, Gerekli öğesini API'ler için seçin. Dağıtımlar ve Ortamlar için İsteğe Bağlı'ya tıklayın. Bu varlıkları sonraki eğitimlerde ekleyebilirsiniz. sonrakiseçin.

   

5. Gözden Geçir + oluştur sekmesinde ayarları gözden geçirin ve Oluştur'u seçin.

   Meta veriler, Meta Veriler sayfasındaki listeye eklenir.

6. Başka bir örnek eklemek için + Yeni meta veriler'i seçin.

7. Ayrıntılar sekmesinde meta veriler hakkındaki bilgileri girin.

   1. Başlık alanına Genel kullanıma yönelik yazın.

   2. Türü Boole olanı seçin.

8. Atamalar sekmesinde, Gerekli öğesini API'ler için seçin. Dağıtımlar ve Ortamlar için geçerli değil'i seçin.

9. Gözden Geçir + 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.

1. Soldaki menüde, Varlıklar'ın altında Meta Veri>Görünümü meta veri şeması'nı seçin.

2. 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ım

API merkezinizdeki envantere API'ler ekleyin.

API envanterinize API'leri kaydetme