Ripristino di emergenza

  • Articolo

Questo contenuto si applica a: segno di spunta v4.0 (anteprima) | Versioni precedenti: blue-checkmark v3.1 (disponibilità generale) blue-checkmark v3.0 (disponibilità generale) blue-checkmark v2.1 (disponibilità generale)

Questo contenuto si applica a: segno di spunta v3.1 (disponibilità generale) | Versione più recente: purple-checkmark v4.0 (anteprima) | Versioni precedenti: blue-checkmark v3.0 blue-checkmark v2.1

Questo contenuto si applica a: segno di spunta v3.0 (disponibilità generale) | Versioni più recenti: purple-checkmark v4.0 (anteprima) purple-checkmark v3.1 | Versione precedente: blue-checkmark v2.1

Questo contenuto si applica a: segno di spunta v2.1 | Versione più recente: blue-checkmark v4.0 (anteprima)

Quando si crea una risorsa di Informazioni sui documenti nel portale di Azure, è necessario specificare un'area. Da quel momento, la risorsa e tutte le relative operazioni rimangono associate a tale area di Azure specifica. È raro, ma non impossibile, riscontrare un problema di rete che interessa un'intera area. Se una soluzione deve essere sempre disponibile, è necessario progettarla in modo che ne venga eseguito il failover in un'altra area o che il carico di lavoro venga suddiviso tra due o più aree. Entrambi gli approcci richiedono almeno due risorse di Informazioni sui documenti in aree diverse e la possibilità di sincronizzare i modelli personalizzati tra aree.

L'API Copia abilita questo scenario consentendo di copiare modelli personalizzati e classificatori da un account Informazioni sui documenti o in altri account, che possono risiedere in qualsiasi area geografica supportata. Questa guida illustra come usare l'API REST di Copia con cURL per i modelli personalizzati. È anche possibile usare un servizio di richiesta HTTP per inviare le richieste.

Nota

A partire dall'API 2024-07-31-preview, i modelli di classificazione personalizzati supportano anche l'API di Copia. Questa guida usa in modo specifico modelli personalizzati per copiare i modelli. Per la copia del modello di classificatore, seguire questa guida.

Scenari aziendali

Se l'app o l'azienda dipende dall'uso di un modello personalizzato di Informazioni sui documenti, è consigliabile copiare il modello in un altro account Informazioni sui documenti in un'area diversa. Se si verifica un'interruzione del servizio nell'area, è quindi possibile accedere al modello nell'area in cui è stato copiato.

Prerequisiti

  1. Due risorse di Informazioni sui documenti di Azure in aree di Azure diverse. Se non sono disponibili, andare al portale di Azure e creare una nuova risorsa di Informazioni sui documenti.
  2. La chiave, l'URL dell'endpoint e l'ID sottoscrizione per la risorsa di Informazioni sui documenti. È possibile trovare questi valori nella scheda Panoramica della risorsa nel portale di Azure.

Panoramica dell'API Copia

Il processo per copiare un modello personalizzato prevede i passaggi seguenti:

  1. Prima di tutto si invia una richiesta di autorizzazione di copia alla risorsa di destinazione, ovvero la risorsa che riceve il modello copiato. Si riceve l'URL del modello di destinazione appena creato, che riceve il modello copiato.
  2. Successivamente si invia la richiesta di copia alla risorsa di origine, ovvero la risorsa che contiene il modello da copiare con il payload (autorizzazione di copia) restituito dalla chiamata precedente. Si riceve un URL su cui è possibile eseguire una query per monitorare lo stato dell'operazione.
  3. È necessario usare le credenziali della risorsa di origine per eseguire una query sullo stato di avanzamento fino al completamento dell'operazione. È anche possibile eseguire una query sull'ID del nuovo modello nella risorsa di destinazione per ottenere lo stato del nuovo modello.

Generare una richiesta di autorizzazione per la copia

La richiesta HTTP seguente ottiene l'autorizzazione per la copia dalla risorsa di destinazione. È necessario immettere l'endpoint e la chiave della risorsa di destinazione come intestazioni.

POST https://<your-resource-endpoint>/documentintelligence/documentModels:authorizeCopy?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}

Testo della richiesta

{
  "modelId": "target-model-name",
  "description": "Copied from SCUS"
}

