Recuperación ante desastres

Este contenido se aplica a:checkmarkv4.0 (GA) | Versiones anteriores:blue-checkmarkv3.1 (GA)red-checkmarkv3.0 (retirada)red-checkmarkv2.1 (retirada)

Este contenido se aplica a:checkmarkv3.1 (GA) | Versión más reciente:purple-checkmarkv4.0 (GA) | Versiones anteriores:blue-checkmarkv3.0blue-checkmarkv2.1

Este contenido se aplica a:red-checkmarkv3.0 (retirada) | Versiones más recientes:purple-checkmarkv4.0 (GA)purple-checkmarkv3.1 | Versión anterior:blue-checkmarkv2.1 (retirada)

Este contenido se aplica a:red-checkmarkv2.1 | Versión más reciente:blue-checkmarkv4.0 (GA)

Al crear un recurso de Document Intelligence en el portal de Azure, especifique una región. A partir de entonces, el recurso y todas sus operaciones permanecen asociados a esa región de Azure concreta. Es raro, pero no imposible, encontrar un problema de red que llegue a toda una región. Si la solución debe estar siempre disponible, debe diseñarla para que conmute por error en otra región o divida la carga de trabajo entre dos o más regiones. Ambos enfoques requieren al menos dos recursos de Document Intelligence en regiones diferentes y la capacidad de sincronizar modelos y clasificadores personalizados entre regiones.

Copy API permite este escenario, ya que permite copiar modelos y clasificadores personalizados de una cuenta de Document Intelligence o en otras, que pueden existir en cualquier región geográfica admitida. En esta guía se muestra cómo usar la API REST de copia con cURL para modelos personalizados. También puede usar un servicio de solicitud HTTP para emitir las solicitudes.

Nota

El modelo de clasificación personalizado de la API 2024-11-30 (GA) es compatible con la API Copy. En esta guía se usan específicamente modelos personalizados para copiar modelos. Para la copia del modelo clasificador, siga la guía de entrenamiento de un clasificador personalizado.

Escenarios empresariales

Si la aplicación o la empresa dependen del uso de un modelo personalizado de Document Intelligence, se recomienda copiar el modelo en otra cuenta de Document Intelligence en otra región. Si se produce una interrupción regional, puede acceder al modelo en la región donde se copió.

Requisitos previos

  1. Dos recursos de Inteligencia de documentos Azure en distintas suscripciones o regiones de Azure. Si no los tiene, vaya al portal de Azure y cree un nuevo recurso de Inteligencia de documentos.
  2. La clave, la dirección URL del punto de conexión y el identificador de suscripción para el recurso de Document Intelligence. Puede encontrar estos valores en la pestaña Overview del recurso en la pestaña Azure portal.

Descripción general de la API de copia

El proceso para copiar un modelo personalizado consta de los pasos siguientes:

  1. En primer lugar, emite una solicitud de autorización de copia al recurso de destino, es decir, el recurso que recibe el modelo copiado. Recibirá la dirección URL del modelo de destino recién creado que recibe el modelo copiado.
  2. A continuación, envíe la solicitud de copia al recurso de origen, que es el recurso que contiene el modelo que debe copiarse, junto con el paquete de datos (autorización de copia) devuelto desde la llamada anterior. Recibirá una dirección URL que puede consultar para realizar el seguimiento del progreso de la operación.
  3. Usará las credenciales del recurso de origen para consultar la dirección URL de progreso hasta que la operación finalice correctamente. También puede consultar el nuevo identificador de modelo en el recurso de destino para obtener el estado del nuevo modelo.

Generar solicitud de autorización de copia

La siguiente solicitud HTTP obtiene la autorización de copia del recurso de destino. Debe especificar el punto de conexión y la clave del recurso de destino como encabezados.

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

Cuerpo de la solicitud

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

Recibirá un 200 código de respuesta con el cuerpo de la respuesta que contiene la carga JSON necesaria para iniciar 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"
}

Iniciar operación de copia

