Recuperação após desastre

  • Artigo

Este conteúdo aplica-se a: marca de verificação v4.0 (pré-visualização) | Versões anteriores: Marca de verificação azul v3.1 (GA) Marca de verificação azul v3.0 (GA) Marca de verificação azul v2.1 (GA)

Este conteúdo aplica-se a: marca de verificação v3.1 (GA) | Última versão:marca de verificação roxa v4.0 (pré-visualização) | Versões anteriores: Marca de verificação azul v3.0Marca de verificação azul v2.1

Este conteúdo aplica-se a: marca de verificação v3.0 (GA) | Últimas versões: marca de verificação roxa v4.0 (preview) marca de verificação roxav3.1 | Versão anterior: Marca de verificação azul v2.1

Este conteúdo aplica-se a: marca de verificação v2.1 | Última versão: Marca de verificação azul v4.0 (pré-visualização)

Ao criar um recurso de Inteligência Documental no portal do Azure, você especifica uma região. A partir de então, seu recurso e todas as suas operações permanecem associados a essa região específica do servidor do Azure. É raro, mas não impossível, encontrar um problema de rede que atinge uma região inteira. Se a sua solução precisa estar sempre disponível, deve projetá-la para failover noutra região ou dividir a carga de trabalho entre duas ou mais regiões. Ambas as abordagens exigem pelo menos dois recursos de Document Intelligence em regiões diferentes e a capacidade de sincronizar modelos e classificadores personalizados entre regiões.

A API de Cópia permite esse cenário, permitindo que você copie modelos e classificadores personalizados de uma conta de Document Intelligence ou para outras, que podem existir em qualquer região geográfica suportada. Este guia mostra como usar a API Copy REST com cURL para modelos personalizados. Você também pode usar um serviço de solicitação HTTP para emitir as solicitações.

Nota

Começando com a API, os 2024-07-31-preview modelos de clasificação personalizados também suportam a API de cópia. Este guia usa especificamente modelos personalizados para copiar modelos. Para cópia do modelo do classificador, siga este guia.

Cenários de negócio

Se seu aplicativo ou empresa depender do uso de um modelo personalizado de Document Intelligence, recomendamos que você copie seu modelo para outra conta de Document Intelligence em outra região. Se ocorrer uma interrupção regional, você poderá acessar seu modelo na região onde ele foi copiado.

Pré-requisitos

  1. Dois recursos do Azure Document Intelligence em regiões diferentes do Azure. Se não os tiver, aceda ao portal do Azure e crie um novo recurso de Inteligência Documental.
  2. A chave, o URL do ponto de extremidade e o ID da assinatura do seu recurso de Document Intelligence. Você pode encontrar esses valores na guia Visão geral do recurso no portal do Azure.

Copiar visão geral da API

O processo para copiar um modelo personalizado consiste nas seguintes etapas:

  1. Primeiro, você emite uma solicitação de autorização de cópia para o recurso de destino, ou seja, o recurso que recebe o modelo copiado. Você recebe de volta a URL do modelo de destino recém-criado que recebe o modelo copiado.
  2. Em seguida, você envia a solicitação de cópia para o recurso de origem — o recurso que contém o modelo a ser copiado com a carga (autorização de cópia) retornada da chamada anterior. Você recebe de volta uma URL que pode consultar para acompanhar o progresso da operação.
  3. Você usa suas credenciais de recurso de origem para consultar a URL de progresso até que a operação seja bem-sucedida. Você também pode consultar a ID do novo modelo no recurso de destino para obter o status do novo modelo.

Gerar solicitação de autorização de cópia

A solicitação HTTP a seguir obtém autorização de cópia do recurso de destino. Você precisa inserir o ponto de extremidade e a chave do recurso de destino como cabeçalhos.

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

Corpo do pedido

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

Você recebe um código de 200 resposta com o corpo da resposta que contém a carga JSON necessária para iniciar a cópia.

{
  "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 operação de cópia

A solicitação HTTP a seguir inicia a operação de cópia no recurso de origem. Você precisa inserir o ponto de extremidade e a chave do seu recurso de origem como url e cabeçalho. Observe que a URL da solicitação contém a ID do modelo de origem que você deseja copiar.

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

O corpo do seu pedido é a resposta do passo 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"
}

Você recebe uma 202\Accepted resposta com um cabeçalho Operation-Location. Esse valor é a URL que você usa para acompanhar o progresso da operação. Copie-o para um local temporário para a próxima etapa.

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

A API de cópia suporta de forma transparente o recurso AEK/CMK . Isso não requer nenhum tratamento especial, mas observe que, se você estiver copiando entre um recurso não criptografado para um recurso criptografado, precisará incluir o cabeçalho x-ms-forms-copy-degrade: trueda solicitação. Se esse cabeçalho não estiver incluído, a operação de cópia falhará e retornará um DataProtectionTransformServiceErrorarquivo .

Acompanhar o progresso da cópia

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

Rastreie o ID do modelo de destino

Você também pode usar a Get model API para controlar o status da operação consultando o modelo de destino. Chame a API usando o ID do modelo de destino que você copiou da Generate copy authorization resposta da solicitação .

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

No corpo da resposta, você vê informações sobre o modelo. Verifique no "status" campo o status do 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 exemplo cURL

Os trechos de código a seguir usam cURL para fazer chamadas de API. Você também precisa preencher os IDs do modelo e as informações de assinatura específicas para seus próprios recursos.

Gerar autorização de cópia

Pedir

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

Resposta bem-sucedida

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

Iniciar operação de cópia

Pedir

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

Resposta bem-sucedida

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

Acompanhe o progresso da operação de cópia

Você pode usar a API de operação GET para listar todas as operações de modelo de documento (bem-sucedidas, em andamento ou com falha) associadas ao seu recurso de Document Intelligence. As informações da operação só persistem por 24 horas. Aqui está uma lista das operações (operationId) que podem ser retornadas:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Rastreie o ID do modelo de destino

Se a operação foi bem-sucedida, o modelo de documento pode ser acessado usando as APIs getModel (obter um único modelo) ou GetModels (obter uma lista de modelos).

Copiar visão geral da API

O processo para copiar um modelo personalizado consiste nas seguintes etapas:

  1. Primeiro, você emite uma solicitação de autorização de cópia para o recurso de destino, ou seja, o recurso que recebe o modelo copiado. Você recebe de volta a URL do modelo de destino recém-criado que recebe o modelo copiado.
  2. Em seguida, você envia a solicitação de cópia para o recurso de origem — o recurso que contém o modelo a ser copiado com a carga (autorização de cópia) retornada da chamada anterior. Você recebe de volta uma URL que pode consultar para acompanhar o progresso da operação.
  3. Você usa suas credenciais de recurso de origem para consultar a URL de progresso até que a operação seja bem-sucedida. Você também pode consultar a ID do novo modelo no recurso de destino para obter o status do novo modelo.

Gerar solicitação de autorização de cópia

A solicitação HTTP a seguir obtém autorização de cópia do recurso de destino. Você precisa inserir o ponto de extremidade e a chave do recurso de destino como cabeçalhos.

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}

Corpo do pedido

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

Você recebe um código de 200 resposta com o corpo da resposta que contém a carga JSON necessária para iniciar a cópia.

{
  "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 operação de cópia

A solicitação HTTP a seguir inicia a operação de cópia no recurso de origem. Você precisa inserir o ponto de extremidade e a chave do seu recurso de origem como url e cabeçalho. Observe que a URL da solicitação contém a ID do modelo de origem que você deseja 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}

O corpo do seu pedido é a resposta do passo 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"
}

Você recebe uma 202\Accepted resposta com um cabeçalho Operation-Location. Esse valor é a URL que você usa para acompanhar o progresso da operação. Copie-o para um local temporário para a próxima etapa.

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

