Delen via


Models - List Files

Hiermee haalt u de bestanden op van het model dat wordt geïdentificeerd door de opgegeven id.

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}

URI-parameters

Name In Vereist Type Description
endpoint
path True

string

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).

id
path True

string

uuid

De id van het model.

filter
query

string

Een filterexpressie voor het selecteren van een subset van de beschikbare bestanden.

        - 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

De duur in seconden dat een SAS-URL geldig moet zijn. De standaardduur is 12 uur. Bij gebruik van 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): een waarde van 0 betekent dat er een gewone blob-URI zonder SAS-token wordt gegenereerd.

skip
query

integer

int32

Het aantal gegevenssets dat wordt overgeslagen.

top
query

integer

int32

Het aantal gegevenssets dat wordt opgenomen na het overslaan.

Antwoorden

Name Type Description
200 OK

PaginatedFiles

OK

Kopteksten

Retry-After: integer

Other Status Codes

Error

Er is een fout opgetreden.

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier de sleutel van uw Cognitive Services-account op.

Type: apiKey
In: header

Authorization

Geef een toegangstoken op van de JWT die wordt geretourneerd door de STS van deze regio. Zorg ervoor dat u het beheerbereik toevoegt aan het token door de volgende querytekenreeks toe te voegen aan de STS-URL: ?scope=speechservicesmanagement

Type: apiKey
In: header

Voorbeelden

Get all files

Voorbeeldaanvraag

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

Voorbeeldrespons

{
  "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"
}

Definities

Name Description
DetailedErrorCode

DetailedErrorCode

Error

Fout

ErrorCode

ErrorCode

File

File

FileKind

FileKind

FileLinks

FileLinks

FileProperties

FileProperties

InnerError

InnerError

PaginatedFiles

Gepagineerde bestanden

DetailedErrorCode

DetailedErrorCode

Name Type Description
DataImportFailed

string

Het importeren van gegevens is mislukt.

DeleteNotAllowed

string

Verwijderen is niet toegestaan.

DeployNotAllowed

string

Implementeren is niet toegestaan.

DeployingFailedModel

string

Het implementeren van een mislukt model.

EmptyRequest

string

Lege aanvraag.

EndpointCannotBeDefault

string

Eindpunt kan niet standaard zijn.

EndpointNotUpdatable

string

Eindpunt kan niet worden bijgewerkt.

EndpointWithoutLogging

string

Eindpunt zonder logboekregistratie.

ExceededNumberOfRecordingsUris

string

Het aantal opnamen is overschreden.

FailedDataset

string

Mislukte gegevensset.

Forbidden

string

Verboden.

InUseViolation

string

In gebruiksovertreding.

InaccessibleCustomerStorage

string

Niet-toegankelijke klantopslag.

InvalidAdaptationMapping

string

Ongeldige aanpassingstoewijzing.

InvalidBaseModel

string

Ongeldig basismodel.

InvalidCallbackUri

string

Ongeldige callback-URI.

InvalidCollection

string

Ongeldige verzameling.

InvalidDataset

string

Ongeldige gegevensset.

InvalidDocument

string

Ongeldig document.

InvalidDocumentBatch

string

Ongeldige documentbatch.

InvalidLocale

string

Ongeldige landinstelling.

InvalidLogDate

string

Ongeldige logboekdatum.

InvalidLogEndTime

string

Ongeldige eindtijd van logboek.

InvalidLogId

string

Ongeldige logboek-id.

InvalidLogStartTime

string

Ongeldige begintijd van logboek.

InvalidModel

string

Ongeldig model.

InvalidModelUri

string

Ongeldige model-URI.

InvalidParameter

string

Ongeldige parameter.

InvalidParameterValue

string

Ongeldige parameterwaarde.

InvalidPayload

string

Ongeldige nettolading.

InvalidPermissions

string

Ongeldige machtigingen.

InvalidPrerequisite

string

Ongeldige vereiste.

InvalidProductId

string

Ongeldige product-id.

InvalidProject

string

Ongeldig project.

InvalidProjectKind

string

Ongeldige projectsoort.

InvalidRecordingsUri

string

Ongeldige URI voor opnamen.

InvalidRequestBodyFormat

string

Ongeldige indeling van aanvraagbody.

InvalidSasValidityDuration

string

Ongeldige geldigheidsduur sas.

InvalidSkipTokenForLogs

string

Ongeldig token voor overslaan voor logboeken.

InvalidSourceAzureResourceId

string

Ongeldige bron-id van Azure-resource.

InvalidSubscription

string

Ongeldig abonnement.

InvalidTest

string

Ongeldige test.

InvalidTimeToLive

string

Ongeldige time to live.

InvalidTopForLogs

string

Ongeldige bovenkant voor logboeken.

InvalidTranscription

string

Ongeldige transcriptie.

InvalidWebHookEventKind

string

Ongeldig soort webhook gebeurtenis.

MissingInputRecords

string

Ontbrekende invoerrecords.

ModelCopyOperationExists

string

De kopieerbewerking van het model bestaat.

ModelDeploymentNotCompleteState

string

De status modelimplementatie is niet voltooid.

ModelDeprecated

string

Het model is afgeschaft.

ModelExists

string

Het model bestaat.

ModelMismatch

string

Model komt niet overeen.

ModelNotDeployable

string

Het model kan niet worden geïmplementeerd.

ModelVersionIncorrect

string

Modelversie onjuist.

NoUtf8WithBom

string

Geen utf8 met bom.

OnlyOneOfUrlsOrContainerOrDataset

string

Slechts één van de URL's of container of gegevensset.

ProjectGenderMismatch

string

Het geslacht van het project komt niet overeen.

QuotaViolation

string

Quotumschending.

SingleDefaultEndpoint

string

Eén standaardeindpunt.

SkuLimitsExist

string

Er bestaan SKU-limieten.

SubscriptionNotFound

string

Kan het abonnement niet vinden.

UnexpectedError

string

Onverwachte fout.

UnsupportedClassBasedAdaptation

string

Niet-ondersteunde aanpassing op basis van klassen.

UnsupportedDelta

string

Niet-ondersteunde delta.

UnsupportedDynamicConfiguration

string

Niet-ondersteunde dynamische configuratie.

UnsupportedFilter

string

Niet-ondersteund filter.

UnsupportedLanguageCode

string

Niet-ondersteunde taalcode.

UnsupportedOrderBy

string

Niet-ondersteunde bestelling door.

UnsupportedPagination

string

Niet-ondersteunde paginering.

UnsupportedTimeRange

string

Niet-ondersteund tijdsbereik.

Error

Fout

Name Type Description
code

ErrorCode

ErrorCode
Foutcodes op hoog niveau.

details

Error[]

Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.

innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).

message

string

Foutbericht op hoog niveau.

target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

ErrorCode

ErrorCode

Name Type Description
Conflict

string

Vertegenwoordigt de conflictfoutcode.

Forbidden

string

Vertegenwoordigt de verboden foutcode.

InternalCommunicationFailed

string

De foutcode voor de interne communicatie mislukt.

InternalServerError

string

Vertegenwoordigt de foutcode van de interne serverfout.

InvalidArgument

string

Vertegenwoordigt de foutcode van het ongeldige argument.

InvalidRequest

string

Vertegenwoordigt de ongeldige aanvraagfoutcode.

NotAllowed

string

Vertegenwoordigt de niet-toegestane foutcode.

NotFound

string

Vertegenwoordigt de foutcode die niet is gevonden.

PipelineError

string

Vertegenwoordigt de foutcode van de pijplijnfout.

ServiceUnavailable

string

Vertegenwoordigt de foutcode die niet beschikbaar is voor de service.

TooManyRequests

string

Vertegenwoordigt de foutcode voor te veel aanvragen.

Unauthorized

string

Vertegenwoordigt de foutcode voor onbevoegden.

UnprocessableEntity

string

Vertegenwoordigt de foutcode van de niet-verwerkbare entiteit.

UnsupportedMediaType

string

Vertegenwoordigt de foutcode van het niet-ondersteunde mediatype.

File

File

Name Type Description
createdDateTime

string

De aanmaaktijd van dit bestand. De tijdstempel is gecodeerd als ISO 8601-datum- en tijdnotatie (zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

kind

FileKind

FileKind
Type gegevens.

links

FileLinks

FileLinks

name

string

De naam van dit bestand.

properties

FileProperties

FileProperties

self

string

De locatie van deze entiteit.

FileKind

FileKind

Name Type Description
AcousticDataArchive

string

Het type gegevens is een akoestisch gegevensarchief.

AcousticDataTranscriptionV2

string

Het type gegevens is akoestische gegevenstranscriptie v2.

Audio

string

Het type gegevens is audio.

DatasetReport

string

Het type gegevens is een gegevenssetrapport.

EvaluationDetails

string

Type gegevens zijn evaluatiedetails.

LanguageData

string

Type gegevens zijn taalgegevens.

ModelReport

string

Het type gegevens is een modelrapport.

OutputFormattingData

string

Het type gegevens is uitvoeropmaakinvoerbestand.

PronunciationData

string

Type gegevens zijn uitspraakgegevens.

Transcription

string

Het type gegevens is transcriptie.

TranscriptionReport

string

Het type gegevens is een transcriptierapport.

FileLinks

Name Type Description
contentUrl

string

De URL voor het ophalen van de inhoud van dit bestand.

FileProperties

FileProperties

Name Type Description
duration

string

De duur voor het geval dit bestand een audiobestand is. De duur wordt gecodeerd als ISO 8601-duur ('PnYnMnDTnHnMnS', zie https://en.wikipedia.org/wiki/ISO_8601#Durations).

size

integer

De grootte van de gegevens in bytes.

InnerError

InnerError

Name Type Description
code

DetailedErrorCode

DetailedErrorCode
Gedetailleerde foutcode- enum.

details

object

Aanvullende ondersteunende informatie met betrekking tot de fout en/of het verwachte beleid.

innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de API-richtlijnen voor Cognitive Services die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat de vereiste eigenschappen Foutcode, bericht en optionele eigenschappen doel, details (sleutelwaardepaar), interne fout (dit kan worden genest).

message

string

Foutbericht op hoog niveau.

target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

PaginatedFiles

Gepagineerde bestanden

Name Type Description
@nextLink

string

Een koppeling naar de volgende set gepagineerde resultaten als er meer entiteiten beschikbaar zijn; anders null.

values

File[]

Een lijst met entiteiten die beperkt zijn door de doorgegeven queryparameters 'skip' en 'top' of hun standaardwaarden.

Wanneer u een lijst doorloopt met behulp van paginering en het parallel verwijderen van entiteiten, worden sommige entiteiten overgeslagen in de resultaten. Het wordt aanbevolen om een lijst op de client te maken en te verwijderen nadat de volledige lijst is opgehaald.