La siguiente solicitud HTTP inicia la operación de copia en el recurso de origen. Debe escribir el punto de conexión y la clave del recurso de origen como dirección URL y encabezado. Observe que la dirección URL de la solicitud contiene el identificador de modelo del modelo de origen que desea copiar.

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

El cuerpo de la solicitud es la respuesta del paso anterior.

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

Recibirá una respuesta 202\Accepted con un encabezado Operation-Location. Este valor es la dirección URL que se usa para realizar el seguimiento del progreso de la operación. Cópielo en una ubicación temporal para el paso siguiente.

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

Nota

Copy API admite de forma transparente la característica AEK/CMK . Esta acción no requiere ningún tratamiento especial, pero tenga en cuenta que si va a copiar entre un recurso sin cifrar en un recurso cifrado, debe incluir el encabezado x-ms-forms-copy-degrade: truede solicitud . Si no se incluye este encabezado, se produce un error en la operación de copia y devuelve un DataProtectionTransformServiceError.

Seguir el progreso de la copia

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

Seguimiento del identificador del modelo de destino

También puede usar la Get model API para realizar un seguimiento del estado de la operación consultando el modelo de destino. Llame a la API mediante el id. del modelo de destino que copió de la respuesta de Generate copy authorization.

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

En el cuerpo de la respuesta, puede ver información sobre el modelo. Compruebe el "status" campo para ver el estado del modelo.

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":[]}}

Código de ejemplo de cURL

Los fragmentos de código siguientes usan cURL para realizar llamadas API. También debe rellenar los identificadores de modelo y la información de suscripción correspondientes a sus propios recursos.

Generar autorización de copia

Solicitud

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

Respuesta correcta

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

Iniciar operación de copia

Solicitud

curl -i -X POST "<your-resource-endpoint>/documentintelligence/documentModels/{modelId}:copyTo?api-version=2024-11-30"
-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}'
}"

Respuesta correcta

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

Seguimiento del progreso de la operación de copia

Puede usar la API de operación GET para enumerar todas las operaciones del modelo de documento (correctas, en curso o con errores) asociadas al recurso de Document Intelligence. La información de la operación solo se conserva durante 24 horas. Esta es una lista de las operaciones (operationId) que se pueden devolver:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Seguimiento del identificador del modelo de destino

Si la operación se realizó correctamente, se puede acceder al modelo de documento mediante las API getModel (obtener un solo modelo) o GetModels (obtener una lista de modelos).

Descripción general de la API de copia

El proceso para copiar un modelo personalizado consta de los pasos siguientes:

  1. En primer lugar, emite una solicitud de autorización de copia al recurso de destino, es decir, el recurso que recibe el modelo copiado. Recibirá la dirección URL del modelo de destino recién creado que recibe el modelo copiado.
  2. A continuación, envíe la solicitud de copia al recurso de origen, que es el recurso que contiene el modelo que debe copiarse, junto con el paquete de datos (autorización de copia) devuelto desde la llamada anterior. Recibirá una dirección URL que puede consultar para realizar el seguimiento del progreso de la operación.
  3. Usará las credenciales del recurso de origen para consultar la dirección URL de progreso hasta que la operación finalice correctamente. También puede consultar el nuevo identificador de modelo en el recurso de destino para obtener el estado del nuevo modelo.

Generar solicitud de autorización de copia

La siguiente solicitud HTTP obtiene la autorización de copia del recurso de destino. Debe especificar el punto de conexión y la clave del recurso de destino como encabezados.

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

Cuerpo de la solicitud

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

Recibirá un 200 código de respuesta con el cuerpo de la respuesta que contiene la carga JSON necesaria para iniciar 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"
}

Iniciar operación de copia

La siguiente solicitud HTTP inicia la operación de copia en el recurso de origen. Debe escribir el punto de conexión y la clave del recurso de origen como dirección URL y encabezado. Observe que la dirección URL de la solicitud contiene el identificador de modelo del modelo de origen que desea copiar.

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

El cuerpo de la solicitud es la respuesta del paso anterior.

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

