Get Chat Thread - Get Chat Thread

Serviço:: Communication

Versão da API:: 2020-09-21-preview2

Obtém um tópico de bate-papo.

GET {endpoint}/chat/threads/{chatThreadId}?api-version=2020-09-21-preview2

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
chatThreadId	path	True	string	ID do thread para obter.
endpoint	path	True	string	O ponto de extremidade do recurso de Comunicação do Azure.
api-version	query	True	string	Versão da API a invocar.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Authorization	True	string	Um token de acesso de usuário ACS (Serviços de Comunicação do Azure).

Respostas

Name	Tipo	Description
200 OK	ChatThread	Pedido bem-sucedido. A ação retorna um recurso `Thread`.
401 Unauthorized	Error	Não autorizado
403 Forbidden	Error	Proibido
429 Too Many Requests	Error	Demasiados pedidos
Other Status Codes	Error	Serviço indisponível

Segurança

Authorization

Um token de acesso de usuário ACS (Serviços de Comunicação do Azure).

Tipo: apiKey
Em: header

Exemplos

Get chat thread

Pedido de amostra

HTTP

GET https://contoso.westus.communications.azure.com/chat/threads/19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2?api-version=2020-09-21-preview2

Resposta da amostra

Código de estado:: 200

{
  "id": "19:uni01_zbnh3nt2dfuffezc3sox7dog7wfhk6y5qe2rwlnfhlhdzirihdpq@thread.v2",
  "topic": "Lunch",
  "createdOn": "2020-06-06T05:55:41.6460000Z",
  "createdBy": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
  "members": [
    {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10a",
      "shareHistoryTime": "2020-06-06T05:55:41Z"
    },
    {
      "id": "8:acs:8540c0de-899f-5cce-acb5-3ec493af3800_0e59221d-0c1d-46ae-9544-c963ce56c10b",
      "shareHistoryTime": "2020-06-06T05:55:41Z"
    }
  ]
}

Código de estado:: 401

{
  "code": "Unauthorized",
  "message": "Request is not authorized."
}

Código de estado:: 403

{
  "code": "Forbidden",
  "message": "User is not allowed to perform specified action."
}

Código de estado:: 429

{
  "code": "TooManyRequests",
  "message": "Rate limit exceeded."
}

Código de estado:: 503

{
  "code": "ServiceUnavailable",
  "message": "The server is currently unable to handle the request."
}

Definições

Name	Description
ChatThread
ChatThreadMember	Um membro do tópico de chat.
Error

ChatThread

Object

Name	Tipo	Description
createdBy	string	ID do proprietário do tópico de chat.
createdOn	string (date-time)	O carimbo de data/hora quando o thread de bate-papo foi criado. O carimbo de data/hora está no formato ISO8601: `yyyy-MM-ddTHH:mm:ssZ`.
id	string	ID do tópico de chat.
members	ChatThreadMember[]	Membros do tópico de bate-papo.
topic	string	Tópico do tópico do bate-papo.

ChatThreadMember

Object

Um membro do tópico de chat.

Name	Tipo	Description
displayName	string	Nome de exibição para o membro do thread de chat.
id	string	O id do membro do tópico de bate-papo no formato `8:acs:ResourceId_AcsUserId`.
shareHistoryTime	string (date-time)	Tempo a partir do qual o histórico de bate-papo é compartilhado com o membro. O carimbo de data/hora está no formato ISO8601: `yyyy-MM-ddTHH:mm:ssZ`.

Error

Object

Name	Tipo	Description
code	string
innerErrors	Error[]
message	string
target	string