Nota

A API de cópia suporta de forma transparente o recurso AEK/CMK . Isso não requer nenhum tratamento especial, mas observe que, se você estiver copiando entre um recurso não criptografado para um recurso criptografado, precisará incluir o cabeçalho x-ms-forms-copy-degrade: trueda solicitação. Se esse cabeçalho não estiver incluído, a operação de cópia falhará e retornará um DataProtectionTransformServiceErrorarquivo .

Acompanhar o progresso da cópia

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}

Rastreie o ID do modelo de destino

Você também pode usar a GET model API para controlar o status da operação consultando o modelo de destino. Chame a API usando o ID do modelo de destino que você copiou da Generate Copy authorization resposta da solicitação .

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

No corpo da resposta, você vê informações sobre o modelo. Verifique no "status" campo o status do 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 exemplo cURL

Os trechos de código a seguir usam cURL para fazer chamadas de API. Você também precisa preencher os IDs do modelo e as informações de assinatura específicas para seus próprios recursos.

Gerar autorização de cópia

Pedir

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

Resposta bem-sucedida

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

Iniciar operação de cópia

Pedir

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

Resposta bem-sucedida

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

Acompanhe o progresso da operação de cópia

Você pode usar a GET operation API para listar todas as operações de modelo de documento (bem-sucedidas, em andamento ou com falha) associadas ao seu recurso de Document Intelligence. As informações da operação só persistem por 24 horas. Aqui está uma lista das operações (operationId) que podem ser retornadas:

  • documentModelBuild
  • documentModelCompose
  • documentModelCopyTo

Rastreie o ID do modelo de destino

Se a operação foi bem-sucedida, o modelo de documento pode ser acessado usando as APIs getModel (obter um único modelo) ou GetModels (obter uma lista de modelos).

Visão geral do modelo de cópia

O processo para copiar um modelo personalizado consiste nas seguintes etapas:

  1. Primeiro, você emite uma solicitação de autorização de cópia para o recurso de destino, ou seja, o recurso que recebe o modelo copiado. Você recebe de volta a URL do modelo de destino recém-criado que recebe o modelo copiado.
  2. Em seguida, você envia a solicitação de cópia para o recurso de origem — o recurso que contém o modelo a ser copiado com a carga (autorização de cópia) retornada da chamada anterior. Você recebe de volta uma URL que pode consultar para acompanhar o progresso da operação.
  3. Você usa suas credenciais de recurso de origem para consultar a URL de progresso até que a operação seja bem-sucedida.

Gerar pedido de autorização

A solicitação HTTP a seguir gera uma autorização de cópia do recurso de destino. Você precisa inserir o ponto de extremidade e a chave do recurso de destino como cabeçalhos.

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

Você recebe uma 201\Created resposta com um modelId valor no corpo. Esta cadeia de caracteres é a ID do modelo recém-criado (em branco). O accessToken é necessário para que a API copie dados para este recurso, e o expirationDateTimeTicks valor é a expiração do token. Salve todos esses três valores em um local seguro.

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 a operação de cópia

A solicitação HTTP a seguir inicia a operação Copiar no recurso de origem. Você precisa inserir o ponto de extremidade e a chave do recurso de origem como cabeçalhos. Observe que a URL da solicitação contém a ID do modelo de origem que você deseja 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}

O corpo do seu pedido tem de ter o seguinte formato. Você precisa inserir o ID do recurso e o nome da região do recurso de destino. Você pode encontrar sua ID de recurso na guia Propriedades do seu recurso no portal do Azure e pode encontrar o nome da região na guia Chaves e ponto de extremidade . Você também precisa da ID do modelo, do token de acesso e do valor de expiração copiados da etapa 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}
}

Você recebe uma 202\Accepted resposta com um cabeçalho Operation-Location. Esse valor é a URL que você usa para acompanhar o progresso da operação. Copie-o para um local temporário para a próxima etapa.

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

