Olağanüstü durum kurtarma
Bu içerik şunlar için geçerlidir: 
v3.1 (GA) | En son sürüm:
v4.0 (önizleme) | Önceki sürümler: 
v3.0 v2.1
Bu içerik şunlar için geçerlidir: v3.0 (GA) | En son sürümler: v4.0 (önizleme) v3.1 | Önceki sürüm: v2.1
Bu içerik şunlar için geçerlidir: v2.1 | En son sürüm: v4.0 (önizleme)
Azure portalında bir Belge Yönetim Bilgileri kaynağı oluşturduğunuzda bir bölge belirtirsiniz. Bundan sonra kaynağınız ve tüm işlemleri ilgili Azure sunucu bölgesiyle ilişkilendirildi. Tüm bölgeyi etkileyen bir ağ sorunuyla karşılaşma ihtimali çok az olsa da ancak imkansız değildir. Çözümünüzün her zaman kullanılabilir olması gerekiyorsa çözümü başka bir bölgeye yük devretmek veya iş yükünü iki veya daha fazla bölgeye bölecek şekilde tasarlamanız gerekir. Her iki yaklaşım için de farklı bölgelerde en az iki Belge Yönetim Bilgileri kaynağı ve bölgeler arasında özel modelleri ve sınıflandırıcıları eşitleme olanağı gerekir.
Kopyalama API'si, özel modelleri ve sınıflandırıcıları bir Belge Yönetim Bilgileri hesabından veya desteklenen herhangi bir coğrafi bölgede mevcut olabilecek diğer kullanıcılara kopyalamanıza olanak tanıyarak bu senaryoyu etkinleştirir. Bu kılavuzda, özel modeller için cURL ile REST API kopyalama özelliğinin nasıl kullanılacağı gösterilmektedir. İstekleri göndermek için bir HTTP istek hizmeti de kullanabilirsiniz.
Not
API'den 2024-07-31-preview başlayarak, özel sınıflandırma modelleri Kopyalama API'sini de destekler. Bu kılavuzda özellikle modelleri kopyalamak için özel modeller kullanılır. Sınıflandırıcı modeli kopyası için bu kılavuzu izleyin.
İş senaryoları
Uygulamanız veya işletmeniz Bir Belge Yönetim Bilgileri özel modelinin kullanımına bağlıysa, modelinizi başka bir bölgedeki başka bir Belge Yönetim Bilgileri hesabına kopyalamanızı öneririz. Bölgesel bir kesinti oluşursa modelinize kopyalandığı bölgeden erişebilirsiniz.
Önkoşullar
- Farklı Azure bölgelerindeki iki Belge Zekası Azure kaynağı. Bu kaynaklara sahip değilseniz Azure portalına gidin ve yeni bir Belge Zekası kaynağı oluşturun.
- Belge Yönetim Bilgileri kaynağınızın anahtarı, uç nokta URL'si ve abonelik kimliği. Bu değerleri Kaynağın Azure portalındaki Genel Bakış sekmesinde bulabilirsiniz.
KOPYALAMA API'lerine genel bakış
Özel modeli kopyalama işlemi aşağıdaki adımlardan oluşur:
- Önce hedef kaynağa, yani kopyalanan modeli alan kaynağa bir kopyalama yetkilendirme isteği gönderirsiniz. Kopyalanan modeli alan yeni oluşturulan hedef modelin URL'sini geri alırsınız.
- Daha sonra, kopyalama isteğini önceki çağrıdan döndürülen yük (kopyalama yetkilendirmesi) ile kopyalanacak modeli içeren kaynak olan kaynak kaynağına gönderirsiniz. İşlemin ilerleme durumunu izlemek için sorgulayabileceğiniz bir URL'yi geri alırsınız.
- İşlem başarılı olana kadar ilerleme URL'sini sorgulamak için kaynak kaynak kimlik bilgilerinizi kullanırsınız. Yeni modelin durumunu almak için hedef kaynaktaki yeni model kimliğini de sorgulayabilirsiniz.
Kopyalama yetkilendirme isteği oluşturma
Aşağıdaki HTTP isteği, hedef kaynağınızdan kopyalama yetkilendirmesini alır. Hedef kaynağınızın uç noktasını ve anahtarını üst bilgi olarak girmeniz gerekir.
POST https://<your-resource-endpoint>/documentintelligence/documentModels:authorizeCopy?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}
Request body
{
"modelId": "target-model-name",
"description": "Copied from SCUS"
}
Kopyayı başlatmak için gereken JSON yükünü içeren yanıt gövdesine sahip bir 200 yanıt kodu alırsınız.
{
"targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
"targetResourceRegion": "region",
"targetModelId": "target-model-name",
"targetModelLocation": "model path",
"accessToken": "access token",
"expirationDateTime": "timestamp"
}
Kopyalama işlemini başlatma
Aşağıdaki HTTP isteği, kaynak kaynakta kopyalama işlemini başlatır. Kaynak kaynağınızın uç noktasını ve anahtarını URL ve üst bilgi olarak girmeniz gerekir. İstek URL'sinin kopyalamak istediğiniz kaynak modelin model kimliğini içerdiğine dikkat edin.
POST https://<your-resource-endpoint>/documentintelligence/documentModels/{modelId}:copyTo?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}
İsteğinizin gövdesi, önceki adımda verilen yanıttır.
{
"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 üst bilgisiyle bir yanıt alırsınız 202\Accepted . Bu değer, işlemin ilerleme durumunu izlemek için kullandığınız URL'dir. Sonraki adım için geçici bir konuma kopyalayın.
HTTP/1.1 202 Accepted
Operation-Location: https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{operation-id}?api-version=2024-02-29-preview
Not
Kopyalama API'si , AEK/CMK özelliğini saydam olarak destekler. Bu herhangi bir özel işlem gerektirmez, ancak şifrelenmemiş bir kaynak arasında şifrelenmiş bir kaynağa kopyalama işlemi yaparsanız istek üst bilgisini x-ms-forms-copy-degrade: trueeklemeniz gerektiğini unutmayın. Bu üst bilgi dahil değilse kopyalama işlemi başarısız olur ve döndürür DataProtectionTransformServiceError.
Kopyalama ilerleme durumunu izleme
GET https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{<operation-id>}?api-version=2024-02-29-preview
Ocp-Apim-Subscription-Key: {<your-key>}
Hedef model kimliğini izleme
Hedef modeli sorgulayarak işlemin durumunu izlemek için API'yi de kullanabilirsiniz Get model . İstek yanıtından kopyaladığınız hedef model kimliğini kullanarak API'yi çağırın.Generate copy authorization
GET https://<your-resource-endpoint>/documentintelligence/documentModels/{modelId}?api-version=2024-02-29-preview" -H "Ocp-Apim-Subscription-Key: <your-key>
Yanıt gövdesinde model hakkındaki bilgileri görürsünüz. Modelin "status" durumu için alanı denetleyin.
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 örnek kodu
Aşağıdaki kod parçacıkları API çağrıları yapmak için cURL kullanır. Ayrıca model kimliklerini ve kendi kaynaklarınıza özgü abonelik bilgilerini de doldurmanız gerekir.
Kopyalama yetkilendirmesi oluşturma
İste
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}'
}"
Başarılı yanıt
{
"targetResourceId": "string",
"targetResourceRegion": "string",
"targetModelId": "string",
"targetModelLocation": "string",
"accessToken": "string",
"expirationDateTime": "string"
}
Kopyalamayı Başlat işlemi
İste
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}'
}"
Başarılı yanıt
HTTP/1.1 202 Accepted
Operation-Location: https://<your-resource-endpoint>.cognitiveservices.azure.com/documentintelligence/operations/{operation-id}?api-version=2024-02-29-preview
Kopyalama işleminin ilerleme durumunu izleme
Get işlemi API'sini kullanarak Belge Yönetim Bilgileri kaynağınızla ilişkili tüm belge modeli işlemlerini (başarılı, devam eden veya başarısız) listeleyebilirsiniz. İşlem bilgileri yalnızca 24 saat boyunca kalır. Döndürülebilecek işlemlerin (operationId) listesi aşağıdadır:
- documentModelBuild
- documentModelCompose
- documentModelCopyTo
Hedef model kimliğini izleme
İşlem başarılı olursa, belge modeline getModel (tek bir model alma) veya GetModels (modellerin listesini alma) API'leri kullanılarak erişilebilir.
KOPYALAMA API'lerine genel bakış
Özel modeli kopyalama işlemi aşağıdaki adımlardan oluşur:
- Önce hedef kaynağa, yani kopyalanan modeli alan kaynağa bir kopyalama yetkilendirme isteği gönderirsiniz. Kopyalanan modeli alan yeni oluşturulan hedef modelin URL'sini geri alırsınız.
- Daha sonra, kopyalama isteğini önceki çağrıdan döndürülen yük (kopyalama yetkilendirmesi) ile kopyalanacak modeli içeren kaynak olan kaynak kaynağına gönderirsiniz. İşlemin ilerleme durumunu izlemek için sorgulayabileceğiniz bir URL'yi geri alırsınız.
- İşlem başarılı olana kadar ilerleme URL'sini sorgulamak için kaynak kaynak kimlik bilgilerinizi kullanırsınız. Yeni modelin durumunu almak için hedef kaynaktaki yeni model kimliğini de sorgulayabilirsiniz.
Kopyalama yetkilendirme isteği oluşturma
Aşağıdaki HTTP isteği, hedef kaynağınızdan kopyalama yetkilendirmesini alır. Hedef kaynağınızın uç noktasını ve anahtarını üst bilgi olarak girmeniz gerekir.
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}
Request body
{
"modelId": "target-model-name",
"description": "Copied from SCUS"
}
Kopyayı başlatmak için gereken JSON yükünü içeren yanıt gövdesine sahip bir 200 yanıt kodu alırsınız.
{
"targetResourceId": "/subscriptions/{targetSub}/resourceGroups/{targetRG}/providers/Microsoft.CognitiveServices/accounts/{targetService}",
"targetResourceRegion": "region",
"targetModelId": "target-model-name",
"targetModelLocation": "model path",
"accessToken": "access token",
"expirationDateTime": "timestamp"
}
Kopyalama işlemini başlatma
Aşağıdaki HTTP isteği, kaynak kaynakta kopyalama işlemini başlatır. Kaynak kaynağınızın uç noktasını ve anahtarını URL ve üst bilgi olarak girmeniz gerekir. İstek URL'sinin kopyalamak istediğiniz kaynak modelin model kimliğini içerdiğine dikkat edin.
POST {{source-endpoint}}formrecognizer/documentModels/{model-to-be-copied}:copyTo?api-version=2023-07-31
Ocp-Apim-Subscription-Key: {SOURCE_FORM_RECOGNIZER_RESOURCE_KEY}
İsteğinizin gövdesi, önceki adımda verilen yanıttır.
{
"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 üst bilgisiyle bir yanıt alırsınız 202\Accepted . Bu değer, işlemin ilerleme durumunu izlemek için kullandığınız URL'dir. Sonraki adım için geçici bir konuma kopyalayın.
HTTP/1.1 202 Accepted
Operation-Location: https://{source-resource}.cognitiveservices.azure.com/formrecognizer/operations/{operation-id}?api-version=2023-07-31
Not
Kopyalama API'si , AEK/CMK özelliğini saydam olarak destekler. Bu herhangi bir özel işlem gerektirmez, ancak şifrelenmemiş bir kaynak arasında şifrelenmiş bir kaynağa kopyalama işlemi yaparsanız istek üst bilgisini x-ms-forms-copy-degrade: trueeklemeniz gerektiğini unutmayın. Bu üst bilgi dahil değilse kopyalama işlemi başarısız olur ve döndürür DataProtectionTransformServiceError.
Kopyalama ilerleme durumunu izleme
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}
Hedef model kimliğini izleme
Hedef modeli sorgulayarak işlemin durumunu izlemek için API'yi de kullanabilirsiniz GET model . İstek yanıtından kopyaladığınız hedef model kimliğini kullanarak API'yi çağırın.Generate Copy authorization
GET https://{YOUR-ENDPOINT}/formrecognizer/documentModels/{modelId}?api-version=2023-07-31" -H "Ocp-Apim-Subscription-Key: <YOUR-KEY>
Yanıt gövdesinde model hakkındaki bilgileri görürsünüz. Modelin "status" durumu için alanı denetleyin.
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 örnek kodu
Aşağıdaki kod parçacıkları API çağrıları yapmak için cURL kullanır. Ayrıca model kimliklerini ve kendi kaynaklarınıza özgü abonelik bilgilerini de doldurmanız gerekir.
Kopyalama yetkilendirmesi oluşturma
İste
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}'
}"
Başarılı yanıt
{
"targetResourceId": "string",
"targetResourceRegion": "string",
"targetModelId": "string",
"targetModelLocation": "string",
"accessToken": "string",
"expirationDateTime": "string"
}
Kopyalamayı Başlat işlemi
İste
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}'
}"
Başarılı yanıt
HTTP/1.1 202 Accepted
Operation-Location: https://{source-resource}.cognitiveservices.azure.com/formrecognizer/operations/{operation-id}?api-version=2023-07-31
Kopyalama işleminin ilerleme durumunu izleme
API'yi GET operation kullanarak Belge Yönetim Bilgileri kaynağınızla ilişkili tüm belge modeli işlemlerini (başarılı, devam eden veya başarısız) listeleyebilirsiniz. İşlem bilgileri yalnızca 24 saat boyunca kalır. Döndürülebilecek işlemlerin (operationId) listesi aşağıdadır:
- documentModelBuild
- documentModelCompose
- documentModelCopyTo
Hedef model kimliğini izleme
İşlem başarılı olursa, belge modeline getModel (tek bir model alma) veya GetModels (modellerin listesini alma) API'leri kullanılarak erişilebilir.
Modeli kopyalamaya genel bakış
Özel modeli kopyalama işlemi aşağıdaki adımlardan oluşur:
- Önce hedef kaynağa, yani kopyalanan modeli alan kaynağa bir kopyalama yetkilendirme isteği gönderirsiniz. Kopyalanan modeli alan yeni oluşturulan hedef modelin URL'sini geri alırsınız.
- Daha sonra, kopyalama isteğini önceki çağrıdan döndürülen yük (kopyalama yetkilendirmesi) ile kopyalanacak modeli içeren kaynak olan kaynak kaynağına gönderirsiniz. İşlemin ilerleme durumunu izlemek için sorgulayabileceğiniz bir URL'yi geri alırsınız.
- İşlem başarılı olana kadar ilerleme URL'sini sorgulamak için kaynak kaynak kimlik bilgilerinizi kullanırsınız.
Yetkilendirme isteği oluşturma
Aşağıdaki HTTP isteği, hedef kaynağınızdan bir kopyalama yetkilendirmesi oluşturur. Hedef kaynağınızın uç noktasını ve anahtarını üst bilgi olarak girmeniz gerekir.
POST https://{TARGET_FORM_RECOGNIZER_RESOURCE_ENDPOINT}/formrecognizer/v2.1/custom/models/copyAuthorization
Ocp-Apim-Subscription-Key: {TARGET_FORM_RECOGNIZER_RESOURCE_KEY}
Gövdede değeri 201\Created olan bir modelId yanıt alırsınız. Bu dize, yeni oluşturulan (boş) modelin kimliğidir. API'nin accessToken bu kaynağa veri kopyalaması için gereklidir ve expirationDateTimeTicks değer belirtecin süre sonudur. Bu değerlerin üçünü de güvenli bir konuma kaydedin.
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}
Kopyalama işlemini başlatma
Aşağıdaki HTTP isteği, kaynak kaynakta Kopyalama işlemini başlatır. Kaynak kaynağınızın uç noktasını ve anahtarını üst bilgi olarak girmeniz gerekir. İstek URL'sinin kopyalamak istediğiniz kaynak modelin model kimliğini içerdiğine dikkat edin.
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}
İsteğinizin gövdesinin aşağıdaki biçime sahip olması gerekir. Hedef kaynağınızın kaynak kimliğini ve bölge adını girmeniz gerekir. Kaynak kimliğinizi Azure portalındaki kaynağınızın Özellikler sekmesinde, bölge adını ise Anahtarlar ve uç nokta sekmesinde bulabilirsiniz. Ayrıca önceki adımdan kopyaladığınız model kimliği, erişim belirteci ve süre sonu değeri de gerekir.
{
"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}
}
Operation-Location üst bilgisiyle bir yanıt alırsınız 202\Accepted . Bu değer, işlemin ilerleme durumunu izlemek için kullandığınız URL'dir. Sonraki adım için geçici bir konuma kopyalayın.
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
Not
Kopyalama API'si , AEK/CMK özelliğini saydam olarak destekler. Bu işlem herhangi bir özel işlem gerektirmez, ancak şifrelenmemiş bir kaynak arasında şifrelenmiş bir kaynağa kopyalama işlemi yaparsanız istek üst bilgisini x-ms-forms-copy-degrade: trueeklemeniz gerektiğini unutmayın. Bu üst bilgi dahil değilse kopyalama işlemi başarısız olur ve döndürür DataProtectionTransformServiceError.
İşlemin ilerleme durumunu izleme
API'yi kaynak kaynak uç noktasına karşı sorgulayarak GET copy model result ilerlemenizi izleyin.
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}
Yanıt, işlemin durumuna bağlı olarak değişir. JSON gövdesindeki alanı arayın "status" . Bu API çağrısını bir betikte otomatikleştiriyorsanız, işlemi saniyede bir sorgulamanızı öneririz.
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 ile işlem durumunu izleme
Hedef modeli sorgulayarak işlemin durumunu izlemek için API'yi de kullanabilirsiniz GET custom model . İlk adımda kopyaladığınız hedef model kimliğini kullanarak bu API'yi çağırın.
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}
Yanıt gövdesinde model hakkında bilgi alırsınız. Modelin "status" durumu için alanı denetleyin.
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 kod örnekleri
Aşağıdaki kod parçacıkları API çağrıları yapmak için cURL kullanır. Ayrıca model kimliklerini ve kendi kaynaklarınıza özgü abonelik bilgilerini de doldurmanız gerekir.
Kopyalama yetkilendirmesi oluşturma
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}"
Kopyalama işlemini başlatma
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}"}"
Kopyalama ilerleme durumunu izleme
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}"
Yaygın hata kodu iletileri
| Hata | Çözüm |
|---|---|
400 / Hatalı İstek "code:" "1002" |
Doğrulama hata veya hatalı biçimlendirilmiş kopyalama isteğini gösterir. Yaygın sorunlar şunlardır: a) Geçersiz veya değiştirilmiş copyAuthorization yük. b) Belirteç için expirationDateTimeTicks süresi dolan değer (copyAuthorization yük 24 saat geçerlidir). c) Geçersiz veya desteklenmeyen targetResourceRegion. d) Geçersiz veya hatalı biçimlendirilmiş targetResourceId dize. |
| Eksik veya geçersiz yetkilendirme talepleri nedeniyle yetkilendirme hatası. | Yük veya içerik API'den copyAuthorization değiştirildiğinde copyAuthorization gerçekleşir. Yükün önceki copyAuthorization çağrıdan döndürülen içerikle aynı olduğundan emin olun. |
| Yetkilendirme meta verileri alınamadı. | Yükün copyAuthorization bir kopyalama isteğiyle yeniden kullanılmakta olduğunu gösterir. Başarılı olan bir kopyalama isteği, aynı copyAuthorization yükü kullanan başka isteklere izin vermez. Ayrı bir hata oluşturursanız ve daha sonra kopyayı aynı yetkilendirme yüküyle yeniden denerseniz, bu hata oluşur. Çözüm, yeni copyAuthorization bir yük oluşturmak ve ardından kopyalama isteğini yeniden göndermektir. |
| Veri aktarımı isteği daha az güvenli bir veri koruma düzenine indirildikçe izin verilmez. | Etkin bir kaynak arasında etkin olmayan AEK bir AEK kaynağa kopyalama sırasında gerçekleşir. Şifrelenmiş modelin hedefe şifrelenmemiş olarak kopyalanmasını sağlamak için, kopyalama isteğiyle üst bilgi belirtin x-ms-forms-copy-degrade: true . |
| "Kimlikli Bilişsel kaynak için bilgi getirilemedi...". | tarafından targetResourceId belirtilen Azure kaynağının geçerli bir Bilişsel kaynak olmadığını veya mevcut olmadığını gösterir. Bu sorunu çözmek için kopyalama isteğini doğrulayın ve yeniden yayımın.Kaynağın geçerli olduğundan ve belirtilen bölgede bulunduğundan emin olun, örneğin, westus2 |
Sonraki adımlar
Bu kılavuzda, özel modellerinizi ikincil bir Belge Yönetim Bilgileri kaynağına yedeklemek için Kopyalama API'sini kullanmayı öğrendiniz. Ardından, Belge Zekası ile başka neler yapabileceğinizi görmek için API başvuru belgelerini inceleyin.
Bu kılavuzda, özel modellerinizi ikincil bir Belge Yönetim Bilgileri kaynağına yedeklemek için Kopyalama API'sini kullanmayı öğrendiniz. Ardından, Belge Zekası ile başka neler yapabileceğinizi görmek için API başvuru belgelerini inceleyin.