Si riceve un codice di risposta 200 con il corpo della risposta contenente il payload JSON necessario per avviare la copia.

{
  "targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
  "targetResourceRegion": "region",
  "targetModelId": "target-model-name",
  "targetModelLocation": "model path",
  "accessToken": "access token",
  "expirationDateTime": "timestamp"
}

Avviare l'operazione di copia

La richiesta HTTP seguente avvia l'operazione di copia nella risorsa di origine. È necessario immettere l'endpoint e la chiave della risorsa di origine come URL e intestazione. Si noti che l'URL della richiesta contiene l'ID modello del modello di origine da copiare.

POST https://<your-resource-endpoint>/documentintelligence/documentModels/{modelId}:copyTo?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}

Il corpo della richiesta è costituito dalla risposta del passaggio precedente.

{
  "targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
  "targetResourceRegion": "region",
  "targetModelId": "target-model-name",
  "targetModelLocation": "model path",
  "accessToken": "access token",
  "expirationDateTime": "timestamp"
}

Si riceve una risposta 202\Accepted che include l'intestazione Operation-Location. Questo valore è l'URL che viene usato per monitorare lo stato di avanzamento dell'operazione. Copiarlo in una posizione temporanea per il passaggio successivo.

HTTP/1.1 202 Accepted
Operation-Location: https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{operation-id}?api-version=2024-02-29-preview

Nota

L'API Copia supporta in modo trasparente la funzionalità Chiave di crittografia dell'account/Chiave gestita dal cliente. Questa funzionalità non richiede alcun trattamento speciale, ma si noti che se si esegue la copia tra una risorsa non crittografata in una risorsa crittografata, è necessario includere l'intestazione della richiesta x-ms-forms-copy-degrade: true. Se questa intestazione non è inclusa, l'operazione di copia avrà esito negativo e restituirà un errore DataProtectionTransformServiceError.

Monitorare lo stato della copia

GET https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{<operation-id>}?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}

Monitorare l'ID modello di destinazione

È anche possibile usare l'API Get model per monitorare lo stato dell'operazione eseguendo una query sul modello di destinazione. Chiamare l'API usando l'ID modello di destinazione copiato dalla risposta della richiesta Generate copy authorization.

GET https://<your-resource-endpoint>/documentintelligence/documentModels/{modelId}?api-version=2024-02-29-preview" -H "Ocp-Apim-Subscription-Key: <your-key>

Nel corpo della risposta vengono visualizzate le informazioni sul modello. Controllare il campo "status" per lo stato del modello.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"modelInfo":{"modelId":"33f4d42c-cd2f-4e74-b990-a1aeafab5a5d","status":"ready","createdDateTime":"2020-02-26T16:59:28Z","lastUpdatedDateTime":"2020-02-26T16:59:34Z"},"trainResult":{"trainingDocuments":[{"documentName":"0.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"1.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"2.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"3.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"4.pdf","pages":1,"errors":[],"status":"succeeded"}],"errors":[]}}

Codice di esempio cURL

I frammenti di codice seguenti usano cURL per effettuare le chiamate API. È anche necessario compilare gli ID modello e le informazioni sulla sottoscrizione specifiche delle risorse in uso.

Generare l'autorizzazione per la copia

Richiedi

curl -i -X POST "<your-resource-endpoint>/documentintelligence/documentModels:authorizeCopy?api-version=2024-02-29-preview"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: <YOUR-KEY>"
--data-ascii "{
  'modelId': '{modelId}',
  'description': '{description}'
}"

Risposta con esito positivo

{
  "targetResourceId": "string",
  "targetResourceRegion": "string",
  "targetModelId": "string",
  "targetModelLocation": "string",
  "accessToken": "string",
  "expirationDateTime": "string"
}

Avviare l'operazione di copia

Richiedi

curl -i -X POST "<your-resource-endpoint>/documentintelligence/documentModels/{modelId}:copyTo?api-version=2024-02-29-preview"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: <YOUR-KEY>"
--data-ascii "{
  'targetResourceId': '{targetResourceId}',
  'targetResourceRegion': {targetResourceRegion}',
  'targetModelId': '{targetModelId}',
  'targetModelLocation': '{targetModelLocation}',
  'accessToken': '{accessToken}',
  'expirationDateTime': '{expirationDateTime}'
}"

