Alterations - Replace

Usługa:

Azure AI Services

Wersja interfejsu API:

4.0

Zastąp zmiany danych.

PUT {Endpoint}/qnamaker/v4.0/alterations

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwany punkt końcowy usług Cognitive Services (np. https://< qnamaker-resource-name> .api.cognitiveservices.azure.com).

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string

Treść żądania

Nazwa	Wymagane	Typ	Opis
wordAlterations	True	AlterationsDTO[]	Kolekcja zmian słów.

Odpowiedzi

Nazwa	Typ	Opis
204 No Content		HTTP 204 Brak zawartości.
Other Status Codes	ErrorResponse	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful query

Przykładowe żądanie

HTTP

PUT {Endpoint}/qnamaker/v4.0/alterations


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

Przykładowa odpowiedź

Kod stanu:

204

Definicje

Nazwa	Opis
AlterationsDTO	Kolekcja wyrazów, które są synonimami.
Error	Obiekt błędu. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
ErrorCodeType	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
ErrorResponse	Odpowiedź na błąd. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
InnerErrorModel	Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.
WordAlterationsDTO	Kolekcja zmian słów.

AlterationsDTO

Objekt

Kolekcja wyrazów, które są synonimami.

Nazwa	Typ	Opis
alterations	string[]	Słowa, które są ze sobą synonimami.

Error

Objekt

Obiekt błędu. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nazwa	Typ	Opis
code	ErrorCodeType	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	Error[]	Tablica szczegółów dotyczących określonych błędów, które doprowadziły do tego zgłoszonego błędu.
innerError	InnerErrorModel	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.
message	string	Czytelna dla człowieka reprezentacja błędu.
target	string	Element docelowy błędu.

ErrorCodeType

Wyliczanie

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.

Wartość	Opis
BadArgument
EndpointKeysError
ExtractionFailure
Forbidden
KbNotFound
NotFound
OperationNotFound
QnaRuntimeError
QuotaExceeded
SKULimitExceeded
ServiceError
Unauthorized
Unspecified
ValidationFailure

ErrorResponse

Objekt

Odpowiedź na błąd. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nazwa	Typ	Opis
error	Error	Obiekt błędu.

InnerErrorModel

Objekt

Obiekt zawierający bardziej szczegółowe informacje o błędzie. Zgodnie z wytycznymi dotyczącymi interfejsu MICROSOFT One API — https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nazwa	Typ	Opis
code	string	Bardziej szczegółowy kod błędu niż został dostarczony przez błąd zawierający.
innerError	InnerErrorModel	Obiekt zawierający bardziej szczegółowe informacje niż bieżący obiekt o błędzie.

WordAlterationsDTO

Objekt

Kolekcja zmian słów.

Nazwa	Typ	Opis
wordAlterations	AlterationsDTO[]	Kolekcja zmian słów.