Web Pub Sub - Get
Rufen Sie die Ressource und die zugehörigen Eigenschaften ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
resource
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ |
Der Name der Ressource. |
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolg. Die Antwort beschreibt die entsprechende Ressource. |
|
Other Status Codes |
Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Fluss
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
WebPubSub_Get
Beispielanforderung
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.SignalRService/webPubSub/myWebPubSubService?api-version=2024-03-01
Beispiel für eine Antwort
{
"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"
}
}
Definitionen
Name | Beschreibung |
---|---|
ACLAction |
Azure Networking ACL-Aktion. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
Error |
Das Fehlerdetails. |
Error |
Fehlerantwort |
IPRule |
Eine IP-Regel |
Live |
Konfiguration der Live-Ablaufverfolgungskategorie einer Microsoft.SignalRService-Ressource. |
Live |
Live-Ablaufverfolgungskonfiguration einer Microsoft.SignalRService-Ressource. |
Managed |
Eine Klasse stellt verwaltete Identitäten dar, die für Anforderung und Antwort verwendet werden. |
Managed |
Stellt den Identitätstyp dar: systemAssigned, userAssigned, None |
NetworkACL |
Netzwerk-ACL |
Private |
Privater Endpunkt |
Private |
ACL für einen privaten Endpunkt |
Private |
Eine private Endpunktverbindung mit einer Azure-Ressource |
Private |
Verbindungsstatus der privaten Endpunktverbindung |
Private |
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde. |
Provisioning |
Bereitstellungsstatus der Ressource. |
Resource |
Ressourcenprotokollkategoriekonfiguration einer Microsoft.SignalRService-Ressource. |
Resource |
Ressourcenprotokollkonfiguration einer Microsoft.SignalRService-Ressource. |
Resource |
Die Abrechnungsinformationen der Ressource. |
Service |
Die Art des Diensts |
Shared |
Beschreibt eine Ressource für freigegebene private Verknüpfungen |
Shared |
Status der freigegebenen ressource für private Links |
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
User |
Eigenschaften der vom Benutzer zugewiesenen Identität. |
Web |
Netzwerk-ACLs für die Ressource |
Web |
Der Typ der eingehenden Anforderung an den Dienst |
Web |
Eine Klasse stellt eine Ressource dar. |
Web |
Optionale Ebene dieser bestimmten SKU. "Standard" oder "Kostenlos".
|
Web |
SocketIO-Einstellungen für die Ressource |
Web |
TLS-Einstellungen für die Ressource |
ACLAction
Azure Networking ACL-Aktion.
Wert | Beschreibung |
---|---|
Allow | |
Deny |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Wert | Beschreibung |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Die zusätzlichen Informationen. |
type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
IPRule
Eine IP-Regel
Name | Typ | Beschreibung |
---|---|---|
action |
Azure Networking ACL-Aktion. |
|
value |
string |
EINE IP- oder CIDR- oder ServiceTag-Eigenschaft |
LiveTraceCategory
Konfiguration der Live-Ablaufverfolgungskategorie einer Microsoft.SignalRService-Ressource.
Name | Typ | Beschreibung |
---|---|---|
enabled |
string |
Gibt an, ob die Live-Ablaufverfolgungskategorie aktiviert ist. Verfügbare Werte: true, false. Schreibungsunabhängig. |
name |
string |
Ruft den Namen der Live-Ablaufverfolgungskategorie ab oder legt sie fest. Verfügbare Werte: ConnectivityLogs, MessagingLogs. Schreibungsunabhängig. |
LiveTraceConfiguration
Live-Ablaufverfolgungskonfiguration einer Microsoft.SignalRService-Ressource.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
categories |
Dient zum Abrufen oder Festlegen der Liste der Kategoriekonfigurationen. |
||
enabled |
string |
false |
Gibt an, ob die Live-Ablaufverfolgung aktiviert ist. Wenn sie auf "true" festgelegt ist, kann der Live-Ablaufverfolgungsclient eine Verbindung mit dem Dienst herstellen. Andernfalls kann der Live-Ablaufverfolgungsclient keine Verbindung mit dem Dienst herstellen, sodass Sie kein Protokoll empfangen können, unabhängig davon, was Sie in "Kategorien" konfigurieren. Verfügbare Werte: true, false. Schreibungsunabhängig. |
ManagedIdentity
Eine Klasse stellt verwaltete Identitäten dar, die für Anforderung und Antwort verwendet werden.
Name | Typ | Beschreibung |
---|---|---|
principalId |
string |
Rufen Sie die Prinzipal-ID für die vom System zugewiesene Identität ab. Nur als Antwort verwendet werden. |
tenantId |
string |
Rufen Sie die Mandanten-ID für die vom System zugewiesene Identität ab. Nur als Antwort verwendet werden |
type |
Stellt den Identitätstyp dar: systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
Abrufen oder Festlegen der vom Benutzer zugewiesenen Identitäten |
ManagedIdentityType
Stellt den Identitätstyp dar: systemAssigned, userAssigned, None
Wert | Beschreibung |
---|---|
None | |
SystemAssigned | |
UserAssigned |
NetworkACL
Netzwerk-ACL
Name | Typ | Beschreibung |
---|---|---|
allow |
Zulässige Anforderungstypen. Der Wert kann eine oder mehrere von: ClientConnection, ServerConnection, RESTAPI sein. |
|
deny |
Anforderungstypen verweigert. Der Wert kann eine oder mehrere von: ClientConnection, ServerConnection, RESTAPI sein. |
PrivateEndpoint
Privater Endpunkt
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollständige qualifizierte ID des privaten Endpunkts |
PrivateEndpointACL
ACL für einen privaten Endpunkt
Name | Typ | Beschreibung |
---|---|---|
allow |
Zulässige Anforderungstypen. Der Wert kann eine oder mehrere von: ClientConnection, ServerConnection, RESTAPI sein. |
|
deny |
Anforderungstypen verweigert. Der Wert kann eine oder mehrere von: ClientConnection, ServerConnection, RESTAPI sein. |
|
name |
string |
Name der privaten Endpunktverbindung |
PrivateEndpointConnection
Eine private Endpunktverbindung mit einer Azure-Ressource
Name | Typ | Beschreibung |
---|---|---|
id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Der Name der Ressource |
properties.groupIds |
string[] |
Gruppen-IDs |
properties.privateEndpoint |
Privater Endpunkt |
|
properties.privateLinkServiceConnectionState |
Verbindungsstatus der privaten Endpunktverbindung |
|
properties.provisioningState |
Bereitstellungsstatus der Ressource. |
|
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
PrivateLinkServiceConnectionState
Verbindungsstatus der privaten Endpunktverbindung
Name | Typ | Beschreibung |
---|---|---|
actionsRequired |
string |
Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Verbraucher erfordern. |
description |
string |
Der Grund für die Genehmigung/Ablehnung der Verbindung. |
status |
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde. |
PrivateLinkServiceConnectionStatus
Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde.
Wert | Beschreibung |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
ProvisioningState
Bereitstellungsstatus der Ressource.
Wert | Beschreibung |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Moving | |
Running | |
Succeeded | |
Unknown | |
Updating |
ResourceLogCategory
Ressourcenprotokollkategoriekonfiguration einer Microsoft.SignalRService-Ressource.
Name | Typ | Beschreibung |
---|---|---|
enabled |
string |
Gibt an, ob die Ressourcenprotokollkategorie aktiviert ist. Verfügbare Werte: true, false. Schreibungsunabhängig. |
name |
string |
Dient zum Abrufen oder Festlegen des Namens der Ressourcenprotokollkategorie. Verfügbare Werte: ConnectivityLogs, MessagingLogs. Schreibungsunabhängig. |
ResourceLogConfiguration
Ressourcenprotokollkonfiguration einer Microsoft.SignalRService-Ressource.
Name | Typ | Beschreibung |
---|---|---|
categories |
Dient zum Abrufen oder Festlegen der Liste der Kategoriekonfigurationen. |
ResourceSku
Die Abrechnungsinformationen der Ressource.
Name | Typ | Beschreibung |
---|---|---|
capacity |
integer (int32) |
Optional, ganze Zahl. Die Anzahl der Einheiten der Ressource. 1 für Free_F1/Standard_S1/Premium_P1, 100 für Premium_P2 standardmäßig. Wenn vorhanden, sind folgende Werte zulässig: 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 |
Wird nicht verwendet. Für die zukünftige Verwendung beibehalten. |
name |
string |
Der Name der SKU. Erforderlich. Zulässige Werte: Standard_S1, Free_F1, Premium_P1, Premium_P2 |
size |
string |
Wird nicht verwendet. Für die zukünftige Verwendung beibehalten. |
tier |
Optionale Ebene dieser bestimmten SKU. "Standard" oder "Kostenlos".
|
ServiceKind
Die Art des Diensts
Wert | Beschreibung |
---|---|
SocketIO | |
WebPubSub |
SharedPrivateLinkResource
Beschreibt eine Ressource für freigegebene private Verknüpfungen
Name | Typ | Beschreibung |
---|---|---|
id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Der Name der Ressource |
properties.groupId |
string |
Die Gruppen-ID vom Anbieter der Ressource, für die die freigegebene private Linkressource gilt |
properties.privateLinkResourceId |
string |
Die Ressourcen-ID der Ressource, für die die freigegebene private Verknüpfungsressource gilt |
properties.provisioningState |
Bereitstellungsstatus der Ressource. |
|
properties.requestMessage |
string |
Die Anforderungsnachricht zum Anfordern der Genehmigung der Ressource für freigegebene private Links |
properties.status |
Status der freigegebenen ressource für private Links |
|
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceStatus
Status der freigegebenen ressource für private Links
Wert | Beschreibung |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected | |
Timeout |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |
UserAssignedIdentityProperty
Eigenschaften der vom Benutzer zugewiesenen Identität.
Name | Typ | Beschreibung |
---|---|---|
clientId |
string |
Abrufen der Client-ID für die vom Benutzer zugewiesene Identität |
principalId |
string |
Abrufen der Prinzipal-ID für die vom Benutzer zugewiesene Identität |
WebPubSubNetworkACLs
Netzwerk-ACLs für die Ressource
Name | Typ | Beschreibung |
---|---|---|
defaultAction |
Azure Networking ACL-Aktion. |
|
ipRules |
IPRule[] |
IP-Regeln zum Filtern von öffentlichem Datenverkehr |
privateEndpoints |
ACLs für Anforderungen von privaten Endpunkten |
|
publicNetwork |
Netzwerk-ACL |
WebPubSubRequestType
Der Typ der eingehenden Anforderung an den Dienst
Wert | Beschreibung |
---|---|
ClientConnection | |
RESTAPI | |
ServerConnection | |
Trace |
WebPubSubResource
Eine Klasse stellt eine Ressource dar.
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
identity |
Eine Klasse stellt verwaltete Identitäten dar, die für Anforderung und Antwort verwendet werden. |
||
kind |
Die Art des Diensts |
||
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
|
name |
string |
Der Name der Ressource |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth Enable or disable aad auth When set as true, connection with AuthType=aad will't work. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth Enable or disable local auth with AccessKey When set as true, connection with AccessKey=xxx will't work. |
properties.externalIP |
string |
Die öffentlich zugängliche IP der Ressource. |
|
properties.hostName |
string |
FQDN der Dienstinstanz. |
|
properties.hostNamePrefix |
string |
Veraltet |
|
properties.liveTraceConfiguration |
Live-Ablaufverfolgungskonfiguration einer Microsoft.SignalRService-Ressource. |
||
properties.networkACLs |
Netzwerk-ACLs für die Ressource |
||
properties.privateEndpointConnections |
Private Endpunktverbindungen mit der Ressource. |
||
properties.provisioningState |
Bereitstellungsstatus der Ressource. |
||
properties.publicNetworkAccess |
string |
Enabled |
Aktivieren oder Deaktivieren des öffentlichen Netzwerkzugriffs. Der Standardwert ist "Aktiviert". Wenn sie aktiviert ist, gelten weiterhin Netzwerk-ACLs. Wenn sie deaktiviert ist, ist der Zugriff auf öffentliche Netzwerke immer deaktiviert, unabhängig davon, was Sie in Netzwerk-ACLs festgelegt haben. |
properties.publicPort |
integer (int32) |
Der öffentlich zugängliche Port der Ressource, die für die browser-/clientseitige Nutzung entwickelt wurde. |
|
properties.regionEndpointEnabled |
string |
Enabled |
Aktivieren oder deaktivieren Sie den regionalen Endpunkt. Der Standardwert ist "Aktiviert". Wenn sie deaktiviert ist, werden neue Verbindungen nicht an diesen Endpunkt weitergeleitet, vorhandene Verbindungen sind jedoch nicht betroffen. Diese Eigenschaft ist replizspezifisch. Der regionale Endpunkt ohne Replikat deaktivieren ist nicht zulässig. |
properties.resourceLogConfiguration |
Ressourcenprotokollkonfiguration einer Microsoft.SignalRService-Ressource. |
||
properties.resourceStopped |
string |
false |
Beenden oder starten Sie die Ressource. Der Standardwert ist "False". Wenn dies der Fall ist, wird die Datenebene der Ressource heruntergefahren. Wenn der Wert falsch ist, wird die Datenebene der Ressource gestartet. |
properties.serverPort |
integer (int32) |
Der öffentlich zugängliche Port der Ressource, die für die serverseitige Nutzung des Kunden entwickelt wurde. |
|
properties.sharedPrivateLinkResources |
Die Liste der freigegebenen ressourcen für private Links. |
||
properties.socketIO |
SocketIO-Einstellungen für die Ressource |
||
properties.tls |
TLS-Einstellungen für die Ressource |
||
properties.version |
string |
Version der Ressource. Wahrscheinlich benötigen Sie dieselbe oder höhere Version von Client-SDKs. |
|
sku |
Die Abrechnungsinformationen der Ressource. |
||
systemData |
Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten. |
||
tags |
object |
Ressourcentags. |
|
type |
string |
Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
WebPubSubSkuTier
Optionale Ebene dieser bestimmten SKU. "Standard" oder "Kostenlos".
Basic
veraltet ist, verwenden Sie stattdessen Standard
.
Wert | Beschreibung |
---|---|
Basic | |
Free | |
Premium | |
Standard |
WebPubSubSocketIOSettings
SocketIO-Einstellungen für die Ressource
Name | Typ | Beschreibung |
---|---|---|
serviceMode |
string |
Der Dienstmodus von Web PubSub für Socket.IO. Zulässige Werte: "Standard": Haben Sie ein eigenes Back-End-Socket.IO Server "Serverless": Ihre Anwendung verfügt nicht über einen Back-End-Server. |
WebPubSubTlsSettings
TLS-Einstellungen für die Ressource
Name | Typ | Standardwert | Beschreibung |
---|---|---|---|
clientCertEnabled |
boolean |
False |
Anfordern des Clientzertifikats während des TLS-Handshakes, falls aktiviert. Wird für die kostenlose Stufe nicht unterstützt. Alle Eingaben werden für die freie Leiste ignoriert. |