Risposta con esito positivo

HTTP/1.1 202 Accepted
Operation-Location: https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{operation-id}?api-version=2024-02-29-preview

Monitorare lo stato dell'operazione di copia

È possibile usare l'API GET operation per elencare tutte le operazioni del modello di documento (riuscite, in corso o non riuscite) associate alla risorsa Informazioni sui documenti. Le informazioni sulle operazioni vengono conservate solo per 24 ore. Ecco un elenco delle operazioni (operationId) che possono essere restituite:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Monitorare l'ID modello di destinazione

Se l'operazione ha esito positivo, è possibile accedere al modello di documento usando le API getModel (recupera un singolo modello) o GetModels (recupera un elenco di modelli).

Panoramica dell'API Copia

Il processo per copiare un modello personalizzato prevede i passaggi seguenti:

  1. Prima di tutto si invia una richiesta di autorizzazione di copia alla risorsa di destinazione, ovvero la risorsa che riceve il modello copiato. Si riceve l'URL del modello di destinazione appena creato, che riceve il modello copiato.
  2. Successivamente si invia la richiesta di copia alla risorsa di origine, ovvero la risorsa che contiene il modello da copiare con il payload (autorizzazione di copia) restituito dalla chiamata precedente. Si riceve un URL su cui è possibile eseguire una query per monitorare lo stato dell'operazione.
  3. È necessario usare le credenziali della risorsa di origine per eseguire una query sullo stato di avanzamento fino al completamento dell'operazione. È anche possibile eseguire una query sull'ID del nuovo modello nella risorsa di destinazione per ottenere lo stato del nuovo modello.

Generare una richiesta di autorizzazione per la copia

La richiesta HTTP seguente ottiene l'autorizzazione per la copia dalla risorsa di destinazione. È necessario immettere l'endpoint e la chiave della risorsa di destinazione come intestazioni.

POST https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/documentModels:authorizeCopy?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}

Testo della richiesta

{
  "modelId": "target-model-name",
  "description": "Copied from SCUS"
}

Si riceve un codice di risposta 200 con il corpo della risposta contenente il payload JSON necessario per avviare la copia.

{
  "targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
  "targetResourceRegion": "region",
  "targetModelId": "target-model-name",
  "targetModelLocation": "model path",
  "accessToken": "access token",
  "expirationDateTime": "timestamp"
}

Avviare l'operazione di copia

La richiesta HTTP seguente avvia l'operazione di copia nella risorsa di origine. È necessario immettere l'endpoint e la chiave della risorsa di origine come URL e intestazione. Si noti che l'URL della richiesta contiene l'ID modello del modello di origine da copiare.

POST {{source-endpoint}}formrecognizer/documentModels/{model-to-be-copied}:copyTo?api-version=2023-07-31
Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}

Il corpo della richiesta è costituito dalla risposta del passaggio precedente.

{
  "targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
  "targetResourceRegion": "region",
  "targetModelId": "target-model-name",
  "targetModelLocation": "model path",
  "accessToken": "access token",
  "expirationDateTime": "timestamp"
}

Si riceve una risposta 202\Accepted che include l'intestazione Operation-Location. Questo valore è l'URL che viene usato per monitorare lo stato di avanzamento dell'operazione. Copiarlo in una posizione temporanea per il passaggio successivo.

HTTP/1.1 202 Accepted
Operation-Location: https://{source-resource}.cognitiveservices.azure.com/formrecognizer/operations/{operation-id}?api-version=2023-07-31

Nota

L'API Copia supporta in modo trasparente la funzionalità Chiave di crittografia dell'account/Chiave gestita dal cliente. Questa funzionalità non richiede alcun trattamento speciale, ma si noti che se si esegue la copia tra una risorsa non crittografata in una risorsa crittografata, è necessario includere l'intestazione della richiesta x-ms-forms-copy-degrade: true. Se questa intestazione non è inclusa, l'operazione di copia avrà esito negativo e restituirà un errore DataProtectionTransformServiceError.

Monitorare lo stato della copia

GET https://{source-resource}.cognitiveservices.azure.com/formrecognizer/operations/{operation-id}?api-version=2023-07-31
Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}