A API de cópia suporta de forma transparente o recurso AEK/CMK . Esta operação não requer nenhum tratamento especial, mas observe que, se você estiver copiando entre um recurso não criptografado para um recurso criptografado, precisará incluir o cabeçalho x-ms-forms-copy-degrade: trueda solicitação. Se esse cabeçalho não estiver incluído, a operação de cópia falhará e retornará um DataProtectionTransformServiceErrorarquivo .

Acompanhe o progresso da operação

Acompanhe seu progresso consultando a GET copy model result API em relação ao ponto de extremidade do recurso de origem.

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}

A resposta varia dependendo do status da operação. Procure o "status" campo no corpo JSON. Se você estiver automatizando essa chamada de API em um script, recomendamos consultar a operação uma vez a 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":{}}

Acompanhe o status da operação com modelID

Você também pode usar a GET custom model API para controlar o status da operação consultando o modelo de destino. Chame essa API usando o ID do modelo de destino que você copiou na primeira etapa.

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}

No corpo da resposta, você recebe informações sobre o modelo. Verifique no "status" campo o status do 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":[]}}

Exemplos de código cURL

Os trechos de código a seguir usam cURL para fazer chamadas de API. Você também precisa preencher os IDs do modelo e as informações de assinatura específicas para seus próprios recursos.

Gerar autorização de cópia

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 operação de cópia

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

Acompanhar o progresso da cópia

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

Mensagens de código de erro comuns

Erro Resolução
400 / Mau Pedido com "code:" "1002" Indica erro de validação ou solicitação de cópia mal formada. Os problemas comuns incluem: a) Carga útil inválida ou modificada copyAuthorization . b) Valor expirado para expirationDateTimeTicks token (copyAuthorization a carga útil é válida por 24 horas). c) Inválido ou não suportado targetResourceRegion. d) String inválida ou malformada targetResourceId .
Falha de autorização devido a reclamações de autorização ausentes ou inválidas. Ocorre quando a carga útil ou o copyAuthorization conteúdo é modificado a copyAuthorization partir da API. Certifique-se de que a carga útil é o mesmo conteúdo exato que foi retornado da chamada anterior copyAuthorization .
Não foi possível recuperar metadados de autorização. Indica que a copyAuthorization carga está sendo reutilizada com uma solicitação de cópia. Uma solicitação de cópia bem-sucedida não permite outras solicitações que usem a mesma copyAuthorization carga útil. Se você gerar um erro separado e mais tarde tentar novamente a cópia com a mesma carga útil de autorização, esse erro será gerado. A resolução é gerar uma nova copyAuthorization carga útil e, em seguida, reemitir a solicitação de cópia.
A solicitação de transferência de dados não é permitida, pois faz downgrade para um esquema de proteção de dados menos seguro. Ocorre ao copiar entre um AEK recurso habilitado para um recurso não AEK habilitado. Para permitir a cópia do modelo criptografado para o destino como não criptografado, especifique x-ms-forms-copy-degrade: true o cabeçalho com a solicitação de cópia.
"Não foi possível buscar informações para o recurso cognitivo com ID...". Indica que o targetResourceId recurso do Azure indicado pelo não é um recurso cognitivo válido ou não existe. Para resolver esse problema, verifique e reemita a solicitação de cópia.
Verifique se o recurso é válido e existe na região especificada, como, por exemplo, westus2

Próximos passos

Neste guia, você aprendeu como usar a API de cópia para fazer backup de seus modelos personalizados em um recurso secundário de Document Intelligence. Em seguida, explore os documentos de referência da API para ver o que mais você pode fazer com o Document Intelligence.

Neste guia, você aprendeu como usar a API de cópia para fazer backup de seus modelos personalizados em um recurso secundário de Document Intelligence. Em seguida, explore os documentos de referência da API para ver o que mais você pode fazer com o Document Intelligence.