障害復旧

[アーティクル]
10/16/2024

このコンテンツの適用対象: v4.0 (プレビュー) | 以前のバージョン: v3.1 (GA) v3.0 (GA) v2.1 (GA)

このコンテンツの適用対象: v3.1 (GA) | 最新バージョン: v4.0 (プレビュー) | 以前のバージョン: v3.0 v2.1

このコンテンツの適用対象: v3.0 (GA) | 最新バージョン: v4.0 (プレビュー) v3.1 | 以前のバージョン: v2.1

このコンテンツの適用対象: v2.1 | 最新バージョン: v4.0 (プレビュー)

Azure portal 内で Document Intelligence リソースを作成するときに、リージョンを指定します。それ以降、ご使用のリソースとそのすべての操作はその特定の Azure サーバーリージョンに関連付けられたままになります。リージョン全体に影響が及ぶネットワークの問題が発生することはまれですが、まったくないわけではありません。ご自分のソリューションを常に使用できるようにする必要がある場合は、別のリージョンにフェールオーバーするか、複数のリージョン間でワークロードを分割するように設計する必要があります。どちらの方法でも、リージョンごとに少なくとも 2 つの Document Intelligence リソースと、リージョン間でカスタムモデルと分類子を同期する機能が必要です。

コピー API によって、ある Document Intelligence アカウントからのカスタムモデルと分類子のコピー、またはサポートされている任意の地理的リージョンに存在できる別のアカウントへのコピーが可能になり、このシナリオが実現します。このガイドでは、カスタムモデルの cURL と共にコピー REST API を使用する方法について説明します。 HTTP 要求サービスを使用して、要求を発行することもできます。

Note

2024-07-31-preview API 以降、カスタム分類モデルではコピー API もサポートされています。このガイドでは、特にカスタムモデルを使用してモデルをコピーします。分類子モデルのコピーの場合は、このガイドに従ってください。

ビジネスシナリオ

ご自分のアプリまたはビジネスが Document Intelligence カスタムモデルの使用に依存している場合は、別のリージョン内の別の Document Intelligence アカウントにご使用のモデルをコピーすることをお勧めします。地域的な障害が発生した場合は、コピー先のリージョン内のご自分のモデルにアクセスできます。

前提条件

異なる Azure リージョン内にある 2 つの Document Intelligence Azure リソース。それらがない場合は、Azure portal に移動し、新しい Document Intelligence リソースを作成します。
ご使用の Document Intelligence リソースのキー、エンドポイント URL、およびサブスクリプション ID。これらの値は Azure portal 上のリソースの [概要] タブにあります。

コピー API の概要

カスタムモデルをコピーするプロセスは、次の手順で構成されています。

まず、ターゲットリソース、つまりコピーされたモデルを受け取るリソースに対してコピー認可要求を発行します。コピーされたモデルを受け取る新しく作成されたターゲットモデルの URL が返されます。
次に、ソースリソース (前の呼び出しから返されたペイロード (コピー承認) を持つ、コピーするモデルが含まれているリソース) にコピー要求を送信します。クエリを実行して操作の進行状況を追跡できる URL が返されます。
操作が成功するまで、ご自分のソースリソースの資格情報を使用して、進行状況の URL に対してクエリを実行します。また、ターゲットリソース内の新しいモデル ID に対してクエリを実行して、新しいモデルの状態を取得することもできます。

コピー承認要求を生成する

次の HTTP 要求では、ターゲットリソースからコピー承認を取得します。ご自分のターゲットリソースのエンドポイントとキーをヘッダーとして入力する必要があります。

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

要求本文

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

コピーを開始するために必要な JSON ペイロードを含む応答本文が追加された 200 応答コードを受信します。

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

コピー操作を開始する

次の HTTP 要求を実行すると、ソースリソースのコピー操作が開始されます。ご自分のソースリソースのエンドポイントとキーを URL とヘッダーとして入力する必要があります。コピーするソースモデルのモデル ID が要求 URL に含まれていることに注目してください。

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

