Projects - List
Lekéri a hitelesített előfizetés projektjeinek listáját.
GET {endpoint}/speechtotext/v3.2-preview.2/projects
GET {endpoint}/speechtotext/v3.2-preview.2/projects?skip={skip}&top={top}&filter={filter}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com). |
filter
|
query |
string |
Szűrési kifejezés az elérhető projektek egy részhalmazának kiválasztásához.
|
|
skip
|
query |
integer int32 |
Kihagyandó adathalmazok száma. |
|
top
|
query |
integer int32 |
A kihagyás után belefoglalt adathalmazok száma. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Hiba történt. |
Biztonság
Ocp-Apim-Subscription-Key
Itt adja meg a Cognitive Services-fiókkulcsot.
Type:
apiKey
In:
header
Authorization
Adjon meg egy hozzáférési jogkivonatot a régió STS által visszaadott JWT-ből. Győződjön meg arról, hogy hozzáadja a felügyeleti hatókört a jogkivonathoz, ha hozzáadja a következő lekérdezési sztringet az STS URL-címéhez: ?scope=speechservicesmanagement
Type:
apiKey
In:
header
Példák
Get all projects |
Get all projects created in 2018 or 2019 |
Get all projects
Sample Request
GET {endpoint}/speechtotext/v3.2-preview.2/projects?skip=0&top=3
Sample Response
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "My speech project"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "My speech project"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "My speech project"
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects?skip=3&top=3"
}
Get all projects created in 2018 or 2019
Sample Request
GET {endpoint}/speechtotext/v3.2-preview.2/projects?skip=0&top=3&filter=createdDateTime%20ge%202018-01-01T00:00:00Z%20and%20createdDateTime%20lt%202020-01-01T00:00:00Z
Sample Response
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2018-03-03T12:45:27Z",
"locale": "en-US",
"displayName": "My speech project"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2018-12-19T17:54:57Z",
"locale": "en-US",
"displayName": "My speech project"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/projects/abc46f33-90b8-443d-adad-4870517356e0",
"links": {
"evaluations": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/evaluations",
"datasets": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/datasets",
"models": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/models",
"endpoints": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/endpoints",
"transcriptions": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects/abc46f33-90b8-443d-adad-4870517356e0/transcriptions"
},
"properties": {
"datasetCount": 23,
"evaluationCount": 42,
"modelCount": 2,
"transcriptionCount": 1994,
"endpointCount": 12
},
"createdDateTime": "2019-02-01T00:45:27Z",
"locale": "en-US",
"displayName": "My speech project"
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/projects?skip=6&top=3&filter=createdDateTime%20ge%202018-01-01T00:00:00Z%20and%20createdDateTime%20lt%202020-01-01T00:00:00Z"
}
Definíciók
Name | Description |
---|---|
Detailed |
DetailedErrorCode |
Error |
Hiba |
Error |
ErrorCode |
Inner |
InnerError |
Paginated |
Többoldalas projektek |
Project |
Project |
Project |
ProjectLinks |
Project |
ProjectProperties |
DetailedErrorCode
DetailedErrorCode
Name | Típus | Description |
---|---|---|
DataImportFailed |
string |
Az adatimportálás nem sikerült. |
DeleteNotAllowed |
string |
A törlés nem engedélyezett. |
DeployNotAllowed |
string |
Az üzembe helyezés nem engedélyezett. |
DeployingFailedModel |
string |
Sikertelen modell üzembe helyezése. |
EmptyRequest |
string |
Üres kérelem. |
EndpointCannotBeDefault |
string |
A végpont nem lehet alapértelmezett. |
EndpointNotUpdatable |
string |
A végpont nem frissíthető. |
EndpointWithoutLogging |
string |
Végpont naplózás nélkül. |
ExceededNumberOfRecordingsUris |
string |
Túllépte a felvétel URI-jainak számát. |
FailedDataset |
string |
Nem sikerült az adathalmaz. |
Forbidden |
string |
Tiltott. |
InUseViolation |
string |
Használaton belüli szabálysértés. |
InaccessibleCustomerStorage |
string |
Elérhetetlen ügyféltároló. |
InvalidAdaptationMapping |
string |
Érvénytelen adaptációs leképezés. |
InvalidBaseModel |
string |
Érvénytelen alapmodell. |
InvalidCallbackUri |
string |
Érvénytelen visszahívási URI. |
InvalidCollection |
string |
Érvénytelen gyűjtemény. |
InvalidDataset |
string |
Érvénytelen adatkészlet. |
InvalidDocument |
string |
Érvénytelen dokumentum. |
InvalidDocumentBatch |
string |
Érvénytelen dokumentumköteg. |
InvalidLocale |
string |
Érvénytelen területi beállítás. |
InvalidLogDate |
string |
Érvénytelen naplódátum. |
InvalidLogEndTime |
string |
Érvénytelen a napló befejezési ideje. |
InvalidLogId |
string |
Érvénytelen naplóazonosító. |
InvalidLogStartTime |
string |
Érvénytelen a napló kezdési időpontja. |
InvalidModel |
string |
Érvénytelen modell. |
InvalidModelUri |
string |
Érvénytelen modell URI-ja. |
InvalidParameter |
string |
Érvénytelen paraméter. |
InvalidParameterValue |
string |
Érvénytelen paraméterérték. |
InvalidPayload |
string |
Érvénytelen hasznos adat. |
InvalidPermissions |
string |
Érvénytelen engedélyek. |
InvalidPrerequisite |
string |
Érvénytelen előfeltétel. |
InvalidProductId |
string |
Érvénytelen termékazonosító. |
InvalidProject |
string |
Érvénytelen projekt. |
InvalidProjectKind |
string |
Érvénytelen projekttípus. |
InvalidRecordingsUri |
string |
Érvénytelen felvételek URI-ja. |
InvalidRequestBodyFormat |
string |
Érvénytelen kérelemtörzs-formátum. |
InvalidSasValidityDuration |
string |
Érvénytelen sas-érvényességi időtartam. |
InvalidSkipTokenForLogs |
string |
Érvénytelen kihagyó jogkivonat a naplókhoz. |
InvalidSourceAzureResourceId |
string |
Érvénytelen forrás Azure-erőforrás-azonosító. |
InvalidSubscription |
string |
Érvénytelen előfizetés. |
InvalidTest |
string |
Érvénytelen teszt. |
InvalidTimeToLive |
string |
Érvénytelen élettartam. |
InvalidTopForLogs |
string |
A naplók felső része érvénytelen. |
InvalidTranscription |
string |
Érvénytelen átírás. |
InvalidWebHookEventKind |
string |
Érvénytelen webhookesemény-típus. |
MissingInputRecords |
string |
Hiányzó bemeneti rekordok. |
ModelCopyOperationExists |
string |
Létezik modellmásolási művelet. |
ModelDeploymentNotCompleteState |
string |
A modell üzembe helyezése nem fejeződött be. |
ModelDeprecated |
string |
A modell elavult. |
ModelExists |
string |
A modell létezik. |
ModelMismatch |
string |
Modelleltérés. |
ModelNotDeployable |
string |
A modell nem helyezhető üzembe. |
ModelVersionIncorrect |
string |
A modell verziója helytelen. |
NoUtf8WithBom |
string |
Nincs utf8 a bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Csak egy URL-cím, tároló vagy adatkészlet. |
ProjectGenderMismatch |
string |
A projekt neme nem egyezik. |
QuotaViolation |
string |
Kvóta megsértése. |
SingleDefaultEndpoint |
string |
Egyetlen alapértelmezett végpont. |
SkuLimitsExist |
string |
A termékváltozatra vonatkozó korlátozások léteznek. |
SubscriptionNotFound |
string |
Az előfizetés nem található. |
UnexpectedError |
string |
Váratlan hiba. |
UnsupportedClassBasedAdaptation |
string |
Nem támogatott osztályalapú adaptáció. |
UnsupportedDelta |
string |
Nem támogatott változás. |
UnsupportedDynamicConfiguration |
string |
Nem támogatott dinamikus konfiguráció. |
UnsupportedFilter |
string |
Nem támogatott szűrő. |
UnsupportedLanguageCode |
string |
Nem támogatott nyelvi kód. |
UnsupportedOrderBy |
string |
Nem támogatott sorrend szerint. |
UnsupportedPagination |
string |
Nem támogatott lapozás. |
UnsupportedTimeRange |
string |
Nem támogatott időtartomány. |
Error
Hiba
Name | Típus | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
ErrorCode
ErrorCode
Name | Típus | Description |
---|---|---|
Conflict |
string |
Az ütközési hibakód jelölője. |
Forbidden |
string |
A tiltott hibakódot jelöli. |
InternalCommunicationFailed |
string |
A belső kommunikáció meghiúsult hibakódját jelképező hibakód. |
InternalServerError |
string |
A belső kiszolgáló hibakódját jelöli. |
InvalidArgument |
string |
Az érvénytelen argumentum hibakódját jelöli. |
InvalidRequest |
string |
Az érvénytelen kérelem hibakódját jelöli. |
NotAllowed |
string |
A nem engedélyezett hibakódot jelöli. |
NotFound |
string |
A nem található hibakódot jelöli. |
PipelineError |
string |
A folyamat hibakódjának jelölője. |
ServiceUnavailable |
string |
A szolgáltatás nem érhető el hibakódját jelöli. |
TooManyRequests |
string |
A túl sok kérelem hibakódját jelöli. |
Unauthorized |
string |
A jogosulatlan hibakódot jelöli. |
UnprocessableEntity |
string |
A feldolgozhatatlan entitás hibakódját jelöli. |
UnsupportedMediaType |
string |
A nem támogatott médiatípus hibakódját jelöli. |
InnerError
InnerError
Name | Típus | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
PaginatedProjects
Többoldalas projektek
Name | Típus | Description |
---|---|---|
@nextLink |
string |
Hivatkozás a lapszámozott eredmények következő készletére, ha több entitás érhető el; egyébként null értékű. |
values |
Project[] |
A "skip" és a "top" átadott lekérdezési paraméterek vagy az alapértelmezett értékek által korlátozott entitások listája. Ha a listákat oldalakra tördeléssel és entitások párhuzamos törlésével iterálja, egyes entitások kimaradnak az eredményekből. Javasoljuk, hogy hozzon létre egy listát az ügyfélen, és törölje a teljes lista lekérése után. |
Project
Project
Name | Típus | Description |
---|---|---|
createdDateTime |
string |
Az objektum létrehozásának időbélyege. Az időbélyeg iso 8601-es dátum- és időformátumként van kódolva ("ÉÉÉÉ-HH-NNH:mm:ssZ", lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
Az entitás egyéni tulajdonságai. A maximálisan megengedett kulcshossz 64 karakter, a maximális megengedett értékhossz 256 karakter, az engedélyezett bejegyzések száma pedig 10. |
description |
string |
Az objektum leírása. |
displayName |
string |
Az objektum megjelenítendő neve. |
links |
ProjectLinks |
|
locale |
string |
A tartalmazott adatok területi beállítása. |
properties |
ProjectProperties |
|
self |
string |
Az entitás helye. |
ProjectLinks
ProjectLinks
Name | Típus | Description |
---|---|---|
datasets |
string |
A projekt összes adathalmazának listájának lekérésének helye. További részletekért lásd a "Projects_ListDatasets" műveletet. |
endpoints |
string |
A projekt összes végpontjának listájának lekérésének helye. További részletekért lásd a "Projects_ListEndpoints" műveletet. |
evaluations |
string |
A projekt összes kiértékelésének listájának lekérésének helye. További részletekért lásd a "Projects_ListEvaluations" műveletet. |
models |
string |
A projekt összes modelljének listájának lekérésének helye. További részletekért lásd a "Projects_ListModels" műveletet. |
transcriptions |
string |
A projekt összes átiratának listájának lekérésének helye. További részletekért lásd a "Projects_ListTranscriptions" műveletet. |
ProjectProperties
ProjectProperties
Name | Típus | Description |
---|---|---|
datasetCount |
integer |
A projekthez társított adathalmazok száma. |
endpointCount |
integer |
A projekthez társított végpontok száma. |
evaluationCount |
integer |
A projekthez társított értékelések száma. |
modelCount |
integer |
A projekthez társított modellek száma. |
transcriptionCount |
integer |
A projekthez társított átiratok száma. |