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

Call Connection - Get Call

参考

服务:: Communication

API 版本:: 2024-06-15-preview

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

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

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-06-15-preview

示例响应

状态代码:: 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	调用连接的状态。
MediaStreamingContentType	要流式传输的内容类型，例如音频
MediaStreamingSubscription	媒体流式处理订阅对象。
MediaStreamingSubscriptionState	媒体流式处理订阅状态。
TranscriptionResultType
TranscriptionSubscription	听录订阅对象。
TranscriptionSubscriptionState	听录订阅状态。

CallConnectionProperties

调用连接的属性

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

CallConnectionStateModel

调用连接的状态。

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

MediaStreamingContentType

要流式传输的内容类型，例如音频

名称	类型	说明
audio	string

MediaStreamingSubscription

媒体流式处理订阅对象。

名称	类型	说明
id	string	订阅 ID。
state	MediaStreamingSubscriptionState	媒体流式处理订阅状态。
subscribedContentTypes	MediaStreamingContentType[]	订阅的媒体流内容类型。

MediaStreamingSubscriptionState

媒体流式处理订阅状态。

名称	类型	说明
active	string
disabled	string
inactive	string

TranscriptionResultType

名称	类型	说明
final	string
intermediate	string

TranscriptionSubscription

听录订阅对象。

名称	类型	说明
id	string	订阅 ID。
state	TranscriptionSubscriptionState	听录订阅状态。
subscribedResultTypes	TranscriptionResultType[]	订阅的听录结果类型。

TranscriptionSubscriptionState

听录订阅状态。

名称	类型	说明
active	string
disabled	string
inactive	string

通过