Microsoft.DeviceRegistry 命名空間

Bicep 資源定義

命名空間資源類型可以使用以下目標作業進行部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

要建立 Microsoft.DeviceRegistry/命名空間資源,請將以下 Bicep 加入範本。

resource symbolicname 'Microsoft.DeviceRegistry/namespaces@2026-11-02-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    management: {
      endpoints: {
        {customized property}: {
          address: 'string'
          endpointType: 'string'
          resourceId: 'string'
          scopeId: 'string'
        }
      }
    }
    messaging: {
      endpoints: {
        {customized property}: {
          address: 'string'
          endpointType: 'string'
          inboundCallerIdentity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          provisioning: {
            allocationWeight: int
            availability: 'string'
          }
          resourceId: 'string'
        }
      }
    }
    observability: {
      enabled: bool
      endpoints: {
        {customized property}: {
          address: 'string'
          endpointType: 'string'
          resourceId: 'string'
          scopeId: 'string'
        }
      }
    }
    outboundIdentity: {
      type: 'string'
      userAssignedIdentity: 'string'
    }
    provisioning: {
      endpoints: {
        {customized property}: {
          endpointType: 'string'
          inboundCallerIdentity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          resourceId: 'string'
        }
      }
    }
    updating: {
      endpoints: {
        {customized property}: {
          endpointType: 'string'
          inboundCallerIdentity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          resourceId: 'string'
        }
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

屬性值

Microsoft.DeviceRegistry/命名空間

名稱 Description 價值觀
身分識別 指派給此資源的受控服務識別。 ManagedServiceIdentity
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 string

約束:
最小長度 = 3
最大長度 = 64
模式 = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (必要)
properties 此資源的資源特定屬性。 命名空間屬性
tags 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

InboundCallerIdentity

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ManagedServiceIdentity

名稱 Description 價值觀
型別 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 “無”
“系統分配”
'SystemAssigned,UserAssigned'
“UserAssigned”(必需)
userAssignedIdentities 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 UserAssignedIdentities

Management

名稱 Description 價值觀
端點 《管理端點詞典》。 管理端點

管理端點

名稱 Description 價值觀
address 要連線的端點位址。 字串 (必要)
endpointType 管理端點所使用的連線類型。 字串 (必要)
resourceId 訊息端點 Azure 資源 ID. 字串 (必要)
scopeId 管理端點的範圍 ID。 字串 (必要)

管理端點

名稱 Description 價值觀

Messaging

名稱 Description 價值觀
端點 傳訊端點字典。 傳訊端點

傳訊端點

名稱 Description 價值觀
address 要連線的端點位址。 字串
endpointType 用於傳訊端點的連線類型。 字串
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity
佈建 這個訊息端點的配置配置。 訊息端點配置
resourceId 訊息端點 Azure 資源 ID. 字串

訊息端點配置

名稱 Description 價值觀
allocationWeight 此訊息端點的分配權重。 整數 (int)
可用性 訊息端點的可用性狀態。 'Available'
“已禁用”

傳訊端點

名稱 Description 價值觀

命名空間可觀察性

名稱 Description 價值觀
已啟用 是否啟用了可觀察性功能。 當在建立或過程中省略時
替換,有效值為假。 在 PATCH 中,省略會保留
現行價值。 將此屬性設為 false 會阻止新的即時資料
會話,同時保留已設定端點。
布爾 (bool)
端點 事件網格 MQTT 端點以自訂位置資源 ID 鍵結。 關鍵是
一個 AIO 站點的完整 Azure 自訂位置 ARM 資源 ID。
在 PATCH 中,省略會保留現有的端點映射。 供應這個
屬性取代了完整的端點映射。
NamespaceObservabilityEndpoints

NamespaceObservabilityEndpoints

名稱 Description 價值觀

命名空間屬性

名稱 Description 價值觀
管理 指派與未指派管理端點。 管理
傳訊 已指派和未指派的傳訊端點。 訊息傳遞
可檢視性 與此命名空間相關的可觀察性配置。
在建立或替換時,此屬性會取代完整的可觀察性
配置。 省略它會移除任何現有的設定。 在PATCH上,
省略此項則保留現有配置。
命名空間可觀察性
出站身份 用於來自 ADR 命名空間的外撥通話的身份。 若未指定且命名空間啟用系統指派身份,則預設使用系統指派身份。 出站身份
佈建 與此命名空間相關的配置端點。 命名空間配置
更新 裝置會更新與此命名空間相關的端點。 Namespace更新

命名空間配置

名稱 Description 價值觀
端點 《配置端點字典》。 命名空間配置端點

命名空間配置端點

名稱 Description 價值觀

Namespace更新

名稱 Description 價值觀
端點 裝置更新端點字典。 NamespaceUpdatingEndpoints

NamespaceUpdatingEndpoints

名稱 Description 價值觀

可觀察性端點

名稱 Description 價值觀
address 事件網格命名空間的 MQTT 主機名稱。 字串 (必要)
endpointType Azure 資源類型是可觀察性端點。 「Microsoft.事件格網/命名空間」(必填)
resourceId 事件網格命名空間的完整 Azure 資源 ID。 字串 (必要)
scopeId Azure IoT 操作 實例範圍 ID 用於 MQTT 認證及即時資料主題建構。 字串 (必要)

出站身份

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ProvisioningEndpoint

名稱 Description 價值觀
endpointType 配置資源的類型。 「Microsoft。裝置/provisioningServices」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId The provisioning endpoint Azure resource Id. 字串 (必要)

TrackedResourceTags

名稱 Description 價值觀

更新終端

名稱 Description 價值觀
endpointType 裝置更新資源的類型。 「Microsoft。DeviceUpdate/updateInstances」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId 裝置更新端點 Azure 資源 ID. 字串 (必要)

UserAssignedIdentities

名稱 Description 價值觀

UserAssignedIdentity

名稱 Description 價值觀

ARM 樣本資源定義

命名空間資源類型可以使用以下目標作業進行部署:

使用範例

資源格式

若要建立 Microsoft.DeviceRegistry/命名空間資源,請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.DeviceRegistry/namespaces",
  "apiVersion": "2026-11-02-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "management": {
      "endpoints": {
        "{customized property}": {
          "address": "string",
          "endpointType": "string",
          "resourceId": "string",
          "scopeId": "string"
        }
      }
    },
    "messaging": {
      "endpoints": {
        "{customized property}": {
          "address": "string",
          "endpointType": "string",
          "inboundCallerIdentity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "provisioning": {
            "allocationWeight": "int",
            "availability": "string"
          },
          "resourceId": "string"
        }
      }
    },
    "observability": {
      "enabled": "bool",
      "endpoints": {
        "{customized property}": {
          "address": "string",
          "endpointType": "string",
          "resourceId": "string",
          "scopeId": "string"
        }
      }
    },
    "outboundIdentity": {
      "type": "string",
      "userAssignedIdentity": "string"
    },
    "provisioning": {
      "endpoints": {
        "{customized property}": {
          "endpointType": "string",
          "inboundCallerIdentity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "resourceId": "string"
        }
      }
    },
    "updating": {
      "endpoints": {
        "{customized property}": {
          "endpointType": "string",
          "inboundCallerIdentity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "resourceId": "string"
        }
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

屬性值

Microsoft.DeviceRegistry/命名空間

名稱 Description 價值觀
apiVersion API 版本 『2026-11-02-預覽』
身分識別 指派給此資源的受控服務識別。 ManagedServiceIdentity
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 string

約束:
最小長度 = 3
最大長度 = 64
模式 = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (必要)
properties 此資源的資源特定屬性。 命名空間屬性
tags 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
型別 資源類型 'Microsoft.DeviceRegistry/命名空間'

InboundCallerIdentity

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ManagedServiceIdentity

名稱 Description 價值觀
型別 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 “無”
“系統分配”
'SystemAssigned,UserAssigned'
“UserAssigned”(必需)
userAssignedIdentities 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 UserAssignedIdentities

Management

名稱 Description 價值觀
端點 《管理端點詞典》。 管理端點

管理端點

名稱 Description 價值觀
address 要連線的端點位址。 字串 (必要)
endpointType 管理端點所使用的連線類型。 字串 (必要)
resourceId 訊息端點 Azure 資源 ID. 字串 (必要)
scopeId 管理端點的範圍 ID。 字串 (必要)

管理端點

名稱 Description 價值觀

Messaging

名稱 Description 價值觀
端點 傳訊端點字典。 傳訊端點

傳訊端點

名稱 Description 價值觀
address 要連線的端點位址。 字串
endpointType 用於傳訊端點的連線類型。 字串
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity
佈建 這個訊息端點的配置配置。 訊息端點配置
resourceId 訊息端點 Azure 資源 ID. 字串

訊息端點配置

名稱 Description 價值觀
allocationWeight 此訊息端點的分配權重。 整數 (int)
可用性 訊息端點的可用性狀態。 'Available'
“已禁用”

傳訊端點

名稱 Description 價值觀

命名空間可觀察性

名稱 Description 價值觀
已啟用 是否啟用了可觀察性功能。 當在建立或過程中省略時
替換,有效值為假。 在 PATCH 中,省略會保留
現行價值。 將此屬性設為 false 會阻止新的即時資料
會話,同時保留已設定端點。
布爾 (bool)
端點 事件網格 MQTT 端點以自訂位置資源 ID 鍵結。 關鍵是
一個 AIO 站點的完整 Azure 自訂位置 ARM 資源 ID。
在 PATCH 中,省略會保留現有的端點映射。 供應這個
屬性取代了完整的端點映射。
NamespaceObservabilityEndpoints

NamespaceObservabilityEndpoints

名稱 Description 價值觀

命名空間屬性

名稱 Description 價值觀
管理 指派與未指派管理端點。 管理
傳訊 已指派和未指派的傳訊端點。 訊息傳遞
可檢視性 與此命名空間相關的可觀察性配置。
在建立或替換時,此屬性會取代完整的可觀察性
配置。 省略它會移除任何現有的設定。 在PATCH上,
省略此項則保留現有配置。
命名空間可觀察性
出站身份 用於來自 ADR 命名空間的外撥通話的身份。 若未指定且命名空間啟用系統指派身份,則預設使用系統指派身份。 出站身份
佈建 與此命名空間相關的配置端點。 命名空間配置
更新 裝置會更新與此命名空間相關的端點。 Namespace更新

命名空間配置

名稱 Description 價值觀
端點 《配置端點字典》。 命名空間配置端點

命名空間配置端點

名稱 Description 價值觀

Namespace更新

名稱 Description 價值觀
端點 裝置更新端點字典。 NamespaceUpdatingEndpoints

NamespaceUpdatingEndpoints

名稱 Description 價值觀

可觀察性端點

名稱 Description 價值觀
address 事件網格命名空間的 MQTT 主機名稱。 字串 (必要)
endpointType Azure 資源類型是可觀察性端點。 「Microsoft.事件格網/命名空間」(必填)
resourceId 事件網格命名空間的完整 Azure 資源 ID。 字串 (必要)
scopeId Azure IoT 操作 實例範圍 ID 用於 MQTT 認證及即時資料主題建構。 字串 (必要)

出站身份

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ProvisioningEndpoint

名稱 Description 價值觀
endpointType 配置資源的類型。 「Microsoft。裝置/provisioningServices」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId The provisioning endpoint Azure resource Id. 字串 (必要)

TrackedResourceTags

名稱 Description 價值觀

更新終端

名稱 Description 價值觀
endpointType 裝置更新資源的類型。 「Microsoft。DeviceUpdate/updateInstances」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId 裝置更新端點 Azure 資源 ID. 字串 (必要)

UserAssignedIdentities

名稱 Description 價值觀

UserAssignedIdentity

名稱 Description 價值觀

Terraform (AzAPI 提供者) 資源定義

命名空間資源類型可以使用以下目標作業進行部署:

  • 資源團體 關於每個 API 版本變更屬性的清單,請參見 變更日誌。

資源格式

若要建立 Microsoft.DeviceRegistry/命名空間資源,請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DeviceRegistry/namespaces@2026-11-02-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      management = {
        endpoints = {
          {customized property} = {
            address = "string"
            endpointType = "string"
            resourceId = "string"
            scopeId = "string"
          }
        }
      }
      messaging = {
        endpoints = {
          {customized property} = {
            address = "string"
            endpointType = "string"
            inboundCallerIdentity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            provisioning = {
              allocationWeight = int
              availability = "string"
            }
            resourceId = "string"
          }
        }
      }
      observability = {
        enabled = bool
        endpoints = {
          {customized property} = {
            address = "string"
            endpointType = "string"
            resourceId = "string"
            scopeId = "string"
          }
        }
      }
      outboundIdentity = {
        type = "string"
        userAssignedIdentity = "string"
      }
      provisioning = {
        endpoints = {
          {customized property} = {
            endpointType = "string"
            inboundCallerIdentity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            resourceId = "string"
          }
        }
      }
      updating = {
        endpoints = {
          {customized property} = {
            endpointType = "string"
            inboundCallerIdentity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            resourceId = "string"
          }
        }
      }
    }
  }
}

