Codici di errore Microsoft Discovery

Usa queste tabelle per consultare i codici di errore e i messaggi restituiti da Microsoft Discovery durante la distribuzione, le operazioni di workspace e supercomputer, la creazione di raccolte e basi di conoscenza e l'esecuzione di strumenti e agenti. La colonna Dettagli riassume la causa e la risoluzione, e collega a un articolo pratico correlato quando si fa domanda.

Per problemi che potrebbero non restituire un codice di errore univoco, vedi Problemi noti per Microsoft Discovery.

I seguenti controlli generali risolvono la maggior parte degli errori prima di consultare un codice specifico:

• Acquisire l'ID di correlazione dall'operazione fallita e usarlo per leggere i log del piano di controllo e del backend. Molti guasti sono spiegati completamente solo nella cronologia operativa, non nell'errore sommario. Vedi Come ottenere l'ID di correlazione dell'operazione dal Log attività.
• Controllare provisioningState. Succeeded significa che l'operazione è completata, Accepted di solito significa che l'operazione è ancora in corso, e Failed significa che devi ispezionare la cronologia operativa. Alcuni tipi di risorse devono essere eliminati e ricreati dopo essere entrati in uno stato terminale Failed .
• Verificare i ruoli dell'identità di distribuzione. La scoperta richiede autorizzazioni del piano dati, di archiviazione, del perimetro di rete e di Foundry, oltre alle autorizzazioni del piano di controllo. Solo il proprietario della sottoscrizione non basta. Vedi Assegnazioni di ruoli per Microsoft Discovery.
• Conferma la regione e la versione dell'API. Distribuisci solo in una regione supportata e usa la versione API che viene fornita con l'attuale Toolbox o l'infrastruttura quickstart.

Errori di risposta dell'API REST

Le richieste Azure Resource Manager sul piano di controllo e le richieste di lavoro nel piano dati dello spazio di lavoro possono restituire i seguenti errori HTTP. Ispeziona il corpo della risposta e l'ID di correlazione prima di riprovare.

Stato HTTP	API o codice di errore	Resolution
400	Piano di controllo: InvalidRequestContent	Correggi un corpo richiesta malformato o la mancanza delle proprietà richieste. Vedi le proprietà della richiesta del supercomputer.
401	Piano dati: non autorizzato	Aggiorna il token di accesso.
403	Piano dati: accesso negato	Verifica i permessi RBAC del chiamante sullo spazio di lavoro o sul progetto. Vedi Risoluzione dei problemi di accesso al progetto.
404	Piano di controllo: ResourceNotFound	Verifica che l'abbonamento, il gruppo di risorse e l'ID risorsa identifichino una risorsa esistente.
404	Piano dati: non trovato	Controlla il nome del progetto, l'ID operazione e l'URL dello spazio di lavoro.
409	Piano di controllo: Conflict	Ispeziona lo stato della risorsa. Ad esempio, aspetta che il supercomputer finisca di fare provisioning prima di creare un pool di nodi. Per uno stato di errore terminale, usa la guida failed-resource.
429	TooManyRequests	Applica il backoff e riprova. Rispetta l'intestazione Retry-After quando viene restituita.
5xx	Piano dati: errore del server	Riprova in caso di errori temporanei con backoff esponenziale limitato. Per un esempio, vedi la strategia di retry dell'API dei job.

Codici di errore di dispiegamento e del piano di controllo