要求の本文は、前の手順の応答です。

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

Operation-Location ヘッダーを含む 202\Accepted 応答を受信します。この値は、操作の進行状況を追跡するために使用する URL です。次の手順のために、これを一時的な場所に保存します。

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

Note

コピー API では、AEK/CMK 機能が透過的にサポートされます。これには特別な処理は必要ありませんが、暗号化されていないリソースと暗号化されたリソースの間でコピーを行う場合は、要求ヘッダー x-ms-forms-copy-degrade: true を含める必要があることにご注意ください。このヘッダーが含まれていない場合、コピー操作は失敗し、DataProtectionTransformServiceError が返されます。

コピーの進行状況を追跡する

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

ターゲットモデル ID を追跡する

Get model API を使い、ターゲットモデルのクエリを実行することによって、操作の状態を追跡することもできます。「Generate copy authorization 要求」の応答からコピーしたターゲットモデル ID を使って、API を呼び出します。

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

応答本文には、モデルの詳細に関する情報が表示されます。 "status" フィールドでモデルの状態を確認します。

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

cURL サンプルコード

次のコードスニペットでは、cURL を使用して API 呼び出しを行います。ご自分のリソースに固有のモデル ID とサブスクリプション情報を入力する必要もあります。

コピーの認可を生成する

Request

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

成功応答

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

コピー操作を開始する

Request

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

成功応答

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

コピー操作の進行状況を追跡する

取得操作 API を使うと、Document Intelligence リソースに関連付けられているすべてのドキュメントモデル操作 (成功、進行中、または失敗) の一覧を表示できます。操作情報は 24 時間だけ保持されます。取得できる操作 (operationId) の一覧を次に示します。

documentModelBuild
documentModelCompose
documentModelCopyTo

ターゲットモデル ID を追跡する

操作が成功した場合は、getModel (1 つのモデルを取得) API または GetModels (モデルの一覧を取得) API を使って、ドキュメントモデルにアクセスできます。

コピー API の概要

カスタムモデルをコピーするプロセスは、次の手順で構成されています。

まず、ターゲットリソース、つまりコピーされたモデルを受け取るリソースに対してコピー認可要求を発行します。コピーされたモデルを受け取る新しく作成されたターゲットモデルの URL が返されます。
次に、ソースリソース (前の呼び出しから返されたペイロード (コピー承認) を持つ、コピーするモデルが含まれているリソース) にコピー要求を送信します。クエリを実行して操作の進行状況を追跡できる URL が返されます。
操作が成功するまで、ご自分のソースリソースの資格情報を使用して、進行状況の URL に対してクエリを実行します。また、ターゲットリソース内の新しいモデル ID に対してクエリを実行して、新しいモデルの状態を取得することもできます。

コピー承認要求を生成する

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}

要求本文

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

コピーを開始するために必要な JSON ペイロードを含む応答本文が追加された 200 応答コードを受信します。

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

コピー操作を開始する

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

要求の本文は、前の手順の応答です。

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

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

Note

コピーの進行状況を追跡する

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}

ターゲットモデル ID を追跡する

GET model API を使い、ターゲットモデルのクエリを実行することによって、操作の状態を追跡することもできます。「Generate Copy authorization 要求」の応答からコピーしたターゲットモデル ID を使って、API を呼び出します。

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

応答本文には、モデルの詳細に関する情報が表示されます。 "status" フィールドでモデルの状態を確認します。

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

cURL サンプルコード

コピーの認可を生成する

Request

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

成功応答

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

コピー操作を開始する

Request

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

成功応答

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

コピー操作の進行状況を追跡する

GET operation API を使うと、Document Intelligence リソースに関連付けられているすべてのドキュメントモデル操作 (成功、進行中、または失敗) の一覧を表示できます。操作情報は 24 時間だけ保持されます。取得できる操作 (operationId) の一覧を次に示します。

documentModelBuild
documentModelCompose
documentModelCopyTo

ターゲットモデル ID を追跡する

モデルの概要をコピーする

