Freigeben über


Iot Dps Resource - Get

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

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

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