Web Pub Sub - Get
리소스 및 해당 속성을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SignalRService/webPubSub/{resourceName}?api-version=2024-03-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. |
resource
|
path | True |
string |
리소스의 이름입니다. regex 패턴: |
subscription
|
path | True |
string uuid |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
성공. 응답은 해당 리소스를 설명합니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
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"
}
}
정의
Name | Description |
---|---|
ACLAction |
Azure 네트워킹 ACL 작업. |
created |
리소스를 만든 ID의 형식입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
IPRule |
IP 규칙 |
Live |
Microsoft.SignalRService 리소스의 라이브 추적 범주 구성입니다. |
Live |
Microsoft.SignalRService 리소스의 라이브 추적 구성입니다. |
Managed |
클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다. |
Managed |
id 형식을 나타냅니다. systemAssigned, userAssigned, None |
NetworkACL |
네트워크 ACL |
Private |
프라이빗 엔드포인트 |
Private |
프라이빗 엔드포인트에 대한 ACL |
Private |
Azure 리소스에 대한 프라이빗 엔드포인트 연결 |
Private |
프라이빗 엔드포인트 연결의 연결 상태 |
Private |
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. |
Provisioning |
리소스의 프로비전 상태입니다. |
Resource |
Microsoft.SignalRService 리소스의 리소스 로그 범주 구성입니다. |
Resource |
Microsoft.SignalRService 리소스의 리소스 로그 구성입니다. |
Resource |
리소스의 청구 정보입니다. |
Service |
서비스의 종류 |
Shared |
공유 Private Link 리소스에 대해 설명합니다. |
Shared |
공유 프라이빗 링크 리소스의 상태 |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
User |
사용자 할당 ID의 속성입니다. |
Web |
리소스에 대한 네트워크 ACL |
Web |
서비스에 들어오는 요청 유형 |
Web |
클래스는 리소스를 나타냅니다. |
Web |
이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.
|
Web |
리소스에 대한 SocketIO 설정 |
Web |
리소스에 대한 TLS 설정 |
ACLAction
Azure 네트워킹 ACL 작업.
Name | 형식 | Description |
---|---|---|
Allow |
string |
|
Deny |
string |
createdByType
리소스를 만든 ID의 형식입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
IPRule
IP 규칙
Name | 형식 | Description |
---|---|---|
action |
Azure 네트워킹 ACL 작업. |
|
value |
string |
IP 또는 CIDR 또는 ServiceTag |
LiveTraceCategory
Microsoft.SignalRService 리소스의 라이브 추적 범주 구성입니다.
Name | 형식 | Description |
---|---|---|
enabled |
string |
라이브 추적 범주를 사용할지 여부를 나타냅니다. 사용 가능한 값: true, false. 대/소문자를 구분하지 않습니다. |
name |
string |
라이브 추적 범주의 이름을 가져오거나 설정합니다. 사용 가능한 값: ConnectivityLogs, MessagingLogs. 대/소문자를 구분하지 않습니다. |
LiveTraceConfiguration
Microsoft.SignalRService 리소스의 라이브 추적 구성입니다.
Name | 형식 | Default value | Description |
---|---|---|---|
categories |
범주 구성 목록을 가져오거나 설정합니다. |
||
enabled |
string |
false |
라이브 추적을 사용하도록 설정할지 여부를 나타냅니다. true로 설정하면 라이브 추적 클라이언트가 서비스에 연결할 수 있습니다. 그렇지 않으면 라이브 추적 클라이언트가 서비스에 연결할 수 없으므로 "범주"에서 구성한 내용에 관계없이 로그를 받을 수 없습니다. 사용 가능한 값: true, false. 대/소문자를 구분하지 않습니다. |
ManagedIdentity
클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
시스템 할당 ID의 보안 주체 ID를 가져옵니다. 응답에만 사용됩니다. |
tenantId |
string |
시스템 할당 ID에 대한 테넌트 ID를 가져옵니다. 응답에만 사용 |
type |
id 형식을 나타냅니다. systemAssigned, userAssigned, None |
|
userAssignedIdentities |
<string,
User |
사용자 할당 ID 가져오기 또는 설정 |
ManagedIdentityType
id 형식을 나타냅니다. systemAssigned, userAssigned, None
Name | 형식 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
NetworkACL
네트워크 ACL
Name | 형식 | Description |
---|---|---|
allow |
허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. |
|
deny |
요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. |
PrivateEndpoint
프라이빗 엔드포인트
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트의 정규화된 ID |
PrivateEndpointACL
프라이빗 엔드포인트에 대한 ACL
Name | 형식 | Description |
---|---|---|
allow |
허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. |
|
deny |
요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. |
|
name |
string |
프라이빗 엔드포인트 연결의 이름 |
PrivateEndpointConnection
Azure 리소스에 대한 프라이빗 엔드포인트 연결
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
리소스의 이름입니다. |
properties.groupIds |
string[] |
그룹 ID |
properties.privateEndpoint |
프라이빗 엔드포인트 |
|
properties.privateLinkServiceConnectionState |
프라이빗 엔드포인트 연결의 연결 상태 |
|
properties.provisioningState |
리소스의 프로비전 상태입니다. |
|
systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
PrivateLinkServiceConnectionState
프라이빗 엔드포인트 연결의 연결 상태
Name | 형식 | Description |
---|---|---|
actionsRequired |
string |
서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다. |
description |
string |
연결의 승인/거부 이유입니다. |
status |
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. |
PrivateLinkServiceConnectionStatus
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.
Name | 형식 | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
ProvisioningState
리소스의 프로비전 상태입니다.
Name | 형식 | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Moving |
string |
|
Running |
string |
|
Succeeded |
string |
|
Unknown |
string |
|
Updating |
string |
ResourceLogCategory
Microsoft.SignalRService 리소스의 리소스 로그 범주 구성입니다.
Name | 형식 | Description |
---|---|---|
enabled |
string |
리소스 로그 범주를 사용할지 여부를 나타냅니다. 사용 가능한 값: true, false. 대/소문자를 구분하지 않습니다. |
name |
string |
리소스 로그 범주의 이름을 가져오거나 설정합니다. 사용 가능한 값: ConnectivityLogs, MessagingLogs. 대/소문자를 구분하지 않습니다. |
ResourceLogConfiguration
Microsoft.SignalRService 리소스의 리소스 로그 구성입니다.
Name | 형식 | Description |
---|---|---|
categories |
범주 구성 목록을 가져오거나 설정합니다. |
ResourceSku
리소스의 청구 정보입니다.
Name | 형식 | Description |
---|---|---|
capacity |
integer |
선택적 정수입니다. 리소스의 단위 수입니다. Free_F1/Standard_S1/Premium_P1 1, 기본적으로 Premium_P2 경우 100입니다. 있는 경우 다음 값이 허용됩니다. 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 |
이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.
|
ServiceKind
서비스의 종류
Name | 형식 | Description |
---|---|---|
SocketIO |
string |
|
WebPubSub |
string |
SharedPrivateLinkResource
공유 Private Link 리소스에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
리소스의 이름입니다. |
properties.groupId |
string |
공유 프라이빗 링크 리소스가 대상인 리소스 공급자의 그룹 ID |
properties.privateLinkResourceId |
string |
공유 프라이빗 링크 리소스가 사용하는 리소스의 리소스 ID |
properties.provisioningState |
리소스의 프로비전 상태입니다. |
|
properties.requestMessage |
string |
공유 프라이빗 링크 리소스의 승인을 요청하기 위한 요청 메시지 |
properties.status |
공유 프라이빗 링크 리소스의 상태 |
|
systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceStatus
공유 프라이빗 링크 리소스의 상태
Name | 형식 | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
|
Timeout |
string |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
UserAssignedIdentityProperty
사용자 할당 ID의 속성입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
사용자 할당 ID에 대한 클라이언트 ID 가져오기 |
principalId |
string |
사용자 할당 ID의 보안 주체 ID 가져오기 |
WebPubSubNetworkACLs
리소스에 대한 네트워크 ACL
Name | 형식 | Description |
---|---|---|
defaultAction |
Azure 네트워킹 ACL 작업. |
|
ipRules |
IPRule[] |
공용 트래픽을 필터링하기 위한 IP 규칙 |
privateEndpoints |
프라이빗 엔드포인트의 요청에 대한 ACL |
|
publicNetwork |
네트워크 ACL |
WebPubSubRequestType
서비스에 들어오는 요청 유형
Name | 형식 | Description |
---|---|---|
ClientConnection |
string |
|
RESTAPI |
string |
|
ServerConnection |
string |
|
Trace |
string |
WebPubSubResource
클래스는 리소스를 나타냅니다.
Name | 형식 | Default value | Description |
---|---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
identity |
클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다. |
||
kind |
서비스의 종류 |
||
location |
string |
리소스가 있는 지리적 위치 |
|
name |
string |
리소스의 이름입니다. |
|
properties.disableAadAuth |
boolean |
False |
DisableLocalAuth aad auth를 사용하거나 사용하지 않도록 설정 true로 설정하면 AuthType=aad와의 연결이 작동하지 않습니다. |
properties.disableLocalAuth |
boolean |
False |
DisableLocalAuth AccessKey를 사용하여 로컬 인증을 사용하거나 사용하지 않도록 설정합니다. true로 설정하면 AccessKey=xxx와의 연결이 작동하지 않습니다. |
properties.externalIP |
string |
리소스의 공개적으로 액세스할 수 있는 IP입니다. |
|
properties.hostName |
string |
서비스의 FQDN instance. |
|
properties.hostNamePrefix |
string |
더 이상 사용되지 않습니다. |
|
properties.liveTraceConfiguration |
Microsoft.SignalRService 리소스의 라이브 추적 구성입니다. |
||
properties.networkACLs |
리소스에 대한 네트워크 ACL |
||
properties.privateEndpointConnections |
리소스에 대한 프라이빗 엔드포인트 연결입니다. |
||
properties.provisioningState |
리소스의 프로비전 상태입니다. |
||
properties.publicNetworkAccess |
string |
Enabled |
공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "사용"입니다. 사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다. 사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다. |
properties.publicPort |
integer |
브라우저/클라이언트 쪽 사용을 위해 설계된 리소스의 공개적으로 액세스할 수 있는 포트입니다. |
|
properties.regionEndpointEnabled |
string |
Enabled |
지역별 엔드포인트를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "사용"입니다. 사용 안 함으로 설정되면 새 연결이 이 엔드포인트로 라우팅되지 않지만 기존 연결은 영향을 받지 않습니다. 이 속성은 복제본(replica) 고유합니다. 복제본(replica) 없이 지역 엔드포인트를 사용하지 않도록 설정할 수 없습니다. |
properties.resourceLogConfiguration |
Microsoft.SignalRService 리소스의 리소스 로그 구성입니다. |
||
properties.resourceStopped |
string |
false |
리소스를 중지하거나 시작합니다. 기본값은 "False"입니다. True이면 리소스의 데이터 평면이 종료됩니다. false이면 리소스의 데이터 평면이 시작됩니다. |
properties.serverPort |
integer |
고객 서버 쪽 사용을 위해 설계된 리소스의 공개적으로 액세스할 수 있는 포트입니다. |
|
properties.sharedPrivateLinkResources |
공유 프라이빗 링크 리소스 목록입니다. |
||
properties.socketIO |
리소스에 대한 SocketIO 설정 |
||
properties.tls |
리소스에 대한 TLS 설정 |
||
properties.version |
string |
리소스의 버전입니다. 클라이언트 SDK의 버전이 동일하거나 그 이상 필요할 수 있습니다. |
|
sku |
리소스의 청구 정보입니다. |
||
systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
||
tags |
object |
리소스 태그. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
WebPubSubSkuTier
이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.
Basic
는 사용되지 않으며, 대신 Standard
를 사용합니다.
Name | 형식 | Description |
---|---|---|
Basic |
string |
|
Free |
string |
|
Premium |
string |
|
Standard |
string |
WebPubSubSocketIOSettings
리소스에 대한 SocketIO 설정
Name | 형식 | Description |
---|---|---|
serviceMode |
string |
Socket.IO 대한 Web PubSub의 서비스 모드입니다. 허용되는 값: "기본값": 사용자 고유의 백 엔드 Socket.IO 서버 "서버리스"가 있음: 애플리케이션에 백 엔드 서버가 없습니다. |
WebPubSubTlsSettings
리소스에 대한 TLS 설정
Name | 형식 | Default value | Description |
---|---|---|---|
clientCertEnabled |
boolean |
False |
사용하도록 설정된 경우 TLS 핸드셰이크 중에 클라이언트 인증서를 요청합니다. 무료 계층에 대해 지원되지 않습니다. 모든 입력은 무료 계층에 대해 무시됩니다. |