Iot Dps Resource - Create Or Update

Utwórz lub zaktualizuj metadane usługi aprowizacji. Typowym wzorcem modyfikowania właściwości jest pobranie metadanych usługi aprowizacji i metadanych zabezpieczeń, a następnie połączenie ich ze zmodyfikowanymi wartościami w nowej treści w celu zaktualizowania usługi aprowizacji.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}?api-version=2026-11-01

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
provisioningServiceName
path True

string

Nazwa usługi provisioning do pobrania.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwisko Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties True

IotDpsPropertiesDescription

Właściwości specyficzne dla usługi aprowizacji

sku True

IotDpsSkuInfo

Informacje o jednostce SKU dla usługi aprowizacji.

etag

string

Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag.

identity

ManagedServiceIdentity

Tożsamości usługi zarządzanej przypisane do tego zasobu.

resourcegroup

string

Grupa zasobów zasobu.

subscriptionid

string

Identyfikator subskrypcji zasobu.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwisko Typ Opis
200 OK

ProvisioningServiceDescription

Operacja aktualizacji zasobu 'ProvisioningServiceDescription' zakończyła się sukcesem

201 Created

ProvisioningServiceDescription

Operacja tworzenia zasobu 'ProvisioningServiceDescription' zakończyła się sukcesem

Nagłówki

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

ErrorDetails

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation podszywaj się pod konto użytkownika

Przykłady

DPSCreate
DPSCreate_DisableLocalAuthFalse
DPSCreate_DisableLocalAuthTrue
DPSCreateWithIotHub
DPSCreateWithNamespace
DPSUpdate
DPSUpdate_DisableLocalAuth

DPSCreate

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "enableDataResidency": false
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {}
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}

DPSCreate_DisableLocalAuthFalse

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "publicNetworkAccess": "Enabled",
    "disableLocalAuth": false
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {
    "key1": "value1"
  }
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": false
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {
    "key1": "value1"
  }
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": false
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {
    "key1": "value1"
  }
}

DPSCreate_DisableLocalAuthTrue

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "publicNetworkAccess": "Enabled",
    "disableLocalAuth": true
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": true
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": true
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {
    "key1": "value1",
    "key2": "value2"
  }
}

DPSCreateWithIotHub

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "enableDataResidency": false,
    "iotHubs": [
      {
        "applyAllocationPolicy": true,
        "allocationWeight": 1,
        "hostName": "myFirstIoTHub.azure-devices.net",
        "authenticationType": "UserAssigned",
        "selectedUserAssignedIdentityResourceId": "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1",
        "location": "eastus"
      }
    ]
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1": {}
    }
  },
  "tags": {}
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "iotHubs": [
      {
        "applyAllocationPolicy": true,
        "allocationWeight": 1,
        "name": "myFirstIoTHub.azure-devices.net",
        "hostName": "myFirstIoTHub.azure-devices.net",
        "authenticationType": "UserAssigned",
        "selectedUserAssignedIdentityResourceId": "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1",
        "location": "eastus"
      }
    ],
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1": {}
    }
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "iotHubs": [
      {
        "applyAllocationPolicy": true,
        "allocationWeight": 1,
        "name": "myFirstIoTHub.azure-devices.net",
        "hostName": "myFirstIoTHub.azure-devices.net",
        "authenticationType": "UserAssigned",
        "selectedUserAssignedIdentityResourceId": "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1",
        "location": "eastus"
      }
    ],
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1": {}
    }
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}

DPSCreateWithNamespace

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "enableDataResidency": false
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {}
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1": {},
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-2": {}
    }
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-1": {},
      "/subscriptions/abcf2d55-764f-419f-974d-f77a55c2ce55/resourcegroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-mi-2": {}
    }
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}

DPSUpdate

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourcegroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {}
    }
  },
  "location": "East US",
  "properties": {
    "enableDataResidency": false
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {}
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "principalId": "aa80bd74-a3f0-4f14-b9da-99c5351cf9d5",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourcegroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {
        "clientId": "c38f618d-47f6-4260-8b3d-1dd8c130f323",
        "principalId": "f1b0b133-10dc-4985-966f-a98a04675fe9"
      }
    }
  },
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups//providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "principalId": "aa80bd74-a3f0-4f14-b9da-99c5351cf9d5",
    "tenantId": "f686d426-8d16-42db-81b7-ab578e110ccd",
    "userAssignedIdentities": {
      "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourcegroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testidentity": {
        "clientId": "c38f618d-47f6-4260-8b3d-1dd8c130f323",
        "principalId": "f1b0b133-10dc-4985-966f-a98a04675fe9"
      }
    }
  },
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "enableDataResidency": false,
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active"
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}

