Mengatasi masalah dengan tautan privat yang dibagikan di Pencarian Azure AI

Note

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Tautan privat bersama memungkinkan Pencarian Azure AI untuk membuat koneksi keluar yang aman melalui titik akhir privat saat mengakses sumber daya pelanggan di jaringan virtual. Artikel ini dapat membantu Anda mengatasi kesalahan yang mungkin terjadi.

Membuat tautan privat bersama adalah operasi sarana kontrol layanan pencarian. Anda dapat membuat tautan privat bersama menggunakan portal Azure atau API REST Manajemen. Pada waktu penyediaan, status permintaan adalah Updating. Setelah operasi berhasil diselesaikan, statusnya adalah Succeeded. Titik akhir privat untuk sumber daya, bersama dengan zona dan pemetaan DNS apa pun, dibuat. Titik akhir ini digunakan secara eksklusif oleh instans layanan pencarian Anda dan dikelola melalui Pencarian Azure AI.

Langkah-langkah yang terlibat dalam membuat sumber daya tautan privat bersama

Berikut ini adalah kesalahan umum yang terjadi selama fase pembuatan.

Kegagalan permintaan validasi

  • SKU yang tidak didukung: Tautan privat bersama didukung pada tingkat Dasar dan yang lebih tinggi. Untuk pengindeks dengan keterampilan, level minimumnya adalah Standard 1 (S1). Untuk informasi selengkapnya, lihat Batas sumber daya tautan privat bersama.

  • Nama tidak valid: Aturan penamaan untuk tautan privat bersama adalah:

    • Panjangnya harus antara 1 hingga 60 karakter
    • Karakter alfanumerik
    • Nama dapat mencakup garis bawah _, titik ., dan tanda hubung - selama bukan karakter pertama dalam nama

  • ID grup tidak valid: ID grup peka huruf besar/kecil dan harus menjadi salah satu nilai berikut.

    Sumber daya Azure ID Grup Versi API pertama yang tersedia
    Azure Storage - Blob (atau) ADLS Gen 2 blob 2020-08-01
    Azure Storage - Tabel table 2020-08-01
    Azure Cosmos DB for NoSQL Sql 2020-08-01
    Azure SQL Database sqlServer 2020-08-01
    Azure Database for MySQL (pratinjau) mysqlServer 2020-08-01-Preview
    Azure Key Vault vault 2020-08-01
    Azure Functions (pratinjau) sites 2020-08-01-Preview

    Sumber daya yang ditandai dengan "(pratinjau)" harus dibuat menggunakan versi pratinjau versi REST API Manajemen.

  • privateLinkResourceId validasi jenis: Mirip dengan groupId, Pencarian Azure AI memvalidasi bahwa jenis sumber daya “tepat” ditentukan dalam privateLinkResourceId. Berikut ini adalah tipe sumber daya yang valid:

    Sumber daya Azure Jenis Sumber Daya Versi API pertama yang tersedia
    Azure Storage Microsoft.Storage/storageAccounts 2020-08-01
    Azure Cosmos DB Microsoft.DocumentDb/databaseAccounts 2020-08-01
    Azure SQL Database Microsoft.Sql/servers 2020-08-01
    Azure Key Vault Microsoft.KeyVault/vaults 2020-08-01
    Azure Database for MySQL (pratinjau) Microsoft.DBforMySQL/servers 2020-08-01-Preview
    Azure Functions (pratinjau) Microsoft.Web/sites 2020-08-01-Preview
    Azure SQL Managed Instance (pratinjau) Microsoft.Sql/managedInstance 2020-08-01-Preview

    Selain itu, groupId yang ditentukan harus valid untuk jenis sumber daya yang ditentukan. Misalnya, groupId "blob" valid untuk jenis Microsoft.Storage/storageAccounts, tidak dapat digunakan dengan jenis sumber daya lainnya. Untuk versi API manajemen pencarian yang diberikan, pelanggan dapat mengetahui detail jenis yang didukung groupId dan sumber daya dengan menggunakan Daftar API yang didukung.

  • Pemberlakuan batas kuota: Layanan pencarian memiliki kuota yang dikenakan pada jumlah sumber daya tautan privat bersama yang berbeda yang dapat dibuat dan jumlah berbagai jenis sumber daya target yang sedang digunakan (berdasarkan groupId). Untuk informasi selengkapnya, lihat Batas sumber daya tautan privat bersama.