カスタムモデルをコピーするプロセスは、次の手順で構成されています。

まず、ターゲットリソース、つまりコピーされたモデルを受け取るリソースに対してコピー認可要求を発行します。コピーされたモデルを受け取る新しく作成されたターゲットモデルの URL が返されます。
次に、ソースリソース (前の呼び出しから返されたペイロード (コピー承認) を持つ、コピーするモデルが含まれているリソース) にコピー要求を送信します。クエリを実行して操作の進行状況を追跡できる URL が返されます。
操作が成功するまで、ご自分のソースリソースの資格情報を使用して、進行状況の URL に対してクエリを実行します。

認可要求を生成する

次の HTTP 要求は、ターゲットリソースからコピーの認可を生成します。ご自分のターゲットリソースのエンドポイントとキーをヘッダーとして入力する必要があります。

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

本文で modelId 値を含む 201\Created 応答を受信します。この文字列は、新しく作成された (空の) モデルの ID です。 accessToken は API がこのリソースにデータをコピーするために必要です。expirationDateTimeTicks の値はトークンの有効期限です。これら 3 つの値すべてを安全な場所に保存しておきます。

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}

コピー操作を開始する

次の HTTP 要求では、ソースリソースのコピー操作を開始します。ご自分のソースリソースのエンドポイントとキーをヘッダーとして入力する必要があります。コピーするソースモデルのモデル ID が要求 URL に含まれていることに注目してください。

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}

実際の要求の本文は、次の形式である必要があります。ご自分のターゲットリソースのリソース ID とリージョン名を入力する必要があります。リソース ID は、Azure portal のリソースの [プロパティ] タブにあります。リージョン名は [キーとエンドポイント] タブにあります。また、前の手順でコピーしたモデル ID、アクセストークン、有効期限の値も必要です。

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

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

Note

コピー API では、AEK/CMK 機能が透過的にサポートされます。この操作には特別な処理は必要ありませんが、暗号化されていないリソースと暗号化されたリソースの間でコピーを行う場合は、要求ヘッダー x-ms-forms-copy-degrade: true を含める必要があることに注意してください。このヘッダーが含まれていない場合、コピー操作は失敗し、DataProtectionTransformServiceError が返されます。

操作の進行状況を追跡する

ソースリソースエンドポイントに対して GET copy model result API のクエリを実行して、進行状況を追跡します。

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}

応答は操作の状態によって異なります。 JSON 本文内の "status" フィールドを探します。スクリプト内でこの API 呼び出しを自動化する場合は、1 秒ごとに操作に対してクエリを実行することをお勧めします。

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

modelID を使用して操作の状態を追跡する

GET custom model API を使い、ターゲットモデルのクエリを実行することによって、操作の状態を追跡することもできます。最初の手順でコピーしたターゲットモデル ID を使用して、この API を呼び出します。

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}

応答本文でモデルの詳細に関する情報を受信します。 "status" フィールドでモデルの状態を確認します。

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

cURL コードサンプル

コピーの認可を生成する

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

コピー操作を開始する

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

コピーの進行状況を追跡する

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

一般的なエラーコードメッセージ

