共用方式為


Projects - List

取得已驗證訂閱的項目清單。

GET {endpoint}/speechtotext/v3.2-preview.2/projects
GET {endpoint}/speechtotext/v3.2-preview.2/projects?skip={skip}&top={top}&filter={filter}

URI 參數

名稱 位於 必要 類型 Description
endpoint
path True

string

支援的認知服務端點 (通訊協定和主機名,例如: https://westus.api.cognitive.microsoft.com) 。

filter
query

string

用於選取可用專案子集的篩選表達式。

        - Supported properties: displayName, description, createdDateTime, locale.

        - Operators:

          - eq, ne are supported for all properties.

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

          - and, or, not are supported.

        - Example:

          filter=displayName eq 'My test'
skip
query

integer

int32

將會略過的數據集數目。

top
query

integer

int32

略過之後將包含的數據集數目。

回應

名稱 類型 Description
200 OK

PaginatedProjects

確定

Other Status Codes

Error

發生錯誤。

安全性

Ocp-Apim-Subscription-Key

請在這裡提供您的認知服務帳戶金鑰。

類型: apiKey
位於: header

Authorization

從此區域的 STS 傳回的 JWT 提供存取令牌。 請務必將下列查詢字串新增至 STS URL,將管理範圍新增至令牌:?scope=speechservicesmanagement

類型: apiKey
位於: header

範例

Get all projects
Get all projects created in 2018 or 2019

Get all projects

範例要求

GET {endpoint}/speechtotext/v3.2-preview.2/projects?skip=0&top=3

範例回覆

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

範例要求

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

範例回覆

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

定義

名稱 Description
DetailedErrorCode

DetailedErrorCode

Error

錯誤

ErrorCode

ErrorCode

InnerError

InnerError

PaginatedProjects

PaginatedProjects

Project

Project

ProjectLinks

ProjectLinks

ProjectProperties

ProjectProperties

DetailedErrorCode

DetailedErrorCode

名稱 類型 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

無效的記錄標識碼。

InvalidLogStartTime

string

記錄開始時間無效。

InvalidModel

string

無效的模型。

InvalidModelUri

string

無效的模型 URI。

InvalidParameter

string

無效的參數。

InvalidParameterValue

string

無效的參數值。

InvalidPayload

string

承載無效。

InvalidPermissions

string

許可權無效。

InvalidPrerequisite

string

無效的必要條件。

InvalidProductId

string

無效的產品標識碼。

InvalidProject

string

無效的專案。

InvalidProjectKind

string

無效的項目種類。

InvalidRecordingsUri

string

無效的錄製 URI。

InvalidRequestBodyFormat

string

要求本文格式無效。

InvalidSasValidityDuration

string

無效的 sas 有效期間。

InvalidSkipTokenForLogs

string

記錄的略過令牌無效。

InvalidSourceAzureResourceId

string

來源 Azure 資源標識碼無效。

InvalidSubscription

string

無效的訂用帳戶。

InvalidTest

string

無效的測試。

InvalidTimeToLive

string

存留時間無效。

InvalidTopForLogs

string

記錄的頂端無效。

InvalidTranscription

string

無效的轉譯。

InvalidWebHookEventKind

string

無效的 Web 攔截事件種類。

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

錯誤

名稱 類型 Description
code

ErrorCode

ErrorCode
高階錯誤碼。

details

Error[]

關於錯誤和/或預期原則的其他支持詳細數據。

innerError

InnerError

InnerError
符合認知服務 API 指導方針的新內部錯誤格式,可在 取得 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow。 這包含必要屬性 ErrorCode、訊息和選用屬性目標、詳細資訊 (機碼值組)、內部錯誤 (可為巢狀)。

message

string

高階錯誤訊息。

target

string

錯誤的來源。 例如,如果文件無效,則會是「documents」或「document id」。

ErrorCode

ErrorCode

名稱 類型 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

表示不支援的媒體類型錯誤碼。

InnerError

InnerError

名稱 類型 Description
code

DetailedErrorCode

DetailedErrorCode
詳細的錯誤碼列舉。

details

object

關於錯誤和/或預期原則的其他支持詳細數據。

innerError

InnerError

InnerError
符合認知服務 API 指導方針的新內部錯誤格式,可在 取得 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow。 這包含必要屬性 ErrorCode、訊息和選用屬性目標、詳細資訊 (機碼值組)、內部錯誤 (可為巢狀)。

message

string

高階錯誤訊息。

target

string

錯誤的來源。 例如,如果文件無效,則會是「documents」或「document id」。

PaginatedProjects

PaginatedProjects

名稱 類型 Description
@nextLink

string

如果有更多實體可用,則為下一組編頁結果的連結;否則為 null。

values

Project[]

受限於傳遞查詢參數 『skip』 和 『top』 或其預設值的實體清單。

使用分頁和平行刪除實體逐一查看清單時,會在結果中略過某些實體。 建議您在用戶端上建置清單,並在擷取完整清單之後刪除。

Project

Project

名稱 類型 Description
createdDateTime

string

建立物件時的時間戳。 時間戳會編碼為 ISO 8601 日期和時間格式, (“YYYY-MM-DDThh:mm:ssZ”,請參閱 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。

customProperties

object

這個實體的自定義屬性。 允許的金鑰長度上限為 64 個字元,允許的最大值長度為 256 個字元,允許的項目計數為 10。

description

string

物件的描述。

displayName

string

對象的顯示名稱。

links

ProjectLinks

ProjectLinks

locale

string

自主數據的地區設定。

properties

ProjectProperties

ProjectProperties

self

string

這個實體的位置。

ProjectLinks

名稱 類型 Description
datasets

string

取得此專案所有資料集清單的位置。 如需詳細資訊,請參閱作業“Projects_ListDatasets”。

endpoints

string

取得此專案所有端點清單的位置。 如需詳細資訊,請參閱作業“Projects_ListEndpoints”。

evaluations

string

取得此專案之所有評估清單的位置。 如需詳細資訊,請參閱作業「Projects_ListEvaluations」。

models

string

取得此專案所有模型清單的位置。 如需詳細資訊,請參閱作業“Projects_ListModels”。

transcriptions

string

取得此專案所有轉譯清單的位置。 如需詳細資訊,請參閱作業「Projects_ListTranscriptions」。

ProjectProperties

ProjectProperties

名稱 類型 Description
datasetCount

integer

與此專案相關聯的數據集數目。

endpointCount

integer

與此項目相關聯的端點數目。

evaluationCount

integer

與此專案相關聯的評估數目。

modelCount

integer

與此專案相關聯的模型數目。

transcriptionCount

integer

與此專案相關聯的轉譯數目。