Namespaces - Create Or Replace

Service:: Device Registry

API-versie:: 2026-04-01

Een naamruimte maken

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceRegistry/namespaces/{namespaceName}?api-version=2026-04-01

URI-parameters

Name	In	Vereist	Type	Description
namespaceName	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$	De naam van de naamruimte.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
identity		SystemAssignedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
properties.management		Management	Toegewezen en niet-toegewezen beheer-endpoints.
properties.messaging		Messaging	Toegewezen en niet-toegewezen berichteneindpunten.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Namespace	De updatebewerking van de resource 'Namespace' is geslaagd
201 Created	Namespace	Resource 'Namespace' create bewerking geslaagd Kopteksten Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Name

Type

Description

200 OK

Namespace

De updatebewerking van de resource 'Namespace' is geslaagd

201 Created

Namespace

Resource 'Namespace' create bewerking geslaagd

Kopteksten

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

CreateOrReplace_Namespace_With_Endpoints

CreateOrReplace_Namespace_With_ManagementEndpoints

CreateOrReplace_Namespace_With_Endpoints

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01?api-version=2026-04-01

{
  "location": "North Europe",
  "properties": {
    "messaging": {
      "endpoints": {
        "eventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic.westeurope-1.eventgrid.azure.net/api/events"
        },
        "anotherEventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic2.westeurope-1.eventgrid.azure.net/api/events"
        }
      }
    }
  },
  "identity": {
    "type": "SystemAssigned"
  }
}

Voorbeeldrespons

Statuscode:: 200

{
  "id": "/subscriptions/00000000-1366-430f-0000-cc873bcf2d27/resourceGroups/gbktestRG/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01",
  "name": "adr-namespace-gbk0925-n01",
  "type": "Microsoft.DeviceRegistry/namespaces",
  "location": "North Europe",
  "systemData": {
    "createdBy": "00003442-0000-0000-0000-494059220000",
    "createdByType": "Application",
    "createdAt": "2024-09-25T23:41:41.8591157Z",
    "lastModifiedBy": "00003442-0000-0000-0000-494059220000",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2024-10-01T21:03:33.5993192Z"
  },
  "identity": {
    "principalId": "00000000-0000-0000-9d20-8a5570c3eb6e",
    "tenantId": "0006f47a-0000-0000-0000-99be82dea000",
    "type": "SystemAssigned"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "messaging": {
      "endpoints": {
        "eventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic.westeurope-1.eventgrid.azure.net/api/events"
        },
        "anotherEventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic2.westeurope-1.eventgrid.azure.net/api/events"
        }
      }
    }
  }
}

Statuscode:: 201

{
  "id": "/subscriptions/00000000-1366-430f-0000-cc873bcf2d27/resourceGroups/gbktestRG/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01",
  "name": "adr-namespace-gbk0925-n01",
  "type": "Microsoft.DeviceRegistry/namespaces",
  "location": "North Europe",
  "systemData": {
    "createdBy": "00003442-0000-0000-0000-494059220000",
    "createdByType": "Application",
    "createdAt": "2024-09-25T23:41:41.8591157Z",
    "lastModifiedBy": "00003442-0000-0000-0000-494059220000",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2024-10-01T21:03:33.5993192Z"
  },
  "identity": {
    "principalId": "00000000-0000-0000-9d20-8a5570c3eb6e",
    "tenantId": "0006f47a-0000-0000-0000-99be82dea000",
    "type": "SystemAssigned"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "messaging": {
      "endpoints": {
        "eventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic.westeurope-1.eventgrid.azure.net/api/events"
        },
        "anotherEventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic2.westeurope-1.eventgrid.azure.net/api/events"
        }
      }
    }
  }
}

CreateOrReplace_Namespace_With_ManagementEndpoints

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01?api-version=2026-04-01

{
  "location": "North Europe",
  "properties": {
    "management": {
      "endpoints": {
        "customLocation1": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-1",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr"
        },
        "customLocation2": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr1.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-2",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr1"
        }
      }
    }
  }
}

Voorbeeldrespons

Statuscode:: 200

{
  "id": "/subscriptions/00000000-1366-430f-0000-cc873bcf2d27/resourceGroups/gbktestRG/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01",
  "name": "adr-namespace-gbk0925-n01",
  "type": "Microsoft.DeviceRegistry/namespaces",
  "location": "North Europe",
  "systemData": {
    "createdBy": "00003442-0000-0000-0000-494059220000",
    "createdByType": "Application",
    "createdAt": "2024-09-25T23:41:41.8591157Z",
    "lastModifiedBy": "00003442-0000-0000-0000-494059220000",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2024-10-01T21:03:33.5993192Z"
  },
  "identity": {
    "principalId": "00000000-0000-0000-9d20-8a5570c3eb6e",
    "tenantId": "0006f47a-0000-0000-0000-99be82dea000",
    "type": "SystemAssigned"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "management": {
      "endpoints": {
        "customLocation1": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-1",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr"
        },
        "customLocation2": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr1.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-2",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr1"
        }
      }
    }
  }
}