エラー	解決策
400 / `"code:" "1002"` が指定された無効な要求	検証エラーまたはコピー要求の形式が正しくないことを示します。一般的な問題には次のようなものがあります。a) 無効または変更された `copyAuthorization` ペイロード。 b) `expirationDateTimeTicks` トークンの期限切れの値 (`copyAuthorization` ペイロードは 24 時間有効です)。 c) 無効またはサポートされていない `targetResourceRegion`。 d) 無効または形式が正しくない `targetResourceId` 文字列。
Authorization failure due to missing or invalid authorization claims (認可要求が見つからないか無効なため、認可エラーが発生しました)	`copyAuthorization` ペイロードまたはコンテンツが `copyAuthorization` API から変更されたときに発生します。ペイロードが、前の `copyAuthorization` の呼び出しから返されたものと確実にまったく同じ内容であるようにします。
Couldn't retrieve authorization metadata (認可メタデータを取得できませんでした)	`copyAuthorization` ペイロードがコピー要求で再利用されていることを示します。コピー要求が成功した場合、それ以上、同じ `copyAuthorization` ペイロードを使用する要求は許可されません。別のエラーが発生した後に、同じ認可ペイロードでコピーを再試行すると、このエラーが発生します。この解決策は、新しい `copyAuthorization` ペイロードを生成してから、コピー要求を再発行することです。
Data transfer request isn't allowed as it downgrades to a less secure data protection scheme (データ転送要求は、安全性の低いデータ保護スキームにダウングレードするため、許可されません)	`AEK` が有効なリソースと `AEK` が有効でないリソース間でコピーするときに発生します。暗号化されたモデルを暗号化されていない状態でターゲットにコピーできるようにするには、コピー要求で `x-ms-forms-copy-degrade: true` ヘッダーを指定します。
"Couldn't fetch information for Cognitive resource with ID..." (ID を持つ Cognitive リソースの情報をフェッチできませんでした...)	`targetResourceId` によって示される Azure リソースが有効な Cognitive リソースではない、または、存在しないことを示します。この問題を解決するには、コピー要求を確認して再発行します。リソースが有効であり、指定したリージョン (`westus2` など) に存在することを確認します

次のステップ

このガイドでは、コピー API を使用して、ご使用のカスタムモデルをセカンダリ Document Intelligence リソースにバックアップする方法について説明しました。次は、API リファレンスドキュメントを参照して、Document Intelligence を使用して他にできることを確認してください。

REST API リファレンスドキュメント

REST API リファレンスドキュメント

次の方法で共有

障害復旧

ビジネスシナリオ

前提条件

コピー API の概要

コピー承認要求を生成する

コピー操作を開始する

コピーの進行状況を追跡する

ターゲットモデル ID を追跡する

cURL サンプルコード

コピーの認可を生成する

コピー操作を開始する

コピー操作の進行状況を追跡する

ターゲットモデル ID を追跡する

コピー API の概要

コピー承認要求を生成する

コピー操作を開始する

コピーの進行状況を追跡する

ターゲットモデル ID を追跡する

cURL サンプルコード

コピーの認可を生成する

コピー操作を開始する

コピー操作の進行状況を追跡する

ターゲットモデル ID を追跡する

モデルの概要をコピーする

認可要求を生成する

コピー操作を開始する

操作の進行状況を追跡する

modelID を使用して操作の状態を追跡する

cURL コードサンプル

コピーの認可を生成する

コピー操作を開始する

コピーの進行状況を追跡する

一般的なエラーコードメッセージ

次のステップ

フィードバック

その他のリソース

次の方法で共有

障害復旧

ビジネス シナリオ

前提条件

コピー API の概要

コピー承認要求を生成する

コピー操作を開始する

コピーの進行状況を追跡する

ターゲット モデル ID を追跡する

cURL サンプル コード

コピーの認可を生成する

コピー操作を開始する

コピー操作の進行状況を追跡する

ターゲット モデル ID を追跡する

コピー API の概要

コピー承認要求を生成する

コピー操作を開始する

コピーの進行状況を追跡する

ターゲット モデル ID を追跡する

cURL サンプル コード

コピーの認可を生成する

コピー操作を開始する

コピー操作の進行状況を追跡する

ターゲット モデル ID を追跡する

モデルの概要をコピーする

認可要求を生成する

コピー操作を開始する

操作の進行状況を追跡する

modelID を使用して操作の状態を追跡する

cURL コード サンプル

コピーの認可を生成する

コピー操作を開始する

コピーの進行状況を追跡する

一般的なエラー コード メッセージ

次のステップ

フィードバック

その他のリソース

ビジネスシナリオ

ターゲットモデル ID を追跡する

cURL サンプルコード

ターゲットモデル ID を追跡する

ターゲットモデル ID を追跡する

cURL サンプルコード

ターゲットモデル ID を追跡する

cURL コードサンプル

一般的なエラーコードメッセージ