你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Communication Services - List By Subscription
按订阅列出
处理列出订阅中所有资源的请求。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Communication/communicationServices?api-version=2023-03-31
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
subscription
|
path | True |
string uuid |
目标订阅的 ID。 该值必须是 UUID。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功。 响应描述订阅中的 CommunicationServices 列表。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
示例
List by subscription
示例请求
示例响应
{
"value": [
{
"id": "/subscriptions/11112222-3333-4444-5555-666677778888/resourceGroups/MyResourceGroup/providers/Microsoft.Communication/CommunicationServices/MyCommunicationResource",
"name": "MyCommunicationResource",
"type": "Microsoft.Communication/CommunicationServices",
"location": "Global",
"properties": {
"provisioningState": "Running",
"dataLocation": "United States",
"hostName": "mycommunicationservice.comms.azure.net",
"version": "0.2.0"
}
}
]
}
定义
名称 | 说明 |
---|---|
Communication |
表示 CommunicationService 资源的类。 |
Communication |
包含 CommunicationServices 数组和下一组的可能链接的对象。 |
Communication |
资源的预配状态。 |
created |
创建资源的标识类型。 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
system |
与资源的创建和上次修改相关的元数据。 |
CommunicationServiceResource
表示 CommunicationService 资源的类。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
location |
string |
资源所在的地理位置 |
name |
string |
资源的名称 |
properties.dataLocation |
string |
通信服务存储其静态数据的位置。 |
properties.hostName |
string |
CommunicationService 实例的 FQDN。 |
properties.immutableResourceId |
string |
通信服务的不可变资源 ID。 |
properties.linkedDomains |
string[] |
电子邮件域资源 ID 的列表。 |
properties.notificationHubId |
string |
链接到此资源的 Azure 通知中心的资源 ID。 |
properties.provisioningState |
资源的预配状态。 |
|
properties.version |
string |
CommunicationService 资源的版本。 可能需要相同或更高版本的客户端 SDK。 |
systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
tags |
object |
资源标记。 |
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
CommunicationServiceResourceList
包含 CommunicationServices 数组和下一组的可能链接的对象。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
客户端用于提取每个服务器端分页) (下一页的 URL。 它目前为 null,已添加供将来使用。 |
value |
CommunicationService 列表 |
CommunicationServices_ProvisioningState
资源的预配状态。
名称 | 类型 | 说明 |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |