Alterations - Replace

服務:

Azure AI Services

API 版本:

v5.0-preview.2

取代改變數據。

PUT {Endpoint}/qnamaker/v5.0-preview.2/alterations

URI 參數

名稱	位於	必要	類型	Description
Endpoint	path	True	string	支持的認知服務端點（例如，https://< qnamaker-resource-name >.api.cognitiveservices.azure.com）。

要求標頭

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string

要求本文

名稱	必要	類型	Description
wordAlterations	True	AlterationsDTO[]	文字改變的集合。

回應

名稱	類型	Description
204 No Content		HTTP 204 無內容。
Other Status Codes	ErrorResponse	錯誤回應。

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

範例

Successful query

範例要求

HTTP

PUT {Endpoint}/qnamaker/v5.0-preview.2/alterations


{
  "wordAlterations": [
    {
      "alterations": [
        "qnamaker",
        "qna maker"
      ]
    },
    {
      "alterations": [
        "botframework",
        "bot framework"
      ]
    },
    {
      "alterations": [
        "webchat",
        "web chat"
      ]
    }
  ]
}

範例回覆

狀態碼:

204

定義

名稱	Description
AlterationsDTO	同義字的集合。
Error	error 物件。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
ErrorCodeType	其中一組伺服器定義的錯誤碼。
ErrorResponse	錯誤回應。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
InnerErrorModel	物件，包含有關錯誤的更特定資訊。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。
WordAlterationsDTO	文字改變的集合。

AlterationsDTO

Object

同義字的集合。

名稱	類型	Description
alterations	string[]	彼此同義的字組。

Error

Object

error 物件。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名稱	類型	Description
code	ErrorCodeType	其中一組伺服器定義的錯誤碼。
details	Error[]	導致此錯誤之特定錯誤的詳細數據陣列。
innerError	InnerErrorModel	物件，包含與目前對象有關錯誤更具體的資訊。
message	string	錯誤的人類可讀取表示法。
target	string	錯誤的目標。

ErrorCodeType

列舉型別

其中一組伺服器定義的錯誤碼。

值	Description
BadArgument
EndpointKeysError
ExtractionFailure
Forbidden
KbNotFound
NotFound
OperationNotFound
QnaRuntimeError
QuotaExceeded
SKULimitExceeded
ServiceError
Unauthorized
Unspecified
ValidationFailure

ErrorResponse

Object

錯誤回應。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名稱	類型	Description
error	Error	error 物件。

InnerErrorModel

Object

物件，包含有關錯誤的更特定資訊。 根據Microsoft一個 API 指導方針 - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses。

名稱	類型	Description
code	string	比包含的錯誤所提供更明確的錯誤碼。
innerError	InnerErrorModel	物件，包含與目前對象有關錯誤更具體的資訊。

WordAlterationsDTO

Object

文字改變的集合。

名稱	類型	Description
wordAlterations	AlterationsDTO[]	文字改變的集合。