Öğretici: REST API 'Lerini kullanma

Bu öğreticide, Azure purview REST API 'Lerini nasıl kullanacağınızı öğreneceksiniz. Bir Azure purview 'a veri göndermek isteyen herkes, otomatik bir işlemin parçası olarak purview 'ı veya kendi kullanıcı deneyimini takip eden bir şekilde oluşturmak için REST API 'Leri kullanabilir.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Önkoşullar

• Başlamak için, mevcut bir Azure purview hesabına sahip olmanız gerekir. Bir kataloğunuz yoksa, Azure purview hesabı oluşturmaya yönelik hızlı başlangıçbölümüne bakın.

Hizmet sorumlusu oluşturma (uygulama)

REST API istemcisinin kataloğa erişmesi için, istemcinin bir hizmet sorumlusu (uygulama) ve kataloğun tanıdığı ve güvenmek üzere yapılandırıldığı bir kimlik olması gerekir. Kataloğa REST API çağrılar yaptığınızda, hizmet sorumlusunun kimliğini kullanır.

Var olan hizmet sorumlularını kullanan müşteriler (uygulama kimlikleri) yüksek oranda hata yaşadı. Bu nedenle, API 'Leri çağırmak için yeni bir hizmet sorumlusu oluşturmanızı öneririz.

Yeni bir hizmet sorumlusu oluşturmak için:

1. Azure Portal oturum açın.

2. portaldan Azure Active Directory arayıp seçin.

3. Azure Active Directory sayfasından sol bölmeden Uygulama kayıtları ' u seçin.

4. Yeni kayıt seçeneğini belirleyin.

5. Uygulama kaydetme sayfasında:

   1. Uygulama için bir ad girin (hizmet asıl adı).
   2. Yalnızca bu kurumsal dizindeki hesapları (< kiracınızın adı > -tek kiracı) seçin.
   3. Yeniden yönlendirme URI 'si (isteğe bağlı) için Web ' i seçin ve bir değer girin. Bu değerin geçerli bir URI olması gerekmez.
   4. Kaydet’i seçin.

6. Yeni hizmet sorumlusu sayfasında, daha sonra kaydetmek için görünen ad ve uygulama (istemci) kimliğinin değerlerini kopyalayın.

   Uygulama KIMLIĞI, client_id örnek kodda değeridir.

Hizmet sorumlusu 'nı (uygulama) kullanmak için, parolasını almanız gerekir. Aşağıdaki adımları uygulayın:

1. Azure portal, Azure Active Directory arayıp seçin ve ardından sol bölmeden Uygulama kayıtları ' yı seçin.

2. Listeden hizmet sorumlunuzu (uygulama) seçin.

3. Sol bölmedeki sertifikalar & parolaları ' nı seçin.

4. Yeni istemci gizli dizisi’ni seçin.

5. İstemci parolası Ekle sayfasında, bir Açıklama girin, süre sonu ' nun altında bir sona erme süresi seçin ve ardından Ekle' yi seçin.

   İstemci gizli dizileri sayfasında, yeni gizliliğin değer sütunundaki dize parolanız olur. Bu değeri kaydedin.

   

Hizmet sorumlusu kullanarak kimlik doğrulamasını ayarlama

Hizmet sorumlusu oluşturulduktan sonra, yukarıda oluşturulan hizmet sorumlusuna sağlamayla hesabınızın veri düzlemi rollerini atamanız gerekir. Hizmet sorumlusu ve sağlamayla hesabı arasında güven oluşturmak için aşağıdaki adımların izlenmesi gerekir.

1. Purview Studio'ya gidin.
2. Sol taraftaki menüden veri eşlemini seçin.
3. Koleksiyonlar ' ı seçin.
4. Koleksiyonlar menüsünde kök koleksiyonu seçin. Bu, listedeki en üst koleksiyon olacaktır ve purview hesabınızla aynı ada sahip olacaktır.
5. Rol atamaları sekmesini seçin.
6. Aşağıdaki rolleri, yukarıda oluşturulan hizmet sorumlusuna, purview 'daki çeşitli veri düzlelerini erişmek için atayın.
   1. Katalog veri düzlemine erişmek için ' Data Curator ' rolü.
   2. Tarama veri düzlemine erişim için ' veri kaynağı Yöneticisi ' rolü.
   3. ' Hesap veri düzlemine erişmek için koleksiyon Admin' rolü.
   4. ' Meta veri ilkesi veri düzlemi 'ne erişmek için koleksiyon Admin' rolü.

Belirteç al

Erişim belirtecini almak için aşağıdaki URL 'ye bir POST isteği gönderebilirsiniz.

https://login.microsoftonline.com/{your-tenant-id}/oauth2/token

Aşağıdaki parametrelerin yukarıdaki URL 'ye geçirilmesi gerekir.

• client_id: Azure Active Directory 'de kayıtlı olan ve purview hesabı için bir veri düzlemi rolüne atanan UYGULAMANıN istemci kimliği.
• client_secret: Yukarıdaki uygulama için istemci gizli dizisi oluşturuldu.
• grant_type: bu ' client_credentials ' olmalıdır.
• kaynak: Bu ' ' olmalıdır https://purview.azure.net

Örnek yanıt belirteci:

    {
        "token_type": "Bearer",
        "expires_in": "86399",
        "ext_expires_in": "86399",
        "expires_on": "1621038348",
        "not_before": "1620951648",
        "resource": "https://purview.azure.net",
        "access_token": "<<access token>>"
    }

Veri düzlemi API 'Lerini çağırmak için yukarıdaki erişim belirtecini kullanın.

Sonraki adımlar