Namespaces - Update

Služba:
Device Registry
Verze rozhraní API:
2026-04-01

Aktualizace oboru názvů

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
namespaceName
 path True

string

minLength: 3
maxLength: 64
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$

Název oboru názvů.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId
 path True

string (uuid)

ID cílového předplatného. Hodnota musí být UUID.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
identity

SystemAssignedServiceIdentity

Identity spravované služby přiřazené k tomuto prostředku.
properties.management

Management

Přiřazené a nepřiřazené řídicí koncové body.
properties.messaging

Messaging

Přiřazené a nepřiřazené koncové body zasílání zpráv.
tags

object

Značky prostředků

Odpovědi

Name Typ Description
200 OK

Namespace

Operace Azure byla úspěšně dokončena.
202 Accepted

Žádost o aktualizaci prostředků byla přijata.

Hlavičky

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

Update_Namespace_Endpoints
Update_Namespace_ManagementEndpoints

Update_Namespace_Endpoints

Ukázkový požadavek

PATCH 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

{
  "properties": {
    "messaging": {
      "endpoints": {
        "eventGridEndpoint": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic.westeurope-1.eventgrid.azure.net/api/events"
        }
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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": {
    "uuid": "cbfe124a-6971-4c90-a7a9-99be82def1ab",
    "provisioningState": "Succeeded",
    "messaging": {
      "endpoints": {
        "eventGridEndpoint1": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic1.westeurope-1.eventgrid.azure.net/api/events"
        },
        "eventGridEndpoint2": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic2.westeurope-1.eventgrid.azure.net/api/events"
        },
        "eventGridEndpoint3": {
          "endpointType": "Microsoft.Devices/IoTHubs",
          "address": "https://myeventgridtopic3.westeurope-1.eventgrid.azure.net/api/events"
        }
      }
    }
  }
}
Stavový kód:
202 
Location: https://contoso.com/operationstatus
azure-AsyncOperation: http://azure.async.operation/status

Update_Namespace_ManagementEndpoints

Ukázkový požadavek

PATCH 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

{
  "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"
        }
      }
    }
  }
}

Ukázková odpověď

Stavový kód:
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": {
    "uuid": "cbfe124a-6971-4c90-a7a9-99be82def1ab",
    "provisioningState": "Succeeded",
    "messaging": {
      "endpoints": {
        "iothubEndpoint1": {
          "endpointType": "Microsoft.Devices/IotHubs",
          "address": "https://iothub-for-dps.azure-devices.net/api/events"
        },
        "iothubEndpoint2": {
          "endpointType": "Microsoft.Devices/IotHubs",
          "address": "https://iothub-for-dps-2.azure-devices.net"
        },
        "iothubEndpoint3": {
          "endpointType": "Microsoft.Devices/IotHubs",
          "address": "https://iothub-for-dps-3.azure-devices.net"
        }
      }
    },
    "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"
        }
      }
    }
  }
}
Stavový kód:
202 
Location: https://contoso.com/operationstatus

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Chybová odpověď
Management

Model endpointů správy jmenného prostoru.
ManagementEndpoint

Model endpointu správy jmenného prostoru používaný službou k připojení k zařízení.
Messaging

Model koncových bodů zasílání zpráv v oboru názvů.
MessagingEndpoint

Model koncového bodu zasílání zpráv v oboru názvů používaný zařízením pro připojení ke službě.
Namespace

Definice oboru názvů.
NamespaceUpdate

Typ používaný pro operace aktualizace oboru názvů.
ProvisioningState

Stav zřizování prostředku.
SystemAssignedServiceIdentity

Identita spravované služby (přiřazená systémem nebo žádná)
SystemAssignedServiceIdentityType

Typ identity spravované služby (přiřazený systémem nebo žádný).
systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby.
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva.
target

string

Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

Management

Objekt

Model endpointů správy jmenného prostoru.

Name Typ Description
endpoints

<string,  ManagementEndpoint>

Slovník správcovských endpointů.

ManagementEndpoint

Objekt

Model endpointu správy jmenného prostoru používaný službou k připojení k zařízení.

Name Typ Description
address

string

Adresa koncového bodu, ke kterému se chcete připojit.
endpointType

string

Typ připojení používaný pro správcovský endpoint.
resourceId

string

ID prostředku Azure koncového bodu zasílání zpráv.
scopeId

string

Scope ID pro správcovský endpoint.

Messaging

Objekt

Model koncových bodů zasílání zpráv v oboru názvů.

Name Typ Description
endpoints

<string,  MessagingEndpoint>

Slovník koncových bodů zasílání zpráv.

MessagingEndpoint

Objekt

Model koncového bodu zasílání zpráv v oboru názvů používaný zařízením pro připojení ke službě.

Name Typ Description
address

string

Adresa koncového bodu, ke kterému se chcete připojit.
endpointType

string

Typ připojení použitého pro koncový bod zasílání zpráv.
resourceId

string

ID prostředku Azure koncového bodu zasílání zpráv.

Namespace

Objekt

Definice oboru názvů.

Name Typ Description
id

string (arm-id)

Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity

SystemAssignedServiceIdentity

Identity spravované služby přiřazené k tomuto prostředku.
location

string

Geografické umístění, ve kterém se nachází zdroj
name

string

Název prostředku
properties.management

Management

Přiřazené a nepřiřazené řídicí koncové body.
properties.messaging

Messaging

Přiřazené a nepřiřazené koncové body zasílání zpráv.
properties.provisioningState

ProvisioningState

Stav zřizování prostředku
properties.uuid

string

Globálně jedinečné, neměnné, opakovaně použitelné ID.
systemData

systemData

Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags

object

Značky prostředků
type

string

Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

NamespaceUpdate

Objekt

Typ používaný pro operace aktualizace oboru názvů.

Name Typ Description
identity

SystemAssignedServiceIdentity

Identity spravované služby přiřazené k tomuto prostředku.
properties.management

Management

Přiřazené a nepřiřazené řídicí koncové body.
properties.messaging

Messaging

Přiřazené a nepřiřazené koncové body zasílání zpráv.
tags

object

Značky prostředků

ProvisioningState

Výčet

Stav zřizování prostředku.

Hodnota Description
Succeeded

Zdroj byl vytvořen.
Failed

Vytvoření zdroje se nezdařilo.
Canceled

Vytváření zdrojů bylo zrušeno.
Accepted

Zdroj byl serverem přijat.
Deleting

Prostředek se odstraňuje.

SystemAssignedServiceIdentity

Objekt

Identita spravované služby (přiřazená systémem nebo žádná)

Name Typ Description
principalId

string (uuid)

ID instančního objektu identity přiřazené systémem. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
tenantId

string (uuid)

ID tenanta přiřazené identity systému. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
type

SystemAssignedServiceIdentityType

Typ identity spravované služby (přiřazený systémem nebo žádný).

SystemAssignedServiceIdentityType

Výčet

Typ identity spravované služby (přiřazený systémem nebo žádný).

Hodnota Description
None
SystemAssigned

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string (date-time)

Časové razítko vytvoření prostředku (UTC).
createdBy

string

Identita, která prostředek vytvořila.
createdByType

createdByType

Typ identity, která prostředek vytvořila.
lastModifiedAt

string (date-time)

Časové razítko poslední změny zdroje (UTC)
lastModifiedBy

string

Identita, která naposledy změnila prostředek.
lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.