屬性值

Microsoft.DeviceRegistry/命名空間

名稱 Description 價值觀
身分識別 指派給此資源的受控服務識別。 ManagedServiceIdentity
位置 資源所在的地理位置 字串 (必要)
名稱 資源名稱 string

約束:
最小長度 = 3
最大長度 = 64
模式 = ^[a-z0-9][a-z0-9-]*[a-z0-9]$ (必要)
properties 此資源的資源特定屬性。 命名空間屬性
tags 資源標籤 標記名稱和值的字典。
型別 資源類型 「Microsoft。裝置登錄/namespaces@2026-11-02-預覽」

InboundCallerIdentity

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ManagedServiceIdentity

名稱 Description 價值觀
型別 受控服務識別的類型(允許 SystemAssigned 和 UserAssigned 類型)。 “無”
“系統分配”
'SystemAssigned,UserAssigned'
“UserAssigned”(必需)
userAssignedIdentities 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中的空白物件({})。 UserAssignedIdentities

Management

名稱 Description 價值觀
端點 《管理端點詞典》。 管理端點

管理端點

名稱 Description 價值觀
address 要連線的端點位址。 字串 (必要)
endpointType 管理端點所使用的連線類型。 字串 (必要)
resourceId 訊息端點 Azure 資源 ID. 字串 (必要)
scopeId 管理端點的範圍 ID。 字串 (必要)

