Freigeben über

Models - Copy

Dienst:
Azure AI Services
API-Version:
v3.2-preview.2

Kopiert ein Modell von einem Abonnement in ein anderes.
Diese Methode kann verwendet werden, um ein Modell aus dieser Sprachressource in ein Ziel zu kopieren. Die Autorisierung wird für die Zielsprachressource abgerufen. Nur benutzerdefinierte Modelle können in eine andere Sprachressource kopiert werden.

POST {endpoint}/speechtotext/v3.2-preview.2/models/{id}:copy

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).
id
 path True

string (uuid)

Der Bezeichner des Modells, das kopiert wird.

Anforderungstext

Name Erforderlich Typ Beschreibung
expirationDateTime True

string (date-time)

Das Ablaufdatum dieser Kopierautorisierung.
id True

string

minLength: 1

Die ID dieser Kopierautorisierung.
sourceResourceId True

string

minLength: 1

Die Azure-Ressourcen-ID der Quellsprachressource.
targetResourceEndpoint True

string

minLength: 1

Der Endpunkt (Basis-URL) der Zielressource (mit benutzerdefiniertem Domänennamen, wenn er verwendet wird).
targetResourceId True

string

minLength: 1

Die Azure-Ressourcen-ID der Zielsprachressource.
targetResourceRegion True

string

minLength: 1

Die Region (auch bekannt als Standort) der Zielsprachressource (z. B. Westus2).

Antworten

Name Typ Beschreibung
202 Accepted

Operation

Die Antwort enthält Informationen zur Entität als Nutzlast und deren Position als Header.

Header

  • Retry-After: integer
  • Operation-Location: string
Other Status Codes

Error

Ein Fehler ist aufgetreten.

Sicherheit

Ocp-Apim-Subscription-Key

Stellen Sie hier Ihren kognitiven Leistungskontoschlüssel bereit.

Typ: apiKey
In: header

Authorization

Stellen Sie ein Zugriffstoken von JWT bereit, das vom STS dieser Region zurückgegeben wird. Stellen Sie sicher, dass Sie dem Token den Verwaltungsbereich hinzufügen, indem Sie der STS-URL die folgende Abfragezeichenfolge hinzufügen: ?scope=speechservicesmanagement

Typ: apiKey
In: header

Beispiele

Copy a model from source resource to target resource

Beispielanforderung

POST {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b:copy

{
  "targetResourceRegion": "westus2",
  "targetResourceId": "/subscriptions/targetSubscriptionId/resourceGroups/targetResourceGroupName/providers/Microsoft.CognitiveServices/accounts/targetSpeechResourceName",
  "targetResourceEndpoint": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models",
  "sourceResourceId": "/subscriptions/sourceSubscriptionId/resourceGroups/sourceResourceGroupName/providers/Microsoft.CognitiveServices/accounts/sourceSpeechResourceName",
  "expirationDateTime": "2019-01-07T11:34:12Z",
  "id": "d61573c6-788b-4eff-b3f5-38a1c7a9585b"
}

Beispiel für eine Antwort

Statuscode:
202 
Operation-Location: https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/operations/models/copy/E30F6A27-82BE-4CCA-9258-0399C70489FF
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/operations/models/copy/E30F6A27-82BE-4CCA-9258-0399C70489FF",
  "createdDateTime": "2019-01-07T11:34:12Z",
  "lastActionDateTime": "2019-01-07T11:34:12Z",
  "status": "NotStarted",
  "id": "e30f6a27-82be-4cca-9258-0399c70489ff"
}

Definitionen

Name Beschreibung
DetailedErrorCode

DetailedErrorCode
EntityError

EntityError
Error

Fehler
ErrorCode

Fehlercode
InnerError

InnerError
ModelCopyAuthorization

ModelCopyAuthorization
Operation

Vorgang
OperationResult

OperationResult
Status

Status

DetailedErrorCode

Enumeration

DetailedErrorCode

Wert Beschreibung
InvalidParameterValue

Ungültiger Parameterwert.
InvalidRequestBodyFormat

Ungültiges Anforderungstextformat.
EmptyRequest

Leere Anforderung.
MissingInputRecords

Fehlende Eingabedatensätze.
InvalidDocument

