Partager via


Models - List Files

Obtient les fichiers du modèle identifiés par l’ID donné.

GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files?sasValidityInSeconds={sasValidityInSeconds}&skip={skip}&top={top}&filter={filter}

Paramètres URI

Nom Dans Obligatoire Type Description
endpoint
path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).

id
path True

string

uuid

Identificateur du modèle.

filter
query

string

Expression de filtrage permettant de sélectionner un sous-ensemble des fichiers disponibles.

        - Supported properties: name, createdDateTime, kind.

        - Operators:

          - eq, ne are supported for all properties.

          - gt, ge, lt, le are supported for createdDateTime.

          - and, or, not are supported.

        - Example:

          filter=name eq 'myaudio.wav' and kind eq 'Audio'
sasValidityInSeconds
query

integer

int32

Durée en secondes pendant laquelle une URL SAP doit être valide. La durée par défaut est de 12 heures. Lors de l’utilisation de BYOS () :https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/speech-encryption-of-data-at-rest#bring-your-own-storage-byos-for-customization-and-logging la valeur 0 signifie qu’un URI d’objet blob simple sans jeton SAP est généré.

skip
query

integer

int32

Nombre de jeux de données qui seront ignorés.

top
query

integer

int32

Nombre de jeux de données qui seront inclus après l’ignorer.

Réponses

Nom Type Description
200 OK

PaginatedFiles

Ok

En-têtes

Retry-After: integer

Other Status Codes

Error

Une erreur est survenue.

Sécurité

Ocp-Apim-Subscription-Key

Fournissez la clé de votre compte Cognitive Services ici.

Type: apiKey
Dans: header

Authorization

Fournissez un jeton d’accès à partir du JWT retourné par le STS de cette région. Veillez à ajouter l’étendue de gestion au jeton en ajoutant la chaîne de requête suivante à l’URL STS : ?scope=speechservicesmanagement

Type: apiKey
Dans: header

Exemples

Get all files

Exemple de requête

GET {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files?sasValidityInSeconds=120&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z

Exemple de réponse

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "report.json",
      "kind": "ModelReport",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/report.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}

Définitions

Nom Description
DetailedErrorCode

DetailedErrorCode

Error

Erreur

ErrorCode

ErrorCode

File

Fichier

FileKind

FileKind

FileLinks

FileLinks

FileProperties

FileProperties

InnerError

InnerError

PaginatedFiles

PaginatedFiles

DetailedErrorCode

DetailedErrorCode

Nom Type Description
DataImportFailed

string

Échec de l’importation des données.

DeleteNotAllowed

string

Supprimer non autorisé.

DeployNotAllowed

string

Déploiement non autorisé.

DeployingFailedModel

string

Déploiement d’un modèle ayant échoué.

EmptyRequest

string

Requête vide.

EndpointCannotBeDefault

string

Le point de terminaison ne peut pas être par défaut.

EndpointNotUpdatable

string

Point de terminaison non modifiable.

EndpointWithoutLogging

string

Point de terminaison sans journalisation.

ExceededNumberOfRecordingsUris

string

Nombre d’URI d’enregistrements dépassé.

FailedDataset

string

Échec du jeu de données.

Forbidden

string

Interdit.

InUseViolation

string

Violation en cours d’utilisation.

InaccessibleCustomerStorage

string

Stockage client inaccessible.

InvalidAdaptationMapping

string

Mappage d’adaptation non valide.

InvalidBaseModel

string

Modèle de base non valide.

InvalidCallbackUri

string

URI de rappel non valide.

InvalidCollection

string

Collection non valide.

InvalidDataset

string

Jeu de données non valide.

InvalidDocument

string

Document non valide.

InvalidDocumentBatch

string

Lot de documents non valide.

InvalidLocale

string

Paramètres régionaux non valides.

InvalidLogDate

string

Date de journal non valide.

InvalidLogEndTime

string

Heure de fin du journal non valide.

InvalidLogId

string

ID de journal non valide.

InvalidLogStartTime

string

Heure de début du journal non valide.

InvalidModel

string

Modèle non valide.

InvalidModelUri

string

URI de modèle non valide.

InvalidParameter

string

Paramètre non valide.

InvalidParameterValue

string

Valeur de paramètre non valide.

InvalidPayload

string

Charge utile non valide.

InvalidPermissions

string

Autorisations non valides.

InvalidPrerequisite

string

Prérequis non valides.

InvalidProductId

string

ID de produit non valide.

InvalidProject

string

Projet non valide.

InvalidProjectKind

string

Type de projet non valide.

InvalidRecordingsUri

string

URI des enregistrements non valides.

InvalidRequestBodyFormat

string

Format du corps de la demande non valide.

InvalidSasValidityDuration

string

Durée de validité de sas non valide.

InvalidSkipTokenForLogs

string

Jeton d’ignorer non valide pour les journaux.

InvalidSourceAzureResourceId

string

ID de ressource Azure source non valide.

InvalidSubscription

string

Abonnement non valide.

InvalidTest

string

Test non valide.

InvalidTimeToLive

string

Durée de vie non valide.

InvalidTopForLogs

string

Top non valide pour les journaux.

InvalidTranscription

string

Transcription non valide.

InvalidWebHookEventKind

string

Type d’événement web hook non valide.

MissingInputRecords

string

Enregistrements d’entrée manquants.

ModelCopyOperationExists

string

L’opération de copie de modèle existe.

ModelDeploymentNotCompleteState

string

État non terminé du déploiement du modèle.

ModelDeprecated

string

Modèle déconseillé.

ModelExists

string

Le modèle existe.

ModelMismatch

string

Incompatibilité du modèle.

ModelNotDeployable

string

Modèle non déployable.

ModelVersionIncorrect

string

Version du modèle incorrecte.

NoUtf8WithBom

string

Pas de utf8 avec bom.

OnlyOneOfUrlsOrContainerOrDataset

string

Une seule des URL, conteneur ou jeu de données.

ProjectGenderMismatch

string

Projet d’incompatibilité entre les sexes.

QuotaViolation

string

Violation de quota.

SingleDefaultEndpoint

string

Point de terminaison par défaut unique.

SkuLimitsExist

string

Des limites de référence SKU existent.

SubscriptionNotFound

string

Abonnement introuvable.

UnexpectedError

string

Erreur inattendue.

UnsupportedClassBasedAdaptation

string

Adaptation basée sur les classes non prise en charge.

UnsupportedDelta

string

Delta non pris en charge.

UnsupportedDynamicConfiguration

string

Configuration dynamique non prise en charge.

UnsupportedFilter

string

Filtre non pris en charge.

UnsupportedLanguageCode

string

Code de langue non pris en charge.

UnsupportedOrderBy

string

Commande non prise en charge par.

UnsupportedPagination

string

Pagination non prise en charge.

UnsupportedTimeRange

string

Intervalle de temps non pris en charge.

Error

Erreur

Nom Type Description
code

ErrorCode

ErrorCode
Codes d’erreur de haut niveau.

details

Error[]

Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.

innerError

InnerError

InnerError
Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).

message

string

Message d’erreur de haut niveau.

target

string

Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

ErrorCode

ErrorCode

Nom Type Description
Conflict

string

Représentant le code d’erreur de conflit.

Forbidden

string

Représentant le code d’erreur interdit.

InternalCommunicationFailed

string

Représentant le code d’erreur d’échec de la communication interne.

InternalServerError

string

Représentant le code d’erreur du serveur interne.

InvalidArgument

string

Représentant le code d’erreur de l’argument non valide.

InvalidRequest

string

Représentant le code d’erreur de requête non valide.

NotAllowed

string

Représentant le code d’erreur non autorisé.

NotFound

string

Représentant le code d’erreur introuvable.

PipelineError

string

Représentant le code d’erreur du pipeline.

ServiceUnavailable

string

Représentant le code d’erreur du service indisponible.

TooManyRequests

string

Représentant le code d’erreur trop grand nombre de requêtes.

Unauthorized

string

Représentant le code d’erreur non autorisé.

UnprocessableEntity

string

Représentant le code d’erreur d’entité non traité.

UnsupportedMediaType

string

Représentant le code d’erreur du type de média non pris en charge.

File

Fichier

Nom Type Description
createdDateTime

string

Heure de création de ce fichier. L’horodatage est encodé au format de date et d’heure ISO 8601 (voir https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

kind

FileKind

FileKind
Type de données.

links

FileLinks

FileLinks

name

string

Nom de ce fichier.

properties

FileProperties

FileProperties

self

string

Emplacement de cette entité.

FileKind

FileKind

Nom Type Description
AcousticDataArchive

string

Le type de données est une archive de données acoustiques.

AcousticDataTranscriptionV2

string

Le type de données est la transcription de données acoustiques v2.

Audio

string

Le type de données est audio.

DatasetReport

string

Le type de données est un rapport de jeu de données.

EvaluationDetails

string

Le type de données correspond aux détails de l’évaluation.

LanguageData

string

Le type de données est des données de langue.

ModelReport

string

Le type de données est un rapport de modèle.

OutputFormattingData

string

Le type de données est le fichier de mise en forme de sortie.

PronunciationData

string

Le type de données est des données de prononciation.

Transcription

string

Le type de données est la transcription.

TranscriptionReport

string

Le type de données est le rapport de transcription.

FileLinks

Nom Type Description
contentUrl

string

URL permettant de récupérer le contenu de ce fichier.

FileProperties

FileProperties

Nom Type Description
duration

string

Durée au cas où ce fichier est un fichier audio. La durée est encodée en tant que durée ISO 8601 (« PnYnMnDTnHnMnS », voir https://en.wikipedia.org/wiki/ISO_8601#Durations).

size

integer

Taille des données en octets.

InnerError

InnerError

Nom Type Description
code

DetailedErrorCode

DetailedErrorCode
Énumération détaillée du code d’erreur.

details

object

Détails supplémentaires concernant l’erreur et/ou les stratégies attendues.

innerError

InnerError

InnerError
Nouveau format d’erreur interne conforme aux instructions de l’API Cognitive Services, disponible à l’adresse https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Ce format contient les propriétés obligatoires ErrorCode, message et les propriétés facultatives target, details (paire clé-valeur), et l’erreur interne (qui peut être imbriquée).

message

string

Message d’erreur de haut niveau.

target

string

Source de l’erreur. Par exemple, « documents » ou « document id » en présence d’un document non valide.

PaginatedFiles

PaginatedFiles

Nom Type Description
@nextLink

string

Un lien vers l’ensemble suivant de résultats paginés s’il existe d’autres entités disponibles ; sinon, null.

values

File[]

Liste d’entités limitées par les paramètres de requête « skip » et « top » passés ou par leurs valeurs par défaut.

Lors de l’itération dans une liste à l’aide de la pagination et de la suppression d’entités en parallèle, certaines entités sont ignorées dans les résultats. Il est recommandé de créer une liste sur le client et de la supprimer après l’extraction de la liste complète.