Code	Messaggio di errore	Dettagli
AuthorizationFailed	The client '<principal>' doesn't have authorization to perform action 'Microsoft.Discovery/...' over scope '...'. If access was recently granted, refresh your credentials.	L'entità autenticata non dispone di un ruolo necessario della piattaforma Discovery, oppure un ruolo concesso di recente non è ancora stato recepito nel token. Assegna Microsoft Discovery Platform Administrator e aggiorna le credenziali di accesso (disconnettiti e accedi di nuovo) in modo che il nuovo ruolo sia incluso nel token. Vedi Assegnazioni di ruoli per Microsoft Discovery.
InvalidResourceType	Microsoft.Discovery is registered, but the provider metadata doesn't expose the 'supercomputers' or 'storageContainers' resource types. Direct ARM requests return InvalidResourceType for API version <version>.	La richiesta utilizza una versione o regione API non supportata, oppure il provider non è completamente registrato. Usa la versione API e Toolbox o quickstart dalla versione attuale, distribuisci in una regione supportata e registra nuovamente il provider. Vedi Registrazione del fornitore risorsa.
DeploymentFailed	The resource operation completed with terminal provisioning state 'Failed'.	Un'operazione di supporto fallì. Leggi la cronologia delle operazioni di distribuzione usando l'ID di correlazione per trovare la prima operazione che fallisce internamente, risolverne la causa principale (spesso un ruolo mancante, una caratteristica di rete o un limite di sottorete), poi riprovare senza eliminare risorse parzialmente create quando possibile. Vedi Come ottenere l'ID di correlazione dell'operazione dal Log attività.
ResourceDeploymentFailure	The resource provision operation didn't complete successfully.	Una risorsa dipendente non è riuscita a fornirla. Identifica l'operazione figlia non riuscita nella cronologia delle operazioni e correggi la causa all'origine del problema. Se la risorsa rimane in uno stato terminale Failed e non può essere riprovata, elimina e ricrea solo la risorsa fallita.
InternalServerError	The server encountered an internal error. Please retry the request.	Un errore temporaneo di backend durante la creazione o l'aggiornamento. Ripetere l'operazione. Se persiste, cattura l'ID di correlazione e crea una richiesta di supporto tecnico di Azure.
Conflict	The resource is in a 'Failed' state and can't be updated.	Una risorsa in stato terminale Failed non può essere aggiornata in loco. Elimina solo la risorsa fallita e ricreala con un nuovo nome e i prerequisiti corretti. Vedi Gestire gli spazi di lavoro di Microsoft Discovery ed Eliminare le risorse di Microsoft Discovery.
RequestDisallowedByPolicy	Create or update public IP failed. Resource was disallowed by policy.	Un'assegnazione Criteri di Azure nega un IP pubblico richiesto dalla configurazione selezionata della rete supercomputer. Usa una configurazione supportata UserDefinedRouting che non prevede un IP pubblico gestito, oppure chiedi al tuo amministratore della policy se è consentita un'esenzione. Vedi Problemi noti per Microsoft Discovery.

Codici di errore dello spazio di lavoro

Code	Messaggio di errore	Dettagli
InvalidRequest	Resources not allowed: storage '<name>' isn't allowlisted in workspace '<workspace>'.	L'account di archiviazione esiste ma non è associato allo spazio di lavoro, quindi le run di strumenti che lo fanno riferimento vengono rifiutate. Associa l'account di archiviazione allo spazio di lavoro, poi riesegui l'operazione. Vedi Gestisci gli spazi di lavoro di Microsoft Discovery.
InvalidRequest	Resources not allowed: supercomputer '<name>' isn't allowlisted in workspace '<workspace>'.	Il supercomputer esiste ma non è associato allo spazio di lavoro. Associa il supercomputer allo spazio di lavoro, poi riesegui lo strumento. Vedi Gestire i supercomputer.
Conflict	Workspace is in a terminal 'Failed' state; the operation conflicts with the current state.	Elimina solo lo spazio di lavoro bloccato (lascia il gruppo risorse, lo storage e il supercomputer al loro posto) e ricrealo con un nome diverso. Per liberare un supercomputer legato a uno spazio di lavoro bloccato, rimuovere l'associazione del supercomputer dall'interno dello spazio invece di eliminarlo. Vedi Gestisci gli spazi di lavoro di Microsoft Discovery.
QuotaExceeded	Workspace creation failed because the container environment quota is insufficient.	L'ambiente App contenitore di Azure dello spazio di lavoro richiede una quota sufficiente per la creazione. Per l'SKU Enterprise, assicurati che siano disponibili almeno 80 core di quota di App contenitore di Azure nella regione di destinazione, quindi riprova. Vedi Quota e prenotazioni.

Codici di errore del supercomputer

