Iot Dps Resource - Get

Referenz

Dienst:: IoT Hub Device Provisioning Service

API-Version:: 2022-12-12

Rufen Sie die nicht sicherheitsrelevanten Metadaten des Bereitstellungsdiensts ab.
Rufen Sie die Metadaten des Bereitstellungsdiensts ohne SAS-Schlüssel ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
provisioningServiceName	path	True	string	Name des abzurufenden Bereitstellungsdiensts.
resourceGroupName	path	True	string	Ressourcengruppenname
subscriptionId	path	True	string	Die Abonnement-ID.
api-version	query	True	string	Die Version der API.

Antworten

Name	Typ	Beschreibung
200 OK	ProvisioningServiceDescription	Die Beschreibung des Bereitstellungsdiensts ohne Schlüssel ist in der Antwort enthalten.
Other Status Codes	ErrorDetails	Standardfehlerantwort

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

DPSGet

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "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",
    "authorizationPolicies": [],
    "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
  }
}

Definitionen

Name	Beschreibung
AccessRightsDescription	Rechte, die dieser Schlüssel besitzt.
AllocationPolicy	Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorDetails	Fehlerdetails.
IotDpsPropertiesDescription	die dienstspezifischen Eigenschaften eines Bereitstellungsdiensts, einschließlich Schlüsseln, verknüpften Iot Hubs, aktuellem Zustand und systemgenerierten Eigenschaften wie Hostname und idScope
IotDpsSku	Sku-Name.
IotDpsSkuInfo	Liste der möglichen Bereitstellungsdienst-SKUs.
IotHubDefinitionDescription	Beschreibung des IoT-Hubs.
IpFilterActionType	Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.
IpFilterRule	Die IP-Filterregeln für einen Bereitstellungsdienst.
IpFilterTargetType	Ziel für Anforderungen, die von dieser Regel erfasst werden.
PrivateEndpoint	Die Eigenschaft des privaten Endpunkts einer privaten Endpunktverbindung
PrivateEndpointConnection	Die private Endpunktverbindung eines Bereitstellungsdiensts
PrivateEndpointConnectionProperties	Die Eigenschaften einer privaten Endpunktverbindung
PrivateLinkServiceConnectionState	Der aktuelle Zustand einer Verbindung mit einem privaten Endpunkt
PrivateLinkServiceConnectionStatus	Die status einer privaten Endpunktverbindung
ProvisioningServiceDescription	Die Beschreibung des Bereitstellungsdiensts.
PublicNetworkAccess	Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]	Beschreibung des freigegebenen Zugriffsschlüssels.
state	Aktueller Status des Bereitstellungsdiensts.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

AccessRightsDescription

Rechte, die dieser Schlüssel besitzt.

Name	Typ	Beschreibung
DeviceConnect	string
EnrollmentRead	string
EnrollmentWrite	string
RegistrationStatusRead	string
RegistrationStatusWrite	string
ServiceConfig	string

AllocationPolicy

Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll.

Name	Typ	Beschreibung
GeoLatency	string
Hashed	string
Static	string

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorDetails

Fehlerdetails.

Name	Typ	Beschreibung
code	integer	Der Fehlercode.
details	string	Die Fehlerdetails.
httpStatusCode	string	Der HTTP-Statuscode.
message	string	Die Fehlermeldung.

IotDpsPropertiesDescription

die dienstspezifischen Eigenschaften eines Bereitstellungsdiensts, einschließlich Schlüsseln, verknüpften Iot Hubs, aktuellem Zustand und systemgenerierten Eigenschaften wie Hostname und idScope

Name	Typ	Beschreibung
allocationPolicy	AllocationPolicy	Zuordnungsrichtlinie, die von diesem Bereitstellungsdienst verwendet werden soll.
authorizationPolicies	SharedAccessSignatureAuthorizationRule[AccessRightsDescription][]	Liste der Autorisierungsschlüssel für einen Bereitstellungsdienst.
deviceProvisioningHostName	string	Geräteendpunkt für diesen Bereitstellungsdienst.
enableDataResidency	boolean	Optional. Gibt an, ob die DPS-instance Data Residency aktiviert hat, und entfernt die geopaarübergreifende Notfallwiederherstellung.
idScope	string	Eindeutiger Bezeichner dieses Bereitstellungsdiensts.
iotHubs	IotHubDefinitionDescription[]	Liste der IoT Hubs, die diesem Bereitstellungsdienst zugeordnet sind.
ipFilterRules	IpFilterRule[]	Die IP-Filterregeln.
portalOperationsHostName	string	Portalendpunkt zum Aktivieren von CORS für diesen Bereitstellungsdienst.
privateEndpointConnections	PrivateEndpointConnection[]	Private Endpunktverbindungen, die auf diesem IotHub erstellt wurden
provisioningState	string	Der ARM-Bereitstellungsstatus des Bereitstellungsdiensts.
publicNetworkAccess	PublicNetworkAccess	Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind
serviceOperationsHostName	string	Dienstendpunkt für den Bereitstellungsdienst.
state	state	Aktueller Status des Bereitstellungsdiensts.

