Поделиться через


Web Pub Sub - Get

Получение ресурса и его свойств.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не учитывает регистр.

resourceName
path True

string

minLength: 3
maxLength: 63
pattern: ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$

Имя ресурса.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть UUID.

api-version
query True

string

minLength: 1

Версия API, используемая для этой операции.

Ответы

Имя Тип Описание
200 OK

WebPubSubResource

Успех. Ответ описывает соответствующий ресурс.

Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

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.

createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

IPRule

Правило IP-адресов

LiveTraceCategory

Конфигурация категории динамической трассировки ресурса Microsoft.SignalRService.

LiveTraceConfiguration

Конфигурация динамической трассировки ресурса Microsoft.SignalRService.

ManagedIdentity

Класс представляет управляемые удостоверения, используемые для запроса и ответа

ManagedIdentityType

Представляет тип удостоверения: systemAssigned, userAssigned, None

NetworkACL

ACL сети

PrivateEndpoint

Частная конечная точка

PrivateEndpointACL

ACL для частной конечной точки

PrivateEndpointConnection

Подключение частной конечной точки к ресурсу Azure

PrivateLinkServiceConnectionState

Состояние подключения частной конечной точки

PrivateLinkServiceConnectionStatus

Указывает, утверждено ли подключение, отклонено или удалено владельцем службы.

ProvisioningState

Состояние подготовки ресурса.

ResourceLogCategory

Конфигурация категории журналов ресурсов ресурса Microsoft.SignalRService.

ResourceLogConfiguration

Конфигурация журнала ресурсов ресурса Microsoft.SignalRService.

ResourceSku

Сведения о выставлении счетов ресурса.

ServiceKind

Тип службы

SharedPrivateLinkResource

Описание ресурса общего приватного канала

SharedPrivateLinkResourceStatus

Состояние ресурса общего приватного канала

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

UserAssignedIdentityProperty

Свойства назначаемого пользователем удостоверения.

WebPubSubNetworkACLs

Сетевые списки управления доступом для ресурса

WebPubSubRequestType

Тип входящего запроса в службу

WebPubSubResource

Класс представляет ресурс.

WebPubSubSkuTier

Необязательный уровень этого конкретного номера SKU. "Стандартный" или "Бесплатный".

Basic устарели, вместо этого используйте Standard.

WebPubSubSocketIOSettings

Параметры SocketIO для ресурса

WebPubSubTlsSettings

Параметры TLS для ресурса

ACLAction

Действие ACL сети Azure.

Значение Описание
Allow
Deny

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

IPRule

Правило IP-адресов

Имя Тип Описание
action

ACLAction

Действие ACL сети Azure.

value

string

IP-адрес или CIDR или ServiceTag

LiveTraceCategory

Конфигурация категории динамической трассировки ресурса Microsoft.SignalRService.

Имя Тип Описание
enabled

string

Указывает, включена ли категория динамической трассировки. Доступные значения: true, false. Без учета регистра.

name

string

Возвращает или задает имя категории динамической трассировки. Доступные значения: ConnectivityLogs, MessagingLogs. Без учета регистра.

LiveTraceConfiguration

Конфигурация динамической трассировки ресурса Microsoft.SignalRService.

Имя Тип Default value Описание
categories

LiveTraceCategory[]

Возвращает или задает список конфигураций категорий.

enabled

string

false

Указывает, включена ли динамическая трассировка. Если задано значение true, клиент динамической трассировки может подключиться к службе. В противном случае клиент динамической трассировки не может подключиться к службе, чтобы получить любой журнал независимо от того, что вы настраиваете в категориях. Доступные значения: true, false. Без учета регистра.

ManagedIdentity

Класс представляет управляемые удостоверения, используемые для запроса и ответа

Имя Тип Описание
principalId

string

Получите идентификатор субъекта для назначенного системой удостоверения. Используется только в ответе.

tenantId

string

Получите идентификатор клиента для назначенного системой удостоверения. Использовать только в ответе

type

ManagedIdentityType

Представляет тип удостоверения: systemAssigned, userAssigned, None

userAssignedIdentities

<string,  UserAssignedIdentityProperty>

Получение или установка назначенных пользователем удостоверений

ManagedIdentityType

Представляет тип удостоверения: systemAssigned, userAssigned, None

Значение Описание
None
SystemAssigned
UserAssigned

NetworkACL

ACL сети

Имя Тип Описание
allow

WebPubSubRequestType[]

Разрешенные типы запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI.

deny

WebPubSubRequestType[]

Типы отклоненных запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI.

PrivateEndpoint

Частная конечная точка

Имя Тип Описание
id

string

Полный идентификатор частной конечной точки

PrivateEndpointACL

ACL для частной конечной точки

Имя Тип Описание
allow

