Iot Dps Resource - List By Subscription

Service:

IoT Hub Device Provisioning Service

API-versie:

2022-12-12

Alle inrichtingsservices in een abonnement ophalen.
Alle inrichtingsservices voor een bepaalde abonnements-id weergeven.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Devices/provisioningServices?api-version=2022-12-12

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string	De abonnements-id.
api-version	query	True	string	De versie van de API.

Antwoorden

Name	Type	Description
200 OK	ProvisioningServiceDescriptionListResult	Dit is een synchrone bewerking. De hoofdtekst bevat een JSON-geserialiseerde matrix van de metagegevens van alle inrichtingsservices in het abonnement.
Other Status Codes	ErrorDetails	Standaardfoutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

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

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

DPSListBySubscription

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/providers/Microsoft.Devices/provisioningServices?api-version=2022-12-12

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
AccessRightsDescription	Rechten die deze sleutel heeft.
AllocationPolicy	Toewijzingsbeleid dat moet worden gebruikt door deze inrichtingsservice.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorDetails	Foutdetails.
IotDpsPropertiesDescription	de servicespecifieke eigenschappen van een inrichtingsservice, waaronder sleutels, gekoppelde ioT-hubs, huidige status en door het systeem gegenereerde eigenschappen, zoals hostnaam en idScope
IotDpsSku	SKU-naam.
IotDpsSkuInfo	Lijst met mogelijke inrichtingsservice-SKU's.
IotHubDefinitionDescription	Beschrijving van de IoT-hub.
IpFilterActionType	De gewenste actie voor aanvragen die met deze regel zijn vastgelegd.
IpFilterRule	De IP-filterregels voor een inrichtingsservice.
IpFilterTargetType	Doel voor aanvragen die zijn vastgelegd met deze regel.
PrivateEndpoint	De privé-eindpunteigenschap van een privé-eindpuntverbinding
PrivateEndpointConnection	De privé-eindpuntverbinding van een inrichtingsservice
PrivateEndpointConnectionProperties	De eigenschappen van een privé-eindpuntverbinding
PrivateLinkServiceConnectionState	De huidige status van een privé-eindpuntverbinding
PrivateLinkServiceConnectionStatus	De status van een privé-eindpuntverbinding
ProvisioningServiceDescription	De beschrijving van de inrichtingsservice.
ProvisioningServiceDescriptionListResult	Lijst met beschrijvingen van inrichtingsservices.
PublicNetworkAccess	Of aanvragen van het openbare netwerk zijn toegestaan
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]	Beschrijving van de gedeelde toegangssleutel.
state	Huidige status van de inrichtingsservice.
systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

AccessRightsDescription

Rechten die deze sleutel heeft.

Name	Type	Description
DeviceConnect	string
EnrollmentRead	string
EnrollmentWrite	string
RegistrationStatusRead	string
RegistrationStatusWrite	string
ServiceConfig	string

AllocationPolicy

Toewijzingsbeleid dat moet worden gebruikt door deze inrichtingsservice.

Name	Type	Description
GeoLatency	string
Hashed	string
Static	string

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Foutdetails.

Name	Type	Description
code	integer	De foutcode.
details	string	De foutdetails.
httpStatusCode	string	De HTTP-statuscode.
message	string	Het foutbericht.

IotDpsPropertiesDescription

de servicespecifieke eigenschappen van een inrichtingsservice, waaronder sleutels, gekoppelde ioT-hubs, huidige status en door het systeem gegenereerde eigenschappen, zoals hostnaam en idScope

Name	Type	Description
allocationPolicy	AllocationPolicy	Toewijzingsbeleid dat moet worden gebruikt door deze inrichtingsservice.
authorizationPolicies	SharedAccessSignatureAuthorizationRule[AccessRightsDescription][]	Lijst met autorisatiesleutels voor een inrichtingsservice.
deviceProvisioningHostName	string	Apparaateindpunt voor deze inrichtingsservice.
enableDataResidency	boolean	Optioneel. Geeft aan of het DPS-exemplaar Data Residency is ingeschakeld, waardoor het herstel na noodgeval tussen geo-paren wordt verwijderd.
idScope	string	De unieke id van deze inrichtingsservice.
iotHubs	IotHubDefinitionDescription[]	Lijst met IoT-hubs die zijn gekoppeld aan deze inrichtingsservice.
ipFilterRules	IpFilterRule[]	De IP-filterregels.
portalOperationsHostName	string	Portal-eindpunt om CORS in te schakelen voor deze inrichtingsservice.
privateEndpointConnections	PrivateEndpointConnection[]	Privé-eindpuntverbindingen die zijn gemaakt op deze IotHub
provisioningState	string	De ARM-inrichtingsstatus van de inrichtingsservice.
publicNetworkAccess	PublicNetworkAccess	Of aanvragen van het openbare netwerk zijn toegestaan
serviceOperationsHostName	string	Service-eindpunt voor inrichtingsservice.
state	state	Huidige status van de inrichtingsservice.