IotDpsSku

Sku-Name.

Name	Typ	Beschreibung
S1	string

IotDpsSkuInfo

Liste der möglichen Bereitstellungsdienst-SKUs.

Name	Typ	Beschreibung
capacity	integer	Die Anzahl der bereitzustellenden Einheiten
name	IotDpsSku	Sku-Name.
tier	string	Tarifname des Bereitstellungsdiensts.

IotHubDefinitionDescription

Beschreibung des IoT-Hubs.

Name	Typ	Beschreibung
allocationWeight	integer	Gewicht, das für einen bestimmten iot h beantragt werden soll.
applyAllocationPolicy	boolean	Flag für die Anwendung von allocationPolicy oder nicht für einen bestimmten iot Hub.
connectionString	string	Verbindungszeichenfolge des IoT Hubs.
location	string	ARM-Region des IoT-Hubs.
name	string	Hostname des IoT Hubs.

IpFilterActionType

Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.

Name	Typ	Beschreibung
Accept	string
Reject	string

IpFilterRule

Die IP-Filterregeln für einen Bereitstellungsdienst.

Name	Typ	Beschreibung
action	IpFilterActionType	Die gewünschte Aktion für Anforderungen, die von dieser Regel erfasst werden.
filterName	string	Der Name der IP-Filterregel.
ipMask	string	Eine Zeichenfolge, die den IP-Adressbereich in der CIDR-Notation für die Regel enthält.
target	IpFilterTargetType	Ziel für Anforderungen, die von dieser Regel erfasst werden.

IpFilterTargetType

Ziel für Anforderungen, die von dieser Regel erfasst werden.

Name	Typ	Beschreibung
all	string
deviceApi	string
serviceApi	string

PrivateEndpoint

Die Eigenschaft des privaten Endpunkts einer privaten Endpunktverbindung

Name	Typ	Beschreibung
id	string	Der Ressourcenbezeichner.

PrivateEndpointConnection

Die private Endpunktverbindung eines Bereitstellungsdiensts

Name	Typ	Beschreibung
id	string	Der Ressourcenbezeichner.
name	string	Der Name der Ressource.
properties	PrivateEndpointConnectionProperties	Die Eigenschaften einer privaten Endpunktverbindung
systemData	systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
type	string	Der Ressourcentyp.

PrivateEndpointConnectionProperties

Die Eigenschaften einer privaten Endpunktverbindung

Name	Typ	Beschreibung
privateEndpoint	PrivateEndpoint	Die Eigenschaft des privaten Endpunkts einer privaten Endpunktverbindung
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Der aktuelle Zustand einer Verbindung mit einem privaten Endpunkt

PrivateLinkServiceConnectionState

Der aktuelle Zustand einer Verbindung mit einem privaten Endpunkt

Name	Typ	Beschreibung
actionsRequired	string	Für eine Verbindung mit einem privaten Endpunkt erforderliche Aktionen
description	string	Die Beschreibung für den aktuellen Zustand einer Verbindung mit einem privaten Endpunkt
status	PrivateLinkServiceConnectionStatus	Die status einer privaten Endpunktverbindung

PrivateLinkServiceConnectionStatus

Die status einer privaten Endpunktverbindung

Name	Typ	Beschreibung
Approved	string
Disconnected	string
Pending	string
Rejected	string

ProvisioningServiceDescription

Die Beschreibung des Bereitstellungsdiensts.

Name	Typ	Beschreibung
etag	string	Das Feld Etag ist nicht erforderlich. Wenn es im Antworttext angegeben wird, muss es auch als Header gemäß der normalen ETag-Konvention bereitgestellt werden.
id	string	Der Ressourcenbezeichner.
location	string	Der Ressourcenspeicherort.
name	string	Der Name der Ressource.
properties	IotDpsPropertiesDescription	Dienstspezifische Eigenschaften für einen Bereitstellungsdienst
resourcegroup	string	Die Ressourcengruppe der Ressource.
sku	IotDpsSkuInfo	SKU-Informationen für einen Bereitstellungsdienst.
subscriptionid	string	Die Abonnement-ID der Ressource.
systemData	systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
tags	object	Die Ressourcentags.
type	string	Der Ressourcentyp.

PublicNetworkAccess

Ob Anforderungen aus dem öffentlichen Netzwerk zulässig sind

Name	Typ	Beschreibung
Disabled	string
Enabled	string

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Beschreibung des freigegebenen Zugriffsschlüssels.

Name	Typ	Beschreibung
keyName	string	Name des Schlüssels.
primaryKey	string	Primärer SAS-Schlüsselwert.
rights	AccessRightsDescription	Rechte, die dieser Schlüssel besitzt.
secondaryKey	string	Sekundärer SAS-Schlüsselwert.

state

Aktueller Status des Bereitstellungsdiensts.

Name	Typ	Beschreibung
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

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über