Dela via

Kopiera och säkerhetskopiera dina Custom Vision-projekt

  • Artikel

När du har skapat och tränat ett Custom Vision-projekt kanske du vill kopiera projektet till en annan resurs. Om din app eller ditt företag är beroende av ett Custom Vision-projekt rekommenderar vi att du kopierar din modell till ett annat Custom Vision-konto i en annan region. Om ett regionalt avbrott inträffar kan du sedan komma åt projektet i den region där det kopierades.

API:erna ExportProject och ImportProject aktiverar det här scenariot genom att du kan kopiera projekt från ett Custom Vision-konto till andra. Den här guiden visar hur du använder dessa REST-API:er med cURL. Du kan också använda en HTTP-begärandetjänst, till exempel REST-klienten för Visual Studio Code, för att utfärda begäranden.

Dricks

Ett exempel på det här scenariot med python-klientbiblioteket finns i flytta Custom Vision Project-lagringsplatsen på GitHub.

Dricks

Om du vill flytta ditt Custom Vision-projekt till Azure AI Vision Image Analysis 4.0 kan du läsa migreringsguiden. Om du vill jämföra de två tjänsterna går du till sidan Jämförelse.

Förutsättningar

  • Två Azure AI Custom Vision-resurser. Om du inte har dem går du till Azure Portal och skapar en ny Custom Vision-resurs.
  • Träningsnycklarna och slutpunkts-URL:erna för dina Custom Vision-resurser. Du hittar dessa värden på resursens fliken Översikt på Azure Portal.
  • Ett skapat Custom Vision-projekt. Se Skapa en klassificerare för instruktioner om hur du gör detta.

Förstå processen

Processen för att kopiera ett projekt består av följande steg:

  1. Först får du ID:t för projektet i ditt källkonto som du vill kopiera.
  2. Sedan anropar du ExportProject-API :et med hjälp av projekt-ID:t och träningsnyckeln för ditt källkonto. Du får en tillfällig tokensträng.
  3. Sedan anropar du Api:et ImportProject med hjälp av tokensträngen och träningsnyckeln för målkontot. Projektet visas sedan under ditt målkonto.

Hämta projekt-ID

Anropa först GetProjects för att se en lista över dina befintliga Custom Vision-projekt och deras ID:n. Använd träningsnyckeln och slutpunkten för ditt källkonto.

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

Du får ett 200\OK svar med en lista över projekt och deras metadata i brödtexten. Värdet "id" är strängen som ska kopieras för nästa steg.

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

Exportera projektet

Anropa ExportProject med hjälp av projekt-ID:t och källträningsnyckeln och slutpunkten.

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

Du får ett 200/OK svar med metadata om det exporterade projektet och en referenssträng "token". Kopiera värdet för token.

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

Dricks

Om du får felet "Ogiltig token" när du importerar projektet kan det bero på att token-URL-strängen inte är webbkodad. Du kan koda token med hjälp av en URL-kodare.

Importera projektet

Anropa ImportProject med hjälp av målträningsnyckeln och slutpunkten, tillsammans med referenstoken. Du kan också ge projektet ett namn i det nya kontot.

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"

Du får ett 200/OK svar med metadata om ditt nyligen importerade projekt.

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

Gå vidare

I den här guiden har du lärt dig hur du kopierar och flyttar ett projekt mellan Custom Vision-resurser. Utforska sedan API-referensdokumenten för att se vad mer du kan göra med Custom Vision.

Referensdokumentation för REST API