Azure Yapay Zeka Arama'te paylaşılan özel bağlantılarla ilgili sorunları giderme

Not

Azure Yapay Zeka Arama Azure portalı, REST API'leri ve Azure SDK’ları aracılığıyla kullanılabilir. Ayrıca kuruluş içeriğini Microsoft Foundry portalındaki aracılar için yeniden kullanılabilir, izin kullanan bilgi bankalarına dönüştüren yönetilen bilgi katmanı Foundry IQ'yu temel alır.

Paylaşılan özel bağlantı, Azure Yapay Zeka Arama'ün sanal ağdaki müşteri kaynaklarına erişirken özel uç nokta üzerinden güvenli giden bağlantılar oluşturmasına olanak tanır. Bu makale, oluşabilecek hataları çözmenize yardımcı olabilir.

Paylaşılan özel bağlantı oluşturmak bir arama hizmeti denetim düzlemi işlemidir. Azure portalını veya Yönetim REST API'sini kullanarak paylaşılan bir özel bağlantı oluşturabilirsiniz. Sağlama sırasında isteğin durumu şeklindedir Updating. İşlem başarıyla tamamlandıktan sonra, durum şeklindedir Succeeded. Tüm DNS bölgeleri ve eşlemeleriyle birlikte kaynağa yönelik özel bir uç nokta oluşturulur. Bu uç nokta yalnızca arama hizmeti örneğiniz tarafından kullanılır ve Azure Yapay Zeka Arama aracılığıyla yönetilir.

Paylaşılan özel bağlantı kaynakları oluşturmayla ilgili adımlar

Aşağıda, oluşturma aşamasında oluşan yaygın hatalar yer alır.

İstek doğrulama hataları

  • Desteklenmeyen SKU: Paylaşılan özel bağlantılar Temel katmanda ve daha üst katmanda desteklenir. Beceri kümelerine sahip dizin oluşturucular için en düşük katman Standart 1 (S1) katmanıdır. Daha fazla bilgi için bkz. Paylaşılan özel bağlantı kaynak sınırları.

  • Geçersiz ad: Paylaşılan özel bağlantı için adlandırma kuralları şunlardır:

    • Uzunluk 1 ile 60 karakter arasında olmalıdır
    • Alfasayısal karakterler
    • Addaki ilk karakter olmadığı sürece adlar alt çizgi _, nokta .ve kısa çizgi - içerebilir

  • Geçersiz grup kimliği: Grup kimlikleri büyük/küçük harfe duyarlıdır ve aşağıdaki değerlerden biri olmalıdır.

    Azure kaynağı Grup Kimliği kullanılabilir ilk API sürümü
    Azure Depolama - Blob (veya) ADLS Nesil 2 blob 2020-08-01
    Azure Depolama - Tablolar table 2020-08-01
    NoSQL için Azure Cosmos DB Sql 2020-08-01
    Azure SQL Veritabanı sqlServer 2020-08-01
    MySQL için Azure Veritabanı (önizleme) mysqlServer 2020-08-01-Preview
    Azure Key Vault vault 2020-08-01
    Azure İşlevleri (önizleme) sites 2020-08-01-Preview

    "(önizleme)" ile işaretlenmiş kaynaklar, Yönetim REST API sürümlerinin önizleme sürümü kullanılarak oluşturulmalıdır.

  • privateLinkResourceId tür doğrulaması: groupId gibi, Azure Yapay Zeka Arama, privateLinkResourceId içinde "doğru" kaynak türünün tanımlandığını doğrular. Geçerli kaynak türleri şunlardır:

    Azure kaynağı Kaynak türü kullanılabilir ilk API sürümü
    Azure Depolama Microsoft.Storage/storageAccounts 2020-08-01
    Azure Cosmos DB veritabanı Microsoft.DocumentDb/databaseAccounts 2020-08-01
    Azure SQL Veritabanı Microsoft.Sql/servers 2020-08-01
    Azure Key Vault Microsoft.KeyVault/vaults 2020-08-01
    MySQL için Azure Veritabanı (önizleme) Microsoft.DBforMySQL/servers 2020-08-01-Preview
    Azure İşlevleri (önizleme) Microsoft.Web/sites 2020-08-01-Preview
    Azure SQL Yönetilen Örnek (önizleme sürümü) Microsoft.Sql/managedInstance 2020-08-01-Preview

    Ayrıca, belirtilen kaynak türü için belirtilen groupId geçerli olmalıdır. Örneğin, groupId "blob" türü Microsoft.Storage/storageAccountsiçin geçerlidir, başka bir kaynak türüyle kullanılamaz. Belirli bir arama yönetimi API'sinin sürümüne göre müşteriler, groupId kullanarak desteklenen ile kaynak türü ayrıntılarını bulabilir.

  • Kota sınırı zorlaması: Arama hizmetlerinde, oluşturulabilecek farklı sayıda paylaşılan özel bağlantı kaynağına ve kullanılmakta olan çeşitli hedef kaynak türlerinin sayısına (groupId temel alınarak) kotalar uygulanır. Daha fazla bilgi için bkz. Paylaşılan özel bağlantı kaynak sınırları.

