Web Pub Sub - Get
Haal de resource en de bijbehorende eigenschappen op.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
resource
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ |
De naam van de resource. |
subscription
|
path | True |
string (uuid) |
De id van het doelabonnement. De waarde moet een UUID zijn. |
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Succes. In het antwoord wordt de bijbehorende resource beschreven. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
WebPubSub_Get
Voorbeeldaanvraag
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.SignalRService/webPubSub/myWebPubSubService?api-version=2024-03-01
Voorbeeldrespons
{
"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"
}
}
Definities
Name | Description |
---|---|
ACLAction |
Azure Networking ACL Action. |
created |
Het type identiteit waarmee de resource is gemaakt. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
IPRule |
Een IP-regel |
Live |
Configuratie van livetraceringscategorie van een Microsoft.SignalRService-resource. |
Live |
Live trace-configuratie van een Microsoft.SignalRService-resource. |
Managed |
Een klasse vertegenwoordigt beheerde identiteiten die worden gebruikt voor aanvragen en antwoorden |
Managed |
Vertegenwoordigt het identiteitstype: systemAssigned, userAssigned, None |
NetworkACL |
Netwerk-ACL |
Private |
Privé-eindpunt |
Private |
ACL voor een privé-eindpunt |
Private |
Een privé-eindpuntverbinding met een Azure-resource |
Private |
Verbindingsstatus van de privé-eindpuntverbinding |
Private |
Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service. |
Provisioning |
Inrichtingsstatus van de resource. |
Resource |
Resourcelogboekcategorieconfiguratie van een Microsoft.SignalRService-resource. |
Resource |
Configuratie van resourcelogboek van een Microsoft.SignalRService-resource. |
Resource |
De factureringsgegevens van de resource. |
Service |
Het soort service |
Shared |
Beschrijft een Gedeelde Private Link-resource |
Shared |
Status van de gedeelde private link-resource |
system |
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource. |
User |
Eigenschappen van door de gebruiker toegewezen identiteit. |
Web |
Netwerk-ACL's voor de resource |
Web |
Het binnenkomende aanvraagtype voor de service |
Web |
Een klasse vertegenwoordigt een resource. |
Web |
Optionele laag van deze specifieke SKU. 'Standaard' of 'Gratis'.
|
Web |
SocketIO-instellingen voor de resource |
Web |
TLS-instellingen voor de resource |
ACLAction
Azure Networking ACL Action.
Waarde | Description |
---|---|
Allow | |
Deny |
createdByType
Het type identiteit waarmee de resource is gemaakt.
Waarde | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Aanvullende informatie over de resourcebeheerfout.
Name | Type | Description |
---|---|---|
info |
object |
De aanvullende informatie. |
type |
string |
Het extra informatietype. |
ErrorDetail
De foutdetails.
Name | Type | Description |
---|---|---|
additionalInfo |
De fout bevat aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
Het foutobject. |
IPRule
Een IP-regel
Name | Type | Description |
---|---|---|
action |
Azure Networking ACL Action. |
|
value |
string |
Een IP- of CIDR- of ServiceTag |
LiveTraceCategory
Configuratie van livetraceringscategorie van een Microsoft.SignalRService-resource.
Name | Type | Description |
---|---|---|
enabled |
string |
Geeft aan of de livetraceringscategorie is ingeschakeld. Beschikbare waarden: waar, onwaar. Hoofdlettergevoelig. |
name |
string |
Hiermee haalt u de naam van de live traceringscategorie op of stelt u deze in. Beschikbare waarden: ConnectivityLogs, MessagingLogs. Hoofdlettergevoelig. |
LiveTraceConfiguration
Live trace-configuratie van een Microsoft.SignalRService-resource.
Name | Type | Default value | Description |
---|---|---|---|
categories |
Hiermee haalt u de lijst met categorieconfiguraties op of stelt u deze in. |
||
enabled |
string |
false |
Hiermee wordt aangegeven of livetracering al dan niet is ingeschakeld. Als deze is ingesteld op true, kan de live trace-client verbinding maken met de service. Anders kan de livetraceringsclient geen verbinding maken met de service, zodat u geen logboeken kunt ontvangen, ongeacht wat u configureert in 'categorieën'. Beschikbare waarden: waar, onwaar. Hoofdlettergevoelig. |
ManagedIdentity
Een klasse vertegenwoordigt beheerde identiteiten die worden gebruikt voor aanvragen en antwoorden
Name | Type | Description |
---|---|---|
principalId |
string |
Haal de principal-id op voor de door het systeem toegewezen identiteit. Alleen worden gebruikt in reactie. |
tenantId |
string |
Haal de tenant-id op voor de door het systeem toegewezen identiteit. Alleen worden gebruikt in reactie |
type |
Vertegenwoordigt het identiteitstype: systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
De door de gebruiker toegewezen identiteiten ophalen of instellen |
ManagedIdentityType
Vertegenwoordigt het identiteitstype: systemAssigned, userAssigned, None
Waarde | Description |
---|---|
None | |
SystemAssigned | |
UserAssigned |
NetworkACL
Netwerk-ACL
Name | Type | Description |
---|---|---|
allow |
Toegestane aanvraagtypen. De waarde kan een of meer zijn: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Geweigerde aanvraagtypen. De waarde kan een of meer zijn: ClientConnection, ServerConnection, RESTAPI. |
PrivateEndpoint
Privé-eindpunt
Name | Type | Description |
---|---|---|
id |
string |
Volledig gekwalificeerde id van het privé-eindpunt |
PrivateEndpointACL
ACL voor een privé-eindpunt
Name | Type | Description |
---|---|---|
allow |
Toegestane aanvraagtypen. De waarde kan een of meer zijn: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Geweigerde aanvraagtypen. De waarde kan een of meer zijn: ClientConnection, ServerConnection, RESTAPI. |
|
name |
string |
Naam van de privé-eindpuntverbinding |
PrivateEndpointConnection
Een privé-eindpuntverbinding met een Azure-resource
Name | Type | Description |
---|---|---|
id |
string (arm-id) |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}" |
name |
string |
De naam van de resource |
properties.groupIds |
string[] |
Groeps-id's |
properties.privateEndpoint |
Privé-eindpunt |
|
properties.privateLinkServiceConnectionState |
Verbindingsstatus van de privé-eindpuntverbinding |
|
properties.provisioningState |
Inrichtingsstatus van de resource. |
|
systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
PrivateLinkServiceConnectionState
Verbindingsstatus van de privé-eindpuntverbinding
Name | Type | Description |
---|---|---|
actionsRequired |
string |
Een bericht dat aangeeft of wijzigingen in de serviceprovider updates voor de consument vereisen. |
description |
string |
De reden voor goedkeuring/afwijzing van de verbinding. |
status |
Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service. |
PrivateLinkServiceConnectionStatus
Geeft aan of de verbinding is goedgekeurd/geweigerd/verwijderd door de eigenaar van de service.
Waarde | Description |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
ProvisioningState
Inrichtingsstatus van de resource.
Waarde | Description |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Moving | |
Running | |
Succeeded | |
Unknown | |
Updating |
ResourceLogCategory
Resourcelogboekcategorieconfiguratie van een Microsoft.SignalRService-resource.
Name | Type | Description |
---|---|---|
enabled |
string |
Hiermee wordt aangegeven of de categorie resourcelogboek is ingeschakeld. Beschikbare waarden: waar, onwaar. Hoofdlettergevoelig. |
name |
string |
Hiermee haalt u de naam van de resourcelogboekcategorie op of stelt u deze in. Beschikbare waarden: ConnectivityLogs, MessagingLogs. Hoofdlettergevoelig. |
ResourceLogConfiguration
Configuratie van resourcelogboek van een Microsoft.SignalRService-resource.
Name | Type | Description |
---|---|---|
categories |
Hiermee haalt u de lijst met categorieconfiguraties op of stelt u deze in. |
ResourceSku
De factureringsgegevens van de resource.
Name | Type | Description |
---|---|---|
capacity |
integer (int32) |
Optioneel, geheel getal. Het aantal eenheden van de resource. 1 voor Free_F1/Standard_S1/Premium_P1, standaard 100 voor Premium_P2. Indien aanwezig zijn de volgende waarden toegestaan: 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 |
Niet gebruikt. Behouden voor toekomstig gebruik. |
name |
string |
De naam van de SKU. Verplicht. Toegestane waarden: Standard_S1, Free_F1, Premium_P1, Premium_P2 |
size |
string |
Niet gebruikt. Behouden voor toekomstig gebruik. |
tier |
Optionele laag van deze specifieke SKU. 'Standaard' of 'Gratis'.
|
ServiceKind
Het soort service
Waarde | Description |
---|---|
SocketIO | |
WebPubSub |
SharedPrivateLinkResource
Beschrijft een Gedeelde Private Link-resource
Name | Type | Description |
---|---|---|
id |
string (arm-id) |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}" |
name |
string |
De naam van de resource |
properties.groupId |
string |
De groeps-id van de provider van de resource waarvoor de gedeelde private link-resource is bedoeld |
properties.privateLinkResourceId |
string |
De resource-id van de resource waarvoor de gedeelde private link-resource is bedoeld |
properties.provisioningState |
Inrichtingsstatus van de resource. |
|
properties.requestMessage |
string |
Het aanvraagbericht voor het aanvragen van goedkeuring van de gedeelde private link-resource |
properties.status |
Status van de gedeelde private link-resource |
|
systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
SharedPrivateLinkResourceStatus
Status van de gedeelde private link-resource
Waarde | Description |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected | |
Timeout |
systemData
Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Name | Type | Description |
---|---|---|
createdAt |
string (date-time) |
De tijdstempel van het maken van resources (UTC). |
createdBy |
string |
De identiteit waarmee de resource is gemaakt. |
createdByType |
Het type identiteit waarmee de resource is gemaakt. |
|
lastModifiedAt |
string (date-time) |
De tijdstempel van de laatste wijziging van de resource (UTC) |
lastModifiedBy |
string |
De identiteit die de resource voor het laatst heeft gewijzigd. |
lastModifiedByType |
Het type identiteit dat de resource voor het laatst heeft gewijzigd. |
UserAssignedIdentityProperty
Eigenschappen van door de gebruiker toegewezen identiteit.
Name | Type | Description |
---|---|---|
clientId |
string |
De client-id ophalen voor de door de gebruiker toegewezen identiteit |
principalId |
string |
De principal-id ophalen voor de door de gebruiker toegewezen identiteit |
WebPubSubNetworkACLs
Netwerk-ACL's voor de resource
Name | Type | Description |
---|---|---|
defaultAction |
Azure Networking ACL Action. |
|
ipRules |
IPRule[] |
IP-regels voor het filteren van openbaar verkeer |
privateEndpoints |
ACL's voor aanvragen van privé-eindpunten |
|
publicNetwork |
Netwerk-ACL |
WebPubSubRequestType
Het binnenkomende aanvraagtype voor de service
Waarde | Description |
---|---|
ClientConnection | |
RESTAPI | |
ServerConnection | |
Trace |
WebPubSubResource
Een klasse vertegenwoordigt een resource.
Name | Type | Default value | Description |
---|---|---|---|
id |
string (arm-id) |
Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}" |
|
identity |
Een klasse vertegenwoordigt beheerde identiteiten die worden gebruikt voor aanvragen en antwoorden |
||
kind |
Het soort service |
||
location |
string |
De geografische locatie waar de resource zich bevindt |
|
name |
string |
De naam van de resource |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth Enable or disable aad auth When set as true, connection with AuthType=aad werkt niet. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth Enable or disable local auth with AccessKey When set as true, connection with AccessKey=xxx werkt niet. |
properties.externalIP |
string |
Het openbaar toegankelijke IP-adres van de resource. |
|
properties.hostName |
string |
FQDN van het service-exemplaar. |
|
properties.hostNamePrefix |
string |
Afgeschreven |
|
properties.liveTraceConfiguration |
Live trace-configuratie van een Microsoft.SignalRService-resource. |
||
properties.networkACLs |
Netwerk-ACL's voor de resource |
||
properties.privateEndpointConnections |
Privé-eindpuntverbindingen met de resource. |
||
properties.provisioningState |
Inrichtingsstatus van de resource. |
||
properties.publicNetworkAccess |
string |
Enabled |
Openbare netwerktoegang in- of uitschakelen. De standaardwaarde is Ingeschakeld. Wanneer deze functie is ingeschakeld, zijn netwerk-ACL's nog steeds van toepassing. Wanneer deze optie is uitgeschakeld, wordt openbare netwerktoegang altijd uitgeschakeld, ongeacht wat u instelt in netwerk-ACL's. |
properties.publicPort |
integer (int32) |
De openbaar toegankelijke poort van de resource die is ontworpen voor gebruik aan de browser-/clientzijde. |
|
properties.regionEndpointEnabled |
string |
Enabled |
Schakel het regionale eindpunt in of uit. De standaardwaarde is Ingeschakeld. Wanneer deze optie is uitgeschakeld, worden nieuwe verbindingen niet doorgestuurd naar dit eindpunt, maar worden bestaande verbindingen niet beïnvloed. Deze eigenschap is specifiek voor replica's. Het regionale eindpunt zonder replica uitschakelen is niet toegestaan. |
properties.resourceLogConfiguration |
Configuratie van resourcelogboek van een Microsoft.SignalRService-resource. |
||
properties.resourceStopped |
string |
false |
Stop of start de resource. Standaard ingesteld op 'Onwaar'. Wanneer dit het geval is, wordt het gegevensvlak van de resource afgesloten. Wanneer deze onwaar is, wordt het gegevensvlak van de resource gestart. |
properties.serverPort |
integer (int32) |
De openbaar toegankelijke poort van de resource die is ontworpen voor gebruik aan de serverzijde van de klant. |
|
properties.sharedPrivateLinkResources |
De lijst met gedeelde private link-resources. |
||
properties.socketIO |
SocketIO-instellingen voor de resource |
||
properties.tls |
TLS-instellingen voor de resource |
||
properties.version |
string |
Versie van de resource. Waarschijnlijk hebt u dezelfde of hogere versie van client-SDK's nodig. |
|
sku |
De factureringsgegevens van de resource. |
||
systemData |
Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens. |
||
tags |
object |
Resourcetags. |
|
type |
string |
Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts' |
WebPubSubSkuTier
Optionele laag van deze specifieke SKU. 'Standaard' of 'Gratis'.
Basic
is afgeschaft, gebruikt u in plaats daarvan Standard
.
Waarde | Description |
---|---|
Basic | |
Free | |
Premium | |
Standard |
WebPubSubSocketIOSettings
SocketIO-instellingen voor de resource
Name | Type | Description |
---|---|---|
serviceMode |
string |
De servicemodus van Web PubSub voor Socket.IO. Toegestane waarden: 'Standaard': uw eigen back-end hebben Socket.IO server 'Serverloos': uw toepassing heeft geen back-endserver |
WebPubSubTlsSettings
TLS-instellingen voor de resource
Name | Type | Default value | Description |
---|---|---|---|
clientCertEnabled |
boolean |
False |
Vraag clientcertificaat aan tijdens TLS-handshake indien ingeschakeld. Niet ondersteund voor de gratis laag. Alle invoer wordt genegeerd voor de gratis laag. |