Custom Models - Copy

Dienst:

Azure AI Services

API-Version:

2.1

Kopieren Sie das benutzerdefinierte Modell, das in dieser Ressource (der Quelle) gespeichert ist, in das vom Benutzer angegebene Ziel Formularerkennung Ressource.

POST {endpoint}/formrecognizer/v2.1/custom/models/{modelId}/copy

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://westus2.api.cognitive.microsoft.com
modelId	path	True	string uuid	Modellbezeichner.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
copyAuthorization	True	CopyAuthorizationResult	Entität, die Ansprüche codiert, um die Kopieranforderung zu autorisieren.
targetResourceId	True	string	Azure-Ressourcen-ID der Zielressource Formularerkennung, in die das Modell kopiert wird.
targetResourceRegion	True	string	Speicherort der Azure-Zielressource. Ein gültiger Azure-Regionsname, der von Cognitive Services unterstützt wird.

Antworten

Name	Typ	Beschreibung
202 Accepted		Die Kopieranforderung wird erfolgreich in die Warteschlange gestellt. Header Operation-Location: string
Other Status Codes	ErrorResponse	Antwortentität, die nicht erfolgreiche Antworten begleitet, die zusätzliche Details zum Fehler enthält.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Copy custom model

Beispielanforderung

HTTP

POST {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8/copy


{
  "targetResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{resourceName}",
  "targetResourceRegion": "westus2",
  "copyAuthorization": {
    "modelId": "f973e3c1-1148-43bb-bea8-49d0603ab3a8",
    "accessToken": "{accessToken}",
    "expirationDateTimeTicks": 86400
  }
}

Beispiel für eine Antwort

Statuscode:

202

Operation-Location: {endpoint}/formrecognizer/v2.1/custom/models/f973e3c1-1148-43bb-bea8-49d0603ab3a8/copyResults/3b1e6c5b-e113-4114-ab6b-ce65dfe8050f

Definitionen

Name	Beschreibung
CopyAuthorizationResult	Anforderungsparameter, der Autorisierungsansprüche für den Kopiervorgang enthält.
CopyRequest	Fordern Sie den Parameter an, um ein vorhandenes benutzerdefiniertes Modell aus der Quellressource in eine Zielressource zu kopieren, auf die von der Ressourcen-ID verwiesen wird.
ErrorInformation
ErrorResponse

CopyAuthorizationResult

Anforderungsparameter, der Autorisierungsansprüche für den Kopiervorgang enthält.

Name	Typ	Beschreibung
accessToken	string	Tokenanspruch, der zum Autorisieren der Anforderung verwendet wird.
expirationDateTimeTicks	integer	Die Uhrzeit, zu der das Zugriffstoken abläuft. Das Datum wird als Anzahl der Sekunden ab 1970-01-01T0:0:0Z UTC bis zur Ablaufzeit dargestellt.
modelId	string	Modellbezeichner.

CopyRequest

Fordern Sie den Parameter an, um ein vorhandenes benutzerdefiniertes Modell aus der Quellressource in eine Zielressource zu kopieren, auf die von der Ressourcen-ID verwiesen wird.

Name	Typ	Beschreibung
copyAuthorization	CopyAuthorizationResult	Entität, die Ansprüche codiert, um die Kopieranforderung zu autorisieren.
targetResourceId	string	Azure-Ressourcen-ID der Zielressource Formularerkennung, in die das Modell kopiert wird.
targetResourceRegion	string	Speicherort der Azure-Zielressource. Ein gültiger Azure-Regionsname, der von Cognitive Services unterstützt wird.

ErrorInformation

Name	Typ	Beschreibung
code	string
message	string

ErrorResponse

Name	Typ	Beschreibung
error	ErrorInformation