Dağıtım hataları

Arama hizmeti paylaşılan özel bağlantı oluşturma isteğini başlatır, ancak gerçek işi Azure Resource Manager gerçekleştirir. Dağıtımın durumunu Azure portalında veya sorguyla denetleyebilir ve oluşabilecek hataları giderebilirsiniz.

Azure Resource Manager dağıtımında başarısız olan paylaşılan özel bağlantı kaynakları List ve Get API çağrılarında görünür, ancak "Sağlama Durumu" Failed şeklindedir. Azure Resource Manager dağıtım hatasının nedeni doğrulandıktan sonra, aşağıdaki tablodan Failed uygun çözümü uyguladıktan sonra kaynağı silin ve yeniden oluşturun.

Dağıtım hatasının nedeni Açıklama Çözüm
Bağlantılı Yetkilendirme Başarısız Hata iletisi, istemcinin arama hizmetinde paylaşılan özel bağlantıyı oluşturma iznine sahip olduğunu, ancak bağlantılı kapsamda 'privateEndpointConnectionApproval/action' eylemini gerçekleştirme izni olmadığını belirtir. URI'de hata veya eksiklik olmadığından emin olmak için istekteki özel bağlantı kimliğini yeniden denetleyin. Azure Yapay Zeka Arama ve Azure PaaS kaynağı farklı aboneliklerdeyse ve REST veya komut satırı arabirimi kullanıyorsanız etkin Azure hesabının Azure PaaS kaynağı olduğundan emin olun. REST istemcileri için süresi dolmuş taşıyıcı belirteci kullanmadığınızdan ve belirtecin etkin abonelik için geçerli olduğundan emin olun.
Ağ kaynağı sağlayıcısı hedef kaynağın aboneliğinde kayıtlı değil Kaynak sağlayıcısı (RP) aracılığıyla Microsoft.Network hedef kaynak (Depolama Hesabı, Azure Cosmos DB, Azure SQL) için bir özel uç nokta (ve ilişkili DNS eşlemeleri) oluşturulur. Hedef kaynağı barındıran abonelik ("hedef abonelik") RP'ye Microsoft.Network kayıtlı değilse Azure Resource Manager dağıtımı başarısız olabilir. Bu RP'yi hedef aboneliğine kaydetmeniz gerekir. Kaynak sağlayıcısını Azure portalı, PowerShell veya CLI kullanarak kaydedebilirsiniz.
Hedef kaynak için geçersiz groupId Azure Cosmos DB hesapları oluşturulduğunda, veritabanı hesabı için API türünü belirtebilirsiniz. Azure Cosmos DB birkaç farklı API türü sunarken, Azure Yapay Zeka Arama paylaşılan özel bağlantı kaynakları için yalnızca "Sql"i groupId destekler. Sql olmayan bir veritabanı hesabına işaret eden bir privateLinkResourceId için "Sql" türünde paylaşılan bir özel bağlantı oluşturulduğunda, uyumsuzluk nedeniyle groupId Azure Resource Manager dağıtımı başarısız olur. Azure Cosmos DB hesabının Azure kaynak kimliği, kullanılmakta olan API türünü belirlemek için yeterli değildir. Azure Yapay Zeka Arama, Azure Cosmos DB'nin reddeddiği özel uç noktayı oluşturmaya çalışır. Belirtilen Azure Cosmos DB kaynağının "Sql" API türünde bir veritabanı hesabı için olduğundan emin privateLinkResourceId olmalısınız
Hedef kaynak bulunamadı içinde privateLinkResourceId belirtilen hedef kaynağın varlığı yalnızca Azure Resource Manager dağıtımının başlarken denetlendi. Hedef kaynak artık kullanılamıyorsa dağıtım başarısız olur. Hedef kaynağın belirtilen abonelikte ve kaynak grubunda bulunduğundan ve taşınmadığından veya silinmediğinden emin olmalısınız.
Geçici/diğer hatalar Azure Resource Manager dağıtımı, bir altyapı kesintisi olduğunda veya beklenmeyen başka nedenlerden dolayı başarısız olabilir. Bu nadir olmalıdır ve genellikle geçici bir durumu gösterir. Bu kaynağı daha sonra yeniden oluşturmayı deneyin. Sorun devam ederse Azure Desteği'ne ulaşın.