Monitorare l'ID modello di destinazione

È anche possibile usare l'API GET model per monitorare lo stato dell'operazione eseguendo una query sul modello di destinazione. Chiamare l'API usando l'ID modello di destinazione copiato dalla risposta della richiesta Generate Copy authorization.

GET https://{YOUR-ENDPOINT}/formrecognizer/documentModels/{modelId}?api-version=2023-07-31" -H "Ocp-Apim-Subscription-Key: <YOUR-KEY>

Nel corpo della risposta vengono visualizzate le informazioni sul modello. Controllare il campo "status" per lo stato del modello.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"modelInfo":{"modelId":"33f4d42c-cd2f-4e74-b990-a1aeafab5a5d","status":"ready","createdDateTime":"2020-02-26T16:59:28Z","lastUpdatedDateTime":"2020-02-26T16:59:34Z"},"trainResult":{"trainingDocuments":[{"documentName":"0.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"1.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"2.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"3.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"4.pdf","pages":1,"errors":[],"status":"succeeded"}],"errors":[]}}

Codice di esempio cURL

I frammenti di codice seguenti usano cURL per effettuare le chiamate API. È anche necessario compilare gli ID modello e le informazioni sulla sottoscrizione specifiche delle risorse in uso.

Generare l'autorizzazione per la copia

Richiedi

curl -i -X POST "{YOUR-ENDPOINT}formrecognizer/documentModels:authorizeCopy?api-version=2023-07-31"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: <YOUR-KEY>"
--data-ascii "{
  'modelId': '{modelId}',
  'description': '{description}'
}"

Risposta con esito positivo

{
  "targetResourceId": "string",
  "targetResourceRegion": "string",
  "targetModelId": "string",
  "targetModelLocation": "string",
  "accessToken": "string",
  "expirationDateTime": "string"
}

Avviare l'operazione di copia

Richiedi

curl -i -X POST "{YOUR-ENDPOINT}/formrecognizer/documentModels/{modelId}:copyTo?api-version=2023-07-31"
-H "Content-Type: application/json"
-H "Ocp-Apim-Subscription-Key: <YOUR-KEY>"
--data-ascii "{
  'targetResourceId': '{targetResourceId}',
  'targetResourceRegion': {targetResourceRegion}',
  'targetModelId': '{targetModelId}',
  'targetModelLocation': '{targetModelLocation}',
  'accessToken': '{accessToken}',
  'expirationDateTime': '{expirationDateTime}'
}"

Risposta con esito positivo

HTTP/1.1 202 Accepted
Operation-Location: https://{source-resource}.cognitiveservices.azure.com/formrecognizer/operations/{operation-id}?api-version=2023-07-31

Monitorare lo stato dell'operazione di copia

È possibile usare l'API GET operation per elencare tutte le operazioni del modello di documento (riuscite, in corso o non riuscite) associate alla risorsa Informazioni sui documenti. Le informazioni sulle operazioni vengono conservate solo per 24 ore. Ecco un elenco delle operazioni (operationId) che possono essere restituite:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Monitorare l'ID modello di destinazione

Se l'operazione ha esito positivo, è possibile accedere al modello di documento usando le API getModel (recupera un singolo modello) o GetModels (recupera un elenco di modelli).

Panoramica di Copia modello

Il processo per copiare un modello personalizzato prevede i passaggi seguenti:

  1. Prima di tutto si invia una richiesta di autorizzazione di copia alla risorsa di destinazione, ovvero la risorsa che riceve il modello copiato. Si riceve l'URL del modello di destinazione appena creato, che riceve il modello copiato.
  2. Successivamente si invia la richiesta di copia alla risorsa di origine, ovvero la risorsa che contiene il modello da copiare con il payload (autorizzazione di copia) restituito dalla chiamata precedente. Si riceve un URL su cui è possibile eseguire una query per monitorare lo stato dell'operazione.
  3. È necessario usare le credenziali della risorsa di origine per eseguire una query sullo stato di avanzamento fino al completamento dell'operazione.

Generare la richiesta di autorizzazione

La richiesta HTTP seguente genera l'autorizzazione per la copia dalla risorsa di destinazione. È necessario immettere l'endpoint e la chiave della risorsa di destinazione come intestazioni.

