Problemen met gedeelde privékoppelingen in Azure AI Zoeken oplossen

Note

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

Met een gedeelde privéverbinding kan Azure AI Zoeken beveiligde uitgaande verbindingen maken via een privé-eindpunt bij het verkrijgen van toegang tot klantresources in een virtueel netwerk. Dit artikel kan u helpen bij het oplossen van fouten die kunnen optreden.

Het maken van een gedeelde privékoppeling is een controlevlakoperatie voor de zoekservice. U kunt een gedeelde privékoppeling maken met behulp van Azure Portal of een REST API voor Beheer. Tijdens het inrichten is de status van de aanvraag Updating. Nadat de bewerking succesvol is voltooid, is de status Succeeded. Er wordt een privé-eindpunt voor de resource gemaakt, samen met eventuele DNS-zones en -toewijzingen. Dit eindpunt wordt uitsluitend gebruikt door uw exemplaar van de zoekservice en wordt beheerd via Azure AI Zoeken.

Stappen voor het maken van gedeelde private link-resources

Hier volgen veelvoorkomende fouten die optreden tijdens de aanmaakfase.

Fouten bij aanvraagvalidatie

  • Niet-ondersteunde SKU: gedeelde privékoppelingen worden ondersteund op de Basic-laag en hoger. Voor indexeerders met vaardighedenspecialisaties is de minimumlaag Standard 1 (S1). Zie Resourcelimieten voor gedeelde privékoppelingen voor meer informatie.

  • Ongeldige naam: naamgevingsregels voor een gedeelde privékoppeling zijn:

    • De lengte moet tussen 1 en 60 tekens lang zijn
    • Alfanumerieke tekens
    • Namen kunnen onderstrepingstekens, punten _en afbreekstreepjes .- bevatten, zolang dit niet het eerste teken in de naam is

  • Ongeldige groeps-id: groeps-id's zijn hoofdlettergevoelig en moeten een van de volgende waarden zijn.

    Azureresource Groeps-id Eerste beschikbare API-versie
    Azure Storage - Blob (of) ADLS Gen 2 blob 2020-08-01
    Azure Storage - Tabellen table 2020-08-01
    Azure Cosmos DB voor NoSQL Sql 2020-08-01
    Azure SQL-database sqlServer 2020-08-01
    Azure Database for MySQL (preview) mysqlServer 2020-08-01-Preview
    Azure Key Vault vault 2020-08-01
    Azure Functions (voorbeeldversie) sites 2020-08-01-Preview

    Resources die zijn gemarkeerd met (preview), moeten worden gemaakt met behulp van een preview-versie van de REST API-versies van Management.

  • privateLinkResourceId typevalidatie: Net als groupId valideert Azure AI Zoeken dat het 'correcte' resourcetype is opgegeven in de privateLinkResourceId. De volgende zijn geldige resourcetypen:

    Azureresource Brontype Eerste beschikbare API-versie
    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 (preview-versie) Microsoft.DBforMySQL/servers 2020-08-01-Preview
    Azure Functions (voorbeeldversie) Microsoft.Web/sites 2020-08-01-Preview
    Azure SQL Managed Instance (voorbeeld) Microsoft.Sql/managedInstance 2020-08-01-Preview

    Bovendien moet de opgegeven groupId waarde geldig zijn voor het opgegeven resourcetype. Bijvoorbeeld, 'blob' is groupId geldig voor het type Microsoft.Storage/storageAccounts, maar kan niet worden gebruikt met een ander resourcetype. Voor een bepaalde API-versie voor zoekbeheer kunnen klanten de ondersteunde groupId en resourcetypegegevens achterhalen door gebruik te maken van de lijst ondersteunde API.

  • Afdwinging van quotum limiet: Search-services hebben quota opgelegd voor het aantal afzonderlijke gedeelde private link-resources dat kan worden gemaakt en het aantal verschillende doelresourcetypen dat wordt gebruikt, op basis van groupId. Zie Resourcelimieten voor gedeelde privékoppelingen voor meer informatie.