Code	Messaggio di errore	Dettagli
BadRequest	UPGRADE FAILED: pre-upgrade hooks failed: Hook pre-upgrade network-operator/templates/keep-ncp-hook.yaml failed: failed calling webhook "mjob.kb.io": ... code 504: 504 Gateway Timeout	Un errore transitorio durante l'installazione interna del supercomputer tramite Helm: il kueue-webhook-service nello spazio dei nomi kueue-system restituisce un errore 504 all'hook pre-aggiornamento dell'operatore di rete. Riprova la creazione del supercomputer e assicurati di essere sull'ultima versione della piattaforma. Ispeziona il pod del webhook se il problema persiste. Consulta i registri del supercomputer.
NodeNotReady	Tool run failed: node became not ready.	Un problema di salute del driver dei nodi o della GPU nel pool di nodi. Assicurati di usare l'immagine del nodo più recente, ricrea il pool di nodi interessato se continua a non essere integro e riprova l'esecuzione. Imposta esplicitamente il pool di nodi corretti nella preferenza del progetto invece di affidarsi alla selezione automatica. Consulta i registri del supercomputer.
JobTerminated	Supercomputer job terminated before completion.	I lavori di lunga durata possono essere sfrattati quando AKS esegue aggiornamenti del sistema operativo dei nodi. Assicurati di utilizzare una release con miglioramenti della resilienza di job e nodi, imposta correttamente nodePoolId nelle preferenze del progetto e controlla l'esecuzione nei log del supercomputer. Vedi esecuzione del compito Debug.

Codici di errore di Bookshelf e della base di conoscenza

Code	Messaggio di errore	Dettagli
ERR_INCOMPLETE_CHUNKED_ENCODING	PATCH .../knowledgeBases/<name>/versions/<version> — 400 (Bad Request). "Failed to create knowledge base."	Il data plane rifiuta una stringa di versione non valida o un nome dello scaffale non valido. Usa un semplice numero di versione intero (ad esempio, 1) invece di una stringa più lunga come 1.0, e assicurati che il nome della libreria usi solo lettere minuscole e trattini. Vedere Indicizzare una knowledge base della libreria.
ResourceCreationValidateFailed	Bookshelf creation validation failed (gateway timeout).	Un timeout temporaneo del back-end durante la creazione della libreria. Riprova e assicurati di utilizzare una release della piattaforma che includa correzioni per la create-resiliency. Verificare che nella regione sia disponibile una quota sufficiente per i modelli di embedding e di recupero dati prima di riprovare. Vedi Consulta i registri della libreria.
IndexingFailed	Knowledge base indexing failed.	L'indicizzazione può non riuscire con documenti singoli di grandi dimensioni oppure a causa di un timeout transitorio di accesso al database (SQL). Controlla i log di indicizzazione del documento interessato, dividi i PDF molto grandi e assicurati di utilizzare una versione con miglioramenti nell'acquisizione. Se un documento di grandi dimensioni non si rispecchia nelle risposte anche se l'indicizzazione ha segnalato un esito positivo, sospetta una troncatura silenziosa e controlla i log di indicizzazione. Vedere Query sui log di indicizzazione della libreria.

Codici di errore per strumenti e agenti

Code	Messaggio di errore	Dettagli
HTTP 500 (Fonderia)	Project deployment failure: 500 error creating agent in Foundry.	La creazione di agenti nella risorsa di supporto Foundry fallisce. Verificare che il ruolo Utente Foundry sia assegnato all'identità gestita dal progetto e convalidare la connettività e il DNS del database privato Cosmos DB Bring Your Own. L'eliminazione del progetto potrebbe essere bloccata per i progetti già nello stato Failed. Usa azioni di pulizia della piattaforma e poi ridistribui. Vedi la creazione dell'agente.
InvalidMessageId	Tool execution failed due to an invalid message id.	Un identificatore di messaggio non valido o non corrispondente che l'agente passa allo strumento impedisce allo strumento di avviarsi. Assicurati di utilizzare una versione che includa la correzione dell'ID del messaggio e il logging diagnostico. Applica eventuali miglioramenti consigliati a livello di prompt e raccogli le definizioni di agente, workflow e strumento per riprodurre il problema. Vedi esecuzione del compito Debug.