Namespaces - Create Or Update
Hizmet ad alanını oluşturur veya güncelleştirir. Oluşturulduktan sonra bu ad alanının kaynak bildirimi değişmez. Bu işlem bir kez etkili olur.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}?api-version=2021-11-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
namespace
|
path | True |
string |
Ad alanı adı. |
resource
|
path | True |
string |
Azure aboneliğindeki Kaynak grubunun adı. |
subscription
|
path | True |
string |
Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur. |
api-version
|
query | True |
string |
İstemci API sürümü. |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
location | True |
string |
Kaynağın bulunduğu Coğrafi konum |
identity.type |
Yönetilen hizmet kimliğinin türü. |
||
identity.userAssignedIdentities |
<string,
User |
Kullanıcı Tarafından Atanan Kimliklerin Özellikleri |
|
properties.alternateName |
string |
Ad alanı için alternatif ad |
|
properties.disableLocalAuth |
boolean |
Bu özellik, Service Bus ad alanı için SAS kimlik doğrulamasını devre dışı bırakır. |
|
properties.encryption.keySource |
Şifreleme için keySource'un olası değerini numaralandırır |
||
properties.encryption.keyVaultProperties |
KeyVault Özellikleri |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Altyapı Şifrelemesini Etkinleştirme (Çift Şifreleme) |
|
properties.privateEndpointConnections |
Özel uç nokta bağlantılarının listesi. |
||
properties.zoneRedundant |
boolean |
Bu özelliğin etkinleştirilmesi, desteklenen kullanılabilirlik alanlarında bir Premium Service Bus Ad Alanı oluşturur. |
|
sku |
SKU'nun Özellikleri |
||
tags |
object |
Kaynak etiketleri |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Ad alanı başarıyla oluşturuldu. |
|
201 Created |
Ad alanı oluşturma isteği kabul edildi. |
|
202 Accepted |
Ad alanı oluşturma veya güncelleştirme isteği kabul edildi. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan ServiceBus hata yanıtı. |
Güvenlik
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 | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
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
}
}
Tanımlar
Name | Description |
---|---|
Connection |
ConnectionState bilgileri. |
created |
Kaynağı oluşturan kimliğin türü. |
End |
Özel Uç Nokta Bağlantısının sağlama durumu. |
Error |
Hata nesnesi. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Kaynak yönetimi hata yanıtı. |
key |
Şifreleme için keySource'un olası değerini numaralandırır |
Key |
keyVault Özelliklerini yapılandıracak özellikler |
Managed |
Yönetilen hizmet kimliğinin türü. |
Private |
PrivateEndpoint bilgileri. |
Private |
PrivateEndpointConnection özellikleri. |
Private |
Bağlantının durumu. |
SBNamespace |
Ad alanı kaynağının açıklaması. |
SBSku |
Ad alanının SKU'su. |
Sku |
Bu SKU'nun adı. |
Sku |
Bu belirli SKU'nun faturalama katmanı. |
system |
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler. |
User |
Tanınan Sözlük değeri. |
ConnectionState
ConnectionState bilgileri.
Name | Tür | Description |
---|---|---|
description |
string |
Bağlantı durumunun açıklaması. |
status |
Bağlantının durumu. |
createdByType
Kaynağı oluşturan kimliğin türü.
Name | Tür | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EndPointProvisioningState
Özel Uç Nokta Bağlantısının sağlama durumu.
Name | Tür | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Error
Hata nesnesi.
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
ErrorAdditionalInfo
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
ErrorResponse
Kaynak yönetimi hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata nesnesi. |
keySource
Şifreleme için keySource'un olası değerini numaralandırır
Name | Tür | Description |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
keyVault Özelliklerini yapılandıracak özellikler
Name | Tür | Description |
---|---|---|
identity.userAssignedIdentity |
string |
Şifreleme için seçilen kullanıcı kimliğinin ARM kimliği |
keyName |
string |
KeyVault'tan Anahtarın Adı |
keyVaultUri |
string |
KeyVault'un Uri'si |
keyVersion |
string |
KeyVault sürümü |
ManagedServiceIdentityType
Yönetilen hizmet kimliğinin türü.
Name | Tür | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
PrivateEndpoint bilgileri.
Name | Tür | Description |
---|---|---|
id |
string |
Özel Uç Nokta için ARM tanımlayıcısı. |
PrivateEndpointConnection
PrivateEndpointConnection özellikleri.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Kaynağın bulunduğu coğrafi konum |
name |
string |
Kaynağın adı |
properties.privateEndpoint |
Bu Bağlantı için Özel Uç Nokta kaynağı. |
|
properties.privateLinkServiceConnectionState |
Bağlantının durumuyla ilgili ayrıntılar. |
|
properties.provisioningState |
Özel Uç Nokta Bağlantısının sağlama durumu. |
|
systemData |
Bu kaynakla ilgili sistem meta verileri. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.EventHub/Namespaces" veya "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
Bağlantının durumu.
Name | Tür | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
SBNamespace
Ad alanı kaynağının açıklaması.
Name | Tür | Varsayılan değer | Description |
---|---|---|---|
id |
string |
Kaynak Kimliği |
|
identity.principalId |
string |
KeyVault'tan ObjectId |
|
identity.tenantId |
string |
KeyVault'tan TenantId |
|
identity.type |
Yönetilen hizmet kimliğinin türü. |
||
identity.userAssignedIdentities |
<string,
User |
Kullanıcı Tarafından Atanan Kimliklerin Özellikleri |
|
location |
string |
Kaynağın bulunduğu Coğrafi konum |
|
name |
string |
Kaynak adı |
|
properties.alternateName |
string |
Ad alanı için alternatif ad |
|
properties.createdAt |
string |
Ad alanının oluşturulduğu saat |
|
properties.disableLocalAuth |
boolean |
Bu özellik, Service Bus ad alanı için SAS kimlik doğrulamasını devre dışı bırakır. |
|
properties.encryption.keySource | Microsoft.KeyVault |
Şifreleme için keySource'un olası değerini numaralandırır |
|
properties.encryption.keyVaultProperties |
KeyVault Özellikleri |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Altyapı Şifrelemesini Etkinleştirme (Çift Şifreleme) |
|
properties.metricId |
string |
Azure Insights ölçümleri için tanımlayıcı |
|
properties.privateEndpointConnections |
Özel uç nokta bağlantılarının listesi. |
||
properties.provisioningState |
string |
Ad alanının sağlama durumu. |
|
properties.serviceBusEndpoint |
string |
Service Bus işlemlerini gerçekleştirmek için kullanabileceğiniz uç nokta. |
|
properties.status |
string |
Ad alanının durumu. |
|
properties.updatedAt |
string |
Ad alanının güncelleştirilildiği saat. |
|
properties.zoneRedundant |
boolean |
Bu özelliğin etkinleştirilmesi, desteklenen kullanılabilirlik alanlarında bir Premium Service Bus Ad Alanı oluşturur. |
|
sku |
SKU'nun Özellikleri |
||
systemData |
Bu kaynakla ilgili sistem meta verileri. |
||
tags |
object |
Kaynak etiketleri |
|
type |
string |
Kaynak türü |
SBSku
Ad alanının SKU'su.
Name | Tür | Description |
---|---|---|
capacity |
integer |
Katman için belirtilen mesajlaşma birimleri. Premium katman için kapasite 1,2 ve 4'tır. |
name |
Bu SKU'nun adı. |
|
tier |
Bu belirli SKU'nun faturalama katmanı. |
SkuName
Bu SKU'nun adı.
Name | Tür | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
Bu belirli SKU'nun faturalama katmanı.
Name | Tür | Description |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Name | Tür | Description |
---|---|---|
createdAt |
string |
Kaynak oluşturma (UTC) zaman damgası. |
createdBy |
string |
Kaynağı oluşturan kimlik. |
createdByType |
Kaynağı oluşturan kimliğin türü. |
|
lastModifiedAt |
string |
Kaynağı en son değiştiren kimliğin türü. |
lastModifiedBy |
string |
Kaynağı en son değiştiren kimlik. |
lastModifiedByType |
Kaynağı en son değiştiren kimliğin türü. |
UserAssignedIdentity
Tanınan Sözlük değeri.
Name | Tür | Description |
---|---|---|
clientId |
string |
Kullanıcı tarafından atanan kimliğin istemci kimliği |
principalId |
string |
Kullanıcı tarafından atanan kimliğin Asıl Kimliği |