Поделиться через

Копирование и создание резервной копии проектов Пользовательского визуального распознавания

  • Статья

После создания и обучения проекта Пользовательское визуальное распознавание может потребоваться скопировать проект в другой ресурс. Если ваше приложение или бизнес зависит от проекта Пользовательское визуальное распознавание, рекомендуется скопировать модель в другую учетную запись Пользовательское визуальное распознавание в другом регионе. Тогда в случае регионального сбоя можно получить доступ к проекту в регионе, куда он был скопирован.

API-интерфейсы ExportProject и ImportProject позволяют копировать проекты из одной учетной записи службы «Пользовательское визуальное распознавание» в другие. Из этого руководства вы узнаете, как использовать эти REST API с cURL. Для выдачи запросов можно также использовать службу HTTP-запросов, например REST Client для Visual Studio Code.

Совет

Пример этого сценария с использованием клиентской библиотеки Python см. в репозитории Move Custom Vision Project (Перемещение проекта службы «Пользовательское визуальное распознавание») на сайте GitHub.

Совет

Если вы хотите переместить проект Пользовательское визуальное распознавание в Azure AI Vision Image Analysis 4.0, см. руководство по миграции. Чтобы сравнить две службы, см. страницу сравнения.

Необходимые компоненты

  • Два ресурса azure AI Пользовательское визуальное распознавание. Если у вас их нет, перейдите на портал Azure и создайте ресурс службы «Пользовательское визуальное распознавание».
  • Ключи обучения и URL-адреса конечных точек для ресурсов службы «Пользовательское визуальное распознавание». Эти значения находятся на вкладке Обзор ресурса на портале Azure.
  • Созданный проект службы «Пользовательское визуальное распознавание» Инструкции о том, как это сделать, см. в разделе Построение классификатора.

Обзор процесса

Процесс копирования проекта включает следующие этапы:

  1. Сначала требуется получить идентификатор проекта в своей исходной учетной записи, которую планируется скопировать.
  2. Затем вызывается API-интерфейс ExportProject с использованием идентификатора проекта и ключа обучения своей исходной учетной записи. Вы получаете строку временного маркера.
  3. Затем вызывается API-интерфейс ImportProject с использованием строки маркера и ключа обучения своей целевой учетной записи. Затем проект зачисляется в целевую учетную запись.

Получение идентификатора проекта

Сначала вызовите метод GetProjects, чтобы просмотреть список существующих проектов службы «Пользовательское визуальное распознавание» и их идентификаторов. Используйте ключ обучения и конечную точку своей исходной учетной записи.

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

Вы получите ответ 200\OK со списком проектов и их метаданными в тексте. Значение "id" представляет собой строку, которую необходимо скопировать для выполнения следующих шагов.

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

Экспорт проекта

Вызовите интерфейс ExportProject, используя идентификатор проекта, исходный ключ обучения и конечную точку.

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

Вы получите ответ 200/OK с метаданными об экспортированном проекте и строку ссылки "token". Скопируйте значение данного маркера.

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

Совет

Если при импорте проекта возникает ошибка «Недопустимый токен», возможно, строка URL-адреса токена не закодирована для передачи по сети. Для кодировки токена можно использовать Средство URL-кодирования.

Импорт проекта

Вызовите интерфейс ImportProject, используя целевой ключ обучения и конечную точку, а также маркер ссылки. Можно также присвоить проекту имя в новой учетной записи.

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"

Вы получите ответ 200/OK с метаданными о недавно импортированном проекте.

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

Следующие шаги

Из этого руководства вы узнали, как копировать и перемещать проект между ресурсами службы «Пользовательское визуальное распознавание». Далее предлагаем изучить справочную документацию по API, чтобы узнать о других возможностях Пользовательского визуального распознавания.