Uw Custom Vision-projecten kopiëren en er een back-up van maken

Artikel
09/02/2024

Nadat u een Custom Vision-project hebt gemaakt en getraind, kunt u het project naar een andere resource kopiëren. Als uw app of bedrijf afhankelijk is van een Custom Vision-project, raden we u aan uw model te kopiëren naar een ander Custom Vision-account in een andere regio. Als er vervolgens een regionale storing optreedt, hebt u toegang tot uw project in de regio waar het is gekopieerd.

Met de ExportProject- en ImportProject-API's kunt u dit scenario inschakelen door projecten van het ene Custom Vision-account naar andere te kopiëren. Deze handleiding laat zien hoe u deze REST API's gebruikt met cURL. U kunt ook een HTTP-aanvraagservice, zoals de REST-client voor Visual Studio Code, gebruiken om de aanvragen uit te geven.

Tip

Zie de opslagplaats Custom Vision-project verplaatsen op GitHub voor een voorbeeld van dit scenario met behulp van de Python-clientbibliotheek.

Tip

Als u uw Custom Vision-project wilt verplaatsen naar Azure AI Vision-afbeeldingsanalyse 4.0, raadpleegt u de migratiehandleiding. Als u de twee services wilt vergelijken, raadpleegt u de pagina Vergelijking.

Vereisten

Twee Azure AI Custom Vision-resources. Als u deze niet hebt, gaat u naar Azure Portal en maakt u een nieuwe Custom Vision-resource.
De trainingssleutels en eindpunt-URL's van uw Custom Vision-resources. U vindt deze waarden op het tabblad Overzicht van de resource in Azure Portal.
Een gemaakt Custom Vision-project. Zie Een classificatie bouwen voor instructies over hoe u dit doet.

PowerShell versie 6.0+ of een vergelijkbaar opdrachtregelprogramma.

Procesoverzicht

Het proces voor het kopiëren van een project bestaat uit de volgende stappen:

Eerst krijgt u de id van het project in uw bronaccount dat u wilt kopiëren.
Vervolgens roept u de ExportProject-API aan met behulp van de project-id en de trainingssleutel van uw bronaccount. U krijgt een tijdelijke tokentekenreeks.
Vervolgens roept u de ImportProject-API aan met behulp van de tokentekenreeks en de trainingssleutel van uw doelaccount. Het project wordt vervolgens vermeld onder uw doelaccount.

De project-id ophalen

Roep GetProjects eerst aan om een lijst met uw bestaande Custom Vision-projecten en hun id's weer te geven. Gebruik de trainingssleutel en het eindpunt van uw bronaccount.

curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects"
-H "Training-key: {training key}"

U krijgt een 200\OK antwoord met een lijst met projecten en hun metagegevens in de hoofdtekst. De "id" waarde is de tekenreeks die moet worden gekopieerd voor de volgende stappen.

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string",
    "settings": {
      "domainId": "00000000-0000-0000-0000-000000000000",
      "classificationType": "Multiclass",
      "targetExportPlatforms": [
        "CoreML"
      ],
      "useNegativeSet": true,
      "detectionParameters": "string",
      "imageProcessingSettings": {
        "augmentationMethods": {}
      }
    },
    "created": "string",
    "lastModified": "string",
    "thumbnailUri": "string",
    "drModeEnabled": true,
    "status": "Succeeded"
  }
]

Het project exporteren

Roep ExportProject aan met behulp van de project-id en uw brontrainingssleutel en -eindpunt.

curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects/{projectId}/export"
-H "Training-key: {training key}"

U krijgt een 200/OK antwoord met metagegevens over het geëxporteerde project en een referentietekenreeks "token". Kopieer de waarde van het token.

{
  "iterationCount": 0,
  "imageCount": 0,
  "tagCount": 0,
  "regionCount": 0,
  "estimatedImportTimeInMS": 0,
  "token": "string"
}

Tip

Als er een fout 'Ongeldig token' wordt weergegeven wanneer u uw project importeert, kan het zijn dat de token-URL-tekenreeks niet is gecodeerd via het web. U kunt het token coderen met behulp van een URL-coderingsprogramma.

Het project importeren

Roep ImportProject aan met behulp van uw doeltrainingssleutel en eindpunt, samen met het referentietoken. U kunt uw project ook een naam geven in het nieuwe account.

curl -v -G -X POST "{endpoint}/customvision/v3.3/Training/projects/import"
--data-urlencode "token={token}" --data-urlencode "name={name}"
-H "Training-key: {training key}" -H "Content-Length: 0"

U krijgt een 200/OK antwoord met metagegevens over uw zojuist geïmporteerde project.

{
  "id": "00000000-0000-0000-0000-000000000000",
  "name": "string",
  "description": "string",
  "settings": {
    "domainId": "00000000-0000-0000-0000-000000000000",
    "classificationType": "Multiclass",
    "targetExportPlatforms": [
      "CoreML"
    ],
    "useNegativeSet": true,
    "detectionParameters": "string",
    "imageProcessingSettings": {
      "augmentationMethods": {}
    }
  },
  "created": "string",
  "lastModified": "string",
  "thumbnailUri": "string",
  "drModeEnabled": true,
  "status": "Succeeded"
}

Volgende stappen

In deze handleiding hebt u geleerd hoe u een project kopieert en verplaatst tussen Custom Vision-resources. Bekijk vervolgens de API-referentiedocumenten om te zien wat u nog meer kunt doen met Custom Vision.

REST API-referentiedocumentatie

Delen via