Statuscode:: 201

{
  "id": "/subscriptions/00000000-1366-430f-0000-cc873bcf2d27/resourceGroups/gbktestRG/providers/Microsoft.DeviceRegistry/namespaces/adr-namespace-gbk0925-n01",
  "name": "adr-namespace-gbk0925-n01",
  "type": "Microsoft.DeviceRegistry/namespaces",
  "location": "North Europe",
  "systemData": {
    "createdBy": "00003442-0000-0000-0000-494059220000",
    "createdByType": "Application",
    "createdAt": "2024-09-25T23:41:41.8591157Z",
    "lastModifiedBy": "00003442-0000-0000-0000-494059220000",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2024-10-01T21:03:33.5993192Z"
  },
  "identity": {
    "principalId": "00000000-0000-0000-9d20-8a5570c3eb6e",
    "tenantId": "0006f47a-0000-0000-0000-99be82dea000",
    "type": "SystemAssigned"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "management": {
      "endpoints": {
        "customLocation1": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-1",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr"
        },
        "customLocation2": {
          "endpointType": "Microsoft.EventGrid/Namespaces",
          "address": "eg-for-adr1.eastus2-1.ts.eventgrid.azure.net",
          "scopeId": "scope-id-for-management-endpoint-2",
          "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.EventGrid/Namespaces/eg-for-adr1"
        }
      }
    }
  }
}

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
Management	Het model van namespace-beheer-endpoints.
ManagementEndpoint	Namespace-beheer-endpointmodel dat door de service wordt gebruikt om verbinding te maken met het apparaat.
Messaging	Het model voor berichteneindpunten in de naamruimte.
MessagingEndpoint	Naamruimte-eindpuntmodel voor berichtenverkeer dat door een apparaat wordt gebruikt om verbinding te maken met een service.
Namespace	Definitie van naamruimte.
ProvisioningState	De inrichtingsstatus van de resource.
SystemAssignedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen of geen)
SystemAssignedServiceIdentityType	Type beheerde service-identiteit (door het systeem toegewezen of geen).
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Management

Object

Het model van namespace-beheer-endpoints.

Name	Type	Description
endpoints	<string, ManagementEndpoint>	Woordenboek van beheer-eindpunten.

ManagementEndpoint

Object

Namespace-beheer-endpointmodel dat door de service wordt gebruikt om verbinding te maken met het apparaat.

Name	Type	Description
address	string	Het eindpuntadres waarmee verbinding moet worden gemaakt.
endpointType	string	Type verbinding gebruikt voor het beheer-eindpunt.
resourceId	string	De Azure-resource-id van het berichteneindpunt.
scopeId	string	De scope ID voor het beheer-endpoint.

Messaging

Object

Het model voor berichteneindpunten in de naamruimte.

Name	Type	Description
endpoints	<string, MessagingEndpoint>	Woordenboek van eindpunten voor berichten.

MessagingEndpoint

Object

Naamruimte-eindpuntmodel voor berichtenverkeer dat door een apparaat wordt gebruikt om verbinding te maken met een service.

Name	Type	Description
address	string	Het eindpuntadres waarmee verbinding moet worden gemaakt.
endpointType	string	Type verbinding dat wordt gebruikt voor het eindpunt voor berichten.
resourceId	string	De Azure-resource-id van het berichteneindpunt.

Namespace

Object

Definitie van naamruimte.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijv. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	SystemAssignedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.management	Management	Toegewezen en niet-toegewezen beheer-endpoints.
properties.messaging	Messaging	Toegewezen en niet-toegewezen berichteneindpunten.
properties.provisioningState	ProvisioningState	Inrichtingsstatus van de resource.
properties.uuid	string	Wereldwijd unieke, onveranderlijke, niet-herbruikbare ID.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ProvisioningState

Opsomming

De inrichtingsstatus van de resource.

Waarde	Description
Succeeded	Er is een bron gemaakt.
Failed	Het maken van bronnen is mislukt.
Canceled	Het maken van grondstoffen is geannuleerd.
Accepted	De bron is geaccepteerd door de server.
Deleting	Resource is aan het verwijderen.

SystemAssignedServiceIdentity

Object

Beheerde service-identiteit (door het systeem toegewezen of geen)

Name	Type	Description
principalId	string (uuid)	De service-principal-id van de aan het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId	string (uuid)	De tenant-id van de aan het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type	SystemAssignedServiceIdentityType	Type beheerde service-identiteit (door het systeem toegewezen of geen).

SystemAssignedServiceIdentityType

Opsomming

Type beheerde service-identiteit (door het systeem toegewezen of geen).

Waarde	Description
None
SystemAssigned

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.