Implementatiefouten

Een zoekservice initieert de aanvraag voor het maken van een gedeelde privékoppeling, maar Azure Resource Manager voert het werkelijke werk uit. U kunt de status van de implementatie controleren in Azure Portal of op query' en eventuele fouten oplossen.

Gedeelde private link-resources die mislukken bij de implementatie van Azure Resource Manager worden weergegeven in List- en Get-API-aanroepen, maar ze hebben een inrichtingsstatus van.Failed Nadat de reden van de azure Resource Manager-implementatiefout is vastgesteld, verwijdert u de Failed resource en maakt u deze opnieuw nadat u de juiste oplossing uit de volgende tabel hebt toegepast.

Reden van uitrolfout Beschrijving Oplossing
GefaaldGekoppeldeAutorisatie Het foutbericht geeft aan dat de client gemachtigd is om de gedeelde privékoppeling te maken in de zoekservice, maar niet gemachtigd is om de actie PrivateEndpointConnectionApproval/action uit te voeren voor het gekoppelde bereik. Controleer de private link-id in de aanvraag opnieuw om ervoor te zorgen dat er geen fouten of weglatingen in de URI zijn. Als Azure AI Zoeken en de Azure PaaS-resource zich in verschillende abonnementen bevinden en als u REST of een opdrachtregelinterface gebruikt, controleert u of het actieve Azure-account de Azure PaaS-resource is. Voor REST-clients moet u ervoor zorgen dat u geen verlopen Bearer-token gebruikt en of het token geldig is voor het actieve abonnement.
Netwerkresourceprovider is niet geregistreerd bij het abonnement van de doelresource Er wordt een privé-eindpunt (en gekoppelde DNS-toewijzingen) gemaakt voor de doelresource (opslagaccount, Azure Cosmos DB, Azure SQL) via de Microsoft.Network resourceprovider (RP). Als het abonnement dat als host fungeert voor de doelresource ('doelabonnement') niet is geregistreerd bij Microsoft.Network RP, kan de Azure Resource Manager-implementatie mislukken. U moet deze RP registreren in hun doelabonnement. U kunt de resourceprovider registreren met behulp van Azure Portal, PowerShell of CLI.
Ongeldig groupId voor de doelresource Wanneer Azure Cosmos DB-accounts worden gemaakt, kunt u het API-type voor het databaseaccount opgeven. Hoewel Azure Cosmos DB verschillende API-typen biedt, ondersteunt Azure AI Zoeken alleen "Sql" als groupId voor gedeelde private link-resources. Wanneer een gedeelde privékoppeling van het type "Sql" wordt gemaakt voor een privateLinkResourceId, die wijst naar een niet-Sql-databaseaccount, mislukt de Azure Resource Manager-implementatie vanwege de groupId onverenigbaarheid. De Azure-resource-id van een Azure Cosmos DB-account is niet voldoende om het API-type te bepalen dat wordt gebruikt. Azure AI Zoeken probeert het privé-eindpunt te maken, dat vervolgens door Azure Cosmos DB wordt geweigerd. Zorg ervoor dat de privateLinkResourceId van de opgegeven Azure Cosmos DB-resource voor een databaseaccount van het type "Sql" API is.
Doelresource niet gevonden Het bestaan van de opgegeven privateLinkResourceId doelresource wordt alleen gecontroleerd tijdens het begin van de Azure Resource Manager-implementatie. Als de doelresource niet meer beschikbaar is, mislukt de implementatie. Zorg ervoor dat de doelresource aanwezig is in het opgegeven abonnement en de resourcegroep en niet wordt verplaatst of verwijderd.
Tijdelijke/andere fouten De Azure Resource Manager-implementatie kan mislukken als er sprake is van een storing in de infrastructuur of vanwege andere onverwachte redenen. Dit moet zeldzaam zijn en geeft meestal een tijdelijke status aan. Probeer deze resource op een later tijdstip opnieuw te maken. Als het probleem zich blijft voordoen, neemt u contact op met azure-ondersteuning.

Problemen met het goedkeuren van het steunend privé-eindpunt

Er wordt een privé-eindpunt gemaakt voor de Azure-doelresource, zoals is opgegeven in de aanvraag voor het maken van gedeelde privékoppelingen. Dit is een van de laatste stappen in de asynchrone Implementatiebewerking van Azure Resource Manager, maar Azure AI Zoeken moet het privé-IP-adres van het privé-eindpunt koppelen als onderdeel van de netwerkconfiguratie. Zodra deze koppeling is voltooid, gaat de provisioningState gedeelde private-koppelingsresource naar een terminale successtatus Succeeded. Klanten mogen alleen de configuratie van het back-up-privé-eindpunt goedkeuren of weigeren(of in het algemeen wijzigen) nadat de status is overgezet naar Succeeded. Als u het privé-eindpunt op een willekeurige manier wijzigt voordat dit tot een onvolledige implementatiebewerking kan leiden, kan dit ertoe leiden dat de gedeelde private link-resource (onmiddellijk of meestal binnen een paar uur) in een Failed status terechtkomt.

Zoekservice-netwerkconnectiviteitswijziging vastgelopen in de status "Bijwerken"

Gedeelde privékoppelingen en privé-eindpunten worden gebruikt wanneer openbare netwerktoegang voor de zoekservice is uitgeschakeld. Normaal gesproken moet het wijzigen van de netwerkverbinding binnen enkele minuten slagen nadat de aanvraag is geaccepteerd. In sommige gevallen kan het enkele uren duren voordat azure AI Search de verbindingswijzigingsbewerking heeft voltooid.

Schermopname van het wijzigen van openbare netwerktoegang tot uitgeschakeld.

Als u merkt dat de verbindingswijzigingsbewerking een aanzienlijke hoeveelheid tijd in beslag neemt, wacht u enkele uren. Verbindingswijzigingsbewerkingen omvatten bewerkingen zoals het bijwerken van DNS-records die langer duren dan verwacht.

Als openbare netwerktoegang wordt gewijzigd, werken bestaande gedeelde privékoppelingen en privé-eindpunten mogelijk niet correct. Als bestaande gedeelde privékoppelingen en privé-eindpunten niet meer werken tijdens een verbindingswijzigingsbewerking, wacht u enkele uren totdat de bewerking is voltooid. Als ze nog steeds niet werken, kunt u deze verwijderen en opnieuw maken.

Normaal gesproken moet een gedeelde private link-resource binnen een paar minuten nadat de aanvraag is geaccepteerd, een terminalstatus (Succeeded of Failed) instellen.

In zeldzame gevallen kan Azure AI Zoeken de status van de gedeelde private link-resource niet correct markeren in een terminalstatus (Succeeded of Failed). Dit treedt meestal op vanwege een onverwachte fout. Gedeelde privékoppelingsresources worden automatisch overgezet naar een Failed status als ze langer dan enkele uren vastzitten in een niet-eindtoestand.

Als de gedeelde private link-resource niet overgaat naar een terminalstatus, wacht u enkele uren om ervoor te zorgen dat deze wordt Failed voordat u deze kunt verwijderen en opnieuw kunt maken. U kunt ook proberen een andere gedeelde private link-resource te maken met een andere naam (waarbij alle andere parameters hetzelfde blijven).

Een bestaande gedeelde private link-resource kan worden bijgewerkt met behulp van de Create or Update API. Met Zoeken kunnen alleen beperkte updates worden uitgevoerd voor de gedeelde private link-resource. Alleen het aanvraagbericht kan worden gewijzigd via deze API.

  • Het is niet mogelijk om een van de kerneigenschappen van een bestaande gedeelde private link-resource (zoals privateLinkResourceId of groupId) bij te werken en dit wordt altijd niet ondersteund. Als een andere eigenschap naast het aanvraagbericht moet worden gewijzigd, adviseren we klanten om de gedeelde private link-resource te verwijderen en opnieuw te maken.

  • Het bijwerken van het aanvraagbericht van een gedeelde Private Link-resource is alleen mogelijk als deze de provisioning status van Succeeded bereikt.

Klanten kunnen een bestaande gedeelde private link-resource verwijderen via de Delete-API. Net als bij het proces van maken (of bijwerken) is dit ook een asynchrone bewerking met vier stappen:

  1. U vraagt een zoekservice om de gedeelde private link-resource te verwijderen.

  2. De zoekservice valideert dat de resource bestaat en heeft een status die geldig is voor verwijdering. Zo ja, dan wordt een Azure Resource Manager-verwijderbewerking gestart om de resource te verwijderen.

  3. Zoekquery's voor de voltooiing van de bewerking (meestal een paar minuten). Op dit moment heeft de gedeelde privélink-resource een toewijzingsstatus van Deleting.

  4. Zodra de bewerking met succes is voltooid, worden het privé-eindpunt en de bijbehorende DNS-toewijzingen verwijderd. De resource wordt niet weergegeven als onderdeel van de Lijst-bewerking en een Get-bewerking voor deze resource resulteert in een 404-fout Niet gevonden.

Stappen voor het verwijderen van gedeelde private link-resources

Hier volgen veelvoorkomende fouten die optreden tijdens de verwijderingsfase.

Fouttype Beschrijving Oplossing
Resource heeft een niet-terminale status Een gedeelde private link-resource die zich niet in een terminalstatus (Succeeded of Failed) bevindt, kan niet worden verwijderd. Het is mogelijk (zelden) dat een gedeelde private link-resource gedurende maximaal 8 uur vastloopt in een niet-terminale status. Wacht totdat de resource de terminalstatus heeft bereikt en voer de verwijderaanvraag opnieuw uit.
Het verwijderen is mislukt met fout "Conflict" De Azure Resource Manager-bewerking voor het verwijderen van een gedeelde private link-resource bereikt de resourceprovider van de doelresource die is opgegeven in privateLinkResourceId ('doel-RP') voordat het privé-eindpunt en de DNS-toewijzingen kunnen worden verwijderd. Klanten kunnen azure-resourcevergrendelingen gebruiken om wijzigingen in hun resources te voorkomen. Wanneer Azure Resource Manager de doel-RP bereikt, moet de doel-RP de status van de doelresource wijzigen (om details over het privé-eindpunt uit de metagegevens te verwijderen). Wanneer de doelresource een vergrendeling heeft geconfigureerd (of de resourcegroep/het bijbehorende abonnement), mislukt de Azure Resource Manager-bewerking met een conflict (en de juiste details). De gedeelde private link-resource wordt niet verwijderd. Klanten moeten de vergrendeling van de doelresource verwijderen voordat ze de verwijderingsbewerking opnieuw proberen uit te voeren. Opmerking: dit probleem kan ook optreden wanneer klanten proberen een zoekservice te verwijderen met gedeelde private link-resources die verwijzen naar vergrendelde doelbronnen
Verwijderen is mislukt De asynchrone Azure Resource Manager-verwijderbewerking kan in zeldzame gevallen mislukken. Wanneer deze bewerking mislukt, wordt bij het uitvoeren van een query op de status van de asynchrone bewerking een foutbericht en de juiste details weergegeven. Voer de bewerking op een later tijdstip opnieuw uit of neem contact op met azure-ondersteuning als het probleem zich blijft voordoen.
Resource zit vast in de status 'Verwijderen' In zeldzame gevallen kan een gedeelde private link-resource gedurende maximaal 8 uur vastzitten in de status 'Verwijderen', waarschijnlijk vanwege een onherstelbare fout in de zoek-RP. Wacht 8 uur, waarna de resource overgaat naar de status Failed en de aanvraag vervolgens opnieuw verzendt.

Volgende stappen

Meer informatie over gedeelde private link-resources en hoe u deze kunt gebruiken voor beveiligde toegang tot beveiligde inhoud.

  • Laatst bijgewerkt om