Web Pub Sub - Get
Get the resource and its properties.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2023-02-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal. |
resource
|
path | True |
string |
The name of the resource. |
subscription
|
path | True |
string |
Gets subscription Id which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client Api Version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Success. The response describes the corresponding resource. |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
WebPubSub_Get
Sample Request
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.SignalRService/webPubSub/myWebPubSubService?api-version=2023-02-01
Sample Response
{
"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": [
{
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2015-02-03T04:05:06Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2015-02-03T04:05:06Z"
},
"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"
}
],
"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"
]
}
]
},
"publicNetworkAccess": "Enabled",
"disableLocalAuth": false,
"disableAadAuth": false
},
"identity": {
"type": "SystemAssigned",
"principalId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000"
},
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2015-02-03T04:05:06Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2015-02-03T04:05:06Z"
},
"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"
}
Definitions
Name | Description |
---|---|
ACLAction |
Azure Networking ACL Action. |
created |
The type of identity that created the resource. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Live |
Live trace category configuration of a Microsoft.SignalRService resource. |
Live |
Live trace configuration of a Microsoft.SignalRService resource. |
Managed |
A class represent managed identities used for request and response |
Managed |
Represents the identity type: systemAssigned, userAssigned, None |
NetworkACL |
Network ACL |
Private |
Private endpoint |
Private |
ACL for a private endpoint |
Private |
A private endpoint connection to an azure resource |
Private |
Connection state of the private endpoint connection |
Private |
Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. |
Provisioning |
Provisioning state of the resource. |
Resource |
Resource log category configuration of a Microsoft.SignalRService resource. |
Resource |
Resource log configuration of a Microsoft.SignalRService resource. |
Resource |
The billing information of the resource. |
Shared |
Describes a Shared Private Link Resource |
Shared |
Status of the shared private link resource |
system |
Metadata pertaining to creation and last modification of the resource. |
User |
Properties of user assigned identity. |
Web |
Network ACLs for the resource |
Web |
The incoming request type to the service |
Web |
A class represent a resource. |
Web |
Optional tier of this particular SKU. 'Standard' or 'Free'.
|
Web |
TLS settings for the resource |
ACLAction
Azure Networking ACL Action.
Name | Type | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
createdByType
The type of identity that created the resource.
Name | Type | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
LiveTraceCategory
Live trace category configuration of a Microsoft.SignalRService resource.
Name | Type | Description |
---|---|---|
enabled |
string |
Indicates whether or the live trace category is enabled. Available values: true, false. Case insensitive. |
name |
string |
Gets or sets the live trace category's name. Available values: ConnectivityLogs, MessagingLogs. Case insensitive. |
LiveTraceConfiguration
Live trace configuration of a Microsoft.SignalRService resource.
Name | Type | Default Value | Description |
---|---|---|---|
categories |
Gets or sets the list of category configurations. |
||
enabled |
string |
false |
Indicates whether or not enable live trace. When it's set to true, live trace client can connect to the service. Otherwise, live trace client can't connect to the service, so that you are unable to receive any log, no matter what you configure in "categories". Available values: true, false. Case insensitive. |
ManagedIdentity
A class represent managed identities used for request and response
Name | Type | Description |
---|---|---|
principalId |
string |
Get the principal id for the system assigned identity. Only be used in response. |
tenantId |
string |
Get the tenant id for the system assigned identity. Only be used in response |
type |
Represents the identity type: systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
Get or set the user assigned identities |
ManagedIdentityType
Represents the identity type: systemAssigned, userAssigned, None
Name | Type | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
NetworkACL
Network ACL
Name | Type | Description |
---|---|---|
allow |
Allowed request types. The value can be one or more of: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Denied request types. The value can be one or more of: ClientConnection, ServerConnection, RESTAPI. |
PrivateEndpoint
Private endpoint
Name | Type | Description |
---|---|---|
id |
string |
Full qualified Id of the private endpoint |
PrivateEndpointACL
ACL for a private endpoint
Name | Type | Description |
---|---|---|
allow |
Allowed request types. The value can be one or more of: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Denied request types. The value can be one or more of: ClientConnection, ServerConnection, RESTAPI. |
|
name |
string |
Name of the private endpoint connection |
PrivateEndpointConnection
A private endpoint connection to an azure resource
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource Id for the resource. |
name |
string |
The name of the resource. |
properties.groupIds |
string[] |
Group IDs |
properties.privateEndpoint |
Private endpoint |
|
properties.privateLinkServiceConnectionState |
Connection state of the private endpoint connection |
|
properties.provisioningState |
Provisioning state of the resource. |
|
systemData |
Metadata pertaining to creation and last modification of the resource. |
|
type |
string |
The type of the resource - e.g. "Microsoft.SignalRService/SignalR" |
PrivateLinkServiceConnectionState
Connection state of the private endpoint connection
Name | Type | Description |
---|---|---|
actionsRequired |
string |
A message indicating if changes on the service provider require any updates on the consumer. |
description |
string |
The reason for approval/rejection of the connection. |
status |
Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. |
PrivateLinkServiceConnectionStatus
Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service.
Name | Type | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
ProvisioningState
Provisioning state of the resource.
Name | Type | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
ResourceLogCategory
Resource log category configuration of a Microsoft.SignalRService resource.
Name | Type | Description |
---|---|---|
enabled |
string |
Indicates whether or the resource log category is enabled. Available values: true, false. Case insensitive. |
name |
string |
Gets or sets the resource log category's name. Available values: ConnectivityLogs, MessagingLogs. Case insensitive. |
ResourceLogConfiguration
Resource log configuration of a Microsoft.SignalRService resource.
Name | Type | Description |
---|---|---|
categories |
Gets or sets the list of category configurations. |
ResourceSku
The billing information of the resource.
Name | Type | Description |
---|---|---|
capacity |
integer |
Optional, integer. The unit count of the resource. 1 by default. If present, following values are allowed: Free: 1; Standard: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100; Premium: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100; |
family |
string |
Not used. Retained for future use. |
name |
string |
The name of the SKU. Required. Allowed values: Standard_S1, Free_F1, Premium_P1 |
size |
string |
Not used. Retained for future use. |
tier |
Optional tier of this particular SKU. 'Standard' or 'Free'.
|
SharedPrivateLinkResource
Describes a Shared Private Link Resource
Name | Type | Description |
---|---|---|
id |
string |
Fully qualified resource Id for the resource. |
name |
string |
The name of the resource. |
properties.groupId |
string |
The group id from the provider of resource the shared private link resource is for |
properties.privateLinkResourceId |
string |
The resource id of the resource the shared private link resource is for |
properties.provisioningState |
Provisioning state of the resource. |
|
properties.requestMessage |
string |
The request message for requesting approval of the shared private link resource |
properties.status |
Status of the shared private link resource |
|
systemData |
Metadata pertaining to creation and last modification of the resource. |
|
type |
string |
The type of the resource - e.g. "Microsoft.SignalRService/SignalR" |
SharedPrivateLinkResourceStatus
Status of the shared private link resource
Name | Type | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
|
Timeout |
string |
systemData
Metadata pertaining to creation and last modification of the resource.
Name | Type | Description |
---|---|---|
createdAt |
string |
The timestamp of resource creation (UTC). |
createdBy |
string |
The identity that created the resource. |
createdByType |
The type of identity that created the resource. |
|
lastModifiedAt |
string |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
The identity that last modified the resource. |
lastModifiedByType |
The type of identity that last modified the resource. |
UserAssignedIdentityProperty
Properties of user assigned identity.
Name | Type | Description |
---|---|---|
clientId |
string |
Get the client id for the user assigned identity |
principalId |
string |
Get the principal id for the user assigned identity |
WebPubSubNetworkACLs
Network ACLs for the resource
Name | Type | Description |
---|---|---|
defaultAction |
Azure Networking ACL Action. |
|
privateEndpoints |
ACLs for requests from private endpoints |
|
publicNetwork |
Network ACL |
WebPubSubRequestType
The incoming request type to the service
Name | Type | Description |
---|---|---|
ClientConnection |
string |
|
RESTAPI |
string |
|
ServerConnection |
string |
|
Trace |
string |
WebPubSubResource
A class represent a resource.
Name | Type | Default Value | Description |
---|---|---|---|
id |
string |
Fully qualified resource Id for the resource. |
|
identity |
A class represent managed identities used for request and response |
||
location |
string |
The GEO location of the resource. e.g. West US | East US | North Central US | South Central US. |
|
name |
string |
The name of the resource. |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth Enable or disable aad auth When set as true, connection with AuthType=aad won't work. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth Enable or disable local auth with AccessKey When set as true, connection with AccessKey=xxx won't work. |
properties.externalIP |
string |
The publicly accessible IP of the resource. |
|
properties.hostName |
string |
FQDN of the service instance. |
|
properties.hostNamePrefix |
string |
Deprecated. |
|
properties.liveTraceConfiguration |
Live trace configuration of a Microsoft.SignalRService resource. |
||
properties.networkACLs |
Network ACLs for the resource |
||
properties.privateEndpointConnections |
Private endpoint connections to the resource. |
||
properties.provisioningState |
Provisioning state of the resource. |
||
properties.publicNetworkAccess |
string |
Enabled |
Enable or disable public network access. Default to "Enabled". When it's Enabled, network ACLs still apply. When it's Disabled, public network access is always disabled no matter what you set in network ACLs. |
properties.publicPort |
integer |
The publicly accessible port of the resource which is designed for browser/client side usage. |
|
properties.resourceLogConfiguration |
Resource log configuration of a Microsoft.SignalRService resource. |
||
properties.serverPort |
integer |
The publicly accessible port of the resource which is designed for customer server side usage. |
|
properties.sharedPrivateLinkResources |
The list of shared private link resources. |
||
properties.tls |
TLS settings for the resource |
||
properties.version |
string |
Version of the resource. Probably you need the same or higher version of client SDKs. |
|
sku |
The billing information of the resource. |
||
systemData |
Metadata pertaining to creation and last modification of the resource. |
||
tags |
object |
Tags of the service which is a list of key value pairs that describe the resource. |
|
type |
string |
The type of the resource - e.g. "Microsoft.SignalRService/SignalR" |
WebPubSubSkuTier
Optional tier of this particular SKU. 'Standard' or 'Free'.
Basic
is deprecated, use Standard
instead.
Name | Type | Description |
---|---|---|
Basic |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
WebPubSubTlsSettings
TLS settings for the resource
Name | Type | Default Value | Description |
---|---|---|---|
clientCertEnabled |
boolean |
True |
Request client certificate during TLS handshake if enabled |