| Description | : Creates or updates a namespace. Once created, this namespace's resource manifest is immutable. This operation is idempotent. |
| Reference | : Link ¶ |
⚶ Changes
{
"#id": "Namespaces_Update",
"$responses": {
"@removed_3723a95344d24e509cfdd24d2c7bc345": {
"201": {
"Description": "Single Namespace item in List or Get Operation",
"Type": "object",
"$properties": [
{
"#name": "properties",
"Description": "Namespace properties supplied for create namespace operation.",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "minimumTlsVersion",
"Description": "The minimum TLS version for the cluster to support, e.g. '1.2'",
"Enum": [
[
"1.0",
""
],
[
"1.1",
""
],
[
"1.2",
""
],
[
"1.3",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "provisioningState",
"Description": "Provisioning state of the Namespace.",
"Required": false,
"Type": "string"
},
{
"#name": "status",
"Description": "Status of the Namespace.",
"Required": false,
"Type": "string"
},
{
"#name": "createdAt",
"Description": "The time the Namespace was created.",
"Format": "date-time",
"Required": false,
"Type": "string"
},
{
"#name": "updatedAt",
"Description": "The time the Namespace was updated.",
"Format": "date-time",
"Required": false,
"Type": "string"
},
{
"#name": "serviceBusEndpoint",
"Description": "Endpoint you can use to perform Service Bus operations.",
"Required": false,
"Type": "string"
},
{
"#name": "clusterArmId",
"Description": "Cluster ARM ID of the Namespace.",
"Required": false,
"Type": "string"
},
{
"#name": "metricId",
"Description": "Identifier for Azure Insights metrics.",
"Required": false,
"Type": "string"
},
{
"#name": "isAutoInflateEnabled",
"Description": "Value that indicates whether AutoInflate is enabled for eventhub namespace.",
"Required": false,
"Type": "boolean"
},
{
"#name": "publicNetworkAccess",
"Description": "This determines if traffic is allowed over public network. By default it is enabled.",
"Enum": [
[
"Enabled",
""
],
[
"Disabled",
""
],
[
"SecuredByPerimeter",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "maximumThroughputUnits",
"Description": "Upper limit of throughput units when AutoInflate is enabled, value should be within 0 to 20 throughput units. ( '0' if AutoInflateEnabled = true)",
"Format": "int32",
"Required": false,
"Type": "integer"
},
{
"#name": "kafkaEnabled",
"Description": "Value that indicates whether Kafka is enabled for eventhub namespace.",
"Required": false,
"Type": "boolean"
},
{
"#name": "zoneRedundant",
"Description": "Enabling this property creates a Standard Event Hubs Namespace in regions supported availability zones.",
"Required": false,
"Type": "boolean"
},
{
"#name": "encryption",
"Description": "Properties of BYOK Encryption description",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "keyVaultProperties",
"Description": "Properties of KeyVault",
"Required": false,
"Type": "array",
"$items": {
"Description": "Properties to configure keyVault Properties",
"Type": "object",
"$properties": [
{
"#name": "keyName",
"Description": "Name of the Key from KeyVault",
"Required": false,
"Type": "string"
},
{
"#name": "keyVaultUri",
"Description": "Uri of KeyVault",
"Required": false,
"Type": "string"
},
{
"#name": "keyVersion",
"Description": "Key Version",
"Required": false,
"Type": "string"
},
{
"#name": "identity",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "userAssignedIdentity",
"Description": "ARM ID of user Identity selected for encryption",
"Required": false,
"Type": "string"
}
]
}
]
}
},
{
"#name": "keySource",
"Description": "Enumerates the possible value of keySource for Encryption",
"Enum": [
[
"Microsoft.KeyVault",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "requireInfrastructureEncryption",
"Description": "Enable Infrastructure Encryption (Double Encryption)",
"Required": false,
"Type": "boolean"
}
]
},
{
"#name": "privateEndpointConnections",
"Description": "List of private endpoint connections.",
"Required": false,
"Type": "array",
"$items": {
"Description": "Properties of the PrivateEndpointConnection.",
"Type": "object",
"$properties": [
{
"#name": "properties",
"Description": "Properties of the PrivateEndpointConnection.",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "privateEndpoint",
"Description": "The Private Endpoint resource for this Connection.",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "id",
"Description": "The ARM identifier for Private Endpoint.",
"Required": false,
"Type": "string"
}
]
},
{
"#name": "privateLinkServiceConnectionState",
"Description": "Details about the state of the connection.",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "status",
"Description": "Status of the connection.",
"Enum": [
[
"Pending",
""
],
[
"Approved",
""
],
[
"Rejected",
""
],
[
"Disconnected",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "description",
"Description": "Description of the connection state.",
"Required": false,
"Type": "string"
}
]
},
{
"#name": "provisioningState",
"Description": "Provisioning state of the Private Endpoint Connection.",
"Enum": [
[
"Creating",
""
],
[
"Updating",
""
],
[
"Deleting",
""
],
[
"Succeeded",
""
],
[
"Canceled",
""
],
[
"Failed",
""
]
],
"Required": false,
"Type": "string"
}
]
},
{
"#name": "location",
"Description": "The geo-location where the resource lives",
"Required": false,
"Type": "string"
}
]
}
},
{
"#name": "disableLocalAuth",
"Description": "This property disables SAS authentication for the Event Hubs namespace.",
"Required": false,
"Type": "boolean"
},
{
"#name": "alternateName",
"Description": "Alternate name specified when alias and namespace names are same.",
"Required": false,
"Type": "string"
},
{
"#name": "platformCapabilities",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "confidentialCompute",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "mode",
"Description": "Setting to Enable or Disable Confidential Compute",
"Enum": [
[
"Disabled",
""
],
[
"Enabled",
""
]
],
"Required": false,
"Type": "string"
}
]
}
]
},
{
"#name": "geoDataReplication",
"Description": "Geo Data Replication settings for the namespace",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "maxReplicationLagDurationInSeconds",
"Description": "The maximum acceptable lag for data replication operations from the primary replica to a quorum of secondary replicas. When the lag exceeds the configured amount, operations on the primary replica will be failed. The allowed values are 0 and 5 minutes to 1 day.",
"Format": "int32",
"Required": false,
"Type": "integer"
},
{
"#name": "locations",
"Description": "A list of regions where replicas of the namespace are maintained.",
"Required": false,
"Type": "array",
"$items": {
"Description": "Namespace replication properties",
"Type": "object",
"$properties": [
{
"#name": "locationName",
"Description": "Azure regions where a replica of the namespace is maintained",
"Required": false,
"Type": "string"
},
{
"#name": "roleType",
"Description": "GeoDR Role Types",
"Enum": [
[
"Primary",
""
],
[
"Secondary",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "replicaState",
"Description": "state of Namespace replica.",
"Required": false,
"Type": "string"
},
{
"#name": "clusterArmId",
"Description": "Optional property that denotes the ARM ID of the Cluster. This is required, if a namespace replica should be placed in a Dedicated Event Hub Cluster",
"Required": false,
"Type": "string"
}
]
}
}
]
}
]
},
{
"#name": "tags",
"Description": "Resource tags.",
"Required": false,
"Type": "object"
},
{
"#name": "location",
"Description": "The geo-location where the resource lives",
"Required": false,
"Type": "string"
},
{
"#name": "sku",
"Description": "Properties of sku resource",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "name",
"Description": "Name of this SKU.",
"Enum": [
[
"Basic",
""
],
[
"Standard",
""
],
[
"Premium",
""
]
],
"Required": true,
"Type": "string"
},
{
"#name": "tier",
"Description": "The billing tier of this particular SKU.",
"Enum": [
[
"Basic",
""
],
[
"Standard",
""
],
[
"Premium",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "capacity",
"Description": "The Event Hubs throughput units for Basic or Standard tiers, where value should be 0 to 20 throughput units. The Event Hubs premium units for Premium tier, where value should be 0 to 10 premium units.",
"Format": "int32",
"Required": false,
"Type": "integer"
}
]
},
{
"#name": "identity",
"Description": "Properties of BYOK Identity description",
"Required": false,
"Type": "object",
"$properties": [
{
"#name": "principalId",
"Description": "ObjectId from the KeyVault",
"Required": false,
"Type": "string"
},
{
"#name": "tenantId",
"Description": "TenantId from the KeyVault",
"Required": false,
"Type": "string"
},
{
"#name": "type",
"Description": "Type of managed service identity.",
"Enum": [
[
"SystemAssigned",
""
],
[
"UserAssigned",
""
],
[
"SystemAssigned, UserAssigned",
""
],
[
"None",
""
]
],
"Required": false,
"Type": "string"
},
{
"#name": "userAssignedIdentities",
"Description": "Properties for User Assigned Identities",
"Required": false,
"Type": "object"
}
]
}
]
}
}
}
}
⚼ Request
PATCH:
/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventHub/namespaces/{namespaceName}
{
api-version:
string
,
subscriptionId:
string
,
resourceGroupName:
string
,
namespaceName:
string
,
parameters:
}
{
,
properties:
{
,
minimumTlsVersion:
enum
,
provisioningState:
string
,
status:
string
,
createdAt:
string
,
updatedAt:
string
,
serviceBusEndpoint:
string
,
clusterArmId:
string
,
metricId:
string
,
isAutoInflateEnabled:
boolean
,
publicNetworkAccess:
enum
,
maximumThroughputUnits:
integer
,
kafkaEnabled:
boolean
,
zoneRedundant:
boolean
,
encryption:
{
,
keyVaultProperties:
[
]
,
{
,
keyName:
string
,
keyVaultUri:
string
,
keyVersion:
string
,
identity:
}
{
,
userAssignedIdentity:
string
,
}
keySource:
enum
,
requireInfrastructureEncryption:
boolean
,
}
privateEndpointConnections:
[
]
,
{
,
properties:
{
,
privateEndpoint:
{
,
id:
string
,
}
privateLinkServiceConnectionState:
{
,
status:
enum
,
description:
string
,
}
provisioningState:
enum
,
}
location:
string
,
}
disableLocalAuth:
boolean
,
alternateName:
string
,
platformCapabilities:
{
,
confidentialCompute:
}
{
,
mode:
enum
,
}
geoDataReplication:
}
{
,
maxReplicationLagDurationInSeconds:
integer
,
locations:
}
[
]
,
{
,
locationName:
string
,
roleType:
enum
,
replicaState:
string
,
clusterArmId:
string
,
}
tags:
object
,
location:
string
,
sku:
{
,
name:
enum
,
tier:
enum
,
capacity:
integer
,
}
identity:
}
{
,
principalId:
string
,
tenantId:
string
,
type:
enum
,
userAssignedIdentities:
object
,
}
⚐ Response (200)
{
properties:
{
,
minimumTlsVersion:
enum
,
provisioningState:
string
,
status:
string
,
createdAt:
string
,
updatedAt:
string
,
serviceBusEndpoint:
string
,
clusterArmId:
string
,
metricId:
string
,
isAutoInflateEnabled:
boolean
,
publicNetworkAccess:
enum
,
maximumThroughputUnits:
integer
,
kafkaEnabled:
boolean
,
zoneRedundant:
boolean
,
encryption:
{
,
keyVaultProperties:
[
]
,
{
,
keyName:
string
,
keyVaultUri:
string
,
keyVersion:
string
,
identity:
}
{
,
userAssignedIdentity:
string
,
}
keySource:
enum
,
requireInfrastructureEncryption:
boolean
,
}
privateEndpointConnections:
[
]
,
{
,
properties:
{
,
privateEndpoint:
{
,
id:
string
,
}
privateLinkServiceConnectionState:
{
,
status:
enum
,
description:
string
,
}
provisioningState:
enum
,
}
location:
string
,
}
disableLocalAuth:
boolean
,
alternateName:
string
,
platformCapabilities:
{
,
confidentialCompute:
}
{
,
mode:
enum
,
}
geoDataReplication:
}
{
,
maxReplicationLagDurationInSeconds:
integer
,
locations:
}
[
]
,
{
,
locationName:
string
,
roleType:
enum
,
replicaState:
string
,
clusterArmId:
string
,
}
tags:
object
,
location:
string
,
sku:
{
,
name:
enum
,
tier:
enum
,
capacity:
integer
,
}
identity:
}
{
,
principalId:
string
,
tenantId:
string
,
type:
enum
,
userAssignedIdentities:
object
,
}
⚐ Response (202)
{
azure-asyncoperation:
string
,
location:
string
,
retry-after:
integer
,
}
⚐ Response (default)
{
error:
}
{
,
code:
string
,
message:
string
,
target:
string
,
details:
[
,
string
,
]
additionalInfo:
}
[
]
,
{
,
type:
string
,
info:
string
,
}