다음을 통해 공유


Transcriptions - List Files

지정된 ID로 식별된 전사의 파일을 가져옵니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
path True

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

id
path True

string

uuid

전사의 식별자입니다.

filter
query

string

사용 가능한 파일의 하위 집합을 선택하기 위한 필터링 식입니다.

        - 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.json' and kind eq 'Transcription'
sasValidityInSeconds
query

integer

int32

SAS URL이 유효해야 하는 기간(초)입니다. 기본 기간은 12시간입니다. 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): 값이 0이면 SAS 토큰이 없는 일반 Blob URI가 생성됩니다.

skip
query

integer

int32

건너뛸 데이터 세트 수입니다.

top
query

integer

int32

건너뛴 후 포함할 데이터 세트 수입니다.

응답

Name 형식 Description
200 OK

PaginatedFiles

정상

헤더

Retry-After: integer

Other Status Codes

Error

오류가 발생했습니다.

보안

Ocp-Apim-Subscription-Key

여기에서 Cognitive Services 계정 키를 제공합니다.

형식: apiKey
In(다음 안에): header

Authorization

이 지역의 STS에서 반환된 JWT에서 액세스 토큰을 제공합니다. STS URL에 다음 쿼리 문자열을 추가하여 관리 scope 토큰에 추가해야 합니다. ?scope=speechservicesmanagement

형식: apiKey
In(다음 안에): header

예제

Get all files
Get all transcription files the name of which starts with the specified string

Get all files

샘플 요청

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasValidityInSeconds=120&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z

샘플 응답

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.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"
      }
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/28bc946b-c251-4a86-84f6-ea0f0a2373ef",
      "name": "mywavefile2.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile2.wav.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/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?skip=2&top=2"
}

Get all transcription files the name of which starts with the specified string

샘플 요청

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasValidityInSeconds=120&skip=0&top=10&filter=name%20eq%20'mywavefile1.wav.json'

샘플 응답

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.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"
      }
    }
  ]
}

정의

Name Description
DetailedErrorCode

DetailedErrorCode

Error

오류

ErrorCode

오류 코드

File

파일

FileKind

FileKind

FileLinks

FileLinks

FileProperties

FileProperties

InnerError

InnerError

PaginatedFiles

PaginatedFiles

DetailedErrorCode

DetailedErrorCode

Name 형식 Description
DataImportFailed

string

데이터 가져오기에 실패했습니다.

DeleteNotAllowed

string

삭제할 수 없습니다.

DeployNotAllowed

string

배포가 허용되지 않습니다.

DeployingFailedModel

string

실패한 모델 배포.

EmptyRequest

string

빈 요청입니다.

EndpointCannotBeDefault

string

엔드포인트는 기본값일 수 없습니다.

EndpointNotUpdatable

string

엔드포인트를 사용할 수 없습니다.

EndpointWithoutLogging

string

로깅이 없는 엔드포인트입니다.

ExceededNumberOfRecordingsUris

string

녹음/녹화 URI 수를 초과했습니다.

FailedDataset

string

실패한 데이터 세트입니다.

Forbidden

string

사용할 수 없습니다.

InUseViolation

string

사용 위반.

InaccessibleCustomerStorage

string

액세스할 수 없는 고객 스토리지.

InvalidAdaptationMapping

string

잘못된 적응 매핑입니다.

InvalidBaseModel

string

잘못된 기본 모델입니다.

InvalidCallbackUri

string

콜백 URI가 잘못되었습니다.

InvalidCollection

string

컬렉션이 잘못되었습니다.

InvalidDataset

string

데이터 세트가 잘못되었습니다.

InvalidDocument

string

잘못된 문서입니다.

InvalidDocumentBatch

string

문서 일괄 처리가 잘못되었습니다.

InvalidLocale

string

잘못된 로캘입니다.

InvalidLogDate

string

잘못된 로그 날짜입니다.

InvalidLogEndTime

string

로그 종료 시간이 잘못되었습니다.

InvalidLogId

string

잘못된 로그 ID입니다.

InvalidLogStartTime

string

로그 시작 시간이 잘못되었습니다.

InvalidModel

string

모델이 잘못되었습니다.

InvalidModelUri

string

모델 URI가 잘못되었습니다.

InvalidParameter

string

잘못된 매개 변수입니다.

InvalidParameterValue

string

매개 변수 값이 잘못되었습니다.

InvalidPayload

string

잘못된 페이로드입니다.

InvalidPermissions

string

권한이 잘못되었습니다.

InvalidPrerequisite

string

필수 구성 요소가 잘못되었습니다.

InvalidProductId

string

제품 ID가 잘못되었습니다.

InvalidProject

string

프로젝트가 잘못되었습니다.

InvalidProjectKind

string

프로젝트 종류가 잘못되었습니다.

InvalidRecordingsUri

string

잘못된 녹음/녹화 URI입니다.

InvalidRequestBodyFormat

string

요청 본문 형식이 잘못되었습니다.

InvalidSasValidityDuration

string

sas 유효 기간이 잘못되었습니다.

InvalidSkipTokenForLogs

string

로그에 대한 건너뛰기 토큰이 잘못되었습니다.

InvalidSourceAzureResourceId

string

원본 Azure 리소스 ID가 잘못되었습니다.

InvalidSubscription

string

구독이 잘못되었습니다.

InvalidTest

string

테스트가 잘못되었습니다.

InvalidTimeToLive

string

유효하지 않은 TL(Time to Live)

InvalidTopForLogs

string

로그의 위쪽이 잘못되었습니다.

InvalidTranscription

string

전사가 잘못되었습니다.

InvalidWebHookEventKind

string

웹 후크 이벤트 종류가 잘못되었습니다.

MissingInputRecords

string

입력 레코드가 없습니다.

ModelCopyOperationExists

string

모델 복사 작업이 있습니다.

ModelDeploymentNotCompleteState

string

모델 배포가 완료되지 않은 상태입니다.

ModelDeprecated

string

모델이 더 이상 사용되지 않습니다.

ModelExists

string

모델이 있습니다.

ModelMismatch

string

모델 불일치.

ModelNotDeployable

string

모델을 배포할 수 없습니다.

ModelVersionIncorrect

string

모델 버전이 잘못되었습니다.

NoUtf8WithBom

string

bom과 함께 utf8이 없습니다.

OnlyOneOfUrlsOrContainerOrDataset

string

URL 또는 컨테이너 또는 데이터 세트 중 하나만 있습니다.

ProjectGenderMismatch

string

프로젝트 성별 불일치.

QuotaViolation

string

할당량 위반.

SingleDefaultEndpoint

string

단일 기본 엔드포인트입니다.

SkuLimitsExist

string

SKU 제한이 있습니다.

SubscriptionNotFound

string

구독을 찾을 수 없습니다.

UnexpectedError

string

예기치 않은 오류입니다.

UnsupportedClassBasedAdaptation

string

지원되지 않는 클래스 기반 적응입니다.

UnsupportedDelta

string

지원되지 않는 델타입니다.

UnsupportedDynamicConfiguration

string

지원되지 않는 동적 구성입니다.

UnsupportedFilter

string

지원되지 않는 필터입니다.

UnsupportedLanguageCode

string

지원되지 않는 언어 코드입니다.

UnsupportedOrderBy

string

지원되지 않는 순서 기준입니다.

UnsupportedPagination

string

지원되지 않는 페이지 매김.

UnsupportedTimeRange

string

지원되지 않는 시간 범위입니다.

Error

오류

Name 형식 Description
code

ErrorCode

오류 코드
높은 수준의 오류 코드입니다.

details

Error[]

오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다.

innerError

InnerError

InnerError
에서 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 필수 속성 ErrorCode, 메시지 및 선택적 속성 대상, 세부 정보(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.

message

string

높은 수준의 오류 메시지입니다.

target

string

오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다.

ErrorCode

오류 코드

Name 형식 Description
Conflict

string

충돌 오류 코드를 나타냅니다.

Forbidden

string

사용할 수 없는 오류 코드를 나타냅니다.

InternalCommunicationFailed

string

내부 통신 실패 오류 코드를 나타냅니다.

InternalServerError

string

내부 서버 오류 코드를 나타냅니다.

InvalidArgument

string

잘못된 인수 오류 코드를 나타냅니다.

InvalidRequest

string

잘못된 요청 오류 코드를 나타냅니다.

NotAllowed

string

허용되지 않는 오류 코드를 나타냅니다.

NotFound

string

찾을 수 없는 오류 코드를 나타냅니다.

PipelineError

string

파이프라인 오류 코드를 나타냅니다.

ServiceUnavailable

string

서비스를 사용할 수 없음 오류 코드를 나타냅니다.

TooManyRequests

string

너무 많은 요청 오류 코드를 나타냅니다.

Unauthorized

string

권한 없는 오류 코드를 나타냅니다.

UnprocessableEntity

string

처리할 수 없는 엔터티 오류 코드를 나타냅니다.

UnsupportedMediaType

string

지원되지 않는 미디어 형식 오류 코드를 나타냅니다.

File

파일

Name 형식 Description
createdDateTime

string

이 파일의 생성 시간입니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다(참조 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

kind

FileKind

FileKind
데이터 형식입니다.

links

FileLinks

FileLinks

name

string

이 파일의 이름입니다.

properties

FileProperties

FileProperties

self

string

이 엔터티의 위치입니다.

FileKind

FileKind

Name 형식 Description
AcousticDataArchive

string

데이터 형식은 음향 데이터 보관입니다.

AcousticDataTranscriptionV2

string

데이터 형식은 음향 데이터 전사 v2입니다.

Audio

string

데이터 형식은 오디오입니다.

DatasetReport

string

데이터 형식은 데이터 세트 보고서입니다.

EvaluationDetails

string

데이터 형식은 평가 세부 정보입니다.

LanguageData

string

데이터 형식은 언어 데이터입니다.

ModelReport

string

데이터 형식은 모델 보고서입니다.

OutputFormattingData

string

데이터 형식은 출력 서식 입력 파일입니다.

PronunciationData

string

데이터 형식은 발음 데이터입니다.

Transcription

string

데이터 형식은 전사입니다.

TranscriptionReport

string

데이터 형식은 전사 보고서입니다.

FileLinks

Name 형식 Description
contentUrl

string

이 파일의 콘텐츠를 검색할 URL입니다.

FileProperties

FileProperties

Name 형식 Description
duration

string

이 파일이 오디오 파일인 경우의 기간입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations).

size

integer

데이터의 크기(바이트)입니다.

InnerError

InnerError

Name 형식 Description
code

DetailedErrorCode

DetailedErrorCode
자세한 오류 코드 열거형입니다.

details

object

오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다.

innerError

InnerError

InnerError
에서 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 필수 속성 ErrorCode, 메시지 및 선택적 속성 대상, 세부 정보(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.

message

string

높은 수준의 오류 메시지입니다.

target

string

오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다.

PaginatedFiles

PaginatedFiles

Name 형식 Description
@nextLink

string

사용할 수 있는 엔터티가 더 있는 경우 페이지를 매긴 다음 결과 집합에 대한 링크입니다. 그렇지 않으면 null입니다.

values

File[]

전달된 쿼리 매개 변수 'skip' 및 'top' 또는 해당 기본값으로 제한되는 엔터티 목록입니다.

페이지 매김을 사용하여 목록을 반복하고 엔터티를 병렬로 삭제하면 일부 엔터티가 결과에서 건너뛰게 됩니다. 클라이언트에서 목록을 빌드하고 전체 목록을 페치한 후 삭제하는 것이 좋습니다.