POST https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/copyAuthorization
Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}

Si riceve una risposta 201\Created con un valore modelId nel corpo. Questa stringa è l'ID del modello appena creato (vuoto). accessToken serve all'API per copiare i dati in questa risorsa e il valore expirationDateTimeTicks indica la scadenza del token. Salvare tutti e tre questi valori in una posizione sicura.

HTTP/1.1 201 Created
Location: https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/33f4d42c-cd2f-4e74-b990-a1aeafab5a5d
{"modelId":"<your model ID>","accessToken":"<your access token>","expirationDateTimeTicks":637233481531659440}

Avviare l'operazione di copia

La richiesta HTTP seguente avvia l'operazione di copia nella risorsa di origine. È necessario immettere l'endpoint e la chiave della risorsa di origine come intestazioni. Si noti che l'URL della richiesta contiene l'ID modello del modello di origine da copiare.

POST https://{SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/<your model ID>/copy HTTP/1.1
Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}

Il corpo della richiesta deve avere il formato seguente. È necessario immettere l'ID risorsa e il nome dell'area della risorsa di destinazione. È possibile trovare l'ID risorsa nella scheda Proprietà della risorsa nel portale di Azure, mentre il nome dell'area è disponibile nella scheda Chiavi ed endpoint. Sono necessari anche i valori per l'ID modello, il token di accesso e la scadenza copiati dal passaggio precedente.

{
   "targetResourceId": "{TARGET_AZURE_FORM_RECOGNIZER_RESOURCE_ID}",  
   "targetResourceRegion": "{TARGET_AZURE_FORM_RECOGNIZER_RESOURCE_REGION_NAME}",
   "copyAuthorization": {"modelId":"<your model ID>","accessToken":"<your access token>","expirationDateTimeTicks":637233481531659440}
}

Si riceve una risposta 202\Accepted che include l'intestazione Operation-Location. Questo valore è l'URL che viene usato per monitorare lo stato di avanzamento dell'operazione. Copiarlo in una posizione temporanea per il passaggio successivo.

HTTP/1.1 202 Accepted
Operation-Location: https://{SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/eccc3f13-8289-4020-ba16-9f1d1374e96f/copyresults/02989ba8-1296-499f-aaf4-55cfff41b8f1

Nota

L'API Copia supporta in modo trasparente la funzionalità Chiave di crittografia dell'account/Chiave gestita dal cliente. Questa operazione non richiede alcun trattamento speciale, ma si noti che se si esegue la copia tra una risorsa non crittografata in una risorsa crittografata, è necessario includere l'intestazione della richiesta x-ms-forms-copy-degrade: true. Se questa intestazione non è inclusa, l'operazione di copia avrà esito negativo e restituirà un errore DataProtectionTransformServiceError.

Monitorare lo stato dell'operazione

Tenere traccia dello stato di avanzamento eseguendo una query sull'API GET copy model result rispetto all'endpoint della risorsa di origine.

GET https://{SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/eccc3f13-8289-4020-ba16-9f1d1374e96f/copyresults/02989ba8-1296-499f-aaf4-55cfff41b8f1 HTTP/1.1
Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}

La risposta varia a seconda dello stato dell'operazione. Cercare il campo "status" nel corpo JSON. Se si automatizza questa chiamata API in uno script, è consigliabile eseguire query sull'operazione una volta al secondo.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"status":"succeeded","createdDateTime":"2020-04-23T18:18:01.0275043Z","lastUpdatedDateTime":"2020-04-23T18:18:01.0275048Z","copyResult":{}}

Monitorare lo stato dell'operazione con modelID

È anche possibile usare l'API GET custom model per monitorare lo stato dell'operazione eseguendo una query sul modello di destinazione. Chiamare questa API usando l'ID modello di destinazione copiato nel primo passaggio.

GET https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/33f4d42c-cd2f-4e74-b990-a1aeafab5a5d HTTP/1.1
Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}