WebPubSubRequestType[]

Разрешенные типы запросов. Значение может быть одним или несколькими: ClientConnection, ServerConnection, RESTAPI.

deny

WebPubSubRequestType[]

Типы отклоненных запросов. Значение может быть одним или несколькими: 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

PrivateEndpoint

Частная конечная точка

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Состояние подключения частной конечной точки

properties.provisioningState

ProvisioningState

Состояние подготовки ресурса.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

PrivateLinkServiceConnectionState

Состояние подключения частной конечной точки

Имя Тип Описание
actionsRequired

string

Сообщение, указывающее, требуются ли изменения в поставщике услуг, требуются какие-либо обновления для потребителя.

description

string

Причина утверждения или отклонения подключения.

status

PrivateLinkServiceConnectionStatus

Указывает, утверждено ли подключение, отклонено или удалено владельцем службы.

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

ResourceLogCategory[]

Возвращает или задает список конфигураций категорий.

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

WebPubSubSkuTier

Необязательный уровень этого конкретного номера SKU. "Стандартный" или "Бесплатный".

Basic устарели, вместо этого используйте Standard.

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

ProvisioningState

Состояние подготовки ресурса.

properties.requestMessage

string

Сообщение запроса для запроса утверждения общего ресурса приватного канала

properties.status

SharedPrivateLinkResourceStatus

Состояние ресурса общего приватного канала

systemData

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

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.

UserAssignedIdentityProperty

Свойства назначаемого пользователем удостоверения.

Имя Тип Описание
clientId

string

Получение идентификатора клиента для назначаемого пользователем удостоверения

principalId

string

Получение идентификатора субъекта для назначенного пользователем удостоверения

WebPubSubNetworkACLs

Сетевые списки управления доступом для ресурса

Имя Тип Описание
defaultAction

ACLAction

Действие ACL сети Azure.

ipRules

IPRule[]

Правила IP-адресов для фильтрации общедоступного трафика

privateEndpoints

PrivateEndpointACL[]

Списки управления доступом для запросов из частных конечных точек

publicNetwork

NetworkACL

ACL сети

WebPubSubRequestType

Тип входящего запроса в службу

Значение Описание
ClientConnection
RESTAPI
ServerConnection
Trace

WebPubSubResource

Класс представляет ресурс.

Имя Тип Default value Описание
id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

ManagedIdentity

Класс представляет управляемые удостоверения, используемые для запроса и ответа

kind

ServiceKind

Тип службы

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

LiveTraceConfiguration

Конфигурация динамической трассировки ресурса Microsoft.SignalRService.

properties.networkACLs

WebPubSubNetworkACLs

Сетевые списки управления доступом для ресурса

properties.privateEndpointConnections

PrivateEndpointConnection[]

Подключения частной конечной точки к ресурсу.

properties.provisioningState

ProvisioningState

Состояние подготовки ресурса.

properties.publicNetworkAccess

string

Enabled

Включение или отключение доступа к общедоступной сети. Значение по умолчанию — "Включено". Если он включен, сетевые списки управления доступом по-прежнему применяются. Если он отключен, доступ к общедоступной сети всегда отключен независимо от того, что вы устанавливаете в сетевых списках управления доступом.

properties.publicPort

integer (int32)

Общедоступный порт ресурса, предназначенный для использования на стороне браузера или клиента.

properties.regionEndpointEnabled

string

Enabled

Включите или отключите региональную конечную точку. Значение по умолчанию — "Включено". При отключении новые подключения не будут перенаправлены в эту конечную точку, однако существующие подключения не будут затронуты. Это свойство зависит от реплики. Отключить региональную конечную точку без реплики запрещено.

properties.resourceLogConfiguration

ResourceLogConfiguration

Конфигурация журнала ресурсов ресурса Microsoft.SignalRService.

properties.resourceStopped

string

false

Остановите или запустите ресурс. По умолчанию — False. Если это верно, плоскость данных ресурса завершается. Когда это значение равно false, запускается плоскость данных ресурса.

properties.serverPort

integer (int32)

Общедоступный порт ресурса, предназначенный для использования на стороне клиента.

properties.sharedPrivateLinkResources

SharedPrivateLinkResource[]

Список общих ресурсов приватного канала.

properties.socketIO

WebPubSubSocketIOSettings

Параметры SocketIO для ресурса

properties.tls

WebPubSubTlsSettings

Параметры TLS для ресурса

properties.version

string

Версия ресурса. Возможно, вам нужна та же или более поздняя версия клиентских пакетов SDK.

sku

ResourceSku

Сведения о выставлении счетов ресурса.

systemData

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, если включен. Не поддерживается для бесплатного уровня. Любые входные данные будут игнорироваться для бесплатного уровня.