計量概觀
Azure 通訊服務目前提供所有 Azure 通訊服務基本類型的計量。 Azure 計量瀏覽器可用來繪製您自己的圖表、調查計量值中的異常狀況,以及使用電子郵件要求發出的計量資料來了解您的 API 流量。
計量所在位置
Azure 通訊服務中的基本類型會發出 API 要求的計量。 這些計量可在您的「通訊服務」資源下的 [計量] 索引標籤中找到。 您也可使用「通訊服務」資源下的 [活頁簿] 索引標籤來建立永久的儀表板。
計量定義
所有 API 要求計量都包含三個可供您用來篩選計量資料的維度。 這些維度可使用 Count
彙總類型來彙總在一起,並支援所有標準的 Azure 彙總時間序列,包括 Sum
、Average
、Min
和 Max
。
如需所支援彙總類型和時間序列彙總的詳細資訊,請參閱 Azure 計量瀏覽器的進階功能
- 作業 - 可在 Azure 通訊服務聊天閘道上呼叫的所有作業或路由。
- 狀態碼 - 要求之後所傳送的狀態碼回應。
- StatusSubClass - 回應之後所傳送的狀態碼系列。
進階傳訊 API 要求
下列作業適用於進階傳訊 API 要求計量:
作業/路由 | 描述 | 案例 |
---|---|---|
DownloadMedia | 下載媒體承載要求。 | 下載媒體承載的企業要求。 |
ListTemplates | 列出範本要求。 | 列出指定通道範本的企業要求。 |
ReceiveMessage | 已接收的訊息。 | 使用者將訊息傳送給企業。 |
SendMessage | 傳送訊息通知要求。 | 要求將訊息傳送給使用者的企業。 |
SendMessageDeliveryStatus | 已收到傳遞狀態。 | 企業收到與訊息相關的回應,企業要求將該訊息傳送給使用者。 |
驗證 API 要求
下列作業適用於驗證 API 要求計量:
作業/路由 | 描述 |
---|---|
CreateIdentity | 建立代表單一使用者的身分識別。 |
DeleteIdentity | 刪除身分識別。 |
CreateToken | 建立存取權杖。 |
RevokeToken | 撤銷在指定時間之前為身分識別建立的所有存取權杖。 |
ExchangeTeamsUserAccessToken | 將 Teams 使用者的 Microsoft Entra 存取權杖交換為到期時間相符的新通訊身分識別存取權杖。 |
通話自動化 API 要求
下列作業適用於通話自動化 API 要求計量:
作業/路由 | 描述 |
---|---|
建立通話 | 建立對使用者的輸出通話。 |
接聽通話 | 接聽進線通話。 |
重新導向通話 | 將進線通話重新導向至其他使用者。 |
拒絕通話 | 拒絕進線通話。 |
將通話轉接給參與者 | 將一對一通話轉接給其他使用者。 |
Play | 對通話參與者播放音訊。 |
PlayPrompt | 在「辨識」動作中對使用者播放提示。 |
辨識 | 辨識來自通話參與者的使用者輸入。 |
新增參與者 | 將參與者新增至通話。 |
移除參與者 | 將參與者從通話中移除。 |
掛斷通話 | 掛斷您的通話連結。 |
終止通話 | 結束所有參與者的通話。 |
取得通話 | 取得關於通話的詳細資料。 |
取得參與者 | 取得關於通話參與者的詳細資料。 |
取得參與者 | 取得通話中的所有參與者。 |
刪除通話 | 刪除通話。 |
取消所有媒體作業 | 取消通話中所有進行中或已排入佇列的媒體作業。 |
聊天 API 要求計量作業
下列作業適用於聊天 API 要求計量:
作業/路由 | 描述 |
---|---|
GetChatMessage | 依訊息識別碼取得訊息。 |
ListChatMessages | 從對話取得聊天訊息的清單。 |
SendChatMessage | 將聊天訊息傳送至對話。 |
UpdateChatMessage | 更新聊天訊息。 |
DeleteChatMessage | 刪除聊天訊息。 |
GetChatThread | 取得聊天對話。 |
ListChatThreads | 取得使用者的聊天對話清單。 |
UpdateChatThread | 更新聊天對話的屬性。 |
CreateChatThread | 建立聊天對話。 |
DeleteChatThread | 刪除對話。 |
GetReadReceipts | 取得對話的讀取回條。 |
SendReadReceipt | 代表使用者將讀取回條事件傳送至對話。 |
SendTypingIndicator | 代表使用者將輸入事件張貼至對話。 |
ListChatThreadParticipants | 取得對話的成員。 |
AddChatThreadParticipants | 將對話成員新增至對話。 如果成員已存在,則不會發生任何變更。 |
RemoveChatThreadParticipant | 從對話中移除成員。 |
如果對無法辨識的作業提出要求,則會收到「路由不正確」值回應。
工作路由器 API 要求
下列作業適用於工作路由器 API 要求計量:
作業/路由 | 描述 |
---|---|
UpsertClassificationPolicy | 建立或更新分類原則。 |
GetClassificationPolicy | 依識別碼擷取現有的分類原則。 |
ListClassificationPolicies | 擷取現有的分類原則 |
DeleteDistributionPolicy | 依識別碼刪除分類原則。 |
UpsertDistributionPolicy | 建立或更新分配原則。 |
GetDistributionPolicy | 依識別碼擷取現有的分配原則。 |
ListDistributionPolicies | 擷取現有的分配原則 |
DeleteDistributionPolicy | 依識別碼刪除分配原則。 |
UpsertExceptionPolicy | 建立或更新例外狀況原則。 |
GetExceptionPolicy | 依識別碼擷取現有的例外狀況原則。 |
ListExceptionPolicies | 擷取現有的例外狀況原則 |
DeleteExceptionPolicy | 依識別碼刪除例外狀況原則。 |
UpsertQueue | 建立或更新佇列。 |
GetQueue | 依識別碼擷取現有的佇列。 |
GetQueues | 擷取現有的佇列 |
DeleteQueue | 依識別碼刪除佇列。 |
GetQueueStatistics | 擷取佇列的統計資料。 |
UpsertJob | 建立或更新作業。 |
GetJob | 依識別碼擷取現有的作業。 |
GetJobs | 擷取現有的作業 |
DeleteJob | 依識別碼刪除佇列原則。 |
ReclassifyJob | 重新分類作業。 |
CancelJob | 提交要求以依識別碼取消現有作業,同時提供自由格式取消原因。 |
CompleteJob | 完成指派的作業。 |
CloseJob | 關閉已完成的作業。 |
AcceptJobOffer | 接受處理作業的邀請,並在其他代理程式已接受作業時傳回 409/衝突。 |
DeclineJobOffer | 拒絕處理作業的邀請。 |
UpsertWorker | 建立或更新背景工作角色。 |
GetWorker | 依識別碼擷取現有的背景工作角色。 |
GetWorkers | 擷取現有的背景工作角色。 |
DeleteWorker | 刪除背景工作角色及其所有追蹤。 |
網路周遊 API 要求
下列作業適用於網路周遊 API 要求計量:
作業/路由 | 描述 |
---|---|
IssueRelayConfiguration | 發出 STUN/TURN 伺服器的設定。 |
會議室 API 要求
下列作業適用於會議室 API 要求計量:
作業/路由 | 描述 |
---|---|
CreateRoom | 建立會議室。 |
DeleteRoom | 刪除會議室。 |
GetRoom | 依會議室識別碼取得會議室。 |
PatchRoom | 依會議室識別碼更新會議室。 |
ListRooms | 列出 Azure 通訊服務資源的所有會議室。 |
AddParticipants | 將參與者新增至會議室。 |
RemoveParticipants | 從會議室中移除參與者。 |
GetParticipants | 取得會議室的參與者清單。 |
UpdateParticipants | 更新會議室的參與者清單。 |
簡訊 API 要求
下列作業適用於簡訊 API 要求計量:
作業/路由 | 描述 |
---|---|
SMSMessageSent | 傳送簡訊。 |
SMSDeliveryReportsReceived | 取得簡訊傳遞報告 |
SMSMessagesReceived | 取得手機簡訊。 |
下一步
- 深入了解資料平台計量