Namespaces - List

Service:

Notification Hubs

API Version:

2023-09-01

Lists the available namespaces within a resource group.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces?api-version=2023-09-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces?$skipToken={$skipToken}&$top={$top}&api-version=2023-09-01

URI Parameters

Name	In	Required	Type	Description
resourceGroupName	path	True	string	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string uuid	The ID of the target subscription. The value must be an UUID.
api-version	query	True	string	The API version to use for this operation.
$skipToken	query		string	Skip token for subsequent requests.
$top	query		integer int32	Maximum number of results to return.

Responses

Name	Type	Description
200 OK	NamespaceListResult	Success
Other Status Codes	ErrorResponse	Error code with reason.

Security

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	impersonate your user account

Examples

Namespaces_List

Sample Request

HTTP

GET https://management.azure.com/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces?api-version=2023-09-01

Sample Response

Status code:

200

{
  "value": [
    {
      "location": "East US",
      "sku": {
        "name": "Standard"
      },
      "properties": {
        "name": "namespace-1",
        "provisioningState": "Succeeded",
        "status": "Created",
        "enabled": true,
        "critical": false,
        "subscriptionId": "29cfa613-cbbc-4512-b1d6-1b3a92c7fa40",
        "createdAt": "2023-04-26T06:10:44.01+00:00",
        "updatedAt": "2023-04-26T06:10:44.03+00:00",
        "namespaceType": "NotificationHub",
        "publicNetworkAccess": "Enabled",
        "networkAcls": {
          "ipRules": [
            {
              "ipMask": "185.48.100.00/24",
              "rights": [
                "Manage",
                "Send",
                "Listen"
              ]
            }
          ],
          "publicNetworkRule": {
            "rights": [
              "Listen"
            ]
          }
        },
        "serviceBusEndpoint": "https://namespace-1.servicebus.windows.net:443/",
        "privateEndpointConnections": []
      },
      "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/namespace-1",
      "name": "namespace-2",
      "type": "Microsoft.NotificationHubs/namespaces",
      "tags": {}
    },
    {
      "location": "East US",
      "sku": {
        "name": "Standard"
      },
      "properties": {
        "name": "namespace-2",
        "provisioningState": "Succeeded",
        "status": "Created",
        "enabled": true,
        "critical": false,
        "subscriptionId": "29cfa613-cbbc-4512-b1d6-1b3a92c7fa40",
        "createdAt": "2023-04-26T06:10:44.01+00:00",
        "updatedAt": "2023-04-26T06:10:44.03+00:00",
        "namespaceType": "NotificationHub",
        "publicNetworkAccess": "Enabled",
        "networkAcls": {
          "ipRules": [],
          "publicNetworkRule": {
            "rights": [
              "Manage",
              "Listen",
              "Send"
            ]
          }
        },
        "serviceBusEndpoint": "https://namespace-2.servicebus.windows.net:443/",
        "privateEndpointConnections": []
      },
      "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/namespace-2",
      "name": "namespace-2",
      "type": "Microsoft.NotificationHubs/namespaces",
      "tags": {
        "tag1": "value1",
        "tag2": "value2"
      }
    }
  ],
  "nextLink": "https://management.azure.com/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/providers/Microsoft.NotificationHubs/namespaces?api-version=2023-09-01&$count=2&$skipToken=##################"
}

Definitions

Name	Description
AccessRights	Defines values for AccessRights.
AdmCredential	Description of a NotificationHub AdmCredential.
AdmCredentialProperties	Description of a NotificationHub AdmCredential.
ApnsCredential	Description of a NotificationHub ApnsCredential.
ApnsCredentialProperties	Description of a NotificationHub ApnsCredential.
BaiduCredential	Description of a NotificationHub BaiduCredential.
BaiduCredentialProperties	Description of a NotificationHub BaiduCredential.
BrowserCredential	Description of a NotificationHub BrowserCredential.
BrowserCredentialProperties	Description of a NotificationHub BrowserCredential.
createdByType	The type of identity that created the resource.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
GcmCredential	Description of a NotificationHub GcmCredential.
GcmCredentialProperties	Description of a NotificationHub GcmCredential.
IpRule	A network authorization rule that filters traffic based on IP address.
MpnsCredential	Description of a NotificationHub MpnsCredential.
MpnsCredentialProperties	Description of a NotificationHub MpnsCredential.
NamespaceListResult	The response of the List Namespace operation.
NamespaceProperties	Represents namespace properties.
NamespaceResource	Notification Hubs Namespace Resource.
NamespaceStatus	Namespace status.
NamespaceType	Defines values for NamespaceType.
NetworkAcls	A collection of network authorization rules.
OperationProvisioningState	Defines values for OperationProvisioningState.
PnsCredentials	Collection of Notification Hub or Notification Hub Namespace PNS credentials.
PrivateEndpointConnectionProperties	Private Endpoint Connection properties.
PrivateEndpointConnectionProvisioningState	State of Private Endpoint Connection.
PrivateEndpointConnectionResource	Represents a Private Endpoint Connection ARM resource - a sub-resource of Notification Hubs namespace.
PrivateLinkConnectionStatus	State of Private Link Connection.
PublicInternetAuthorizationRule	A default (public Internet) network authorization rule, which contains rights if no other network rule matches.
PublicNetworkAccess	Type of public network access.
RemotePrivateEndpointConnection	Represents a Private Endpoint that is connected to Notification Hubs namespace using Private Endpoint Connection.
RemotePrivateLinkServiceConnectionState	State of the Private Link Service connection.
ReplicationRegion	Allowed replication region
Sku	The Sku description for a namespace
SkuName	Namespace SKU name.
systemData	Metadata pertaining to creation and last modification of the resource.
WnsCredential	Description of a NotificationHub WnsCredential.
WnsCredentialProperties	Description of a NotificationHub WnsCredential.
XiaomiCredential	Description of a NotificationHub XiaomiCredential.
XiaomiCredentialProperties	Description of a NotificationHub XiaomiCredentialProperties.
ZoneRedundancyPreference	Namespace SKU name.

AccessRights

Defines values for AccessRights.

Name	Type	Description
Listen	string
Manage	string
Send	string

AdmCredential

Description of a NotificationHub AdmCredential.

Name	Type	Description
properties	AdmCredentialProperties	Description of a NotificationHub AdmCredential.

AdmCredentialProperties

Description of a NotificationHub AdmCredential.

Name	Type	Description
authTokenUrl	string	Gets or sets the URL of the authorization token.
clientId	string	Gets or sets the client identifier.
clientSecret	string	Gets or sets the credential secret access key.

ApnsCredential

Description of a NotificationHub ApnsCredential.

Name	Type	Description
properties	ApnsCredentialProperties	Description of a NotificationHub ApnsCredential.

ApnsCredentialProperties

Description of a NotificationHub ApnsCredential.

Name	Type	Description
apnsCertificate	string	Gets or sets the APNS certificate.
appId	string	Gets or sets the issuer (iss) registered claim key, whose value is your 10-character Team ID, obtained from your developer account
appName	string	Gets or sets the name of the application
certificateKey	string	Gets or sets the certificate key.
endpoint	string	Gets or sets the endpoint of this credential.
keyId	string	Gets or sets a 10-character key identifier (kid) key, obtained from your developer account
thumbprint	string	Gets or sets the APNS certificate Thumbprint
token	string	Gets or sets provider Authentication Token, obtained through your developer account

BaiduCredential

Description of a NotificationHub BaiduCredential.

Name	Type	Description
properties	BaiduCredentialProperties	Description of a NotificationHub BaiduCredential.

BaiduCredentialProperties

Description of a NotificationHub BaiduCredential.

Name	Type	Description
baiduApiKey	string	Gets or sets baidu Api Key.
baiduEndPoint	string	Gets or sets baidu Endpoint.
baiduSecretKey	string	Gets or sets baidu Secret Key

BrowserCredential

Description of a NotificationHub BrowserCredential.

Name	Type	Description
properties	BrowserCredentialProperties	Description of a NotificationHub BrowserCredential.

BrowserCredentialProperties

Description of a NotificationHub BrowserCredential.

Name	Type	Description
subject	string	Gets or sets web push subject.
vapidPrivateKey	string	Gets or sets VAPID private key.
vapidPublicKey	string	Gets or sets VAPID public key.

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Error response