Destekleyici özel uç noktanın onaylanmasıyla ilgili sorunlar

Paylaşılan özel bağlantı oluşturma isteğinde belirtildiği gibi hedef Azure kaynağı için özel bir uç nokta oluşturulur. Bu, zaman uyumsuz Azure Resource Manager dağıtım işleminin son adımlarından biridir, ancak Azure Yapay Zeka Arama'ün ağ yapılandırması kapsamında özel uç noktanın özel IP adresini bağlaması gerekir. Bu bağlantı tamamlandıktan sonra, provisioningState paylaşılan özel bağlantı kaynağının terminal başarı durumuna Succeededgeçer. Müşteriler, durum Succeeded olduğunda yalnızca özel uç noktanın yapılandırmasını onaylamalı veya reddetmeli (veya genel olarak yapılandırmayı değiştirmelidir). Özel uç noktanın bundan önce herhangi bir şekilde değiştirilmesi, tamamlanmamış bir dağıtım işlemine neden olabilir ve paylaşılan özel bağlantı kaynağının bir durumda (hemen veya genellikle birkaç saat içinde) Failed durumuna dönüşmesine neden olabilir.

Arama hizmeti ağ bağlantısı değişikliği "Güncelleştirme" durumunda durdu.

Arama hizmeti Genel Ağ Erişimi Devre Dışı olduğunda paylaşılan özel bağlantılar ve özel uç noktalar kullanılır. Genellikle, istek kabul edildikten sonra ağ bağlantısının değiştirilmesi birkaç dakika içinde başarılı olur. Bazı durumlarda Azure Yapay Zeka Arama'te bağlantı değişikliği işleminin tamamlanması birkaç saat sürebilir.

Genel ağ erişimini devre dışı olarak değiştirme ekran görüntüsü.

Bağlantı değişikliği işleminin önemli miktarda zaman aldığını gözlemlerseniz birkaç saat bekleyin. Bağlantı değişikliği işlemleri, DNS kayıtlarını güncelleştirme gibi beklenenden daha uzun sürebilecek işlemleri içerir.

Genel Ağ Erişimi değiştirilirse, mevcut paylaşılan özel bağlantılar ve özel uç noktalar düzgün çalışmayabilir. Bağlantı değiştirme işlemi sırasında mevcut paylaşılan özel bağlantılar ve özel uç noktalar çalışmayı durdurursa, işlemin tamamlanması için birkaç saat bekleyin. Hala çalışmıyorsa silmeyi ve yeniden oluşturmayı deneyin.

Genellikle, paylaşılan özel bağlantı kaynağı istek kabul edildikten birkaç dakika sonra terminal durumuna (Succeeded veya Failed) geçmelidir.

Nadir durumlarda Azure Yapay Zeka Arama, paylaşılan özel bağlantı kaynağının durumunu terminal durumuna (Succeeded veya Failed) doğru şekilde işaretleyemediğini gösterir. Bu durum genellikle beklenmeyen bir hata nedeniyle oluşur. Paylaşılan özel bağlantı kaynakları, terminal olmayan bir durumda birkaç saatten uzun süre "takılı" kalırsa otomatik olarak Failed durumuna geçirilir.

Paylaşılan özel bağlantı kaynağı terminal durumuna geçmezse, silip yeniden oluşturabilmeniz için Failed olduğundan emin olmak için birkaç saat bekleyin. Alternatif olarak, beklemek yerine farklı bir adla (diğer tüm parametreleri aynı tutarak) başka bir paylaşılan özel bağlantı kaynağı oluşturmayı deneyebilirsiniz.

Mevcut bir paylaşılan özel bağlantı kaynağı Oluşturma veya Güncelleştirme API'sini kullanarak güncelleştirilebilir. Arama yalnızca paylaşılan özel bağlantı kaynağında dar güncelleştirmelere izin verir. Yalnızca istek iletisi bu API aracılığıyla değiştirilebilir.

  • Mevcut bir paylaşılan özel bağlantı kaynağının (veya privateLinkResourceIdgibigroupId) "çekirdek" özelliklerinin hiçbiri güncelleştirilemez ve bu her zaman desteklenmez. İstek iletisi dışında başka bir özelliğin değiştirilmesi gerekiyorsa, müşterilere paylaşılan özel bağlantı kaynağını silmelerini ve yeniden oluşturmalarını öneririz.

  • Paylaşılan özel bağlantı kaynağının istek iletisini güncelleştirmek yalnızca sağlama durumuna Succeededulaştığında mümkündür.