Kegagalan penyebaran

Layanan pencarian memulai permintaan untuk membuat tautan pribadi bersama, tetapi Azure Resource Manager melakukan pekerjaan yang sebenarnya. Anda dapat memeriksa status penyebaran di portal Azure atau melalui kueri, dan mengatasi kesalahan yang mungkin terjadi.

Sumber daya tautan privat yang dibagikan yang gagal dalam penyebaran Azure Resource Manager muncul dalam panggilan API Daftar dan Dapatkan, namun mereka memiliki "Status Penyediaan" dari Failed. Setelah alasan kegagalan penyebaran Azure Resource Manager dipastikan, hapus sumber daya Failed dan buat kembali setelah menerapkan resolusi yang sesuai dari tabel berikut.

Alasan kegagalan penerapan Deskripsi Resolusi
"OtorisasiTertautGagal" Pesan kesalahan menyatakan bahwa klien memiliki izin untuk membuat tautan privat bersama pada layanan pencarian, tetapi tidak memiliki izin untuk melakukan tindakan 'privateEndpointConnectionApproval/action' pada cakupan tertaut. Centang ulang ID tautan privat dalam permintaan untuk memastikan tidak ada kesalahan atau kelalaian dalam URI. Jika Pencarian Azure AI dan sumber daya Azure PaaS berada dalam langganan yang berbeda, dan jika Anda menggunakan REST atau antarmuka baris perintah, pastikan akun Azure aktif adalah sumber daya Azure PaaS. Untuk klien REST, pastikan Anda tidak menggunakan token pembawa kedaluwarsa, dan token tersebut berlaku untuk langganan aktif.
Penyedia sumber daya jaringan tidak terdaftar pada langganan sumber daya target Titik akhir privat (dan pemetaan DNS terkait) dibuat untuk sumber daya target (Akun Penyimpanan, Azure Cosmos DB, Azure SQL) melalui Microsoft.Network penyedia sumber daya (RP). Jika langganan yang menghosting sumber daya target ("langganan target") tidak terdaftar di Microsoft.Network RP, maka penyebaran Azure Resource Manager dapat gagal. Anda perlu mendaftarkan RP ini dalam langganan target mereka. Anda dapat mendaftarkan penyedia sumber daya menggunakan portal Azure, PowerShell, atau CLI.
groupIdtidak valid untuk sumber daya target Saat akun Azure Cosmos DB dibuat, Anda dapat menentukan jenis API untuk akun database. Meskipun Azure Cosmos DB menawarkan beberapa jenis API yang berbeda, Pencarian Azure AI hanya mendukung "Sql" sebagai groupId untuk sumber daya tautan privat bersama. Saat sebuah tautan privat bersama dengan tipe "Sql" dibuat untuk privateLinkResourceId yang menunjuk ke akun database non-Sql, penyebaran Azure Resource Manager gagal karena ketidakcocokan groupId. ID sumber daya Azure dari akun Azure Cosmos DB tidak cukup untuk menentukan jenis API yang sedang digunakan. Pencarian Azure AI mencoba membuat titik akhir privat, yang kemudian ditolak Oleh Azure Cosmos DB. Anda harus memastikan bahwa privateLinkResourceId sumber daya Azure Cosmos DB yang ditentukan adalah untuk akun database jenis API "Sql"
Sumber daya target tidak ditemukan Keberadaan sumber daya target yang disebutkan di privateLinkResourceId hanya diperiksa pada saat awal penyebaran Azure Resource Manager. Jika sumber daya target tidak lagi tersedia, maka penyebaran gagal. Anda harus memastikan bahwa sumber daya target ada di grup langganan dan sumber daya yang ditentukan dan tidak dipindahkan atau dihapus.
Kesalahan sementara/lainnya Penyebaran Azure Resource Manager dapat gagal jika ada pemadaman infrastruktur atau karena alasan tak terduga lainnya. Ini seharusnya jarang terjadi dan biasanya menunjukkan keadaan sementara. Coba lagi membuat sumber daya ini di lain waktu. Jika masalah berlanjut, hubungi Dukungan Azure.

