Delen via

Een back-up maken van uw aangepaste tekstclassificatiemodellen en deze herstellen

  • Artikel

Wanneer u een taalresource maakt, geeft u een regio op waarin deze moet worden gemaakt. Vanaf dat tijdstip vinden uw resource en alle gerelateerde bewerkingen plaats in de opgegeven Azure-serverregio. Het is zeldzaam, maar niet onmogelijk, om een netwerkprobleem te ondervinden dat een hele regio treft. Als uw oplossing altijd beschikbaar moet zijn, moet u deze ontwerpen voor een van beide failovers in een andere regio. Dit vereist twee Azure AI-taalresources in verschillende regio's en de mogelijkheid om aangepaste modellen tussen regio's te synchroniseren.

Als uw app of bedrijf afhankelijk is van het gebruik van een aangepast tekstclassificatiemodel, raden we u aan een replica van uw project te maken in een andere ondersteunde regio. Als er een regionale storing optreedt, hebt u vervolgens toegang tot uw model in de andere failoverregio waar u uw project hebt gerepliceerd.

Het repliceren van een project betekent dat u de metagegevens en assets van uw project exporteert en in een nieuw project importeert. Hiermee maakt u alleen een kopie van uw projectinstellingen en getagde gegevens. U moet nog steeds de modellen trainen en implementeren die beschikbaar zijn voor gebruik met voorspellings-API's.

In dit artikel leert u hoe u de API's voor exporteren en importeren kunt gebruiken om uw project te repliceren van de ene resource naar de andere die bestaat in verschillende ondersteunde geografische regio's, hoe u uw projecten gesynchroniseerd kunt houden en hoe u wijzigingen kunt aanbrengen in uw runtimeverbruik.

Vereisten

  • Twee Azure AI Language-resources in verschillende Azure-regio's. Maak een taalresource en verbind deze met een Azure-opslagaccount. Het is raadzaam om beide taalresources te verbinden met hetzelfde opslagaccount, maar dit kan leiden tot iets hogere latentie bij het importeren van uw project en het trainen van een model.

Het eindpunt van uw resourcesleutels ophalen

Gebruik de volgende stappen om de sleutels en het eindpunt van uw primaire en secundaire resources op te halen. Deze worden in de volgende stappen gebruikt.

  • Ga naar de overzichtspagina van uw resource in de Azure Portal

  • Selecteer sleutels en eindpunt in het menu aan de linkerkant. U gebruikt het eindpunt en de sleutel voor de API-aanvragen

Een schermopname van de sleutel- en eindpuntpagina in de Azure Portal.

Tip

Noteer sleutels en eindpunten voor zowel primaire als secundaire resources. Gebruik deze waarden om de volgende tijdelijke aanduidingen te vervangen: {PRIMARY-ENDPOINT}, {PRIMARY-RESOURCE-KEY}en {SECONDARY-RESOURCE-KEY}{SECONDARY-ENDPOINT} . Noteer ook uw projectnaam, modelnaam en implementatienaam. Gebruik deze waarden om de volgende tijdelijke aanduidingen te vervangen: {PROJECT-NAME}en {DEPLOYMENT-NAME}{MODEL-NAME} .

Uw primaire projectassets exporteren

Begin met het exporteren van de projectassets uit het project in uw primaire resource.

Exporttaak verzenden

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {PRIMARY-ENDPOINT} en {PRIMARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Maak een POST-aanvraag met behulp van de volgende URL, headers en JSON-hoofdtekst om uw project te exporteren.

Aanvraag-URL

Gebruik de volgende URL bij het maken van uw API-aanvraag. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam voor uw project. Deze waarde is hoofdlettergevoelig. MyProject
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is de nieuwste modelversie die is uitgebracht. 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Gebruik de volgende JSON in de aanvraagbody om aan te geven dat u alle assets wilt exporteren.

{
  "assetsToExport": ["*"]
}

Nadat u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat de taak correct is verzonden. Extraheer de waarde in de operation-location antwoordheaders. De indeling wordt als volgt weergegeven:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U gebruikt deze URL om de status van de exporttaak op te halen.

Status van exporttaak ophalen

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {PRIMARY-ENDPOINT} en {PRIMARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Gebruik de volgende GET-aanvraag om de status van het exporteren van uw projectassets op te halen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

Aanvraag-URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/export/jobs/{JOB-ID}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{JOB-ID} De id voor het zoeken naar de trainingsstatus van uw model. Dit staat in de location headerwaarde die u in de vorige stap hebt ontvangen. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van de reactie

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

Gebruik de URL van de resultUrl sleutel in de hoofdtekst om de geëxporteerde assets van deze taak weer te geven.

Exportresultaten ophalen

Dien een GET-aanvraag in met behulp van de {RESULT-URL} die u in de vorige stap hebt ontvangen om de resultaten van de exporttaak weer te geven.

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Kopieer de hoofdtekst van het antwoord zoals u deze gaat gebruiken als de hoofdtekst voor de volgende importtaak.

Importeren naar een nieuw project

Importeer nu de geëxporteerde projectassets in uw nieuwe project in de secundaire regio, zodat u deze kunt repliceren.

Importtaak verzenden

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Dien een POST-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om het labelbestand te importeren. Zorg ervoor dat het labelbestand de geaccepteerde indeling heeft.

Als er al een project met dezelfde naam bestaat, worden de gegevens van dat project vervangen.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/:import?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam voor uw project. Deze waarde is hoofdlettergevoelig. myProject
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst

Gebruik de volgende JSON in uw aanvraag. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectName": "{PROJECT-NAME}",
    "storageInputContainerName": "{CONTAINER-NAME}",
    "projectKind": "customMultiLabelClassification",
    "description": "Trying out custom multi label text classification",
    "language": "{LANGUAGE-CODE}",
    "multilingual": true,
    "settings": {}
  },
  "assets": {
    "projectKind": "customMultiLabelClassification",
    "classes": [
      {
        "category": "Class1"
      },
      {
        "category": "Class2"
      }
    ],
    "documents": [
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class1"
          },
          {
            "category": "Class2"
          }
        ]
      },
      {
        "location": "{DOCUMENT-NAME}",
        "language": "{LANGUAGE-CODE}",
        "dataset": "{DATASET}",
        "classes": [
          {
            "category": "Class2"
          }
        ]
      }
    ]
  }
}
Sleutel Tijdelijke aanduiding Waarde Voorbeeld
api-versie {API-VERSION} De versie van de API die u aanroept. De versie die hier wordt gebruikt, moet dezelfde API-versie in de URL zijn. Meer informatie over andere beschikbare API-versies 2022-05-01
projectNaam {PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
projectKind customMultiLabelClassification Uw project. customMultiLabelClassification
language {LANGUAGE-CODE} Een tekenreeks die de taalcode aangeeft voor de documenten die in uw project worden gebruikt. Als uw project een meertalig project is, kiest u de taalcode van het merendeel van de documenten. Zie Taalondersteuning voor meer informatie over meertalige ondersteuning. en-us
Meertalige true Een booleaanse waarde waarmee u documenten in meerdere talen in uw gegevensset kunt hebben. Wanneer uw model is geïmplementeerd, kunt u een query uitvoeren op het model in elke ondersteunde taal (niet noodzakelijkerwijs opgenomen in uw trainingsdocumenten). Zie Taalondersteuning voor meer informatie over meertalige ondersteuning. true
storageInputContainerName {CONTAINER-NAME} De naam van de Azure-opslagcontainer waarin u uw documenten hebt geüpload. myContainer
Klassen [] Matrix met alle klassen die u in het project hebt. Dit zijn de klassen waar u uw documenten in wilt classificeren. []
documenten [] Matrix met alle documenten in uw project en wat de klassen zijn gelabeld voor dit document. []
location {DOCUMENT-NAME} De locatie van de documenten in de opslagcontainer. Omdat alle documenten zich in de hoofdmap van de container bevinden, moet dit de naam van het document zijn. doc1.txt
Dataset {DATASET} De testset waarnaar dit document wordt opgegeven wanneer deze vóór de training wordt gesplitst. Zie Een model trainen voor meer informatie over het splitsen van gegevens. Mogelijke waarden voor dit veld zijn Train en Test. Train

Nadat u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat de taak correct is verzonden. Extraheer de waarde in de operation-location antwoordheaders. De indeling wordt als volgt weergegeven:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U gebruikt deze URL om de status van de importtaak op te halen.

Mogelijke foutscenario's voor deze aanvraag:

  • De geselecteerde resource heeft niet de juiste machtigingen voor het opslagaccount.
  • De storageInputContainerName opgegeven bestaat niet.
  • Er wordt ongeldige taalcode gebruikt of als het taalcodetype geen tekenreeks is.
  • multilingual waarde is een tekenreeks en geen booleaanse waarde.

Status van importtaak ophalen

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Gebruik de volgende GET-aanvraag om de status van het importeren van uw project op te halen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

Aanvraag-URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/import/jobs/{JOB-ID}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{JOB-ID} De id voor het zoeken naar de trainingsstatus van uw model. Deze waarde bevindt zich in de location headerwaarde die u in de vorige stap hebt ontvangen. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Uw model trainen

Nadat u uw project hebt geïmporteerd, hebt u alleen de assets en metagegevens en assets van het project gekopieerd. U moet uw model nog steeds trainen, waardoor uw account wordt gebruikt.

Trainingstaak verzenden

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Dien een POST-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om een trainingstaak in te dienen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/:train?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Aanvraagbody

Gebruik de volgende JSON in de hoofdtekst van uw aanvraag. Het model krijgt de zodra de {MODEL-NAME} training is voltooid. Alleen succesvolle trainingstaken produceren modellen.

{
	"modelLabel": "{MODEL-NAME}",
	"trainingConfigVersion": "{CONFIG-VERSION}",
	"evaluationOptions": {
		"kind": "percentage",
		"trainingSplitPercentage": 80,
		"testingSplitPercentage": 20
	}
}
Sleutel Tijdelijke aanduiding Waarde Voorbeeld
modelLabel {MODEL-NAME} De modelnaam die aan uw model wordt toegewezen zodra het is getraind. myModel
trainingConfigVersion {CONFIG-VERSION} Dit is de modelversie die wordt gebruikt om het model te trainen. 2022-05-01
evaluationOptions Optie voor het splitsen van uw gegevens over trainings- en testsets. {}
Soort percentage Splitsmethoden. Mogelijke waarden zijn percentage en manual. Zie Een model trainen voor meer informatie. percentage
trainingSplitPercentage 80 Percentage van uw getagde gegevens dat moet worden opgenomen in de trainingsset. De aanbevolen waarde is 80. 80
testingSplitPercentage 20 Percentage van uw getagde gegevens dat moet worden opgenomen in de testset. De aanbevolen waarde is 20. 20

Notitie

De trainingSplitPercentage en testingSplitPercentage zijn alleen vereist als Kind is ingesteld op percentage en de som van beide percentages gelijk moet zijn aan 100.

Nadat u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat de taak correct is verzonden. Extraheer de waarde in de location antwoordheaders. De indeling wordt als volgt weergegeven:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U kunt deze URL gebruiken om de trainingsstatus op te halen.

Trainingsstatus ophalen

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Gebruik de volgende GET-aanvraag om de status van de trainingsvoortgang van uw model op te halen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

Aanvraag-URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/train/jobs/{JOB-ID}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{JOB-ID} De id voor het zoeken naar de trainingsstatus van uw model. Deze waarde bevindt zich in de location headerwaarde die u in de vorige stap hebt ontvangen. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Zie Levenscyclus van modellen voor meer informatie over andere beschikbare API-versies. 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van antwoord

Nadat u de aanvraag hebt verzonden, krijgt u het volgende antwoord.

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

Uw model implementeren

Dit is de stap waarbij u het getrainde model beschikbaar maakt voor formulierverbruik via de voorspellings-API voor runtime.

Tip

Gebruik dezelfde implementatienaam als uw primaire project voor eenvoudiger onderhoud en minimale wijzigingen in uw systeem om het omleiden van uw verkeer te verwerken.

Implementatietaak verzenden

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Dien een PUT-aanvraag in met behulp van de volgende URL, headers en JSON-hoofdtekst om een implementatietaak in te dienen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{DEPLOYMENT-NAME} De naam van uw implementatie. Deze waarde is hoofdlettergevoelig. staging
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Aanvraagbody

Gebruik de volgende JSON in de hoofdtekst van uw aanvraag. Gebruik de naam van het model dat u wilt toewijzen aan de implementatie.

{
  "trainedModelLabel": "{MODEL-NAME}"
}
Sleutel Tijdelijke aanduiding Waarde Voorbeeld
trainedModelLabel {MODEL-NAME} De modelnaam die aan uw implementatie wordt toegewezen. U kunt alleen goed getrainde modellen toewijzen. Deze waarde is hoofdlettergevoelig. myModel

Nadat u uw API-aanvraag hebt verzonden, ontvangt u een 202 antwoord dat aangeeft dat de taak correct is verzonden. Extraheer de waarde in de operation-location antwoordheaders. De indeling wordt als volgt weergegeven:

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

{JOB-ID} wordt gebruikt om uw aanvraag te identificeren, omdat deze bewerking asynchroon is. U kunt deze URL gebruiken om de implementatiestatus op te halen.

De implementatiestatus ophalen

Vervang de tijdelijke aanduidingen in de volgende aanvraag door uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY} die u in de eerste stap hebt verkregen.

Gebruik de volgende GET-aanvraag om de status van de implementatietaak op te vragen. U kunt de URL gebruiken die u in de vorige stap hebt ontvangen of de tijdelijke aanduidingen hieronder vervangen door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam van uw project. Deze waarde is hoofdlettergevoelig. myProject
{DEPLOYMENT-NAME} De naam van uw implementatie. Deze waarde is hoofdlettergevoelig. staging
{JOB-ID} De id voor het zoeken naar de trainingsstatus van uw model. Dit staat in de location headerwaarde die u in de vorige stap hebt ontvangen. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van antwoord

Nadat u de aanvraag hebt verzonden, krijgt u het volgende antwoord. Blijf dit eindpunt pollen totdat de statusparameter verandert in 'geslaagd'. U moet een 200 code ophalen om het succes van de aanvraag aan te geven.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

Wijzigingen in het aanroepen van de runtime

Controleer in uw systeem bij de stap waar u de voorspellings-API voor runtime aanroept op de antwoordcode die is geretourneerd door de api voor het verzenden van taken. Als u een consistente fout ziet bij het indienen van de aanvraag, kan dit duiden op een storing in uw primaire regio. Een keer mislukken betekent niet dat er een storing is, het kan een tijdelijk probleem zijn. Probeer de taak opnieuw in te dienen via de secundaire resource die u hebt gemaakt. Gebruik voor de tweede aanvraag uw {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY}als u de bovenstaande stappen hebt gevolgd en {DEPLOYMENT-NAME} hetzelfde zou zijn, {PROJECT-NAME} zodat er geen wijzigingen nodig zijn in de aanvraagbody.

