Namespaces - Create Or Update
Tworzy lub aktualizuje przestrzeń nazw usługi. Po utworzeniu manifest zasobu tej przestrzeni nazw jest niezmienny. Ta operacja jest idempotentna.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}?api-version=2021-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
namespace
|
path | True |
string |
Nazwa przestrzeni nazw. |
resource
|
path | True |
string |
Nazwa grupy zasobów w ramach subskrypcji platformy Azure. |
subscription
|
path | True |
string |
Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi. |
api-version
|
query | True |
string |
Wersja interfejsu API klienta. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
identity.type |
Typ tożsamości usługi zarządzanej. |
||
identity.userAssignedIdentities |
<string,
User |
Właściwości tożsamości przypisanych przez użytkownika |
|
properties.alternateName |
string |
Alternatywna nazwa przestrzeni nazw |
|
properties.disableLocalAuth |
boolean |
Ta właściwość wyłącza uwierzytelnianie sygnatury dostępu współdzielonego dla przestrzeni nazw usługi Service Bus. |
|
properties.encryption.keySource |
Wylicza możliwą wartość kluczaSource dla szyfrowania |
||
properties.encryption.keyVaultProperties |
Właściwości usługi KeyVault |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Włączanie szyfrowania infrastruktury (podwójne szyfrowanie) |
|
properties.privateEndpointConnections |
Lista połączeń prywatnego punktu końcowego. |
||
properties.zoneRedundant |
boolean |
Włączenie tej właściwości powoduje utworzenie przestrzeni nazw usługi Service Bus w warstwie Premium w regionach obsługiwanych stref dostępności. |
|
sku |
Właściwości jednostki SKU |
||
tags |
object |
Tagi zasobów |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Przestrzeń nazw została pomyślnie utworzona. |
|
201 Created |
Zaakceptowano żądanie tworzenia przestrzeni nazw. |
|
202 Accepted |
Zaakceptowane żądanie tworzenia lub aktualizowania przestrzeni nazw. |
|
Other Status Codes |
Odpowiedź błędu usługi ServiceBus opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
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
}
}
Definicje
Nazwa | Opis |
---|---|
Connection |
Informacje o stanie połączenia. |
created |
Typ tożsamości, która utworzyła zasób. |
End |
Stan aprowizacji połączenia prywatnego punktu końcowego. |
Error |
Obiekt błędu. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Odpowiedź na błąd zarządzania zasobami. |
key |
Wylicza możliwą wartość kluczaSource dla szyfrowania |
Key |
Właściwości do konfigurowania właściwości usługi KeyVault |
Managed |
Typ tożsamości usługi zarządzanej. |
Private |
Informacje o prywatnym punkcie końcowym. |
Private |
Właściwości elementu PrivateEndpointConnection. |
Private |
Stan połączenia. |
SBNamespace |
Opis zasobu przestrzeni nazw. |
SBSku |
Jednostka SKU przestrzeni nazw. |
Sku |
Nazwa tej jednostki SKU. |
Sku |
Warstwa rozliczeń tej konkretnej jednostki SKU. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
User |
Rozpoznana wartość słownika. |
ConnectionState
Informacje o stanie połączenia.
Nazwa | Typ | Opis |
---|---|---|
description |
string |
Opis stanu połączenia. |
status |
Stan połączenia. |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
EndPointProvisioningState
Stan aprowizacji połączenia prywatnego punktu końcowego.
Nazwa | Typ | Opis |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
Error
Obiekt błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorResponse
Odpowiedź na błąd zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
keySource
Wylicza możliwą wartość kluczaSource dla szyfrowania
Nazwa | Typ | Opis |
---|---|---|
Microsoft.KeyVault |
string |
KeyVaultProperties
Właściwości do konfigurowania właściwości usługi KeyVault
Nazwa | Typ | Opis |
---|---|---|
identity.userAssignedIdentity |
string |
Identyfikator arm tożsamości użytkownika wybranej do szyfrowania |
keyName |
string |
Nazwa klucza z usługi KeyVault |
keyVaultUri |
string |
Identyfikator URI usługi KeyVault |
keyVersion |
string |
Wersja usługi KeyVault |
ManagedServiceIdentityType
Typ tożsamości usługi zarządzanej.
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
PrivateEndpoint
Informacje o prywatnym punkcie końcowym.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator usługi ARM dla prywatnego punktu końcowego. |
PrivateEndpointConnection
Właściwości elementu PrivateEndpointConnection.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
name |
string |
Nazwa zasobu |
properties.privateEndpoint |
Zasób prywatnego punktu końcowego dla tego połączenia. |
|
properties.privateLinkServiceConnectionState |
Szczegóły dotyczące stanu połączenia. |
|
properties.provisioningState |
Stan aprowizacji połączenia prywatnego punktu końcowego. |
|
systemData |
Dane metadane systemowe odnoszące się do tego zasobu. |
|
type |
string |
Typ zasobu. Np. "Microsoft.EventHub/Namespaces" lub "Microsoft.EventHub/Namespaces/EventHubs" |
PrivateLinkConnectionStatus
Stan połączenia.
Nazwa | Typ | Opis |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
SBNamespace
Opis zasobu przestrzeni nazw.
Nazwa | Typ | Wartość domyślna | Opis |
---|---|---|---|
id |
string |
Identyfikator zasobu |
|
identity.principalId |
string |
ObjectId z usługi KeyVault |
|
identity.tenantId |
string |
TenantId z usługi KeyVault |
|
identity.type |
Typ tożsamości usługi zarządzanej. |
||
identity.userAssignedIdentities |
<string,
User |
Właściwości tożsamości przypisanych przez użytkownika |
|
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
|
name |
string |
Nazwa zasobu |
|
properties.alternateName |
string |
Alternatywna nazwa przestrzeni nazw |
|
properties.createdAt |
string |
Czas utworzenia przestrzeni nazw |
|
properties.disableLocalAuth |
boolean |
Ta właściwość wyłącza uwierzytelnianie sygnatury dostępu współdzielonego dla przestrzeni nazw usługi Service Bus. |
|
properties.encryption.keySource | Microsoft.KeyVault |
Wylicza możliwą wartość kluczaSource dla szyfrowania |
|
properties.encryption.keyVaultProperties |
Właściwości usługi KeyVault |
||
properties.encryption.requireInfrastructureEncryption |
boolean |
Włączanie szyfrowania infrastruktury (podwójne szyfrowanie) |
|
properties.metricId |
string |
Identyfikator metryk usługi Azure Insights |
|
properties.privateEndpointConnections |
Lista połączeń prywatnego punktu końcowego. |
||
properties.provisioningState |
string |
Stan aprowizacji przestrzeni nazw. |
|
properties.serviceBusEndpoint |
string |
Punkt końcowy, którego można użyć do wykonywania operacji usługi Service Bus. |
|
properties.status |
string |
Stan przestrzeni nazw. |
|
properties.updatedAt |
string |
Czas aktualizacji przestrzeni nazw. |
|
properties.zoneRedundant |
boolean |
Włączenie tej właściwości powoduje utworzenie przestrzeni nazw usługi Service Bus w warstwie Premium w regionach obsługiwanych stref dostępności. |
|
sku |
Właściwości jednostki SKU |
||
systemData |
Dane metadane systemowe odnoszące się do tego zasobu. |
||
tags |
object |
Tagi zasobów |
|
type |
string |
Typ zasobu |
SBSku
Jednostka SKU przestrzeni nazw.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Określone jednostki obsługi komunikatów dla warstwy. W przypadku warstwy Premium pojemność to 1,2 i 4. |
name |
Nazwa tej jednostki SKU. |
|
tier |
Warstwa rozliczeń tej konkretnej jednostki SKU. |
SkuName
Nazwa tej jednostki SKU.
Nazwa | Typ | Opis |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
SkuTier
Warstwa rozliczeń tej konkretnej jednostki SKU.
Nazwa | Typ | Opis |
---|---|---|
Basic |
string |
|
Premium |
string |
|
Standard |
string |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserAssignedIdentity
Rozpoznana wartość słownika.
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta tożsamości przypisanej przez użytkownika |
principalId |
string |
Identyfikator podmiotu tożsamości przypisanej przez użytkownika |