Freigeben über

Kopieren benutzerdefinierter Analysatoren

Jede Inhaltsverständnisressource bietet standardmäßig Zugriff auf alle vordefinierten Analysegeräte. Eine vollständige Liste finden Sie unter vordefinierten Analysegeräten. Benutzerdefinierte Analysatoren sind Analysen, die Sie definieren, um bestimmte Inhalte zu verarbeiten, in denen Sie den Inhaltstyp, das Schema und jede andere Verarbeitungslogik definieren können. Weitere Informationen zum Definieren eines benutzerdefinierten Analyzers finden Sie unter Definieren eines benutzerdefinierten Analyzers.

Der Kopiervorgang für Analysegeräte unterstützt einige verschiedene Szenarien:

  • Kopieren Sie innerhalb einer Ressource, um eine Kopie eines vorhandenen Analysators in derselben Ressource als Sicherung oder als Version zu erstellen, an der Sie weiterarbeiten können.
  • Kopieren Sie alle Ressourcen , um eine Analyse von einer Foundry-Ressource in eine andere zu kopieren. Dies unterstützt Failover-Szenarien und das teamsübergreifende Teilen von Analysewerkzeugen.

Von Bedeutung

Der Kopiervorgang zum Kopieren über Ressourcen hinweg unterstützt das Kopieren von Analysetools über Abonnements und sogar Azure-Mandanten hinweg.

Kopieren innerhalb einer Foundry-Ressource

Der Kopiervorgang in einer Foundry-Ressource ist ein einzelstufiger Vorgang. Geben Sie die Zielanalyse-ID in der Anforderungs-URL an, und geben Sie die Quellanalyse-ID im Anforderungstext an.

POST https://{resource}.ai.azure.com/contentunderstanding/analyzers/{targetAnalyzer}:copy?api-version=2025-11-01
Content-Type: application/json
Ocp-Apim-Subscription-Key: {Auth key}

{
  "sourceAnalyzerId": "{sourceAnalyzerId}"

}

Kopieren über Foundry-Ressourcen

Das Kopieren eines Analyzers über Foundry-Ressourcen hinweg ist ein mehrstufiger Prozess, da ein Dienstprinzipal möglicherweise nicht über Berechtigungen für beide Ressourcen verfügt:

  1. Erhalten Sie eine Autorisierung zum Kopieren im Source Analyzer, indem Sie die vollständig qualifizierte Ressourcen-ID für das Kopierziel und die Zielregion angeben.
  2. Kopieren Sie die resultierende Antwort, und verwenden Sie sie als Textkörper der nächsten Anforderung.
  3. Stellen Sie eine Kopieranforderung für die Zielressource aus, indem Sie die vollqualifizierte Quellressource, die Quellanalyse-ID und die Region angeben.
POST https://{source resource}.services.ai.azure.com/contentunderstanding/analyzers/{source analyzer id}:grantCopyAuthorization?api-version=2025-11-01
Content-Type: application/json
Ocp-Apim-Subscription-Key: {Auth key}

{ 
  "targetAzureResourceId":"/subscriptions/{subscription guid}/resourceGroups/{resource group}/providers/Microsoft.CognitiveServices/accounts/{target resource}",
  "targetRegion":"{region}"
}


POST https://{target resource}.services.ai.azure.com/contentunderstanding/analyzers/{target analyzer id}:copy?api-version=2025-11-01
Content-Type: application/json
Ocp-Apim-Subscription-Key: {Auth key}

{
    "sourceAzureResourceId":"/subscriptions/{subscription guid}/resourceGroups/{resource group}/providers/Microsoft.CognitiveServices/accounts/{source resource}",
    "sourceAnalyzerId":"{source analyzer id}",
    "sourceRegion":"{region}"
}

Hinweis

Analysatoren unterstützen jetzt die Klassifizierung/Segmentierung und Analyse der einzelnen identifizierten Klassen und Segmente in einer einzigen Anforderung. Beim Kopieren eines Analyzers, der dieses Feature verwendet, müssen Sie auch alle referenzierten Analyzer kopieren.

Anschließend können Sie überprüfen, ob die Analyse kopiert wurde, indem Sie die GET-Analyse für die Ressource aufrufen, wenn sich diese Kopie innerhalb der Ressource befand, oder auf der Zielressource, wenn diese Kopie ressourcenübergreifend war.

GET https://{target resource}.services.ai.azure.com/contentunderstanding/analyzers/{target analyzer id}?api-version=2025-11-01
Ocp-Apim-Subscription-Key: {Auth key}
  • Last updated on