Name	Type	Description
error	ErrorDetail	The error object.

GcmCredential

Description of a NotificationHub GcmCredential.

Name	Type	Description
properties	GcmCredentialProperties	Description of a NotificationHub GcmCredential.

GcmCredentialProperties

Description of a NotificationHub GcmCredential.

Name	Type	Description
gcmEndpoint	string	Gets or sets the GCM endpoint.
googleApiKey	string	Gets or sets the Google API key.

IpRule

A network authorization rule that filters traffic based on IP address.

Name	Type	Description
ipMask	string	IP mask.
rights	AccessRights[]	List of access rights.

MpnsCredential

Description of a NotificationHub MpnsCredential.

Name	Type	Description
properties	MpnsCredentialProperties	Description of a NotificationHub MpnsCredential.

MpnsCredentialProperties

Description of a NotificationHub MpnsCredential.

Name	Type	Description
certificateKey	string	Gets or sets the certificate key for this credential.
mpnsCertificate	string	Gets or sets the MPNS certificate.
thumbprint	string	Gets or sets the MPNS certificate Thumbprint

NamespaceListResult

The response of the List Namespace operation.

Name	Type	Description
nextLink	string	Gets or sets link to the next set of results.
value	NamespaceResource[]	Gets or sets result of the List AuthorizationRules operation.

NamespaceProperties

Represents namespace properties.

Name	Type	Default Value	Description
createdAt	string		Time when the namespace was created.
critical	boolean		Gets or sets whether or not the namespace is set as Critical.
dataCenter	string		Deprecated.
enabled	boolean		Gets or sets whether or not the namespace is currently enabled.
metricId	string		Azure Insights Metrics id.
name	string		Name of the Notification Hubs namespace. This is immutable property, set automatically by the service when the namespace is created.
namespaceType	NamespaceType		Defines values for NamespaceType.
networkAcls	NetworkAcls		A collection of network authorization rules.
pnsCredentials	PnsCredentials		Collection of Notification Hub or Notification Hub Namespace PNS credentials.
privateEndpointConnections	PrivateEndpointConnectionResource[]		Private Endpoint Connections for namespace
provisioningState	OperationProvisioningState		Defines values for OperationProvisioningState.
publicNetworkAccess	PublicNetworkAccess	Enabled	Type of public network access.
region	string		Region. The value is always set to the same value as Namespace.Location, so we are deprecating this property.
replicationRegion	ReplicationRegion		Allowed replication region
scaleUnit	string		Gets or sets scaleUnit where the namespace gets created
serviceBusEndpoint	string		Gets or sets endpoint you can use to perform NotificationHub operations.
status	NamespaceStatus		Namespace status.
subscriptionId	string		Namespace subscription id.
updatedAt	string		Time when the namespace was updated.
zoneRedundancy	ZoneRedundancyPreference	Disabled	Namespace SKU name.

NamespaceResource

Notification Hubs Namespace Resource.

Name	Type	Description
id	string	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	The geo-location where the resource lives
name	string	The name of the resource
properties	NamespaceProperties	Represents namespace properties.
sku	Sku	The Sku description for a namespace
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
tags	object	Resource tags.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

NamespaceStatus

Namespace status.

Name	Type	Description
Created	string
Creating	string
Deleting	string
Suspended	string

NamespaceType

Defines values for NamespaceType.

Name	Type	Description
Messaging	string
NotificationHub	string

NetworkAcls

A collection of network authorization rules.

Name	Type	Description
ipRules	IpRule[]	List of IP rules.
publicNetworkRule	PublicInternetAuthorizationRule	A default (public Internet) network authorization rule, which contains rights if no other network rule matches.

OperationProvisioningState

Defines values for OperationProvisioningState.

Name	Type	Description
Canceled	string
Disabled	string
Failed	string
InProgress	string
Pending	string
Succeeded	string
Unknown	string

PnsCredentials

Collection of Notification Hub or Notification Hub Namespace PNS credentials.

Name	Type	Description
admCredential	AdmCredential	Description of a NotificationHub AdmCredential.
apnsCredential	ApnsCredential	Description of a NotificationHub ApnsCredential.
baiduCredential	BaiduCredential	Description of a NotificationHub BaiduCredential.
browserCredential	BrowserCredential	Description of a NotificationHub BrowserCredential.
gcmCredential	GcmCredential	Description of a NotificationHub GcmCredential.
mpnsCredential	MpnsCredential	Description of a NotificationHub MpnsCredential.
wnsCredential	WnsCredential	Description of a NotificationHub WnsCredential.
xiaomiCredential	XiaomiCredential	Description of a NotificationHub XiaomiCredential.

PrivateEndpointConnectionProperties

Private Endpoint Connection properties.

Name	Type	Description
groupIds	string[]	List of group ids. For Notification Hubs, it always contains a single "namespace" element.
privateEndpoint	RemotePrivateEndpointConnection	Represents a Private Endpoint that is connected to Notification Hubs namespace using Private Endpoint Connection.
privateLinkServiceConnectionState	RemotePrivateLinkServiceConnectionState	State of the Private Link Service connection.
provisioningState	PrivateEndpointConnectionProvisioningState	State of Private Endpoint Connection.

PrivateEndpointConnectionProvisioningState

State of Private Endpoint Connection.

Name	Type	Description
Creating	string
Deleted	string
Deleting	string
DeletingByProxy	string
Succeeded	string
Unknown	string
Updating	string
UpdatingByProxy	string

PrivateEndpointConnectionResource

Represents a Private Endpoint Connection ARM resource - a sub-resource of Notification Hubs namespace.

Name	Type	Description
id	string	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties	PrivateEndpointConnectionProperties	Private Endpoint Connection properties.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

PrivateLinkConnectionStatus

State of Private Link Connection.

Name	Type	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

PublicInternetAuthorizationRule

A default (public Internet) network authorization rule, which contains rights if no other network rule matches.

Name	Type	Description
rights	AccessRights[]	List of access rights.

PublicNetworkAccess

Type of public network access.

Name	Type	Description
Disabled	string
Enabled	string

RemotePrivateEndpointConnection

Represents a Private Endpoint that is connected to Notification Hubs namespace using Private Endpoint Connection.

Name	Type	Description
id	string	ARM resource ID of the Private Endpoint. This may belong to different subscription and resource group than a Notification Hubs namespace.

RemotePrivateLinkServiceConnectionState

State of the Private Link Service connection.

Name	Type	Description
actionsRequired	string	Human-friendly description of required actions.
description	string	Human-friendly description.
status	PrivateLinkConnectionStatus	State of Private Link Connection.

ReplicationRegion

Allowed replication region

Name	Type	Description
AustraliaEast	string
BrazilSouth	string
Default	string
None	string
NorthEurope	string
SouthAfricaNorth	string
SouthEastAsia	string
WestUs2	string

Sku

The Sku description for a namespace

Name	Type	Description
capacity	integer	Gets or sets the capacity of the resource
family	string	Gets or sets the Sku Family
name	SkuName	Namespace SKU name.
size	string	Gets or sets the Sku size
tier	string	Gets or sets the tier of particular sku

SkuName

Namespace SKU name.

Name	Type	Description
Basic	string
Free	string
Standard	string

systemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

WnsCredential

Description of a NotificationHub WnsCredential.

Name	Type	Description
properties	WnsCredentialProperties	Description of a NotificationHub WnsCredential.

WnsCredentialProperties

Description of a NotificationHub WnsCredential.

Name	Type	Description
certificateKey	string	Ges or sets the WNS Certificate Key.
packageSid	string	Gets or sets the package ID for this credential.
secretKey	string	Gets or sets the secret key.
windowsLiveEndpoint	string	Gets or sets the Windows Live endpoint.
wnsCertificate	string	Gets or sets the WNS Certificate.

XiaomiCredential

Description of a NotificationHub XiaomiCredential.

Name	Type	Description
properties	XiaomiCredentialProperties	Description of a NotificationHub XiaomiCredentialProperties.

XiaomiCredentialProperties

Description of a NotificationHub XiaomiCredentialProperties.

Name	Type	Description
appSecret	string	Gets or sets app secret.
endpoint	string	Gets or sets xiaomi service endpoint.

ZoneRedundancyPreference

Namespace SKU name.

Name	Type	Description
Disabled	string
Enabled	string