Web Pub Sub - Get
Получение ресурса и его свойств.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не учитывает регистр. |
resource
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ |
Имя ресурса. |
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть UUID. |
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для этой операции. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Успех. Ответ описывает соответствующий ресурс. |
|
Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
WebPubSub_Get
Образец запроса
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.SignalRService/webPubSub/myWebPubSubService?api-version=2024-03-01
Пример ответа
{
"sku": {
"name": "Premium_P1",
"tier": "Premium",
"size": "P1",
"capacity": 1
},
"properties": {
"provisioningState": "Succeeded",
"externalIP": "10.0.0.1",
"hostName": "mywebpubsubservice.webpubsub.azure.com",
"publicPort": 443,
"serverPort": 443,
"version": "1.0",
"privateEndpointConnections": [
{
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"actionsRequired": "None"
}
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/WebPubSub/myWebPubSubService/privateEndpointConnections/mywebpubsubservice.1fa229cd-bf3f-47f0-8c49-afb36723997e",
"name": "mywebpubsubservice.1fa229cd-bf3f-47f0-8c49-afb36723997e",
"type": "Microsoft.SignalRService/WebPubSub/privateEndpointConnections",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2015-02-03T04:05:06Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2015-02-03T04:05:06Z"
}
}
],
"tls": {
"clientCertEnabled": true
},
"liveTraceConfiguration": {
"enabled": "false",
"categories": [
{
"name": "ConnectivityLogs",
"enabled": "true"
}
]
},
"resourceLogConfiguration": {
"categories": [
{
"name": "ConnectivityLogs",
"enabled": "true"
}
]
},
"networkACLs": {
"defaultAction": "Deny",
"publicNetwork": {
"allow": [
"ClientConnection"
]
},
"privateEndpoints": [
{
"name": "mywebpubsubservice.1fa229cd-bf3f-47f0-8c49-afb36723997e",
"allow": [
"ServerConnection"
]
}
],
"ipRules": [
{
"value": "123.456.789.123/24",
"action": "Allow"
},
{
"value": "123.456.789.123",
"action": "Allow"
},
{
"value": "AppService",
"action": "Allow"
}
]
},
"publicNetworkAccess": "Enabled",
"disableLocalAuth": false,
"disableAadAuth": false,
"regionEndpointEnabled": "Enabled",
"resourceStopped": "false",
"socketIO": {
"serviceMode": "Serverless"
}
},
"kind": "WebPubSub",
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"location": "eastus",
"tags": {
"key1": "value1"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myResourceGroup/providers/Microsoft.SignalRService/WebPubSub/myWebPubSubService",
"name": "myWebPubSubService",
"type": "Microsoft.SignalRService/WebPubSub",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2015-02-03T04:05:06Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2015-02-03T04:05:06Z"
}
}
Определения
Имя | Описание |
---|---|
ACLAction |
Действие ACL сети Azure. |
created |
Тип удостоверения, создавшего ресурс. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Ответ на ошибку |
IPRule |
Правило IP-адресов |
Live |
Конфигурация категории динамической трассировки ресурса Microsoft.SignalRService. |
Live |
Конфигурация динамической трассировки ресурса Microsoft.SignalRService. |
Managed |
Класс представляет управляемые удостоверения, используемые для запроса и ответа |
Managed |
Представляет тип удостоверения: systemAssigned, userAssigned, None |
NetworkACL |
ACL сети |
Private |
Частная конечная точка |
Private |
ACL для частной конечной точки |
Private |
Подключение частной конечной точки к ресурсу Azure |
Private |
Состояние подключения частной конечной точки |
Private |
Указывает, утверждено ли подключение, отклонено или удалено владельцем службы. |
Provisioning |
Состояние подготовки ресурса. |
Resource |
Конфигурация категории журналов ресурсов ресурса Microsoft.SignalRService. |
Resource |
Конфигурация журнала ресурсов ресурса Microsoft.SignalRService. |
Resource |
Сведения о выставлении счетов ресурса. |
Service |
Тип службы |
Shared |
Описание ресурса общего приватного канала |
Shared |
Состояние ресурса общего приватного канала |
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
User |
Свойства назначаемого пользователем удостоверения. |
Web |
Сетевые списки управления доступом для ресурса |
Web |
Тип входящего запроса в службу |
Web |
Класс представляет ресурс. |
Web |
Необязательный уровень этого конкретного номера SKU. "Стандартный" или "Бесплатный".
|
Web |
Параметры SocketIO для ресурса |
Web |
Параметры TLS для ресурса |
ACLAction
Действие ACL сети Azure.
Значение | Описание |
---|---|
Allow | |
Deny |
createdByType
Тип удостоверения, создавшего ресурс.
Значение | Описание |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |
IPRule
Правило IP-адресов
Имя | Тип | Описание |
---|---|---|
action |
Действие ACL сети Azure. |
|
value |
string |
IP-адрес или CIDR или ServiceTag |
LiveTraceCategory
Конфигурация категории динамической трассировки ресурса Microsoft.SignalRService.
Имя | Тип | Описание |
---|---|---|
enabled |
string |
Указывает, включена ли категория динамической трассировки. Доступные значения: true, false. Без учета регистра. |
name |
string |
Возвращает или задает имя категории динамической трассировки. Доступные значения: ConnectivityLogs, MessagingLogs. Без учета регистра. |
LiveTraceConfiguration
Конфигурация динамической трассировки ресурса Microsoft.SignalRService.
Имя | Тип | Default value | Описание |
---|---|---|---|
categories |
Возвращает или задает список конфигураций категорий. |
||
enabled |
string |
false |
Указывает, включена ли динамическая трассировка. Если задано значение true, клиент динамической трассировки может подключиться к службе. В противном случае клиент динамической трассировки не может подключиться к службе, чтобы получить любой журнал независимо от того, что вы настраиваете в категориях. Доступные значения: true, false. Без учета регистра. |
ManagedIdentity
Класс представляет управляемые удостоверения, используемые для запроса и ответа
Имя | Тип | Описание |
---|---|---|
principalId |
string |
Получите идентификатор субъекта для назначенного системой удостоверения. Используется только в ответе. |
tenantId |
string |
Получите идентификатор клиента для назначенного системой удостоверения. Использовать только в ответе |
type |
Представляет тип удостоверения: systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
Получение или установка назначенных пользователем удостоверений |
ManagedIdentityType
Представляет тип удостоверения: systemAssigned, userAssigned, None
Значение | Описание |
---|---|
None | |
SystemAssigned | |
UserAssigned |
NetworkACL
ACL сети
Имя | Тип | Описание |
---|---|---|
allow |
Разрешенные типы запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Типы отклоненных запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI. |
PrivateEndpoint
Частная конечная точка
Имя | Тип | Описание |
---|---|---|
id |
string |
Полный идентификатор частной конечной точки |
PrivateEndpointACL
ACL для частной конечной точки
Имя | Тип | Описание |
---|---|---|
allow |
Разрешенные типы запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Типы отклоненных запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI. |
|
name |
string |
Имя подключения частной конечной точки |
PrivateEndpointConnection
Подключение частной конечной точки к ресурсу Azure
Имя | Тип | Описание |
---|---|---|
id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Имя ресурса |
properties.groupIds |
string[] |
Идентификаторы групп |
properties.privateEndpoint |
Частная конечная точка |
|
properties.privateLinkServiceConnectionState |
Состояние подключения частной конечной точки |
|
properties.provisioningState |
Состояние подготовки ресурса. |
|
systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
PrivateLinkServiceConnectionState
Состояние подключения частной конечной точки
Имя | Тип | Описание |
---|---|---|
actionsRequired |
string |
Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя. |
description |
string |
Причина утверждения или отклонения подключения. |
status |
Указывает, утверждено ли подключение, отклонено или удалено владельцем службы. |
PrivateLinkServiceConnectionStatus
Указывает, утверждено ли подключение, отклонено или удалено владельцем службы.
Значение | Описание |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
ProvisioningState
Состояние подготовки ресурса.
Значение | Описание |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Moving | |
Running | |
Succeeded | |
Unknown | |
Updating |
ResourceLogCategory
Конфигурация категории журналов ресурсов ресурса Microsoft.SignalRService.
Имя | Тип | Описание |
---|---|---|
enabled |
string |
Указывает, включена ли категория журнала ресурсов. Доступные значения: true, false. Без учета регистра. |
name |
string |
Возвращает или задает имя категории журнала ресурсов. Доступные значения: ConnectivityLogs, MessagingLogs. Без учета регистра. |
ResourceLogConfiguration
Конфигурация журнала ресурсов ресурса Microsoft.SignalRService.
Имя | Тип | Описание |
---|---|---|
categories |
Возвращает или задает список конфигураций категорий. |
ResourceSku
Сведения о выставлении счетов ресурса.
Имя | Тип | Описание |
---|---|---|
capacity |
integer (int32) |
Необязательное целое число. Количество единиц ресурса. 1 для Free_F1/Standard_S1/Premium_P1, 100 для Premium_P2 по умолчанию. При наличии допустимы следующие значения: Free_F1: 1; Standard_S1: 1,2,3,4,5,6,7,8 9 10 20 30 40 50 60 70 80 90 100; Premium_P1: 1,2,3,4,5,6,7,8,9 10 20 30 40 50 60 70 80 90 100; Premium_P2: 100 200 300 400 500 600 700 800 900 1000; |
family |
string |
Не используется. Сохранено для дальнейшего использования. |
name |
string |
Имя номера SKU. Обязательное. Допустимые значения: Standard_S1, Free_F1, Premium_P1, Premium_P2 |
size |
string |
Не используется. Сохранено для дальнейшего использования. |
tier |
Необязательный уровень этого конкретного номера SKU. "Стандартный" или "Бесплатный".
|
ServiceKind
Тип службы
Значение | Описание |
---|---|
SocketIO | |
WebPubSub |
SharedPrivateLinkResource
Описание ресурса общего приватного канала
Имя | Тип | Описание |
---|---|---|
id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Имя ресурса |
properties.groupId |
string |
Идентификатор группы поставщика ресурса, для которой используется общий ресурс приватного канала. |
properties.privateLinkResourceId |
string |
Идентификатор ресурса, для которой используется общий ресурс приватного канала. |
properties.provisioningState |
Состояние подготовки ресурса. |
|
properties.requestMessage |
string |
Сообщение запроса для запроса утверждения общего ресурса приватного канала |
properties.status |
Состояние ресурса общего приватного канала |
|
systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceStatus
Состояние ресурса общего приватного канала
Значение | Описание |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected | |
Timeout |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |
UserAssignedIdentityProperty
Свойства назначаемого пользователем удостоверения.
Имя | Тип | Описание |
---|---|---|
clientId |
string |
Получение идентификатора клиента для назначаемого пользователем удостоверения |
principalId |
string |
Получение идентификатора субъекта для назначенного пользователем удостоверения |
WebPubSubNetworkACLs
Сетевые списки управления доступом для ресурса
Имя | Тип | Описание |
---|---|---|
defaultAction |
Действие ACL сети Azure. |
|
ipRules |
IPRule[] |
Правила IP-адресов для фильтрации общедоступного трафика |
privateEndpoints |
Списки управления доступом для запросов из частных конечных точек |
|
publicNetwork |
ACL сети |
WebPubSubRequestType
Тип входящего запроса в службу
Значение | Описание |
---|---|
ClientConnection | |
RESTAPI | |
ServerConnection | |
Trace |
WebPubSubResource
Класс представляет ресурс.
Имя | Тип | Default value | Описание |
---|---|---|---|
id |
string (arm-id) |
Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
identity |
Класс представляет управляемые удостоверения, используемые для запроса и ответа |
||
kind |
Тип службы |
||
location |
string |
Географическое расположение, в котором находится ресурс |
|
name |
string |
Имя ресурса |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth Enable или disable aad auth When set as true, connection with AuthType=aad не будет работать. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth Enable или disable local auth with AccessKey When set as true, connection with AccessKey=xxx не будет работать. |
properties.externalIP |
string |
Общедоступный IP-адрес ресурса. |
|
properties.hostName |
string |
Полное доменное имя экземпляра службы. |
|
properties.hostNamePrefix |
string |
Устарело. |
|
properties.liveTraceConfiguration |
Конфигурация динамической трассировки ресурса Microsoft.SignalRService. |
||
properties.networkACLs |
Сетевые списки управления доступом для ресурса |
||
properties.privateEndpointConnections |
Подключения частной конечной точки к ресурсу. |
||
properties.provisioningState |
Состояние подготовки ресурса. |
||
properties.publicNetworkAccess |
string |
Enabled |
Включение или отключение доступа к общедоступной сети. Значение по умолчанию — "Включено". Если он включен, сетевые списки управления доступом по-прежнему применяются. Если он отключен, доступ к общедоступной сети всегда отключен независимо от того, что вы устанавливаете в сетевых списках управления доступом. |
properties.publicPort |
integer (int32) |
Общедоступный порт ресурса, предназначенный для использования на стороне браузера или клиента. |
|
properties.regionEndpointEnabled |
string |
Enabled |
Включите или отключите региональную конечную точку. Значение по умолчанию — "Включено". При отключении новые подключения не будут перенаправлены в эту конечную точку, однако существующие подключения не будут затронуты. Это свойство зависит от реплики. Отключить региональную конечную точку без реплики запрещено. |
properties.resourceLogConfiguration |
Конфигурация журнала ресурсов ресурса Microsoft.SignalRService. |
||
properties.resourceStopped |
string |
false |
Остановите или запустите ресурс. По умолчанию — False. Если это верно, плоскость данных ресурса завершается. Когда это значение равно false, запускается плоскость данных ресурса. |
properties.serverPort |
integer (int32) |
Общедоступный порт ресурса, предназначенный для использования на стороне клиента. |
|
properties.sharedPrivateLinkResources |
Список общих ресурсов приватного канала. |
||
properties.socketIO |
Параметры SocketIO для ресурса |
||
properties.tls |
Параметры TLS для ресурса |
||
properties.version |
string |
Версия ресурса. Возможно, вам нужна та же или более поздняя версия клиентских пакетов SDK. |
|
sku |
Сведения о выставлении счетов ресурса. |
||
systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
||
tags |
object |
Теги ресурсов. |
|
type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
WebPubSubSkuTier
Необязательный уровень этого конкретного номера SKU. "Стандартный" или "Бесплатный".
Basic
устарели, вместо этого используйте Standard
.
Значение | Описание |
---|---|
Basic | |
Free | |
Premium | |
Standard |
WebPubSubSocketIOSettings
Параметры SocketIO для ресурса
Имя | Тип | Описание |
---|---|---|
serviceMode |
string |
Режим службы Web PubSub для Socket.IO. Допустимые значения: "Default": у вас есть собственный сервер серверной Socket.IO "Бессерверный": у вашего приложения нет серверного сервера. |
WebPubSubTlsSettings
Параметры TLS для ресурса
Имя | Тип | Default value | Описание |
---|---|---|---|
clientCertEnabled |
boolean |
False |
Запрос сертификата клиента во время подтверждения TLS, если включен. Не поддерживается для бесплатного уровня. Любые входные данные будут игнорироваться для бесплатного уровня. |