Megosztás a következőn keresztül:

Azure Storage integrálása értesítésekhez és biztonsági mentéshez

  • Cikk

A Custom Vision-projektet integrálhatja egy Azure Blob Storage-üzenetsorsal, hogy leküldéses értesítéseket kapjon a projektbetanítási/exportálási tevékenységről. Ez a funkció hasznos, ha elkerüli a szolgáltatás folyamatos lekérdezését az eredményekhez, ha hosszú műveletek futnak. Ehelyett integrálhatja a tárolási üzenetsor-értesítéseket a munkafolyamatba.

Az Azure Storage használatával is tárolhatja a közzétett modellek biztonsági másolatait.

Ez az útmutató bemutatja, hogyan használhatja ezeket a REST API-kat a cURL használatával. A kérelmeket HTTP-kérési szolgáltatással is elvégezheti, például a Visual Studio Code REST-ügyfelét .

Feljegyzés

A leküldéses értesítések a CreateProject API opcionális notificationQueueUri paraméterétől függenek, és a modell biztonsági mentéséhez az opcionális exportModelContainerUri paramétert is használnia kell. Ez az útmutató mindkettőt a funkciók teljes készletéhez fogja használni.

Előfeltételek

Azure Storage-integráció beállítása

Nyissa meg a Custom Vision betanítási erőforrását az Azure Portalon, válassza ki az Identitás lapot, és engedélyezze a rendszer által hozzárendelt felügyelt identitást.

Ezután nyissa meg a tárerőforrást az Azure Portalon. Lépjen a Hozzáférés-vezérlés (IAM) lapra, és válassza a Szerepkör-hozzárendelés hozzáadása (előzetes verzió) lehetőséget. Ezután adjon hozzá egy szerepkör-hozzárendelést az integrációs funkcióhoz, vagy mindkettőhöz:

  • Ha a modell biztonsági mentési funkcióját szeretné használni, válassza ki a Storage Blob Data Közreműködő szerepkört, és adja hozzá tagként a Custom Vision betanítási erőforrását. Válassza a Véleményezés + hozzárendelés elemet a befejezéshez.
  • Ha az értesítési üzenetsor funkció használatát tervezi, válassza ki a Storage Queue Data Közreműködő szerepkört, és adja hozzá tagként a Custom Vision betanítási erőforrását. Válassza a Véleményezés + hozzárendelés elemet a befejezéshez.

A szerepkör-hozzárendelésekkel kapcsolatos segítségért lásd: Azure-szerepkörök hozzárendelése az Azure Portal használatával.

Integrációs URL-címek lekérése

Ezután lekérheti azokat az URL-címeket, amelyek lehetővé teszik a Custom Vision-erőforrás számára ezeknek a végpontoknak a elérését.

Az értesítési üzenetsor integrációs URL-címéhez lépjen a tárfiók Üzenetsorok lapjára, adjon hozzá egy új üzenetsort, és mentse az URL-címét egy ideiglenes helyre.

Azure Storage-üzenetsor oldala

A modell biztonsági mentési integrációs URL-címéhez lépjen a tárfiók Tárolók lapjára, és hozzon létre egy új tárolót. Ezután jelölje ki, és lépjen a Tulajdonságok lapra. Másolja az URL-címet egy ideiglenes helyre.

Azure Storage-tároló tulajdonságainak lapja

Custom Vision-projekt integrálása

Most, hogy rendelkezik az integrációs URL-címekkel, létrehozhat egy új Custom Vision-projektet, amely integrálja az Azure Storage funkcióit. A funkciók hozzáadásához egy meglévő projektet is frissíthet.

Amikor meghívja a CreateProject API-t, adja hozzá az exportModelContainerUri és a notificationQueueUri opcionális paramétereit. Rendelje hozzá az előző szakaszban kapott URL-értékeket.

curl -v -X POST "{endpoint}/customvision/v3.3/Training/projects?exportModelContainerUri={inputUri}&notificationQueueUri={inputUri}&name={inputName}"
-H "Training-key: {subscription key}"

Ha választ kap 200/OK , az azt jelenti, hogy az URL-címek sikeresen be lettek állítva. Az URL-értékeket a JSON-válaszban is látnia kell:

{
  "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": {}
},
"exportModelContainerUri": {url}
"notificationQueueUri": {url}
  },
  "created": "string",
  "lastModified": "string",
  "thumbnailUri": "string",
  "drModeEnabled": true,
  "status": "Succeeded"
}

A kapcsolat ellenőrzése

Az előző szakaszban szereplő API-hívásnak már új információkat kellett volna aktiválnia az Azure Storage-fiókjában.

A kijelölt tárolóban egy tesztblobnak kell lennie egy CustomVision-TestPermission mappában. Ez a blob csak ideiglenesen fog létezni.

Az értesítési üzenetsorban egy tesztértesítésnek a következő formátumban kell megjelennie:

{
"version": "1.0" ,
"type": "ConnectionTest",
"Content":
    {
    "projectId": "00000000-0000-0000-0000-000000000000"
    }
}

Eseményértesítések lekérése

Ha készen áll, hívja meg a Projekt TrainProject API-t egy szokásos betanítási művelet végrehajtásához.

A Storage értesítési üzenetsorában a betanítás befejezése után értesítést kap:

{
"version": "1.0" ,
"type": "Training",
"Content":
    {
    "projectId": "00000000-0000-0000-0000-000000000000",
    "iterationId": "00000000-0000-0000-0000-000000000000",
    "trainingStatus": "TrainingCompleted"
    }
}

A "trainingStatus" mező lehet vagy "TrainingCompleted""TrainingFailed". A "iterationId" mező a betanított modell azonosítója.

Modellexportálási biztonsági másolatok lekérése

Ha készen áll, hívja meg az ExportIteration API-t, hogy exportáljon egy betanított modellt egy megadott platformra.

A kijelölt tárolóban megjelenik az exportált modell biztonsági másolata. A blobnév formátuma a következő lesz:

{projectId} - {iterationId}.{platformType}

Emellett értesítést fog kapni az üzenetsorban, amikor az exportálás befejeződik.

{
"version": "1.0" ,
"type": "Export",
"Content":
    {
    "projectId": "00000000-0000-0000-0000-000000000000",
    "iterationId": "00000000-0000-0000-0000-000000000000",
    "exportStatus": "ExportCompleted",
    "modelUri": {url}
    }
}

A "exportStatus" mező lehet vagy "ExportCompleted""ExportFailed". A "modelUri" mező tartalmazza a tárolóban tárolt biztonsági mentési modell URL-címét, feltéve, hogy az elején integrálta az üzenetsor-értesítéseket. Ha nem tette meg, a mező megjeleníti "modelUri" a Custom Vision-modell blob SAS URL-címét.

Következő lépések

Ebben az útmutatóban megtanulta, hogyan másolhat és készíthet biztonsági másolatot egy projektről a Custom Vision-erőforrások között. Ezután ismerkedjen meg az API referencia-dokumentumaival, és nézze meg, mit tehet még a Custom Vision használatával.