Skip to content

Commit 1319a54

Browse files
Merge pull request #214759 from laujan/patch-163
Update disaster-recovery.md
2 parents db66ce5 + 831d516 commit 1319a54

File tree

1 file changed

+12
-4
lines changed

1 file changed

+12
-4
lines changed

articles/applied-ai-services/form-recognizer/disaster-recovery.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,14 @@ ms.author: lajanuar
1515

1616
# Back up and recover your Form Recognizer models
1717

18+
::: moniker range="form-recog-3.0.0"
19+
[!INCLUDE [applies to v3.0](includes/applies-to-v3-0.md)]
20+
::: moniker-end
21+
22+
::: moniker range="form-recog-2.1.0"
23+
[!INCLUDE [applies to v2.1](includes/applies-to-v2-1.md)]
24+
::: moniker-end
25+
1826
::: moniker range=">= form-recog-2.1.0"
1927

2028
When you create a Form Recognizer resource in the Azure portal, you specify a region. From then on, your resource and all of its operations stay associated with that particular Azure server region. It's rare, but not impossible, to encounter a network issue that hits an entire region. If your solution needs to always be available, then you should design it to either fail-over into another region or split the workload between two or more regions. Both approaches require at least two Form Recognizer resources in different regions and the ability to sync custom models across regions.
@@ -187,15 +195,15 @@ The following code snippets use cURL to make API calls outlined in the steps abo
187195

188196
### Track copy operation progress
189197

190-
You can use the [**Get operation**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetOperation) API to list all document model operations (succeeded, in-progress, failed) associated with your Form Recognizer resource. Operation information only persists for 24 hours. Here is a list of the operations (operationId) that can be returned:
198+
You can use the [**Get operation**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetOperation) API to list all document model operations (succeeded, in-progress, or failed) associated with your Form Recognizer resource. Operation information only persists for 24 hours. Here's a list of the operations (operationId) that can be returned:
191199

192200
* documentModelBuild
193201
* documentModelCompose
194202
* documentModelCopyTo
195203

196204
### Track the target model ID
197205

198-
If the operation was successful, the document model can be accessed using [**getModel**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetModel)(get a single model) or [**GetModels**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetModels)(get a list of models) APIs.
206+
If the operation was successful, the document model can be accessed using the [**getModel**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetModel) (get a single model), or [**GetModels**](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2022-08-31/operations/GetModels) (get a list of models) APIs.
199207

200208
::: moniker-end
201209

@@ -253,7 +261,7 @@ Operation-Location: https://{SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecog
253261
```
254262

255263
> [!NOTE]
256-
> The Copy API transparently supports the [AEK/CMK](https://msazure.visualstudio.com/Cognitive%20Services/_wiki/wikis/Cognitive%20Services.wiki/52146/Customer-Managed-Keys) feature. This doesn't require any special treatment, but note that if you're copying between an unencrypted resource to an encrypted resource, you need to include the request header `x-ms-forms-copy-degrade: true`. If this header is not included, the copy operation will fail and return a `DataProtectionTransformServiceError`.
264+
> The Copy API transparently supports the [AEK/CMK](https://msazure.visualstudio.com/Cognitive%20Services/_wiki/wikis/Cognitive%20Services.wiki/52146/Customer-Managed-Keys) feature. This operation doesn't require any special treatment, but note that if you're copying between an unencrypted resource to an encrypted resource, you need to include the request header `x-ms-forms-copy-degrade: true`. If this header is not included, the copy operation will fail and return a `DataProtectionTransformServiceError`.
257265
258266
### Track operation progress
259267

@@ -323,7 +331,7 @@ curl -i GET "https://<SOURCE_FORM_RECOGNIZER_RESOURCE_ENDPOINT>/formrecognizer/v
323331
|"Authorization failure due to missing or invalid authorization claims".| Occurs when the `copyAuthorization` payload or content is modified from what was returned by the `copyAuthorization` API. Ensure that the payload is the same exact content that was returned from the earlier `copyAuthorization` call.|
324332
|"Couldn't retrieve authorization metadata".| Indicates that the `copyAuthorization` payload is being reused with a copy request. A copy request that succeeds won't allow any further requests that use the same `copyAuthorization` payload. If you raise a separate error (like the ones noted below) and you later retry the copy with the same authorization payload, this error gets raised. The resolution is to generate a new `copyAuthorization` payload and then reissue the copy request.|
325333
|"Data transfer request isn't allowed as it downgrades to a less secure data protection scheme".| Occurs when copying between an `AEK` enabled resource to a non `AEK` enabled resource. To allow copying encrypted model to the target as unencrypted specify `x-ms-forms-copy-degrade: true` header with the copy request.|
326-
|"Couldn't fetch information for Cognitive resource with ID...". | Indicates that the Azure resource indicated by the `targetResourceId` isn't a valid Cognitive resource or doesn't exist. Verify and reissue the copy request to resolve this issue.</br>Ensure the resource is valid and exists in the specified region, i.e., 'westus2'|
334+
|"Couldn't fetch information for Cognitive resource with ID...". | Indicates that the Azure resource indicated by the `targetResourceId` isn't a valid Cognitive resource or doesn't exist. Verify and reissue the copy request to resolve this issue.</br> Ensure the resource is valid and exists in the specified region, such as, `westus2`|
327335

328336
::: moniker-end
329337

0 commit comments

Comments
 (0)