DPSUpdate_DisableLocalAuth

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2026-11-01

{
  "location": "East US",
  "properties": {
    "disableLocalAuth": true
  },
  "sku": {
    "name": "S1",
    "capacity": 1
  },
  "tags": {}
}

Przykładowa odpowiedź

{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": true
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}
{
  "name": "myFirstProvisioningService",
  "type": "Microsoft.Devices/ProvisioningServices",
  "etag": "AAAAAAAADGk=",
  "id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
  "location": "eastus",
  "properties": {
    "allocationPolicy": "Hashed",
    "authorizationPolicies": [],
    "deviceProvisioningHostName": "global.azure-devices-provisioning.net",
    "idScope": "0ne00000012",
    "portalOperationsHostName": "myFirstProvisioningService.services.azure-devices-provisioning.net",
    "serviceOperationsHostName": "myFirstProvisioningService.azure-devices-provisioning.net",
    "state": "Active",
    "disableLocalAuth": true
  },
  "resourcegroup": "myResourceGroup",
  "sku": {
    "name": "S1",
    "capacity": 1,
    "tier": "Standard"
  },
  "subscriptionid": "91d12660-3dec-467a-be2a-213b5544ddc0",
  "tags": {}
}

Definicje

Nazwisko Opis
AccessRightsDescription

Prawa, które ma ten klucz.

AllocationPolicy

Zasady alokacji, które mają być używane przez tę usługę aprowizacji.

createdByType

Typ tożsamości, która utworzyła zasób.

DeviceRegistryNamespaceAuthenticationType

Typ uwierzytelniania MI w przestrzeni nazw rejestru urządzeń: UserAssigned, SystemAssigned.

DeviceRegistryNamespaceDescription

Opis przestrzeni nazw rejestru urządzeń, która jest połączona z usługą aprowizacji.

ErrorDetails

Szczegóły błędu.

IotDpsPropertiesDescription

właściwości specyficzne dla usługi aprowizacji, w tym klucze, połączone centra iot, bieżący stan i system wygenerowane właściwości, takie jak nazwa hosta i idScope

IotDpsSku

Nazwa jednostki SKU.

IotDpsSkuInfo

Lista możliwych jednostek SKU usługi aprowizacji.

IotHubAuthenticationType

Typ uwierzytelniania IotHub MI: KeyBased, UserAssigned, SystemAssigned.

IotHubDefinitionDescription

Opis centrum IoT.

IpFilterActionType

Żądana akcja żądań przechwyconych przez tę regułę.

IpFilterRule

Reguły filtrowania adresów IP dla usługi aprowizacji.

IpFilterTargetType

Element docelowy dla żądań przechwyconych przez tę regułę.

LinkingState

Stan linkowania ADR dla usługi provisioning.

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

PrivateEndpoint

Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego

PrivateEndpointConnection

Połączenie prywatnego punktu końcowego usługi aprowizacji

PrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego

PrivateLinkServiceConnectionState

Bieżący stan połączenia prywatnego punktu końcowego

PrivateLinkServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego

ProvisioningServiceDescription

Opis usługi aprowizacji.

PublicNetworkAccess

Czy żądania z sieci publicznej są dozwolone

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Opis klucza dostępu współdzielonego.

State

Bieżący stan usługi aprowizacji.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

AccessRightsDescription

Prawa, które ma ten klucz.

Wartość Opis
ServiceConfig
EnrollmentRead
EnrollmentWrite
DeviceConnect
RegistrationStatusRead
RegistrationStatusWrite

AllocationPolicy

Zasady alokacji, które mają być używane przez tę usługę aprowizacji.

Wartość Opis
Hashed
GeoLatency
Static

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

DeviceRegistryNamespaceAuthenticationType

Typ uwierzytelniania MI w przestrzeni nazw rejestru urządzeń: UserAssigned, SystemAssigned.

Wartość Opis
UserAssigned

Typ uwierzytelniania przypisany przez użytkownika.

SystemAssigned

Typ uwierzytelniania przypisany przez system.

DeviceRegistryNamespaceDescription

Opis przestrzeni nazw rejestru urządzeń, która jest połączona z usługą aprowizacji.

Nazwisko Typ Opis
authenticationType

DeviceRegistryNamespaceAuthenticationType

Typ uwierzytelniania MI w przestrzeni nazw rejestru urządzeń: UserAssigned, SystemAssigned.

dataAddress

string

