你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Call Connection - Get Call

服务:

Communication

API 版本:

2024-09-15

获取正在进行的调用的详细信息属性。

GET {endpoint}/calling/callConnections/{callConnectionId}?api-version=2024-09-15

URI 参数

名称	在	必需	类型	说明
callConnectionId	path	True	string	调用连接 ID。
endpoint	path	True	string url	Azure 通信资源的终结点。
api-version	query	True	string	要调用的 API 版本。

请求头

名称	必需	类型	说明
Authorization	True	string	Azure 通信服务用户访问令牌。

响应

名称	类型	说明
200 OK	CallConnectionProperties	返回调用属性的详细信息。
Other Status Codes	CommunicationErrorResponse	错误

安全性

Authorization

Azure 通信服务用户访问令牌。

类型: apiKey
在: header

示例

CallConnection_GetCall

示例请求

HTTP

GET https://contoso.communications.azure.com/calling/callConnections/18dea47f-b081-4107-9a5c-4300819d2c6c?api-version=2024-09-15

示例响应

状态代码:

200

{
  "callConnectionId": "18dea47f-b081-4107-9a5c-4300819d2c6c",
  "serverCallId": "aHR0cHM6Ly9jb252ZXJzYXRpb251cmwvdGVzdA",
  "sourceCallerIdNumber": {
    "value": "+18440123456"
  },
  "source": {
    "kind": "communicationUser",
    "communicationUser": {
      "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_da7be3a9-8788-42a6-85c6-56b2cf784fce"
    }
  },
  "targets": [
    {
      "kind": "communicationUser",
      "communicationUser": {
        "id": "8:acs:b9614373-fd0b-480c-8fd2-cb58b70eab9f_0f50d091-5bd3-448b-884d-44be7037d9b9"
      }
    },
    {
      "kind": "phoneNumber",
      "phoneNumber": {
        "value": "+14250123456"
      }
    }
  ],
  "callConnectionState": "connected",
  "callbackUri": "https://app.contoso.com/callback"
}

定义

名称	说明
CallConnectionProperties	调用连接的属性
CallConnectionStateModel	调用连接的状态。

CallConnectionProperties

调用连接的属性

名称	类型	说明
answeredBy	CommunicationUserIdentifierModel
answeredFor	PhoneNumberIdentifierModel
callConnectionId	string	调用连接 ID。
callConnectionState	CallConnectionStateModel	调用连接的状态。
callbackUri	string	回调 URI。
correlationId	string	关联 ID。
serverCallId	string	服务器调用 ID。
source	CommunicationIdentifierModel
sourceCallerIdNumber	PhoneNumberIdentifierModel
sourceDisplayName	string	拨打 pstn 号码时，呼叫的显示名称。
targets	CommunicationIdentifierModel[]	调用的目标。

CallConnectionStateModel

调用连接的状态。

名称	类型	说明
connected	string
connecting	string
disconnected	string
disconnecting	string
transferAccepted	string
transferring	string
unknown	string