Olağanüstü durum kurtarma

Bu içerik şunlar için geçerlidir:v4.0 (önizleme) | Önceki sürümler:v3.1 (GA)v3.0 (GA)v2.1 (GA)

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ölgelerdeki en az iki Belge Yönetim Bilgileri kaynağı ve bölgeler arasında özel modelleri eşitleme olanağı gerekir.

Kopyalama API'si, desteklenen herhangi bir coğrafi bölgede mevcut olabilecek bir Belge Yönetim Bilgileri hesabından veya başkalarına özel modeller kopyalamanıza olanak tanıyarak bu senaryoyu etkinleştirir. Bu kılavuzda, rest API'yi cURL ile kopyalama işleminin nasıl kullanılacağı gösterilmektedir. İstekleri göndermek için bir HTTP istek hizmeti de kullanabilirsiniz.

İş 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

1. 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.
2. 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:

1. Ö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.
2. 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.
3. İş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 Model alma API'sini de kullanabilirsiniz. Kopyalama yetkilendirme isteği yanıtından kopyaladığınız hedef model kimliğini kullanarak API'yi çağırın.

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 operation 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.

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.

• REST API başvuru belgeleri