IotDpsSku

SKU-naam.

Name	Type	Description
S1	string

IotDpsSkuInfo

Lijst met mogelijke inrichtingsservice-SKU's.

Name	Type	Description
capacity	integer	Het aantal eenheden dat moet worden ingericht
name	IotDpsSku	SKU-naam.
tier	string	De naam van de prijscategorie van de inrichtingsservice.

IotHubDefinitionDescription

Beschrijving van de IoT-hub.

Name	Type	Description
allocationWeight	integer	gewicht toe te passen voor een bepaalde iot h.
applyAllocationPolicy	boolean	vlag voor het toepassen van allocationPolicy of niet voor een bepaalde ioT-hub.
connectionString	string	Verbindingsreeks van de IoT-hub.
location	string	ARM-regio van de IoT-hub.
name	string	Hostnaam van de IoT-hub.

IpFilterActionType

De gewenste actie voor aanvragen die met deze regel zijn vastgelegd.

Name	Type	Description
Accept	string
Reject	string

IpFilterRule

De IP-filterregels voor een inrichtingsservice.

Name	Type	Description
action	IpFilterActionType	De gewenste actie voor aanvragen die met deze regel zijn vastgelegd.
filterName	string	De naam van de IP-filterregel.
ipMask	string	Een tekenreeks die het IP-adresbereik in CIDR-notatie voor de regel bevat.
target	IpFilterTargetType	Doel voor aanvragen die zijn vastgelegd met deze regel.

IpFilterTargetType

Doel voor aanvragen die zijn vastgelegd met deze regel.

Name	Type	Description
all	string
deviceApi	string
serviceApi	string

PrivateEndpoint

De privé-eindpunteigenschap van een privé-eindpuntverbinding

Name	Type	Description
id	string	De resource-id.

PrivateEndpointConnection

De privé-eindpuntverbinding van een inrichtingsservice

Name	Type	Description
id	string	De resource-id.
name	string	De resourcenaam.
properties	PrivateEndpointConnectionProperties	De eigenschappen van een privé-eindpuntverbinding
systemData	systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
type	string	Het resourcetype.

PrivateEndpointConnectionProperties

De eigenschappen van een privé-eindpuntverbinding

Name	Type	Description
privateEndpoint	PrivateEndpoint	De privé-eindpunteigenschap van een privé-eindpuntverbinding
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	De huidige status van een privé-eindpuntverbinding

PrivateLinkServiceConnectionState

De huidige status van een privé-eindpuntverbinding

Name	Type	Description
actionsRequired	string	Vereiste acties voor een privé-eindpuntverbinding
description	string	De beschrijving voor de huidige status van een privé-eindpuntverbinding
status	PrivateLinkServiceConnectionStatus	De status van een privé-eindpuntverbinding

PrivateLinkServiceConnectionStatus

De status van een privé-eindpuntverbinding

Name	Type	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ProvisioningServiceDescription

De beschrijving van de inrichtingsservice.

Name	Type	Description
etag	string	Het veld Etag is niet vereist. Als deze is opgegeven in de hoofdtekst van het antwoord, moet deze ook worden opgegeven als een header volgens de normale ETag-conventie.
id	string	De resource-id.
location	string	De resourcelocatie.
name	string	De resourcenaam.
properties	IotDpsPropertiesDescription	Servicespecifieke eigenschappen voor een inrichtingsservice
resourcegroup	string	De resourcegroep van de resource.
sku	IotDpsSkuInfo	SKU-informatie voor een inrichtingsservice.
subscriptionid	string	De abonnements-id van de resource.
systemData	systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.
tags	object	De resourcetags.
type	string	Het resourcetype.

ProvisioningServiceDescriptionListResult

Lijst met beschrijvingen van inrichtingsservices.

Name	Type	Description
nextLink	string	de volgende koppeling
value	ProvisioningServiceDescription[]	Lijst met beschrijvingen van inrichtingsservices.

PublicNetworkAccess

Of aanvragen van het openbare netwerk zijn toegestaan

Name	Type	Description
Disabled	string
Enabled	string

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Beschrijving van de gedeelde toegangssleutel.

Name	Type	Description
keyName	string	Naam van de sleutel.
primaryKey	string	Waarde van primaire SAS-sleutel.
rights	AccessRightsDescription	Rechten die deze sleutel heeft.
secondaryKey	string	Waarde van secundaire SAS-sleutel.

state

Huidige status van de inrichtingsservice.

Name	Type	Description
Activating	string
ActivationFailed	string
Active	string
Deleted	string
Deleting	string
DeletionFailed	string
FailingOver	string
FailoverFailed	string
Resuming	string
Suspended	string
Suspending	string
Transitioning	string

systemData

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

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