Adres płaszczyzny danych powiązanej przestrzeni nazw Azure Device Registry.

linkingState

LinkingState

Stan łączenia tej przestrzeni nazw.

location

string

Lokalizacja Azure w powiązanej przestrzeni nazw Device Registry.

namespaceUuid

string

Unikalny identyfikator powiązanej przestrzeni nazw Device Registry.

resourceId

string (arm-id)

Identyfikator zasobu usługi ARM przestrzeni nazw rejestru urządzeń.

selectedUserAssignedIdentityResourceId

string (arm-id)

Wybrany identyfikator zasobu tożsamości przypisanego przez użytkownika skojarzony z przestrzenią nazw rejestru urządzeń. Jest to wymagane, gdy typ authenticationType ma wartość UserAssigned.

ErrorDetails

Szczegóły błędu.

Nazwisko Typ Opis
code

integer (int32)

Kod błędu.

details

string

Szczegóły błędu.

httpStatusCode

string

Kod statusu HTTP.

message

string

Komunikat o błędzie.

IotDpsPropertiesDescription

właściwości specyficzne dla usługi aprowizacji, w tym klucze, połączone centra iot, bieżący stan i system wygenerowane właściwości, takie jak nazwa hosta i idScope

Nazwisko Typ Domyślna wartość Opis
allocationPolicy

AllocationPolicy

Zasady alokacji, które mają być używane przez tę usługę aprowizacji.

authorizationPolicies

SharedAccessSignatureAuthorizationRuleAccessRightsDescription[]

Lista kluczy autoryzacji dla usługi aprowizacji.

deviceProvisioningHostName

string

Punkt końcowy urządzenia dla tej usługi aprowizacji.

deviceRegistryNamespaces

DeviceRegistryNamespaceDescription[]

Przestrzenie nazw Device Registry powiązane z usługą provisioning.

disableLocalAuth

boolean

False

Wyłącza wszystkie metody uwierzytelniania poza Azure RBAC.

enableDataResidency

boolean

Optional. Wskazuje, czy wystąpienie usługi DPS ma włączoną rezydencję danych, usuwając odzyskiwanie po awarii między parami geograficznymi.

idScope

string

Unikatowy identyfikator tej usługi aprowizacji.

iotHubs

IotHubDefinitionDescription[]

Lista centrów IoT skojarzonych z tą usługą aprowizacji.

ipFilterRules

IpFilterRule[]

Reguły filtrowania adresów IP.

portalOperationsHostName

string

Punkt końcowy portalu umożliwiający włączenie mechanizmu CORS dla tej usługi aprowizacji.

privateEndpointConnections

PrivateEndpointConnection[]

Połączenia prywatnego punktu końcowego utworzone w tej usłudze IotHub

provisioningState

string

Stan aprowizacji usługi ARM dla usługi aprowizacji.

publicNetworkAccess

PublicNetworkAccess

Czy żądania z sieci publicznej są dozwolone

serviceOperationsHostName

string

Punkt końcowy usługi na potrzeby aprowizacji usługi.

state

State

Bieżący stan usługi aprowizacji.

IotDpsSku

Nazwa jednostki SKU.

Wartość Opis
S1

IotDpsSkuInfo

Lista możliwych jednostek SKU usługi aprowizacji.

Nazwisko Typ Opis
capacity

integer (int64)

Liczba jednostek do aprowizacji

name

IotDpsSku

Nazwa jednostki SKU.

tier

string

Nazwa warstwy cenowej usługi aprowizacji.

IotHubAuthenticationType

Typ uwierzytelniania IotHub MI: KeyBased, UserAssigned, SystemAssigned.

Wartość Opis
KeyBased

Typ uwierzytelniania opartego na kluczu.

UserAssigned

Typ uwierzytelniania przypisany przez użytkownika.

SystemAssigned

Typ uwierzytelniania przypisany przez system.

IotHubDefinitionDescription

Opis centrum IoT.

Nazwisko Typ Opis
allocationWeight

integer (int32)

waga do ubiegania się o daną iot h.

applyAllocationPolicy

boolean

flaga stosowania elementu allocationPolicy lub nie dla danego centrum iot.

authenticationType

IotHubAuthenticationType

Typ uwierzytelniania IotHub MI: KeyBased, UserAssigned, SystemAssigned.

connectionString

string

Parametry połączenia centrum IoT Hub. Jest to wymagane, gdy AuthenticationType jest KeyBased.

hostName

string

Nazwa hosta centrum IoT. Jest to wymagane, gdy connectionString nie jest dostępny.

location

string

