Özel NER modellerinizi yedekleme ve kurtarma
Bir Dil kaynağı oluşturduğunuzda, kaynağın oluşturulacağı bölgeyi belirtirsiniz. Bundan sonra kaynağınız ve kaynağınızla ilgili tüm işlemler belirtilen Azure sunucu bölgesinde gerçekleşir. Bölgenin tamamını etkileyen bir ağ sorunuyla karşılaşmak nadirdir 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 üzere tasarlamanız gerekir. Bunun için farklı bölgelerdeki iki Azure AI Dili kaynağı ve bunlar arasında özel modellerin eşitlenmesi gerekir.
Uygulamanız veya işletmeniz özel bir NER modelinin kullanımına bağlıysa, projenizin çoğaltmasını desteklenen ek bir bölgede oluşturmanızı öneririz. Bölgesel bir kesinti oluşursa, modelinize projenizi çoğalttığınız diğer yük devretme bölgesinden erişebilirsiniz.
Projeyi çoğaltmak, proje meta verilerinizi ve varlıklarınızı dışarı aktarmanız ve bunları yeni bir projeye içeri aktarmanız anlamına gelir. Bu yalnızca proje ayarlarınızın ve etiketli verilerinizin bir kopyasını oluşturur. Tahmin API'leriyle kullanılabilir olacak modelleri eğitipdağıtmanız gerekir.
Bu makalede, projenizi bir kaynaktan desteklenen farklı coğrafi bölgelerde bulunan başka bir kaynağa çoğaltmak için dışarı ve içeri aktarma API'lerini kullanmayı, projelerinizi eşitlenmiş durumda tutma yönergelerini ve çalışma zamanı tüketiminize gereken değişiklikleri öğreneceksiniz.
Önkoşullar
- Farklı Azure bölgelerindeki iki Azure Yapay Zeka Dili kaynağı. Kaynaklarınızı oluşturun ve bir Azure depolama hesabına bağlayın. Dil kaynaklarınızın her birini farklı depolama hesaplarına bağlamanız önerilir. Her depolama hesabı, ayrı Dil kaynaklarınızın bulunduğu ilgili bölgelerde bulunmalıdır. Ek bir Dil kaynağı ve depolama hesabı oluşturmak için hızlı başlangıcı izleyebilirsiniz.
Kaynak anahtarlarınızın uç noktasını alma
Birincil ve ikincil kaynaklarınızın anahtarlarını ve uç noktasını almak için aşağıdaki adımları kullanın. Bunlar aşağıdaki adımlarda kullanılacaktır.
Azure portal kaynağınıza genel bakış sayfasına gidin
Sol taraftaki menüden Anahtarlar ve Uç Nokta'yı seçin. API istekleri için uç noktayı ve anahtarı kullanacaksınız
İpucu
Hem birincil hem de ikincil kaynakların yanı sıra birincil ve ikincil kapsayıcı adları için anahtarları ve uç noktaları not edin. Şu yer tutucuları değiştirmek için bu değerleri kullanın: {PRIMARY-ENDPOINT}, {PRIMARY-RESOURCE-KEY}, {PRIMARY-CONTAINER-NAME}, {SECONDARY-ENDPOINT}, {SECONDARY-RESOURCE-KEY}ve {SECONDARY-CONTAINER-NAME}.
Ayrıca proje adınızı, model adınızı ve dağıtım adınızı da not alın. Aşağıdaki yer tutucuları değiştirmek için şu değerleri kullanın: {PROJECT-NAME}, {MODEL-NAME} ve {DEPLOYMENT-NAME}.
Birincil proje varlıklarınızı dışarı aktarma
İlk olarak, birincil kaynağınızdaki projeden proje varlıklarını dışarı aktarın.
Dışarı aktarma işini gönder
Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {PRIMARY-RESOURCE-KEY} ile {PRIMARY-ENDPOINT} değiştirin.
Projenizi dışarı aktarmak için aşağıdaki URL, üst bilgiler ve JSON gövdesini kullanarak bir POST isteği oluşturun.
İstek URL’si
API isteğinizi oluştururken aşağıdaki URL'yi kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | MyProject |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son model sürümüdür . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Gövde
tüm varlıkları dışarı aktarmak istediğinizi belirterek istek gövdesinde aşağıdaki JSON'ı kullanın.
{
"assetsToExport": ["*"]
}
API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}
{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. Dışarı aktarma işinin durumunu almak için bu URL'yi kullanacaksınız.
Dışarı aktarma işi durumunu alma
Aşağıdaki istekteki yer tutucuları, ilk adımda aldığınız ve {PRIMARY-RESOURCE-KEY} ile {PRIMARY-ENDPOINT} değiştirin.
Proje varlıklarınızı dışarı aktarma durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.
İstek URL’si
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{JOB-ID} |
Modelinizin eğitim durumunu bulma kimliği. Bu, önceki adımda aldığınız üst bilgi değerindedir location . |
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Yanıt gövdesi
{
"resultUrl": "{RESULT-URL}",
"jobId": "string",
"createdDateTime": "2021-10-19T23:24:41.572Z",
"lastUpdatedDateTime": "2021-10-19T23:24:41.572Z",
"expirationDateTime": "2021-10-19T23:24:41.572Z",
"status": "unknown",
"errors": [
{
"code": "unknown",
"message": "string"
}
]
}
Bu işten dışarı aktarılan varlıkları görüntülemek için gövdedeki anahtarın URL'sini resultUrl kullanın.
Dışarı aktarma sonuçlarını alma
Dışarı aktarma işinin {RESULT-URL} sonuçlarını görüntülemek için önceki adımda aldığınız get isteğini gönderin.
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Yanıt gövdesini bir sonraki içeri aktarma işinin gövdesi olarak kullanacağınız şekilde kopyalayın.
Yeni projeye aktarma
Şimdi devam edin ve ikincil bölgedeki yeni projenizde dışarı aktarılan proje varlıklarını içeri aktararak çoğaltabilirsiniz.
İçeri aktarma işini gönderme
Aşağıdaki istekteki {SECONDARY-ENDPOINT}yer tutucuları, ilk adımda aldığınız , {SECONDARY-RESOURCE-KEY}ve {SECONDARY-CONTAINER-NAME} ile değiştirin.
Etiket dosyanızı içeri aktarmak için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Etiketler dosyanızın kabul edilen biçimi izlediğinden emin olun.
Aynı ada sahip bir proje zaten varsa, o projenin verileri değiştirilir.
{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Gövde
İsteğinizde aşağıdaki JSON'yi kullanın. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.
{
"projectFileVersion": "{API-VERSION}",
"stringIndexType": "Utf16CodeUnit",
"metadata": {
"projectName": "{PROJECT-NAME}",
"projectKind": "CustomEntityRecognition",
"description": "Trying out custom NER",
"language": "{LANGUAGE-CODE}",
"multilingual": true,
"storageInputContainerName": "{CONTAINER-NAME}",
"settings": {}
},
"assets": {
"projectKind": "CustomEntityRecognition",
"entities": [
{
"category": "Entity1"
},
{
"category": "Entity2"
}
],
"documents": [
{
"location": "{DOCUMENT-NAME}",
"language": "{LANGUAGE-CODE}",
"dataset": "{DATASET}",
"entities": [
{
"regionOffset": 0,
"regionLength": 500,
"labels": [
{
"category": "Entity1",
"offset": 25,
"length": 10
},
{
"category": "Entity2",
"offset": 120,
"length": 8
}
]
}
]
},
{
"location": "{DOCUMENT-NAME}",
"language": "{LANGUAGE-CODE}",
"dataset": "{DATASET}",
"entities": [
{
"regionOffset": 0,
"regionLength": 100,
"labels": [
{
"category": "Entity2",
"offset": 20,
"length": 5
}
]
}
]
}
]
}
}
| Anahtar | Yer tutucu | Değer | Örnek |
|---|---|---|---|
api-version |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada kullanılan sürümün URL'deki API sürümüyle aynı olması gerekir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinin | 2022-03-01-preview |
projectName |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
projectKind |
CustomEntityRecognition |
Proje türünüz. | CustomEntityRecognition |
language |
{LANGUAGE-CODE} |
Projenizde kullanılan belgelerin dil kodunu belirten bir dize. Projeniz çok dilli bir projeyse, belgelerin çoğunun dil kodunu seçin. | en-us |
multilingual |
true |
Veri kümenizde birden çok dilde belge olmasını sağlayan boole değeridir ve modeliniz dağıtıldığında modeli desteklenen herhangi bir dilde sorgulayabilirsiniz (eğitim belgelerinize dahil olması gerekmez). Çok dilli destek hakkında bilgi için bkz. dil desteği. | true |
storageInputContainerName |
{CONTAINER-NAME} | Belgelerinizi karşıya yüklediğiniz Azure depolama kapsayıcınızın adı. | myContainer |
entities |
Projede sahip olduğunuz tüm varlık türlerini içeren dizi. Bunlar, belgelerinizden içine ayıklanacak varlık türleridir. | ||
documents |
Projenizdeki tüm belgeleri ve her belge içinde etiketlenmiş varlıkların listesini içeren dizi. | [] | |
location |
{DOCUMENT-NAME} |
Depolama kapsayıcısında belgelerin konumu. Tüm belgeler kapsayıcının kökünde olduğundan, bu belge adı olmalıdır. | doc1.txt |
dataset |
{DATASET} |
Eğitimden önce bölündüğünde bu dosyanın gideceği test kümesi. Verilerinizin nasıl bölündüğü hakkında daha fazla bilgi için bkz. Modeli eğitme . Bu alanın olası değerleri ve Test'tirTrain. |
Train |
API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. İçeri aktarma işi durumunu almak için bu URL'yi kullanacaksınız.
Bu istek için olası hata senaryoları:
- Seçilen kaynağın depolama hesabı için uygun izinleri yok.
- Belirtilen
storageInputContainerNameyok. - Geçersiz dil kodu kullanılır veya dil kodu türü dize değilse.
-
multilingualdeğeri bir dizedir ve boole değeri değildir.
İçeri aktarma işi durumunu alma
Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Projenizi içeri aktarmanızın durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.
İstek URL’si
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{JOB-ID} |
Modelinizin eğitim durumunu bulma kimliği. Bu değer, önceki adımda aldığınız üst bilgi değerindedir location . |
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Modelinizi eğitme
Projenizi içeri aktardıktan sonra yalnızca projenin varlıklarını, meta verilerini ve varlıklarını kopyalamış olursunuz. Modelinizi eğitmeye devam etmeniz gerekir ve bu da hesabınızda kullanıma neden olur.
Eğitim işi gönderme
Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Bir eğitim işi göndermek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir POST isteği gönderin. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
İstek gövdesi
İstek gövdesinde aşağıdaki JSON'yi kullanın. Eğitim tamamlandıktan sonra modele {MODEL-NAME} verilir. Yalnızca başarılı eğitim işleri model üretir.
{
"modelLabel": "{MODEL-NAME}",
"trainingConfigVersion": "{CONFIG-VERSION}",
"evaluationOptions": {
"kind": "percentage",
"trainingSplitPercentage": 80,
"testingSplitPercentage": 20
}
}
| Anahtar | Yer tutucu | Değer | Örnek |
|---|---|---|---|
| modelLabel | {MODEL-NAME} |
Başarıyla eğitildikten sonra modelinize atanacak model adı. | myModel |
| trainingConfigVersion | {CONFIG-VERSION} |
Bu, modeli eğitmek için kullanılacak model sürümüdür . | 2022-05-01 |
| evaluationOptions | Verilerinizi eğitim ve test kümelerine bölme seçeneği. | {} |
|
| Tür | percentage |
Bölünmüş yöntemler. Olası değerler: percentage veya manual. Daha fazla bilgi için bkz. Modeli eğitme . |
percentage |
| trainingSplitPercentage | 80 |
Etiketli verilerinizin eğitim kümesine dahil edilecek yüzdesi. Önerilen değer: 80. |
80 |
| testingSplitPercentage | 20 |
Test kümesine eklenecek etiketli verilerinizin yüzdesi. Önerilen değer: 20. |
20 |
Not
trainingSplitPercentage ve testingSplitPercentage yalnızca olarak ayarlanırsa Kindpercentage gereklidir ve her iki yüzdenin toplamı 100'e eşit olmalıdır.
API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın location . Şu şekilde biçimlendirilir:
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. Eğitim durumunu almak için bu URL'yi kullanabilirsiniz.
Eğitim durumunu alma
Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Modelinizin eğitim ilerleme durumunu almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.
İstek URL’si
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{JOB-ID} |
Modelinizin eğitim durumunu bulma kimliği. Bu değer, önceki adımda aldığınız üst bilgi değerindedir location . |
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Yanıt Gövdesi
İsteği gönderdikten sonra aşağıdaki yanıtı alırsınız.
{
"result": {
"modelLabel": "{MODEL-NAME}",
"trainingConfigVersion": "{CONFIG-VERSION}",
"estimatedEndDateTime": "2022-04-18T15:47:58.8190649Z",
"trainingStatus": {
"percentComplete": 3,
"startDateTime": "2022-04-18T15:45:06.8190649Z",
"status": "running"
},
"evaluationStatus": {
"percentComplete": 0,
"status": "notStarted"
}
},
"jobId": "{JOB-ID}",
"createdDateTime": "2022-04-18T15:44:44Z",
"lastUpdatedDateTime": "2022-04-18T15:45:48Z",
"expirationDateTime": "2022-04-25T15:44:44Z",
"status": "running"
}
Modelinizi dağıtma
Bu, eğitilen modelinizi çalışma zamanı tahmin API'sini kullanarak kullanılabilir form tüketimine eklediğiniz adımdır.
İpucu
Trafiğinizi yeniden yönlendirmeyi işlemek için sisteminizde daha kolay bakım ve en az değişiklik yapmak için birincil projenizle aynı dağıtım adını kullanın.
Dağıtım işini gönderme
Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Bir dağıtım işi göndermek için aşağıdaki URL' yi, üst bilgileri ve JSON gövdesini kullanarak bir PUT isteği gönderin. Aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirin.
{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{DEPLOYMENT-NAME} |
Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır. | staging |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüm içindir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
İstek gövdesi
İsteğinizin gövdesinde aşağıdaki JSON kodunu kullanın. Dağıtıma atamak için modelin adını kullanın.
{
"trainedModelLabel": "{MODEL-NAME}"
}
| Anahtar | Yer tutucu | Değer | Örnek |
|---|---|---|---|
| trainedModelLabel | {MODEL-NAME} |
Dağıtımınıza atanacak model adı. Yalnızca başarıyla eğitilmiş modeller atayabilirsiniz. Bu değer büyük/küçük harfe duyarlıdır. | myModel |
API isteğinizi gönderdikten sonra işin doğru şekilde gönderildiğini belirten bir 202 yanıt alırsınız. Yanıt üst bilgilerinde değeri ayıklayın operation-location . Şu şekilde biçimlendirilir:
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
{JOB-ID} bu işlem zaman uyumsuz olduğundan isteğinizi tanımlamak için kullanılır. Dağıtım durumunu almak için bu URL'yi kullanabilirsiniz.
Dağıtım durumunu alma
Aşağıdaki istekteki yer tutucuları, ilk adımda edindiğiniz ve {SECONDARY-RESOURCE-KEY} ile {SECONDARY-ENDPOINT} değiştirin.
Dağıtım işinin durumunu sorgulamak için aşağıdaki GET isteğini kullanın. Önceki adımda aldığınız URL'yi kullanabilir veya aşağıdaki yer tutucu değerleri kendi değerlerinizle değiştirebilirsiniz.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{DEPLOYMENT-NAME} |
Dağıtımınızın adı. Bu değer büyük/küçük harfe duyarlıdır. | staging |
{JOB-ID} |
Modelinizin eğitim durumunu bulma kimliği. Bu, önceki adımda aldığınız üst bilgi değerindedir location . |
xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Yanıt Gövdesi
İsteği gönderdikten sonra aşağıdaki yanıtı alırsınız.
Durum parametresi "başarılı" olarak değişene kadar bu uç noktayı yoklamayı sürdürebilirsiniz. İsteğin başarısını belirten bir 200 kod almalısınız.
{
"jobId":"{JOB-ID}",
"createdDateTime":"{CREATED-TIME}",
"lastUpdatedDateTime":"{UPDATED-TIME}",
"expirationDateTime":"{EXPIRATION-TIME}",
"status":"running"
}
Çalışma zamanını çağırmadaki değişiklikler
Sisteminizde, çalışma zamanı tahmin API'sini çağırdığınız adımda, gönderme görevi API'sinden döndürülen yanıt kodunu denetleyin. İsteği gönderirken tutarlı bir hata gözlemlerseniz, bu birincil bölgenizde bir kesinti olduğunu gösterebilir. Bir kez başarısız olmak kesinti anlamına gelmez, geçici bir sorun olabilir. oluşturduğunuz ikincil kaynak aracılığıyla işi göndermeyi yeniden deneyin. İkinci istek için ve komutunu kullanın {SECONDARY-ENDPOINT}{SECONDARY-RESOURCE-KEY}. Yukarıdaki {PROJECT-NAME} adımları izlediyseniz ve {DEPLOYMENT-NAME} aynı olması durumunda istek gövdesinde değişiklik yapılması gerekmez.
İkincil kaynağınızı kullanmaya geri dönmeniz durumunda, modelinizin dağıtıldığı bölgelerdeki fark nedeniyle gecikme süresinde küçük bir artış gözlemlersiniz.
Projelerinizin eşitlenmemiş olup olmadığını denetleyin
Her iki projenin de güncelliğini korumak sürecin önemli bir parçasıdır. Birincil projenizde güncelleştirme yapılıp yapılmadığını sık sık denetlemeniz gerekir, böylece bunları ikincil projenize taşıyabilirsiniz. Bu şekilde birincil bölgeniz başarısız olursa ve ikincil bölgeye geçerseniz, zaten en son güncelleştirmeleri içerdiğinden benzer model performansı bekleyebilirsiniz. Projelerinizin eşitlenip eşitlenmediğini denetleme sıklığını ayarlamak önemli bir seçimdir. İkincil modelinizdeki verilerin güncelliğini garanti etmek için bu denetimi günlük olarak yapmanızı öneririz.
Proje ayrıntılarını alma
Proje ayrıntılarınızı almak için aşağıdaki URL'yi kullanın. Gövdede döndürülen anahtarlardan biri projenin son değiştirilme tarihini gösterir. Aşağıdaki adımı biri birincil projeniz, diğeri de ikincil projeniz için olmak üzere iki kez yineleyin ve her ikisi için de döndürülen zaman damgasını karşılaştırarak bunların eşitlenmemiş olup olmadığını denetleyin.
Proje ayrıntılarınızı almak için aşağıdaki GET isteğini kullanın. Aşağıdaki yer tutucu değerlerini kendi değerlerinizle değiştirin.
{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}?api-version={API-VERSION}
| Yer tutucu | Değer | Örnek |
|---|---|---|
{ENDPOINT} |
API isteğinizin kimliğini doğrulamak için uç nokta. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{PROJECT-NAME} |
Projenizin adı. Bu değer büyük/küçük harfe duyarlıdır. | myProject |
{API-VERSION} |
Çağırdığınız API'nin sürümü. Burada başvuruda bulunılan değer, yayınlanan en son sürüme yöneliktir. Diğer kullanılabilir API sürümleri hakkında daha fazla bilgi edinmek için bkz. Model yaşam döngüsü . | 2022-05-01 |
Üst Bilgiler
İsteğinizin kimliğini doğrulamak için aşağıdaki üst bilgiyi kullanın.
| Anahtar | Değer |
|---|---|
Ocp-Apim-Subscription-Key |
Kaynağınızın anahtarı. API isteklerinizin kimliğini doğrulamak için kullanılır. |
Yanıt gövdesi
{
"createdDateTime": "2021-10-19T23:24:41.572Z",
"lastModifiedDateTime": "2021-10-19T23:24:41.572Z",
"lastTrainedDateTime": "2021-10-19T23:24:41.572Z",
"lastDeployedDateTime": "2021-10-19T23:24:41.572Z",
"projectKind": "CustomEntityRecognition",
"storageInputContainerName": "{CONTAINER-NAME}",
"projectName": "{PROJECT-NAME}",
"multilingual": false,
"description": "Project description",
"language": "{LANGUAGE-CODE}"
}
ve {SECONDARY-RESOURCE-KEY}kullanarak {SECONDARY-ENDPOINT} çoğaltılan projeniz için aynı adımları yineleyin. Her iki projeden döndürüleni lastModifiedDateTime karşılaştırın. Birincil projeniz ikincil projenizden daha önce değiştirildiyse dışarı aktarma, içeri aktarma, eğitim ve dağıtma adımlarını yinelemeniz gerekir.
Sonraki adımlar
Bu makalede, projenizi başka bir bölgedeki ikincil bir Dil kaynağına çoğaltmak için dışarı ve içeri aktarma API'lerini kullanmayı öğrendiniz. Ardından, API'leri yazma ile başka neler yapabileceğinizi görmek için API başvuru belgelerini inceleyin.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin