Microsoft.EventHub (preview:2025-05-01)

2025/11/14 • 1 updated methods

Namespaces_Update (updated)
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 ,
}
,
]
,
}
,
}