Microsoft.ServiceBus (stable:2024-01-01)

2025/06/18 • 5 updated methods

Namespaces_List (updated)
Description Gets all the available namespaces within the subscription, irrespective of the resource groups.
Reference Link ¶

⚶ Changes

{
  "#id": "Namespaces_List",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "zoneRedundant",
                "Description": {
                  "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
                  "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.ServiceBus/namespaces
{
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
value:
[
{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Namespaces_ListByResourceGroup (updated)
Description Gets the available namespaces within a resource group.
Reference Link ¶

⚶ Changes

{
  "#id": "Namespaces_ListByResourceGroup",
  "$responses": {
    "200": {
      "$properties": {
        "value": {
          "$properties": {
            "properties": [
              {
                "#name": "zoneRedundant",
                "Description": {
                  "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
                  "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
                }
              }
            ]
          }
        }
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces
{
resourceGroupName: string ,
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
value:
[
{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}
,
]
,
nextLink: string ,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Namespaces_CreateOrUpdate (updated)
Description Creates or updates a service namespace. Once created, this namespace's resource manifest is immutable. This operation is idempotent.
Reference Link ¶

⚶ Changes

{
  "#id": "Namespaces_CreateOrUpdate",
  "$parameters": {
    "parameters": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    }
  },
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}
{
resourceGroupName: string ,
namespaceName: string ,
parameters:
{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}
,
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}

⚐ Response (201)

{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Namespaces_Get (updated)
Description Gets a description for the specified namespace.
Reference Link ¶

⚶ Changes

{
  "#id": "Namespaces_Get",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}
{
resourceGroupName: string ,
namespaceName: string ,
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
Namespaces_Update (updated)
Description Updates a service namespace. Once created, this namespace's resource manifest is immutable. This operation is idempotent.
Reference Link ¶

⚶ Changes

{
  "#id": "Namespaces_Update",
  "$responses": {
    "200": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    },
    "201": {
      "$properties": {
        "properties": [
          {
            "#name": "zoneRedundant",
            "Description": {
              "new": "This property reflects if zone redundancy has been enabled for namespaces in regions that support availability zones.",
              "old": "Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones."
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}
{
resourceGroupName: string ,
namespaceName: string ,
parameters:
{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
properties:
{
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
}
,
api-version: string ,
subscriptionId: string ,
}

⚐ Response (200)

{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}

⚐ Response (201)

{
sku:
{
name: enum ,
tier: enum ,
capacity: integer ,
}
,
identity:
{
principalId: string ,
tenantId: string ,
type: enum ,
userAssignedIdentities: object ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
properties:
{
minimumTlsVersion: enum ,
provisioningState: string ,
status: string ,
createdAt: string ,
updatedAt: string ,
serviceBusEndpoint: string ,
metricId: string ,
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 ,
}
,
systemData:
{
createdBy: string ,
createdByType: enum ,
createdAt: string ,
lastModifiedBy: string ,
lastModifiedByType: enum ,
lastModifiedAt: string ,
}
,
}
,
]
,
disableLocalAuth: boolean ,
alternateName: string ,
publicNetworkAccess: enum ,
premiumMessagingPartitions: integer ,
}
,
}

⚐ Response (202)

{}

⚐ Response (default)

{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
{
error:
{
code: string ,
message: string ,
target: string ,
details:
[
string ,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}
,
]
,
additionalInfo:
[
{
type: string ,
info: object ,
}
,
]
,
}
,
}