Ungültiges Dokument.
ModelVersionIncorrect

Modellversion falsch.
InvalidDocumentBatch

Ungültiger Dokumentbatch.
UnsupportedLanguageCode

Nicht unterstützter Sprachcode.
DataImportFailed

Fehler beim Datenimport.
InUseViolation

Verletzung des Einsatzes.
InvalidLocale

Ungültiges Gebietsschema.
InvalidBaseModel

Ungültiges Basismodell.
InvalidAdaptationMapping

Ungültige Anpassungszuordnung.
InvalidDataset

Ungültiges Dataset.
InvalidTest

Ungültiger Test.
FailedDataset

Fehler beim Dataset.
InvalidModel

Ungültiges Modell.
InvalidTranscription

Ungültige Transkription.
InvalidPayload

Ungültige Nutzlast.
InvalidParameter

Ungültiger Parameter.
EndpointWithoutLogging

Endpunkt ohne Protokollierung.
InvalidPermissions

Ungültige Berechtigungen.
InvalidPrerequisite

Ungültige Voraussetzung.
InvalidProductId

Ungültige Produkt-ID.
InvalidSubscription

Ungültiges Abonnement.
InvalidProject

Ungültiges Projekt.
InvalidProjectKind

Ungültige Projektart.
InvalidRecordingsUri

Ungültiger Aufzeichnungs-URI.
OnlyOneOfUrlsOrContainerOrDataset

Nur eine url oder ein Container oder Dataset.
ExceededNumberOfRecordingsUris

Die Anzahl der Aufzeichnungs-URIs wurde überschritten.
ModelMismatch

Modellkonflikt.
ProjectGenderMismatch

Projekt Gender-Mismatch.
ModelDeprecated

Das Modell ist veraltet.
ModelExists

Das Modell ist vorhanden.
ModelNotDeployable

Das Modell kann nicht bereitgestellt werden.
EndpointNotUpdatable

Endpunkt nicht aktualisierbar.
SingleDefaultEndpoint

Einzelner Standardendpunkt.
EndpointCannotBeDefault

Der Endpunkt kann nicht standardmäßig sein.
InvalidModelUri

Ungültiger Modell-URI.
SubscriptionNotFound

Das Abonnement wurde nicht gefunden.
QuotaViolation

Kontingentverletzung.
UnsupportedDelta

Nicht unterstütztes Delta.
UnsupportedFilter

Nicht unterstützter Filter.
UnsupportedPagination

Nicht unterstützte Paginierung.
UnsupportedDynamicConfiguration

Nicht unterstützte dynamische Konfiguration.
UnsupportedOrderBy

Nicht unterstützte Reihenfolge nach.
NoUtf8WithBom

Kein utf8 mit bom.
ModelDeploymentNotCompleteState

Der Status der Modellbereitstellung ist nicht abgeschlossen.
SkuLimitsExist

Sku-Grenzwerte sind vorhanden.
DeployingFailedModel

Fehler beim Bereitstellen des Modells.
UnsupportedTimeRange

Nicht unterstützter Zeitraum.
InvalidLogDate

Ungültiges Protokolldatum.
InvalidLogId

Ungültige Protokoll-ID.
InvalidLogStartTime

Ungültige Startzeit des Protokolls.
InvalidLogEndTime

Ungültige Protokollendzeit.
InvalidTopForLogs

Ungültiger Anfang für Protokolle.
InvalidSkipTokenForLogs

Ungültiges Skip-Token für Protokolle.
DeleteNotAllowed

Löschen nicht zulässig.
Forbidden

Verboten.
DeployNotAllowed

Bereitstellen nicht zulässig.
UnexpectedError

Unerwarteter Fehler.
InvalidCollection

Ungültige Auflistung.
InvalidCallbackUri

Ungültiger Rückruf-URI.
InvalidSasValidityDuration

Ungültige Gültigkeitsdauer für sas.
InaccessibleCustomerStorage

Nicht zugänglicher Kundenspeicher.
UnsupportedClassBasedAdaptation

Nicht unterstützte klassenbasierte Anpassung.
InvalidWebHookEventKind

Ungültiger Web hook-Ereignistyp.
InvalidTimeToLive

Ungültige Zeit für live.
InvalidSourceAzureResourceId

Ungültige Azure-Quellressourcen-ID.
ModelCopyOperationExists

Der Modellkopievorgang ist vorhanden.

EntityError

Objekt

EntityError

Name Typ Beschreibung
code

string

Der Code dieses Fehlers.
message

string

Die Meldung für diesen Fehler.

Error

Objekt

Fehler

Name Typ Beschreibung
code

ErrorCode

Fehlercode
Fehlercodes auf hoher Ebene.
details

Error[]

Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.
innerError

InnerError

InnerError
Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message

string

Fehlermeldung auf hoher Ebene.
target

string

Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

ErrorCode

Enumeration

Fehlercode

Wert Beschreibung
InvalidRequest

Stellt den ungültigen Anforderungsfehlercode dar.
InvalidArgument

Stellt den fehlercode für ungültiges Argument dar.
InternalServerError

Stellt den internen Fehlercode des Servers dar.
ServiceUnavailable

Stellt den dienst nicht verfügbaren Fehlercode dar.
NotFound

Stellt den nicht gefundenen Fehlercode dar.
PipelineError

Stellt den Pipelinefehlerfehlercode dar.
Conflict

Stellt den Konfliktfehlercode dar.
InternalCommunicationFailed

Fehlercode für die interne Kommunikation.
Forbidden

Stellt den verbotenen Fehlercode dar.
NotAllowed

Stellt den nicht zulässigen Fehlercode dar.
Unauthorized

Stellt den nicht autorisierten Fehlercode dar.
UnsupportedMediaType

Stellt den Fehlercode für den nicht unterstützten Medientyp dar.
TooManyRequests

Stellt den Fehlercode für zu viele Anforderungen dar.
UnprocessableEntity

Stellt den nicht verarbeiteten Entitätsfehlercode dar.

InnerError

Objekt

InnerError

Name Typ Beschreibung
code

DetailedErrorCode

DetailedErrorCode
Detaillierte Fehlercode-Enumeration.
details

object

Zusätzliche unterstützende Details zu den Fehler- und/oder erwarteten Richtlinien.
innerError

InnerError

InnerError
Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message

string

Fehlermeldung auf hoher Ebene.
target

string

Die Quelle des Fehlers. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

ModelCopyAuthorization

Objekt

ModelCopyAuthorization

Name Typ Beschreibung
expirationDateTime

string (date-time)

Das Ablaufdatum dieser Kopierautorisierung.
id

string

minLength: 1

Die ID dieser Kopierautorisierung.
sourceResourceId

string

minLength: 1

Die Azure-Ressourcen-ID der Quellsprachressource.
targetResourceEndpoint

string

minLength: 1

Der Endpunkt (Basis-URL) der Zielressource (mit benutzerdefiniertem Domänennamen, wenn er verwendet wird).
targetResourceId

string

minLength: 1

Die Azure-Ressourcen-ID der Zielsprachressource.
targetResourceRegion

string

minLength: 1

Die Region (auch bekannt als Standort) der Zielsprachressource (z. B. Westus2).

Operation

Objekt

Vorgang

Name Typ Beschreibung
createdDateTime

string (date-time)

Der Zeitstempel, zu dem das Objekt erstellt wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
error

EntityError

EntityError
id

string (uuid)

Der Bezeichner dieses Vorgangs.
lastActionDateTime

string (date-time)

Der Zeitstempel, zu dem der aktuelle Status eingegeben wurde. Der Zeitstempel wird als ISO 8601-Datums- und Uhrzeitformat codiert ("JJJJ-MM-DDThh:mm:ssZ", siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
result

OperationResult

OperationResult
self

string (uri)

Der Speicherort dieser Entität.
status

Status

Status
Beschreiben des aktuellen Status der API

OperationResult

Objekt

OperationResult

Name Typ Beschreibung
link

string (uri)

Die Verknüpfung mit dem Ergebnis des Vorgangs.

Status

Enumeration

Status

Wert Beschreibung
NotStarted

Der lange ausgeführte Vorgang wurde noch nicht gestartet.
Running

Der lange ausgeführte Vorgang wird zurzeit verarbeitet.
Succeeded

Der lange ausgeführte Vorgang wurde erfolgreich abgeschlossen.
Failed

Fehler beim vorgang mit langer Ausführung.