管理端點

名稱 Description 價值觀

Messaging

名稱 Description 價值觀
端點 傳訊端點字典。 傳訊端點

傳訊端點

名稱 Description 價值觀
address 要連線的端點位址。 字串
endpointType 用於傳訊端點的連線類型。 字串
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity
佈建 這個訊息端點的配置配置。 訊息端點配置
resourceId 訊息端點 Azure 資源 ID. 字串

訊息端點配置

名稱 Description 價值觀
allocationWeight 此訊息端點的分配權重。 整數 (int)
可用性 訊息端點的可用性狀態。 'Available'
“已禁用”

傳訊端點

名稱 Description 價值觀

命名空間可觀察性

名稱 Description 價值觀
已啟用 是否啟用了可觀察性功能。 當在建立或過程中省略時
替換,有效值為假。 在 PATCH 中,省略會保留
現行價值。 將此屬性設為 false 會阻止新的即時資料
會話,同時保留已設定端點。
布爾 (bool)
端點 事件網格 MQTT 端點以自訂位置資源 ID 鍵結。 關鍵是
一個 AIO 站點的完整 Azure 自訂位置 ARM 資源 ID。
在 PATCH 中,省略會保留現有的端點映射。 供應這個
屬性取代了完整的端點映射。
NamespaceObservabilityEndpoints