Müşteriler, Delete API'sini kullanarak mevcut paylaşılan özel bağlantı kaynağını silebilir. Oluşturma (veya güncelleştirme) işlemine benzer şekilde, bu da dört adımlı zaman uyumsuz bir işlemdir:

  1. Paylaşılan özel bağlantı kaynağını silmek için bir arama hizmeti istiyorsunuz.

  2. Arama hizmeti kaynağın mevcut olduğunu ve silinmek üzere geçerli bir durumda olduğunu doğrular. Öyleyse, kaynağı kaldırmak için bir Azure Resource Manager silme işlemi başlatır.

  3. İşlemin tamamlanması için arama sorguları gerçekleştirin (bu genellikle birkaç dakika sürer). Bu noktada, paylaşılan özel bağlantı kaynağının sağlama durumu Deletingolacaktır.

  4. İşlem başarıyla tamamlandıktan sonra, yedekleme özel uç noktası ve ilişkili DNS eşlemeleri kaldırılır. Kaynak Liste işleminin bir parçası olarak gösterilmez ve bu kaynakta Get işlemi denenmesi 404 Bulunamadı sonucunu döndürür.

Paylaşılan özel bağlantı kaynaklarını silmeyle ilgili adımlar

Aşağıda, silme aşamasında oluşan yaygın hatalar yer alır.

Hata Türü Açıklama Çözüm
Kaynak nihai olmayan bir durumda. Terminal durumunda (Succeeded veya Failed) olmayan paylaşılan özel bağlantı kaynağı silinemez. Paylaşılan özel bağlantı kaynağının 8 saate kadar belirsiz bir durumda takılması mümkündür (nadir). Kaynak terminal durumuna gelene kadar bekleyin ve silme isteğini yeniden deneyin.
Silme işlemi "Çakışma" hatasıyla başarısız oldu Paylaşılan bir özel bağlantı kaynağını silmeye yönelik Azure Resource Manager işlemi, özel uç noktayı ve DNS eşlemelerini kaldırmadan önce ("hedef RP") içinde privateLinkResourceId belirtilen hedef kaynağın kaynak sağlayıcısına ulaşır. Müşteriler kaynaklarında değişiklik yapılmasını önlemek için Azure kaynak kilitlerini kullanabilir. Azure Resource Manager hedef RP'ye ulaştığında, hedef RP'nin hedef kaynağın durumunu değiştirmesini gerektirir (meta verilerinden özel uç noktayla ilgili ayrıntıları kaldırmak için). Hedef kaynağın üzerinde yapılandırılmış bir kilit (veya kaynak grubu/aboneliği) olduğunda, Azure Resource Manager işlemi "Çakışma" (ve uygun ayrıntılar) ile başarısız olur. Paylaşılan özel bağlantı kaynağı silinmez. Müşterilerin silme işlemini yeniden denemeden önce hedef kaynak üzerindeki kilidi kaldırması gerekir. Not: Müşteriler "kilitli" hedef kaynakları işaret eden paylaşılan özel bağlantı kaynaklarıyla bir arama hizmetini silmeye çalıştığında da bu sorun oluşabilir
Silme işlemi başarısız oldu Zaman uyumsuz Azure Resource Manager silme işlemi nadir durumlarda başarısız olabilir. Bu işlem başarısız olduğunda, zaman uyumsuz işlemin durumunu sorgulamak bir hata iletisi ve uygun ayrıntıları sunar. İşlemi daha sonra yeniden deneyin veya sorun devam ederse Azure Desteği'ne ulaşın.
Kaynak "Siliniyor" durumunda takıldı Nadir durumlarda, özel bir bağlantı paylaşılan kaynak, muhtemelen arama hizmet sağlayıcısındaki kritik bir arıza nedeniyle "Silme" durumunda 8 saat boyunca takılı kalabilir. 8 saat bekleyin, bundan sonra kaynak Failed durumuna geçirilecek ve istek yeniden gönderilecektir.

Sonraki adımlar

Paylaşılan özel bağlantı kaynakları ve korumalı içeriğe güvenli erişim için bu kaynakları kullanma hakkında daha fazla bilgi edinin.

  • Son güncelleştirme: