Models - List Files
지정된 ID로 식별된 모델의 파일을 가져옵니다.
GET {endpoint}/speechtotext/v3.2/models/{id}/files
GET {endpoint}/speechtotext/v3.2/models/{id}/files?sasValidityInSeconds={sasValidityInSeconds}&skip={skip}&top={top}&filter={filter}
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com). |
id
|
path | True |
string uuid |
모델의 식별자입니다. |
filter
|
query |
string |
사용 가능한 파일의 하위 집합을 선택하기 위한 필터링 식입니다.
|
|
sas
|
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 |
정상 헤더 Retry-After: integer |
|
Other Status Codes |
오류가 발생했습니다. |
여기에서 Cognitive Services 계정 키를 제공합니다.
형식:
apiKey
In(다음 안에):
header
이 지역의 STS에서 반환된 JWT에서 액세스 토큰을 제공합니다. STS URL에 다음 쿼리 문자열을 추가하여 관리 범위를 토큰에 추가해야 합니다. ?scope=speechservicesmanagement
형식:
apiKey
In(다음 안에):
header
샘플 요청
GET {endpoint}/speechtotext/v3.2/models/827712a5-f942-4997-91c3-7c6cde35600b/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/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/models/827712a5-f942-4997-91c3-7c6cde35600b/files?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}
Name | Description |
---|---|
Detailed |
DetailedErrorCode |
Error |
오류 |
Error |
오류 코드 |
File |
파일 |
File |
FileKind |
File |
FileLinks |
File |
FileProperties |
Inner |
InnerError |
Paginated |
PaginatedFiles |
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가 잘못되었습니다. |
InvalidChannels |
string |
채널이 잘못되었습니다. |
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 |
유효하지 않은 라이브 시간입니다. |
InvalidTopForLogs |
string |
로그의 위쪽이 잘못되었습니다. |
InvalidTranscription |
string |
잘못된 전사입니다. |
InvalidWebHookEventKind |
string |
웹 후크 이벤트 종류가 잘못되었습니다. |
MissingInputRecords |
string |
입력 레코드가 없습니다. |
ModelCopyAuthorizationExpired |
string |
만료된 ModelCopyAuthorization. |
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 |
지원되지 않는 시간 범위입니다. |
오류
Name | 형식 | Description |
---|---|---|
code |
오류 코드 |
|
details |
Error[] |
오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다. |
innerError |
InnerError |
|
message |
string |
높은 수준의 오류 메시지입니다. |
target |
string |
오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다. |
오류 코드
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 |
지원되지 않는 미디어 형식 오류 코드를 나타냅니다. |
파일
Name | 형식 | Description |
---|---|---|
createdDateTime |
string |
이 파일의 생성 시간입니다. 타임스탬프는 ISO 8601 날짜 및 시간 형식으로 인코딩됩니다(참조 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
kind |
FileKind |
|
links |
FileLinks |
|
name |
string |
이 파일의 이름입니다. |
properties |
FileProperties |
|
self |
string |
이 엔터티의 위치입니다. |
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
Name | 형식 | Description |
---|---|---|
duration |
string |
이 파일이 오디오 파일인 경우의 기간입니다. 기간은 ISO 8601 기간으로 인코딩됩니다("PnYnMnDTnHnMnS", 참조 https://en.wikipedia.org/wiki/ISO_8601#Durations). |
size |
integer |
데이터의 크기(바이트)입니다. |
InnerError
Name | 형식 | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
오류 및/또는 예상 정책에 대한 추가 지원 세부 정보입니다. |
innerError |
InnerError |
|
message |
string |
높은 수준의 오류 메시지입니다. |
target |
string |
오류의 출처입니다. 예를 들어 잘못된 문서의 경우 "documents" 또는 "document id"가 됩니다. |
PaginatedFiles
Name | 형식 | Description |
---|---|---|
@nextLink |
string |
사용할 수 있는 엔터티가 더 있는 경우 페이지를 매긴 다음 결과 집합에 대한 링크입니다. 그렇지 않으면 null입니다. |
values |
File[] |
전달된 쿼리 매개 변수 'skip' 및 'top' 또는 해당 기본값으로 제한되는 엔터티 목록입니다. 페이지 매김을 사용하여 목록을 반복하고 엔터티를 병렬로 삭제하는 경우 결과에서 일부 엔터티를 건너뛰게 됩니다. 클라이언트에서 목록을 빌드하고 전체 목록을 페치한 후 삭제하는 것이 좋습니다. |