NamespaceObservabilityEndpoints

名稱 Description 價值觀

命名空間屬性

名稱 Description 價值觀
管理 指派與未指派管理端點。 管理
傳訊 已指派和未指派的傳訊端點。 訊息傳遞
可檢視性 與此命名空間相關的可觀察性配置。
在建立或替換時,此屬性會取代完整的可觀察性
配置。 省略它會移除任何現有的設定。 在PATCH上,
省略此項則保留現有配置。
命名空間可觀察性
出站身份 用於來自 ADR 命名空間的外撥通話的身份。 若未指定且命名空間啟用系統指派身份,則預設使用系統指派身份。 出站身份
佈建 與此命名空間相關的配置端點。 命名空間配置
更新 裝置會更新與此命名空間相關的端點。 Namespace更新

命名空間配置

名稱 Description 價值觀
端點 《配置端點字典》。 命名空間配置端點

命名空間配置端點

名稱 Description 價值觀

Namespace更新

名稱 Description 價值觀
端點 裝置更新端點字典。 NamespaceUpdatingEndpoints

NamespaceUpdatingEndpoints

名稱 Description 價值觀

可觀察性端點

名稱 Description 價值觀
address 事件網格命名空間的 MQTT 主機名稱。 字串 (必要)
endpointType Azure 資源類型是可觀察性端點。 「Microsoft.事件格網/命名空間」(必填)
resourceId 事件網格命名空間的完整 Azure 資源 ID。 字串 (必要)
scopeId Azure IoT 操作 實例範圍 ID 用於 MQTT 認證及即時資料主題建構。 字串 (必要)

出站身份

名稱 Description 價值觀
型別 識別類型。 “系統分配”
“UserAssigned”(必需)
userAssignedIdentity 使用者指派的受控識別的資源識別碼。 當類型為 UserAssigned 時,必須使用。 字串

ProvisioningEndpoint

名稱 Description 價值觀
endpointType 配置資源的類型。 「Microsoft。裝置/provisioningServices」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId The provisioning endpoint Azure resource Id. 字串 (必要)

TrackedResourceTags

名稱 Description 價值觀

更新終端

名稱 Description 價值觀
endpointType 裝置更新資源的類型。 「Microsoft。DeviceUpdate/updateInstances」(必填)
inboundCallerIdentity 連結資源用來呼叫 ADR 命名空間的身份。 InboundCallerIdentity (必填)
resourceId 裝置更新端點 Azure 資源 ID. 字串 (必要)

UserAssignedIdentities

名稱 Description 價值觀

UserAssignedIdentity

名稱 Description 價值觀