Nel corpo della risposta vengono si ricevono le informazioni sul modello. Controllare il campo "status" per lo stato del modello.

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
{"modelInfo":{"modelId":"33f4d42c-cd2f-4e74-b990-a1aeafab5a5d","status":"ready","createdDateTime":"2020-02-26T16:59:28Z","lastUpdatedDateTime":"2020-02-26T16:59:34Z"},"trainResult":{"trainingDocuments":[{"documentName":"0.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"1.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"2.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"3.pdf","pages":1,"errors":[],"status":"succeeded"},{"documentName":"4.pdf","pages":1,"errors":[],"status":"succeeded"}],"errors":[]}}

Esempi di codice cURL

I frammenti di codice seguenti usano cURL per effettuare le chiamate API. È anche necessario compilare gli ID modello e le informazioni sulla sottoscrizione specifiche delle risorse in uso.

Generare l'autorizzazione per la copia

curl -i -X POST "https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/copyAuthorization" -H "Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}"

Avviare l'operazione di copia

curl -i -X POST "https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/copyAuthorization" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}" --data-ascii "{ \"targetResourceId\": \"{TARGET_AZURE_FORM_RECOGNIZER_RESOURCE_ID}\",   \"targetResourceRegion\": \"{TARGET_AZURE_FORM_RECOGNIZER_RESOURCE_REGION_NAME}\", \"copyAuthorization\": "{\"modelId\":\"33f4d42c-cd2f-4e74-b990-a1aeafab5a5d\",\"accessToken\":\"1855fe23-5ffc-427b-aab2-e5196641502f\",\"expirationDateTimeTicks\":637233481531659440}"}"

Monitorare lo stato della copia

curl -i GET "https://<SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT>/formrecognizer/v2.1/custom/models/{SOURCE_MODELID}/copyResults/{RESULT_ID}" -H "Content-Type: application/json" -H "Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}"

Messaggi e codici errore comuni

Error Risoluzione
400/Richiesta non valida con "code:" "1002" Indica un errore di convalida o una richiesta di copia non valida. I problemi comuni includono: a) Payload copyAuthorization non valido o modificato. b) Valore scaduto per il token expirationDateTimeTicks (il payload copyAuthorization è valido per 24 ore). c) Area targetResourceRegion non valida o non supportata. d) Stringa targetResourceId non valida.
Errore di autorizzazione dovuto ad attestazioni di autorizzazione mancanti o non valide. Si verifica quando il contenuto o il payload copyAuthorization viene modificato rispetto a quello dell'API copyAuthorization. Assicurarsi che il payload includa lo stesso contenuto esatto restituito dalla chiamata copyAuthorization precedente.
Non è stato possibile recuperare i metadati dell'autorizzazione. Indica che il payload copyAuthorization viene riutilizzato con una richiesta di copia. Una richiesta di copia che ha esito positivo non consente ulteriori richieste che usano lo stesso payload copyAuthorization. Se viene generato un errore separato e successivamente si ritenta la copia con lo stesso payload di autorizzazione, viene generato questo errore. Per risolvere il problema è necessario generare un nuovo payload copyAuthorization e quindi eseguire nuovamente la richiesta di copia.
La richiesta di trasferimento dei dati non è consentita perché effettua il downgrade a uno schema di protezione dei dati meno sicuro. Si verifica durante la copia tra una risorsa abilitata per AEK a una risorsa non abilitata per AEK. Per consentire la copia del modello crittografato nella destinazione come modello non crittografato, specificare l'intestazione x-ms-forms-copy-degrade: true con la richiesta di copia.
"Non è stato possibile recuperare informazioni per la risorsa Servizi cognitivi con ID...". Indica che la risorsa di Azure indicata da targetResourceId non è una risorsa Servizi cognitivi valida o non esiste. Per risolvere questo problema, verificare e inviare nuovamente la richiesta di copia.
Assicurarsi che la risorsa sia valida ed esista nell'area specificata, ad esempio westus2

Passaggi successivi

In questa guida si è appreso come usare l'API Copia per eseguire il backup dei modelli personalizzati in una risorsa Informazioni sui documenti secondaria. Consultare, ora, la documentazione di riferimento delle API per informazioni su altre operazioni che è possibile eseguire con Informazioni sui documenti.

In questa guida si è appreso come usare l'API Copia per eseguire il backup dei modelli personalizzati in una risorsa Informazioni sui documenti secondaria. Consultare, ora, la documentazione di riferimento delle API per informazioni su altre operazioni che è possibile eseguire con Informazioni sui documenti.