Web Pub Sub - Get
Získejte prostředek a jeho vlastnosti.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
resource
|
path | True |
string |
Název prostředku. Vzor regulárního výrazu: |
subscription
|
path | True |
string uuid |
ID cílového předplatného. Hodnota musí být UUID. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěch. Odpověď popisuje odpovídající prostředek. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
WebPubSub_Get
Ukázkový požadavek
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.SignalRService/webPubSub/myWebPubSubService?api-version=2024-03-01
Ukázková odpověď
{
"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"
}
}
Definice
Name | Description |
---|---|
ACLAction |
Akce seznamu ACL pro sítě Azure |
created |
Typ identity, která prostředek vytvořila. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
IPRule |
Pravidlo PROTOKOLU IP |
Live |
Konfigurace kategorie živého trasování prostředku Microsoft.SignalRService |
Live |
Konfigurace živého trasování prostředku Microsoft.SignalRService |
Managed |
Třída představující spravované identity používané pro požadavky a odpovědi |
Managed |
Představuje typ identity: systemAssigned, userAssigned, None |
NetworkACL |
Seznam ACL sítě |
Private |
Privátní koncový bod |
Private |
Seznam ACL pro privátní koncový bod |
Private |
Připojení privátního koncového bodu k prostředku Azure |
Private |
Stav připojení privátního koncového bodu |
Private |
Určuje, jestli bylo připojení schváleno, odmítnuto nebo odebráno vlastníkem služby. |
Provisioning |
Stav zřizování prostředku. |
Resource |
Konfigurace kategorie protokolu prostředků pro prostředek Microsoft.SignalRService |
Resource |
Konfigurace protokolu prostředků prostředku Microsoft.SignalRService. |
Resource |
Fakturační údaje prostředku. |
Service |
Druh služby |
Shared |
Popisuje sdílený prostředek Private Link. |
Shared |
Stav prostředku sdíleného privátního propojení |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
User |
Vlastnosti identity přiřazené uživatelem. |
Web |
Síťové seznamy ACL pro prostředek |
Web |
Typ příchozího požadavku na službu |
Web |
Třída představuje prostředek. |
Web |
Volitelná úroveň této konkrétní skladové položky 'Standard' nebo 'Free'.
|
Web |
Nastavení SocketIO pro prostředek |
Web |
Nastavení protokolu TLS pro prostředek |
ACLAction
Akce seznamu ACL pro sítě Azure
Name | Typ | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
IPRule
Pravidlo PROTOKOLU IP
Name | Typ | Description |
---|---|---|
action |
Akce seznamu ACL pro sítě Azure |
|
value |
string |
IP adresa, CIDR nebo značka služby |
LiveTraceCategory
Konfigurace kategorie živého trasování prostředku Microsoft.SignalRService
Name | Typ | Description |
---|---|---|
enabled |
string |
Určuje, jestli je povolená kategorie živého trasování nebo . Dostupné hodnoty: true, false Nerozlišují se malá a velká písmena. |
name |
string |
Získá nebo nastaví název kategorie živého trasování. Dostupné hodnoty: ConnectivityLogs, MessagingLogs. Nerozlišují se malá a velká písmena. |
LiveTraceConfiguration
Konfigurace živého trasování prostředku Microsoft.SignalRService
Name | Typ | Default value | Description |
---|---|---|---|
categories |
Získá nebo nastaví seznam konfigurací kategorií. |
||
enabled |
string |
false |
Určuje, jestli je povolené živé trasování. Když je nastavená hodnota true, klient živého trasování se může připojit ke službě. Jinak se klient živého trasování nemůže ke službě připojit, takže nemůžete přijímat žádný protokol bez ohledu na to, co nakonfigurujete v kategoriích. Dostupné hodnoty: true, false Nerozlišují se malá a velká písmena. |
ManagedIdentity
Třída představující spravované identity používané pro požadavky a odpovědi
Name | Typ | Description |
---|---|---|
principalId |
string |
Získejte ID objektu zabezpečení pro identitu přiřazenou systémem. Použít pouze jako odpověď. |
tenantId |
string |
Získejte ID tenanta pro identitu přiřazenou systémem. Použít pouze v reakci |
type |
Představuje typ identity: systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
Získání nebo nastavení identit přiřazených uživatelem |
ManagedIdentityType
Představuje typ identity: systemAssigned, userAssigned, None
Name | Typ | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
NetworkACL
Seznam ACL sítě
Name | Typ | Description |
---|---|---|
allow |
Povolené typy požadavků. Hodnota může být jedna nebo více z těchto: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Typy zamítnutých požadavků Hodnota může být jedna nebo více z těchto: ClientConnection, ServerConnection, RESTAPI. |
PrivateEndpoint
Privátní koncový bod
Name | Typ | Description |
---|---|---|
id |
string |
Úplné kvalifikované ID privátního koncového bodu |
PrivateEndpointACL
Seznam ACL pro privátní koncový bod
Name | Typ | Description |
---|---|---|
allow |
Povolené typy požadavků. Hodnota může být jedna nebo více z těchto: ClientConnection, ServerConnection, RESTAPI. |
|
deny |
Typy zamítnutých požadavků Hodnota může být jedna nebo více z těchto: ClientConnection, ServerConnection, RESTAPI. |
|
name |
string |
Název připojení privátního koncového bodu |
PrivateEndpointConnection
Připojení privátního koncového bodu k prostředku Azure
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}. |
name |
string |
Název prostředku |
properties.groupIds |
string[] |
ID skupin |
properties.privateEndpoint |
Privátní koncový bod |
|
properties.privateLinkServiceConnectionState |
Stav připojení privátního koncového bodu |
|
properties.provisioningState |
Stav zřizování prostředku. |
|
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
PrivateLinkServiceConnectionState
Stav připojení privátního koncového bodu
Name | Typ | Description |
---|---|---|
actionsRequired |
string |
Zpráva s informacemi o tom, jestli změny poskytovatele služeb vyžadují aktualizace příjemce. |
description |
string |
Důvod schválení nebo zamítnutí připojení. |
status |
Určuje, jestli bylo připojení schváleno, odmítnuto nebo odebráno vlastníkem služby. |
PrivateLinkServiceConnectionStatus
Určuje, jestli bylo připojení schváleno, odmítnuto nebo odebráno vlastníkem služby.
Name | Typ | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
ProvisioningState
Stav zřizování prostředku.
Name | Typ | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
ResourceLogCategory
Konfigurace kategorie protokolu prostředků pro prostředek Microsoft.SignalRService
Name | Typ | Description |
---|---|---|
enabled |
string |
Určuje, jestli je povolená kategorie protokolu prostředků nebo . Dostupné hodnoty: true, false Nerozlišují se malá a velká písmena. |
name |
string |
Získá nebo nastaví název kategorie protokolu prostředků. Dostupné hodnoty: ConnectivityLogs, MessagingLogs. Nerozlišují se malá a velká písmena. |
ResourceLogConfiguration
Konfigurace protokolu prostředků prostředku Microsoft.SignalRService.
Name | Typ | Description |
---|---|---|
categories |
Získá nebo nastaví seznam konfigurací kategorií. |
ResourceSku
Fakturační údaje prostředku.
Name | Typ | Description |
---|---|---|
capacity |
integer |
Volitelné, celé číslo. Počet jednotek prostředku. 1 pro Free_F1/Standard_S1/Premium_P1, 100 pro Premium_P2 ve výchozím nastavení. Pokud existují, jsou povoleny následující hodnoty: 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 |
Nepoužívá se. Uchová se pro budoucí použití. |
name |
string |
Název skladové položky. Povinná hodnota. Povolené hodnoty: Standard_S1, Free_F1, Premium_P1, Premium_P2 |
size |
string |
Nepoužívá se. Uchová se pro budoucí použití. |
tier |
Volitelná úroveň této konkrétní skladové položky 'Standard' nebo 'Free'.
|
ServiceKind
Druh služby
Name | Typ | Description |
---|---|---|
SocketIO |
string |
|
WebPubSub |
string |
SharedPrivateLinkResource
Popisuje sdílený prostředek Private Link.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}. |
name |
string |
Název prostředku |
properties.groupId |
string |
ID skupiny od poskytovatele prostředku, pro který je prostředek sdíleného privátního propojení určen |
properties.privateLinkResourceId |
string |
ID prostředku, pro který je prostředek sdíleného privátního propojení určen |
properties.provisioningState |
Stav zřizování prostředku. |
|
properties.requestMessage |
string |
Zpráva žádosti o schválení prostředku sdíleného privátního propojení |
properties.status |
Stav prostředku sdíleného privátního propojení |
|
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
SharedPrivateLinkResourceStatus
Stav prostředku sdíleného privátního propojení
Name | Typ | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
|
Timeout |
string |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
UserAssignedIdentityProperty
Vlastnosti identity přiřazené uživatelem.
Name | Typ | Description |
---|---|---|
clientId |
string |
Získání ID klienta pro identitu přiřazenou uživatelem |
principalId |
string |
Získání ID objektu zabezpečení pro identitu přiřazenou uživatelem |
WebPubSubNetworkACLs
Síťové seznamy ACL pro prostředek
Name | Typ | Description |
---|---|---|
defaultAction |
Akce seznamu ACL pro sítě Azure |
|
ipRules |
IPRule[] |
Pravidla IP adres pro filtrování veřejného provozu |
privateEndpoints |
Seznamy ACL pro požadavky z privátních koncových bodů |
|
publicNetwork |
Seznam ACL sítě |
WebPubSubRequestType
Typ příchozího požadavku na službu
Name | Typ | Description |
---|---|---|
ClientConnection |
string |
|
RESTAPI |
string |
|
ServerConnection |
string |
|
Trace |
string |
WebPubSubResource
Třída představuje prostředek.
Name | Typ | Default value | Description |
---|---|---|---|
id |
string |
Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}. |
|
identity |
Třída představující spravované identity používané pro požadavky a odpovědi |
||
kind |
Druh služby |
||
location |
string |
Geografické umístění, kde se prostředek nachází |
|
name |
string |
Název prostředku |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth Povolení nebo zakázání ověřování aad Pokud je nastaveno na hodnotu true, připojení pomocí AuthType=aad nebude fungovat. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth Povolení nebo zakázání místního ověřování pomocí AccessKey Pokud je nastavená hodnota true, připojení pomocí AccessKey=xxx nebude fungovat. |
properties.externalIP |
string |
Veřejně přístupná IP adresa prostředku. |
|
properties.hostName |
string |
Plně kvalifikovaný název domény instance služby. |
|
properties.hostNamePrefix |
string |
Zastaralé |
|
properties.liveTraceConfiguration |
Konfigurace živého trasování prostředku Microsoft.SignalRService |
||
properties.networkACLs |
Síťové seznamy ACL pro prostředek |
||
properties.privateEndpointConnections |
Připojení privátních koncových bodů k prostředku |
||
properties.provisioningState |
Stav zřizování prostředku. |
||
properties.publicNetworkAccess |
string |
Enabled |
Povolte nebo zakažte veřejný síťový přístup. Výchozí hodnota je "Povoleno". Síťové seznamy ACL platí i v případě, že je povoleno. Pokud je zakázaný, veřejný síťový přístup je vždy zakázán bez ohledu na to, co jste nastavili v seznamech ACL sítě. |
properties.publicPort |
integer |
Veřejně přístupný port prostředku, který je určený pro použití na straně prohlížeče nebo klienta. |
|
properties.regionEndpointEnabled |
string |
Enabled |
Povolte nebo zakažte místní koncový bod. Výchozí hodnota je "Povoleno". Pokud je tato možnost zakázaná, nová připojení se do tohoto koncového bodu nesměrují, ale na stávající připojení to nebude mít vliv. Tato vlastnost je specifická pro repliku. Zakázání místního koncového bodu bez repliky není povolené. |
properties.resourceLogConfiguration |
Konfigurace protokolu prostředků prostředku Microsoft.SignalRService. |
||
properties.resourceStopped |
string |
false |
Zastavte nebo spusťte prostředek. Výchozí hodnota je False. Pokud je to pravda, rovina dat prostředku se vypne. Když je hodnota false, spustí se rovina dat prostředku. |
properties.serverPort |
integer |
Veřejně přístupný port prostředku, který je určený pro použití na straně serveru zákazníka. |
|
properties.sharedPrivateLinkResources |
Seznam prostředků sdíleného privátního propojení. |
||
properties.socketIO |
Nastavení SocketIO pro prostředek |
||
properties.tls |
Nastavení protokolu TLS pro prostředek |
||
properties.version |
string |
Verze prostředku. Pravděpodobně potřebujete stejnou nebo vyšší verzi klientských sad SDK. |
|
sku |
Fakturační údaje prostředku. |
||
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
||
tags |
object |
Značky prostředků. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
WebPubSubSkuTier
Volitelná úroveň této konkrétní skladové položky 'Standard' nebo 'Free'.
Basic
je zastaralá, místo toho použijte Standard
.
Name | Typ | Description |
---|---|---|
Basic |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
WebPubSubSocketIOSettings
Nastavení SocketIO pro prostředek
Name | Typ | Description |
---|---|---|
serviceMode |
string |
Režim služby Web PubSub pro Socket.IO. Povolené hodnoty: Výchozí: máte vlastní back-end Socket.IO server bez serveru: vaše aplikace nemá back-endový server. |
WebPubSubTlsSettings
Nastavení protokolu TLS pro prostředek
Name | Typ | Default value | Description |
---|---|---|---|
clientCertEnabled |
boolean |
False |
Vyžádejte si klientský certifikát během metody handshake protokolu TLS, pokud je povoleno. Nepodporuje se pro úroveň Free. Všechny vstupy budou ignorovány pro úroveň Free. |