Region usługi ARM centrum IoT.

name

string

Nazwa hosta centrum IoT.

selectedUserAssignedIdentityResourceId

string (arm-id)

Wybrany identyfikator zasobu tożsamości przypisany przez użytkownika powiązany z hubem IoT. Jest to wymagane, gdy typ authenticationType ma wartość UserAssigned.

IpFilterActionType

Żądana akcja żądań przechwyconych przez tę regułę.

Wartość Opis
Accept
Reject

IpFilterRule

Reguły filtrowania adresów IP dla usługi aprowizacji.

Nazwisko Typ Opis
action

IpFilterActionType

Żądana akcja żądań przechwyconych przez tę regułę.

filterName

string

Nazwa reguły filtru adresów IP.

ipMask

string

Ciąg zawierający zakres adresów IP w notacji CIDR dla reguły.

target

IpFilterTargetType

Element docelowy dla żądań przechwyconych przez tę regułę.

IpFilterTargetType

Element docelowy dla żądań przechwyconych przez tę regułę.

Wartość Opis
all
serviceApi
deviceApi

LinkingState

Stan linkowania ADR dla usługi provisioning.

Wartość Opis
NotLinked

Usługa provisioning nie jest powiązana z przestrzenią nazw Device Registry.

InProgress

Proces linkowania jest w toku.

Succeeded

Proces łączenia zakończył się sukcesem.

Orphaned

Powiązana przestrzeń nazw Device Registry już nie istnieje.

ManagedServiceIdentity

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

Nazwisko Typ Opis
principalId

string (uuid)

Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

tenantId

string (uuid)

Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.

type

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

userAssignedIdentities

<string,  UserAssignedIdentity>

tożsamości User-Assigned
Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownikowe userAssignedIdentities będą identyfikatorami zasobów ARM w formie: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Wartość Opis
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PrivateEndpoint

Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego

Nazwisko Typ Opis
id

string

Identyfikator zasobu.

PrivateEndpointConnection

Połączenie prywatnego punktu końcowego usługi aprowizacji

Nazwisko Typ Opis
id

string

W pełni określony identyfikator zasobu dla tego zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nazwa zasobu

properties

PrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego

Nazwisko Typ Opis
privateEndpoint

PrivateEndpoint

Właściwość prywatnego punktu końcowego połączenia prywatnego punktu końcowego

privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Bieżący stan połączenia prywatnego punktu końcowego

PrivateLinkServiceConnectionState

Bieżący stan połączenia prywatnego punktu końcowego

Nazwisko Typ Opis
actionsRequired

string

Akcje wymagane dla połączenia prywatnego punktu końcowego

description

string

Opis bieżącego stanu połączenia prywatnego punktu końcowego

status

PrivateLinkServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego

PrivateLinkServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego

Wartość Opis
Pending
Approved
Rejected
Disconnected

ProvisioningServiceDescription

Opis usługi aprowizacji.

Nazwisko Typ Opis
etag

string

Pole Etag nie jest wymagane. Jeśli jest on podany w treści odpowiedzi, musi być również podany jako nagłówek zgodnie z normalną konwencją ETag.

id

string

W pełni określony identyfikator zasobu dla tego zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Tożsamości usługi zarządzanej przypisane do tego zasobu.

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties

IotDpsPropertiesDescription

Właściwości specyficzne dla usługi aprowizacji

resourcegroup

string

Grupa zasobów zasobu.

sku

IotDpsSkuInfo

Informacje o jednostce SKU dla usługi aprowizacji.

subscriptionid

string

Identyfikator subskrypcji zasobu.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

PublicNetworkAccess

Czy żądania z sieci publicznej są dozwolone

Wartość Opis
Enabled
Disabled

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

Opis klucza dostępu współdzielonego.

Nazwisko Typ Opis
keyName

string

Nazwa klucza.

primaryKey

string

Podstawowa wartość klucza sygnatury dostępu współdzielonego.

rights

AccessRightsDescription

Prawa, które ma ten klucz.

secondaryKey

string

Pomocnicza wartość klucza sygnatury dostępu współdzielonego.

State

Bieżący stan usługi aprowizacji.

Wartość Opis
Activating
Active
Deleting
Deleted
ActivationFailed
DeletionFailed
Transitioning
Suspending
Suspended
Resuming
FailingOver
FailoverFailed

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

UserAssignedIdentity

Właściwości tożsamości przypisanej przez użytkownika

Nazwisko Typ Opis
clientId

string (uuid)

Identyfikator klienta przypisanej tożsamości.

principalId

string (uuid)

Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.