Communication Services - List By Subscription
List By Subscription (Enumerar por suscripción)
Controla las solicitudes para enumerar todos los recursos de una suscripción.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Communication/communicationServices?api-version=2023-03-31
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
subscription
|
path | True |
string uuid |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
api-version
|
query | True |
string |
Versión de API que se usará para la operación. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Correcto. La respuesta describe la lista de CommunicationServices en la suscripción. |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
Ejemplos
List by subscription
Solicitud de ejemplo
Respuesta de muestra
{
"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"
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Communication |
Clase que representa un recurso CommunicationService. |
Communication |
Objeto que incluye una matriz de CommunicationServices y un posible vínculo para el siguiente conjunto. |
Communication |
Estado de aprovisionamiento del recurso. |
created |
Tipo de identidad que creó el recurso. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
CommunicationServiceResource
Clase que representa un recurso CommunicationService.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.dataLocation |
string |
Ubicación donde el servicio de comunicación almacena sus datos en reposo. |
properties.hostName |
string |
FQDN de la instancia de CommunicationService. |
properties.immutableResourceId |
string |
Identificador de recurso inmutable del servicio de comunicación. |
properties.linkedDomains |
string[] |
Lista de identificadores de recursos de dominio de correo electrónico. |
properties.notificationHubId |
string |
Identificador de recurso de un centro de notificaciones de Azure vinculado a este recurso. |
properties.provisioningState |
Estado de aprovisionamiento del recurso. |
|
properties.version |
string |
Versión del recurso CommunicationService. Probablemente necesite la misma versión o posterior de los SDK de cliente. |
systemData |
Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
CommunicationServiceResourceList
Objeto que incluye una matriz de CommunicationServices y un posible vínculo para el siguiente conjunto.
Nombre | Tipo | Description |
---|---|---|
nextLink |
string |
La dirección URL que el cliente debe usar para capturar la página siguiente (por paginación del lado servidor). Es null por ahora, agregado para su uso futuro. |
value |
Lista de CommunicationService |
CommunicationServices_ProvisioningState
Estado de aprovisionamiento del recurso.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |