Namespaces - Create Or Update
서비스 네임스페이스를 만들거나 업데이트합니다. 만든 후 이 네임스페이스의 리소스 매니페스트는 변경할 수 없습니다. 이 작업은 idempotent 방식입니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}?api-version=2021-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
네임스페이스 이름입니다. |
resource
|
path | True |
string |
Azure 구독 내의 리소스 그룹 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
identity.type |
관리 서비스 ID의 유형입니다. |
||
identity.userAssignedIdentities |
<string,
User |
사용자 할당 ID에 대한 속성 |
|
properties.alternateName |
string |
네임스페이스의 대체 이름 |
|
properties.disableLocalAuth |
boolean |
이 속성은 Service Bus 네임스페이스에 대한 SAS 인증을 사용하지 않도록 설정합니다. |
|
properties.encryption.keySource |
암호화에 사용할 수 있는 keySource 값을 열거합니다. |
||
properties.encryption.keyVaultProperties |
KeyVault의 속성 |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
인프라 암호화 사용(이중 암호화) |
|
properties.privateEndpointConnections |
프라이빗 엔드포인트 연결 목록입니다. |
||
properties.zoneRedundant |
boolean |
이 속성을 사용하도록 설정하면 지원되는 가용성 영역에 프리미엄 Service Bus 네임스페이스가 만들어집니다. |
|
sku |
SKU의 속성 |
||
tags |
object |
리소스 태그 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
네임스페이스를 만들었습니다. |
|
201 Created |
네임스페이스 만들기 요청이 수락되었습니다. |
|
202 Accepted |
네임스페이스 만들기 또는 업데이트 요청이 수락되었습니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 ServiceBus 오류 응답입니다. |
보안
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 | 사용자 계정 가장 |
예제
NameSpaceCreate
Sample Request
PUT https://management.azure.com/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace2924?api-version=2021-11-01
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
}
}
Sample Response
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-2924",
"name": "sdk-Namespace-2924",
"type": "Microsoft.ServiceBus/Namespaces",
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"provisioningState": "Created",
"metricId": "5f750a97-50d9-4e36-8081-c9ee4c0210d4:sdk-namespace-2924",
"createdAt": "2017-05-25T22:26:36.76Z",
"updatedAt": "2017-05-25T22:26:36.76Z",
"serviceBusEndpoint": "https://sdk-Namespace-2924.servicebus.windows-int.net:443/"
}
}
{
"sku": {
"name": "Standard",
"tier": "Standard"
},
"id": "/subscriptions/5f750a97-50d9-4e36-8081-c9ee4c0210d4/resourceGroups/ArunMonocle/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-2924",
"name": "sdk-Namespace-2924",
"type": "Microsoft.ServiceBus/Namespaces",
"location": "South Central US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"provisioningState": "Created",
"metricId": "5f750a97-50d9-4e36-8081-c9ee4c0210d4:sdk-namespace-2924",
"createdAt": "2017-05-25T22:26:36.76Z",
"updatedAt": "2017-05-25T22:26:36.76Z",
"serviceBusEndpoint": "https://sdk-Namespace-2924.servicebus.windows-int.net:443/",
"disableLocalAuth": false
}
}
정의
Name | Description |
---|---|
Connection |
ConnectionState 정보입니다. |
created |
리소스를 만든 ID의 형식입니다. |
End |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
Error |
Error 개체. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
리소스 관리 오류 응답입니다. |
key |
암호화에 사용할 수 있는 keySource 값을 열거합니다. |
Key |
keyVault 속성을 구성하는 속성 |
Managed |
관리 서비스 ID의 유형입니다. |
Private |
PrivateEndpoint 정보입니다. |
Private |
PrivateEndpointConnection의 속성입니다. |
Private |
연결의 상태입니다. |
SBNamespace |
네임스페이스 리소스에 대한 설명입니다. |
SBSku |
네임스페이스의 SKU입니다. |
Sku |
이 SKU의 이름입니다. |
Sku |
이 특정 SKU의 청구 계층입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
User |
인식된 사전 값입니다. |
ConnectionState
ConnectionState 정보입니다.
Name | 형식 | Description |
---|---|---|
description |
string |
연결 상태에 대한 설명입니다. |
status |
연결의 상태입니다. |
createdByType
리소스를 만든 ID의 형식입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EndPointProvisioningState
프라이빗 엔드포인트 연결의 프로비전 상태입니다.
Name | 형식 | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Error
Error 개체.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorResponse
리소스 관리 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
keySource
암호화에 사용할 수 있는 keySource 값을 열거합니다.
Name | 형식 | Description |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
keyVault 속성을 구성하는 속성
Name | 형식 | Description |
---|---|---|
identity.userAssignedIdentity |
string |
암호화를 위해 선택된 사용자 ID의 ARM ID |
keyName |
string |
KeyVault의 키 이름 |
keyVaultUri |
string |
KeyVault의 URI |
keyVersion |
string |
KeyVault 버전 |
ManagedServiceIdentityType
관리 서비스 ID의 유형입니다.
Name | 형식 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
PrivateEndpoint 정보입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트에 대한 ARM 식별자입니다. |
PrivateEndpointConnection
PrivateEndpointConnection의 속성입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
리소스가 있는 지리적 위치 |
name |
string |
리소스의 이름입니다. |
properties.privateEndpoint |
이 연결에 대한 프라이빗 엔드포인트 리소스입니다. |
|
properties.privateLinkServiceConnectionState |
연결 상태에 대한 세부 정보입니다. |
|
properties.provisioningState |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
|
systemData |
이 리소스와 관련된 시스템 메타 데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.EventHub/Namespaces" 또는 "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
연결의 상태입니다.
Name | 형식 | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
SBNamespace
네임스페이스 리소스에 대한 설명입니다.
Name | 형식 | 기본값 | Description |
---|---|---|---|
id |
string |
리소스 ID |
|
identity.principalId |
string |
KeyVault의 ObjectId |
|
identity.tenantId |
string |
KeyVault의 TenantId |
|
identity.type |
관리 서비스 ID의 유형입니다. |
||
identity.userAssignedIdentities |
<string,
User |
사용자 할당 ID에 대한 속성 |
|
location |
string |
리소스가 있는 지리적 위치 |
|
name |
string |
리소스 이름 |
|
properties.alternateName |
string |
네임스페이스의 대체 이름 |
|
properties.createdAt |
string |
네임스페이스를 만든 시간 |
|
properties.disableLocalAuth |
boolean |
이 속성은 Service Bus 네임스페이스에 대한 SAS 인증을 사용하지 않도록 설정합니다. |
|
properties.encryption.keySource | Microsoft.KeyVault |
암호화에 사용할 수 있는 keySource 값을 열거합니다. |
|
properties.encryption.keyVaultProperties |
KeyVault의 속성 |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
인프라 암호화 사용(이중 암호화) |
|
properties.metricId |
string |
Azure Insights 메트릭에 대한 식별자 |
|
properties.privateEndpointConnections |
프라이빗 엔드포인트 연결 목록입니다. |
||
properties.provisioningState |
string |
네임스페이스의 프로비전 상태입니다. |
|
properties.serviceBusEndpoint |
string |
Service Bus 작업을 수행하는 데 사용할 수 있는 엔드포인트입니다. |
|
properties.status |
string |
네임스페이스의 상태입니다. |
|
properties.updatedAt |
string |
네임스페이스가 업데이트된 시간입니다. |
|
properties.zoneRedundant |
boolean |
이 속성을 사용하도록 설정하면 지원되는 가용성 영역에 프리미엄 Service Bus 네임스페이스가 만들어집니다. |
|
sku |
SKU의 속성 |
||
systemData |
이 리소스와 관련된 시스템 메타 데이터입니다. |
||
tags |
object |
리소스 태그 |
|
type |
string |
리소스 유형 |
SBSku
네임스페이스의 SKU입니다.
Name | 형식 | Description |
---|---|---|
capacity |
integer |
계층에 대해 지정된 메시징 단위입니다. 프리미엄 계층의 경우 용량은 1,2 및 4입니다. |
name |
이 SKU의 이름입니다. |
|
tier |
이 특정 SKU의 청구 계층입니다. |
SkuName
이 SKU의 이름입니다.
Name | 형식 | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
이 특정 SKU의 청구 계층입니다.
Name | 형식 | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스를 마지막으로 수정한 ID 유형입니다. |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
UserAssignedIdentity
인식된 사전 값입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
사용자 할당 ID의 클라이언트 ID |
principalId |
string |
사용자 할당 ID의 보안 주체 ID |