Recibirá una respuesta 202\Accepted con un encabezado Operation-Location. Este valor es la dirección URL que se usa para realizar el seguimiento del progreso de la operación. Cópielo en una ubicación temporal para el paso siguiente.

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

Nota

Copy API admite de forma transparente la característica AEK/CMK . Esta acción no requiere ningún tratamiento especial, pero tenga en cuenta que si va a copiar entre un recurso sin cifrar en un recurso cifrado, debe incluir el encabezado x-ms-forms-copy-degrade: truede solicitud . Si no se incluye este encabezado, se produce un error en la operación de copia y devuelve un DataProtectionTransformServiceError.

Seguir el progreso de la 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}

Seguimiento del identificador del modelo de destino

También puede usar la GET model API para realizar un seguimiento del estado de la operación consultando el modelo de destino. Llame a la API mediante el id. del modelo de destino que copió de la respuesta de Generate Copy authorization.

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

En el cuerpo de la respuesta, puede ver información sobre el modelo. Compruebe el "status" campo para ver el estado del modelo.

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":[]}}

Código de ejemplo de cURL

Los fragmentos de código siguientes usan cURL para realizar llamadas API. También debe rellenar los identificadores de modelo y la información de suscripción correspondientes a sus propios recursos.

Generar autorización de copia

Solicitud

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}'
}"

Respuesta correcta

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

Iniciar operación de copia

Solicitud

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}'
}"

Respuesta correcta

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

Seguimiento del progreso de la operación de copia

Puede usar la GET operation API para enumerar todas las operaciones del modelo de documento (correctas, en curso o con errores) asociadas al recurso de Document Intelligence. La información de la operación solo se conserva durante 24 horas. Esta es una lista de las operaciones (operationId) que se pueden devolver:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Seguimiento del identificador del modelo de destino

Si la operación se realizó correctamente, se puede acceder al modelo de documento mediante las API getModel (obtener un solo modelo) o GetModels (obtener una lista de modelos).

Información general sobre el modelo de copia

El proceso para copiar un modelo personalizado consta de los pasos siguientes:

  1. En primer lugar, emite una solicitud de autorización de copia al recurso de destino, es decir, el recurso que recibe el modelo copiado. Recibirá la dirección URL del modelo de destino recién creado que recibe el modelo copiado.
  2. A continuación, envíe la solicitud de copia al recurso de origen, que es el recurso que contiene el modelo que debe copiarse, junto con el paquete de datos (autorización de copia) devuelto desde la llamada anterior. Recibirá una dirección URL que puede consultar para realizar el seguimiento del progreso de la operación.
  3. Usará las credenciales del recurso de origen para consultar la dirección URL de progreso hasta que la operación finalice correctamente.

Generación de una solicitud de autorización

La siguiente solicitud HTTP genera una autorización de copia del recurso de destino. Debe especificar el punto de conexión y la clave del recurso de destino como encabezados.

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

Recibe una respuesta 201\Created con un valor modelId en el cuerpo. Esta cadena es el identificador del modelo recién creado (en blanco). El accessToken se necesita para que la API copie los datos en este recurso, y el valor de expirationDateTimeTicks es la expiración del token. Guarde los tres valores en una ubicación segura.

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}

Iniciar la operación de copia

La siguiente solicitud HTTP inicia la operación de copia en el recurso de origen. Debe especificar el punto de conexión y la clave del recurso de origen como encabezados. Observe que la dirección URL de la solicitud contiene el identificador de modelo del modelo de origen que desea copiar.

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}

El cuerpo de la solicitud debe tener el siguiente formato. Debe escribir el identificador de recurso y el nombre de región del recurso de destino. Puede encontrar el identificador de recurso en la pestaña Properties del recurso en el portal de Azure y puede encontrar el nombre de región en la pestaña Keys y endpoint. También necesita el identificador de modelo, el token de acceso y el valor de expiración que copió del paso anterior.

{
   "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}
}

Recibirá una respuesta 202\Accepted con un encabezado Operation-Location. Este valor es la dirección URL que se usa para realizar el seguimiento del progreso de la operación. Cópielo en una ubicación temporal para el paso siguiente.

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

Copy API admite de forma transparente la característica AEK/CMK . Esta operación no requiere ningún tratamiento especial, pero tenga en cuenta que si va a copiar entre un recurso sin cifrar en un recurso cifrado, debe incluir el encabezado x-ms-forms-copy-degrade: truede solicitud . Si no se incluye este encabezado, se produce un error en la operación de copia y devuelve un DataProtectionTransformServiceError.

Seguimiento del progreso de la operación

Realice un seguimiento del progreso consultando la GET copy model result API en el punto de conexión del recurso de origen.

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 respuesta varía en función del estado de la operación. Busque el campo "status" en el cuerpo JSON. Si va a automatizar esta llamada API en un script, se recomienda consultar la operación una vez cada segundo.

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":{}}

Seguimiento del estado de la operación con modelID

También puede usar la GET custom model API para realizar un seguimiento del estado de la operación consultando el modelo de destino. Llame a esta API con el identificador del modelo de destino que copió en el primer paso.

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}

En el cuerpo de la respuesta, usted recibirá información sobre el modelo. Compruebe el "status" campo para ver el estado del modelo.

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":[]}}

Ejemplos de código cURL

Los fragmentos de código siguientes usan cURL para realizar llamadas API. También debe rellenar los identificadores de modelo y la información de suscripción correspondientes a sus propios recursos.

Generación de autorización de 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}"

Iniciar operación de 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}"}"

Seguimiento del progreso de la 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}"

Mensajes comunes de código de error

Error Resolución
400 / Solicitud incorrecta con "code:" "1002" Indica el error de validación o la solicitud de copia con formato incorrecto. Entre los problemas comunes se incluyen: a) Carga no válida o modificada copyAuthorization . b) Un valor expirado para el token expirationDateTimeTicks (la carga copyAuthorization es válida durante 24 horas). c) No válido o no admitido targetResourceRegion. d) Cadena no válida o con formato incorrecto targetResourceId .
Error de autorización debido a notificaciones de autorización que faltan o no son válidas. Se produce cuando la carga útil o el contenido de copyAuthorization se modifican desde la copyAuthorization API. Asegúrese de que la carga sea el mismo contenido exacto que se devolvió en la llamada anterior copyAuthorization.
No se pudieron recuperar los metadatos de autorización. Indica que la carga de copyAuthorization se está usando de nuevo con una solicitud de copia. Una solicitud de copia que se realiza correctamente no permite más solicitudes que usen la misma copyAuthorization carga útil. Si genera un error independiente y, posteriormente, intenta de nuevo la copia con la misma carga de autorización, se genera este error. La resolución consiste en generar una nueva copyAuthorization carga y, a continuación, volver a emitir la solicitud de copia.
No se permite la solicitud de transferencia de datos, ya que cambia a un esquema de protección de datos menos seguro. Se produce cuando se realiza una copia entre un recurso con AEK habilitado y un recurso que no tiene AEK habilitado. Para permitir copiar el modelo cifrado al destino como no cifrado, especifique el encabezado x-ms-forms-copy-degrade: true con la solicitud de copia.
"No se pudo obtener información del recurso de Cognitive con el id...". Indica que el recurso de Azure indicado por el targetResourceId no es un recurso cognitivo válido o no existe. Para resolver este problema, compruebe y vuelva a emitir la solicitud de copia.
Asegúrese de que el recurso es válido y existe en la región especificada, como , westus2

Pasos siguientes

En esta guía, ha obtenido información sobre cómo usar la API de copia para realizar una copia de seguridad de los modelos personalizados en un recurso de Documento de inteligencia secundario. A continuación, explore los documentos de referencia de la API para ver qué más puede hacer con la inteligencia de documentos.

En esta guía, ha aprendido a usar la API de copiado para realizar copias de seguridad de sus modelos personalizados en un recurso secundario de Document Intelligence. A continuación, explore los documentos de referencia de API para ver qué más puede hacer con la inteligencia de documentos.

  • Last updated on