Masalah dalam menyetujui titik akhir privat yang mendukung

Titik akhir privat dibuat ke sumber daya Azure target seperti yang ditentukan dalam permintaan pembuatan tautan privat bersama. Ini adalah salah satu langkah terakhir dalam operasi penyebaran Azure Resource Manager asinkron, tetapi Pencarian Azure AI perlu menautkan alamat IP privat dari titik akhir privat, sebagai bagian dari konfigurasi jaringannya. Setelah tautan ini selesai, provisioningState sumber daya tautan privat bersama masuk ke status Succeededkeberhasilan terminal . Pelanggan hanya boleh menyetujui atau menolak (atau secara umum memodifikasi pengaturan pencadangan titik akhir privat) setelah status bertransisi ke Succeeded. Memodifikasi titik akhir privat dengan cara apa pun sebelum ini dapat mengakibatkan operasi penyebaran yang tidak lengkap dan dapat menyebabkan sumber daya tautan privat bersama berakhir (baik segera, atau biasanya dalam beberapa jam) dalam keadaan Failed .

perubahan konektivitas jaringan layanan pencarian terhenti dalam status "Memperbarui"

Tautan privat yang dibagikan dan titik akhir privat digunakan saat layanan Akses Jaringan Publik Dinonaktifkan. Biasanya, mengubah konektivitas jaringan harus berhasil dalam beberapa menit setelah permintaan diterima. Dalam beberapa keadaan, Pencarian Azure AI mungkin memerlukan waktu beberapa jam untuk menyelesaikan operasi perubahan konektivitas.

Cuplikan layar mengubah akses jaringan publik ke dinonaktifkan.

Jika Anda mengamati bahwa operasi perubahan konektivitas membutuhkan waktu yang signifikan, tunggu beberapa jam. Operasi perubahan konektivitas melibatkan operasi seperti memperbarui rekaman DNS yang mungkin memakan waktu lebih lama dari yang diharapkan.

Jika Akses Jaringan Publik diubah, tautan privat bersama dan titik akhir privat yang ada mungkin tidak berfungsi dengan benar. Jika tautan privat bersama dan titik akhir privat yang ada berhenti berfungsi selama operasi perubahan konektivitas, tunggu beberapa jam hingga operasi selesai. Jika masih tidak berfungsi, coba hapus dan buat ulang.

Biasanya, sumber daya tautan privat bersama harus mencapai status terminal (Succeeded atau Failed) dalam beberapa menit setelah permintaan diterima.

Dalam keadaan yang jarang terjadi, Pencarian Azure AI dapat gagal menandai status sumber daya tautan privat bersama dengan benar ke status terminal (Succeeded atau Failed). Ini biasanya terjadi karena kegagalan yang tidak terduga. Sumber daya yang dibagikan melalui tautan privat akan otomatis berpindah ke status Failed jika berhenti dalam status nonterminal selama lebih dari beberapa jam.

Jika sumber daya tautan privat bersama tidak beralih ke status terminal, tunggu beberapa jam untuk memastikan bahwa sumber daya tersebut menjadi Failed sebelum Anda dapat menghapusnya dan membuatnya kembali. Atau, alih-alih menunggu Anda dapat mencoba membuat sumber daya tautan privat bersama lainnya dengan nama yang berbeda (buat semua parameter lain tetap sama).

Sumber daya tautan privat bersama yang ada dapat diperbarui menggunakan Membuat atau Perbarui API. Pencarian hanya memungkinkan pembaruan sempit ke sumber daya tautan privat bersama - hanya pesan permintaan yang dapat dimodifikasi melalui API ini.

  • Tidak dimungkinkan untuk memperbarui properti "inti" dari sumber daya tautan privat bersama yang ada (seperti privateLinkResourceId atau groupId) dan ini akan selalu tidak didukung. Jika ada properti lain selain pesan permintaan yang perlu diubah, kami menyarankan pelanggan untuk menghapus dan membuat ulang sumber daya tautan privat bersama.

  • Memperbarui pesan permintaan sumber daya tautan privat bersama hanya dimungkinkan jika mencapai status penyediaan Succeeded.

