Conversational Analysis Authoring - Deploy Project
新しいデプロイを作成するか、既存のものを置き換えます。
PUT {Endpoint}/language/authoring/analyze-conversations/projects/{projectName}/deployments/{deploymentName}?api-version=2023-04-01URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
deployment
|
path | True |
string |
使用するプロジェクトの特定の配置の名前。 |
|
Endpoint
|
path | True |
string |
サポートされている Cognitive Services エンドポイント (例: https://.api.cognitiveservices.azure.com). |
|
project
|
path | True |
string |
使用するプロジェクトの名前。 |
|
api-version
|
query | True |
string |
クライアント API バージョン。 |
要求本文
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| trainedModelLabel | True |
string |
トレーニング済みのモデル ラベルを表します。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 202 Accepted |
呼び出しが成功すると、ジョブの状態を確認するために使用する Operation-Location ヘッダーが返されます。 Headers operation-location: string |
|
| Other Status Codes |
エラー応答。 |
セキュリティ
AADToken
これらは Azure Active Directory OAuth2 フローです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権 Azure Mapsを付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-idアプリケーションがアクセスを要求しているリソースAzure Maps示す必要があります。 これは、 Maps 管理 API から取得できます。
Authorization URLは、Azure パブリック クラウド インスタンスに固有です。 ソブリン クラウドには、一意の承認 URL と Azure Active Directory 構成があります。
* Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。
* Azure Maps Web SDK を使用すると、複数のユース ケースに対してアプリケーションを構成ベースで設定できます。
- 現在、Azure Active Directory v1.0 または v2.0 は職場、学校、ゲストをサポートしていますが、個人用アカウントはサポートしていません。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| 名前 | 説明 |
|---|---|
| https://cognitiveservices.azure.com/.default | https://cognitiveservices.azure.com/.default |
Ocp-Apim-Subscription-Key
言語サービス リソースのサブスクリプション キー。
Type:
apiKey
In:
header
例
Successful Deploy Project
Sample Request
PUT {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/production?api-version=2023-04-01
{
"trainedModelLabel": "29886710a2ae49259d62cffca977db66"
}
Sample Response
operation-location: {Endpoint}/language/authoring/analyze-conversations/projects/EmailApp/deployments/production/jobs/66fa9a67-a561-42f1-8a13-f3a879b1a324_637858368000000000?api-version=2023-04-01定義
| 名前 | 説明 |
|---|---|
|
Conversational |
プロジェクトの配置を作成または更新するためのオプションを表します。 |
| Error |
error オブジェクト。 |
|
Error |
人間が判読できるエラー コード。 |
|
Error |
エラー応答。 |
|
Inner |
人間が判読できるエラー コード。 |
|
Inner |
エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。 |
ConversationalAnalysisAuthoringCreateDeploymentOptions
プロジェクトの配置を作成または更新するためのオプションを表します。
| 名前 | 型 | 説明 |
|---|---|---|
| trainedModelLabel |
string |
トレーニング済みのモデル ラベルを表します。 |
Error
error オブジェクト。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
サーバー定義のエラー コードのセットの 1 つ。 |
|
| details |
Error[] |
この報告されたエラーの原因となった特定のエラーに関する詳細の配列。 |
| innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
| message |
string |
エラーの人間が判読できる表現。 |
| target |
string |
エラーのターゲット。 |
ErrorCode
人間が判読できるエラー コード。
| 名前 | 型 | 説明 |
|---|---|---|
| AzureCognitiveSearchIndexLimitReached |
string |
|
| AzureCognitiveSearchIndexNotFound |
string |
|
| AzureCognitiveSearchNotFound |
string |
|
| AzureCognitiveSearchThrottling |
string |
|
| Conflict |
string |
|
| Forbidden |
string |
|
| InternalServerError |
string |
|
| InvalidArgument |
string |
|
| InvalidRequest |
string |
|
| NotFound |
string |
|
| OperationNotFound |
string |
|
| ProjectNotFound |
string |
|
| QuotaExceeded |
string |
|
| ServiceUnavailable |
string |
|
| Timeout |
string |
|
| TooManyRequests |
string |
|
| Unauthorized |
string |
|
| Warning |
string |
ErrorResponse
エラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
error オブジェクト。 |
InnerErrorCode
人間が判読できるエラー コード。
| 名前 | 型 | 説明 |
|---|---|---|
| AzureCognitiveSearchNotFound |
string |
|
| AzureCognitiveSearchThrottling |
string |
|
| EmptyRequest |
string |
|
| ExtractionFailure |
string |
|
| InvalidCountryHint |
string |
|
| InvalidDocument |
string |
|
| InvalidDocumentBatch |
string |
|
| InvalidParameterValue |
string |
|
| InvalidRequest |
string |
|
| InvalidRequestBodyFormat |
string |
|
| KnowledgeBaseNotFound |
string |
|
| MissingInputDocuments |
string |
|
| ModelVersionIncorrect |
string |
|
| UnsupportedLanguageCode |
string |
InnerErrorModel
エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
サーバー定義のエラー コードのセットの 1 つ。 |
|
| details |
object |
エラーの詳細。 |
| innererror |
エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。 |
|
| message |
string |
エラー メッセージ。 |
| target |
string |
エラー ターゲット。 |