Als u teruggaat naar het gebruik van uw secundaire resource, neemt de latentie enigszins toe vanwege het verschil in regio's waar uw model is geïmplementeerd.

Controleren of uw projecten niet zijn gesynchroniseerd

Het behoud van de frisheid van beide projecten is een belangrijk onderdeel van het proces. U moet regelmatig controleren of er updates zijn aangebracht in uw primaire project, zodat u deze verplaatst naar uw secundaire project. Als uw primaire regio uitvalt en u naar de secundaire regio gaat, moet u vergelijkbare modelprestaties verwachten, omdat deze al de meest recente updates bevat. Het instellen van de frequentie van het controleren of uw projecten zijn gesynchroniseerd is een belangrijke keuze. We raden u aan deze controle dagelijks uit te voeren om ervoor te zorgen dat de gegevens in uw secundaire model actueel zijn.

Projectdetails ophalen

Gebruik de volgende URL om de projectgegevens op te halen. Een van de sleutels die in de hoofdtekst worden geretourneerd, geeft de laatste wijzigingsdatum van het project aan. Herhaal de volgende stap twee keer, één voor uw primaire project en een andere voor uw secundaire project en vergelijk de tijdstempel die voor beide wordt geretourneerd om te controleren of ze niet gesynchroniseerd zijn.

Gebruik de volgende GET-aanvraag om uw projectgegevens op te halen. Vervang de waarden van de tijdelijke aanduidingen hieronder door uw eigen waarden.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}?api-version={API-VERSION}
Tijdelijke aanduiding Waarde Voorbeeld
{ENDPOINT} Het eindpunt voor het verifiëren van uw API-aanvraag. https://<your-custom-subdomain>.cognitiveservices.azure.com
{PROJECT-NAME} De naam voor uw project. Deze waarde is hoofdlettergevoelig. myProject
{API-VERSION} De versie van de API die u aanroept. De waarde waarnaar hier wordt verwezen, is voor de meest recente versie die is uitgebracht. Meer informatie over andere beschikbare API-versies 2022-05-01

Kopteksten

Gebruik de volgende header om uw aanvraag te verifiëren.

Sleutel Waarde
Ocp-Apim-Subscription-Key De sleutel voor uw resource. Wordt gebruikt voor het verifiëren van uw API-aanvragen.

Hoofdtekst van de reactie

    {
        "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": "customMultiLabelClassification",
        "storageInputContainerName": "{CONTAINER-NAME}",
        "projectName": "{PROJECT-NAME}",
        "multilingual": false,
        "description": "Project description",
        "language": "{LANGUAGE-CODE}"
    }

Zodra u uw API-aanvraag hebt verzonden, ontvangt u een 200 antwoord dat aangeeft dat het is gelukt en de hoofdtekst van het JSON-antwoord met uw projectgegevens.

Herhaal dezelfde stappen voor het gerepliceerde project met behulp van {SECONDARY-ENDPOINT} en {SECONDARY-RESOURCE-KEY}. Vergelijk de geretourneerde lastModifiedDateTime van beide projecten. Als uw primaire project eerder is gewijzigd dan het secundaire project, moet u de stappen voor het exporteren, importeren, trainen en implementeren van uw model herhalen.

Volgende stappen

In dit artikel hebt u geleerd hoe u de API's voor exporteren en importeren gebruikt om uw project te repliceren naar een secundaire taalresource in een andere regio. Bekijk vervolgens de API-referentiedocumenten om te zien wat u nog meer kunt doen met het ontwerpen van API's.