Pelanggan dapat menghapus sumber daya tautan privat bersama yang ada melalui Hapus API. Mirip dengan proses pembuatan (atau pembaruan), ini juga merupakan operasi asinkron dengan empat langkah:

  1. Anda meminta layanan pencarian untuk menghapus sumber daya tautan privat bersama.

  2. Layanan pencarian memvalidasi bahwa sumber daya ada dan berada dalam status valid untuk penghapusan. Jika demikian, ia memulai operasi penghapusan Azure Resource Manager untuk menghapus sumber daya.

  3. Kueri pencarian untuk penyelesaian operasi (yang biasanya memakan waktu beberapa menit). Pada titik ini, sumber daya tautan privat bersama akan memiliki status provisi .Deleting

  4. Setelah proses berhasil diselesaikan, titik akhir privat pendukung dan pemetaan DNS yang terkait akan dihapus. Sumber daya tidak muncul sebagai bagian dari operasi Daftar dan mencoba operasi Dapatkan pada sumber daya ini menghasilkan 404 Tidak Ditemukan.

Langkah-langkah yang terlibat dalam menghapus sumber daya tautan privat bersama

Berikut ini adalah kesalahan umum yang terjadi selama fase penghapusan.

Jenis Kegagalan Deskripsi Resolusi
Sumber daya dalam status nonterminal Sumber daya tautan privat bersama yang tidak dalam status terminal (Succeeded atau Failed) tidak dapat dihapus. Dimungkinkan (jarang) agar sumber daya tautan privat bersama terjebak dalam keadaan nonterminal hingga 8 jam. Tunggu hingga sumber daya mencapai status terminal dan coba lagi permintaan penghapusan.
Operasi hapus gagal dengan kesalahan "Konflik" Operasi Azure Resource Manager untuk menghapus sumber daya tautan privat bersama menjangkau penyedia sumber daya dari sumber daya target yang ditentukan di privateLinkResourceId ("target RP") sebelum dapat menghapus titik akhir privat dan pemetaan DNS. Pelanggan dapat menggunakan kunci sumber daya Azure untuk mencegah perubahan apa pun pada sumber daya mereka. Saat Azure Resource Manager berinteraksi dengan RP target, Azure Resource Manager mengharuskan RP target untuk memodifikasi status sumber daya target (dengan menghapus detail tentang private endpoint dari metadatanya). Ketika sumber daya target memiliki kunci yang dikonfigurasi padanya (atau grup sumber daya /langganannya), operasi Azure Resource Manager gagal dengan "Konflik" (dan detail yang sesuai). Sumber daya tautan privat bersama tidak akan dihapus. Pelanggan harus menghapus kunci pada sumber daya target sebelum mencoba kembali operasi penghapusan. Catatan: Masalah ini juga dapat terjadi ketika pelanggan mencoba menghapus layanan pencarian dengan sumber daya tautan privat bersama yang menunjuk ke sumber daya target "terkunci"
Operasi Penghapusan Gagal Operasi penghapusan Azure Resource Manager asinkron dapat gagal dalam kasus yang jarang terjadi. Ketika operasi ini gagal, mengkueri status operasi asinkron menyajikan pesan kesalahan dan detail yang sesuai. Coba lagi operasi tersebut di lain waktu, atau hubungi Dukungan Azure jika masalah berlanjut.
Sumber daya macet pada status "Menghapus" Dalam kasus yang jarang terjadi, sumber daya tautan pribadi bersama mungkin terjebak pada status "Menghapus" hingga 8 jam, kemungkinan karena beberapa kegagalan besar pada sistem pencarian RP. Tunggu selama 8 jam, setelah itu sumber daya akan beralih ke status Failed dan kemudian menerbitkan kembali permintaan tersebut.

Langkah berikutnya

Pelajari selengkapnya tentang sumber daya tautan privat bersama dan cara menggunakannya untuk akses aman ke konten yang dilindungi.

  • Terakhir diperbarui pada