Iot Dps Resource - Update

Referens

Tjänst:: IoT Hub Device Provisioning Service

API-version:: 2022-12-12

Uppdatera taggarna för en befintlig etableringstjänst. för att uppdatera andra fält använder du metoden CreateOrUpdate

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
provisioningServiceName	path	True	string	Namnet på etableringstjänsten som ska skapas eller uppdateras.
resourceGroupName	path	True	string	Resursgruppsidentifierare.
subscriptionId	path	True	string	Prenumerationsidentifieraren.
api-version	query	True	string	Versionen av API:et.

Begärandetext

Name	Typ	Description
tags	object	Resurstaggar

Svar

Name	Typ	Description
200 OK	ProvisioningServiceDescription	Etableringstjänsten har uppdaterats

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

DPSPatch

Exempelbegäran

HTTP

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

{
  "tags": {
    "foo": "bar"
  }
}

Exempelsvar

Statuskod:: 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",
    "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": {
    "foo": "bar"
  },
  "sku": {
    "name": "S1",
    "tier": "Standard",
    "capacity": 1
  }
}

Definitioner

Name	Description
AccessRightsDescription	Rättigheter som nyckeln har.
AllocationPolicy	Allokeringsprincip som ska användas av den här etableringstjänsten.
createdByType	Den typ av identitet som skapade resursen.
IotDpsPropertiesDescription	tjänstspecifika egenskaper för en etableringstjänst, inklusive nycklar, länkade iot-hubbar, aktuellt tillstånd och systemgenererade egenskaper som värdnamn och idScope
IotDpsSku	Sku-namn.
IotDpsSkuInfo	Lista över möjliga SKU:er för etableringstjänsten.
IotHubDefinitionDescription	Beskrivning av IoT-hubben.
IpFilterActionType	Önskad åtgärd för begäranden som samlas in av den här regeln.
IpFilterRule	IP-filterreglerna för en etableringstjänst.
IpFilterTargetType	Mål för begäranden som samlas in av den här regeln.
PrivateEndpoint	Egenskapen privat slutpunkt för en privat slutpunktsanslutning
PrivateEndpointConnection	Den privata slutpunktsanslutningen för en etableringstjänst
PrivateEndpointConnectionProperties	Egenskaperna för en privat slutpunktsanslutning
PrivateLinkServiceConnectionState	Det aktuella tillståndet för en privat slutpunktsanslutning
PrivateLinkServiceConnectionStatus	Status för en privat slutpunktsanslutning
ProvisioningServiceDescription	Beskrivningen av etableringstjänsten.
PublicNetworkAccess	Om begäranden från offentligt nätverk tillåts
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]	Beskrivning av den delade åtkomstnyckeln.
state	Etableringstjänstens aktuella tillstånd.
systemData	Metadata som rör skapande och senaste ändring av resursen.
TagsResource	En container som endast innehåller taggarna för en resurs, så att användaren kan uppdatera taggarna på en etableringstjänstinstans.

AccessRightsDescription

Uppräkning

Rättigheter som nyckeln har.

Värde	Description
DeviceConnect
EnrollmentRead
EnrollmentWrite
RegistrationStatusRead
RegistrationStatusWrite
ServiceConfig

AllocationPolicy

Uppräkning

Allokeringsprincip som ska användas av den här etableringstjänsten.

Värde	Description
GeoLatency
Hashed
Static

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

IotDpsPropertiesDescription

Objekt

tjänstspecifika egenskaper för en etableringstjänst, inklusive nycklar, länkade iot-hubbar, aktuellt tillstånd och systemgenererade egenskaper som värdnamn och idScope

Name	Typ	Description
allocationPolicy	AllocationPolicy	Allokeringsprincip som ska användas av den här etableringstjänsten.
authorizationPolicies	SharedAccessSignatureAuthorizationRule[AccessRightsDescription][]	Lista över auktoriseringsnycklar för en etableringstjänst.
deviceProvisioningHostName	string	Enhetsslutpunkt för den här etableringstjänsten.
enableDataResidency	boolean	Valfritt. Anger om DPS-instansen har Data Residency aktiverad, vilket tar bort haveriberedskapen för flera geo-par.
idScope	string	Unik identifierare för den här etableringstjänsten.
iotHubs	IotHubDefinitionDescription[]	Lista över IoT-hubbar som är associerade med den här etableringstjänsten.
ipFilterRules	IpFilterRule[]	IP-filterreglerna.
portalOperationsHostName	string	Portalslutpunkt för att aktivera CORS för den här etableringstjänsten.
privateEndpointConnections	PrivateEndpointConnection[]	Privata slutpunktsanslutningar som skapats på denna IotHub
provisioningState	string	ARM-etableringstillståndet för etableringstjänsten.
publicNetworkAccess	PublicNetworkAccess	Om begäranden från offentligt nätverk tillåts
serviceOperationsHostName	string	Tjänstslutpunkt för etableringstjänst.
state	state	Etableringstjänstens aktuella tillstånd.

IotDpsSku

Uppräkning

Sku-namn.

Värde	Description
S1

IotDpsSkuInfo

Objekt

Lista över möjliga SKU:er för etableringstjänsten.

Name	Typ	Description
capacity	integer (int64)	Antalet enheter som ska etableras
name	IotDpsSku	Sku-namn.
tier	string	Namn på prisnivå för etableringstjänsten.

IotHubDefinitionDescription

Objekt

Beskrivning av IoT-hubben.

Name	Typ	Description
allocationWeight	integer (int32)	vikt att ansöka om en viss iot h.
applyAllocationPolicy	boolean	flagga för att tillämpa allocationPolicy eller inte för en viss iot-hubb.
connectionString	string	Anslutningssträng för IoT-hubben.
location	string	ARM-regionen i IoT-hubben.
name	string	Värdnamnet för IoT-hubben.

IpFilterActionType

Uppräkning

Önskad åtgärd för begäranden som samlas in av den här regeln.

Värde	Description
Accept
Reject

IpFilterRule

Objekt

IP-filterreglerna för en etableringstjänst.

Name	Typ	Description
action	IpFilterActionType	Önskad åtgärd för begäranden som samlas in av den här regeln.
filterName	string	Namnet på IP-filterregeln.
ipMask	string	En sträng som innehåller IP-adressintervallet i CIDR-notation för regeln.
target	IpFilterTargetType	Mål för begäranden som samlas in av den här regeln.

IpFilterTargetType

Uppräkning

Mål för begäranden som samlas in av den här regeln.

Värde	Description
all
deviceApi
serviceApi

PrivateEndpoint

Objekt

Egenskapen privat slutpunkt för en privat slutpunktsanslutning

Name	Typ	Description
id	string	Resursidentifieraren.

PrivateEndpointConnection

Objekt

Den privata slutpunktsanslutningen för en etableringstjänst

Name	Typ	Description
id	string	Resursidentifieraren.
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	Resursnamnet.
properties	PrivateEndpointConnectionProperties	Egenskaperna för en privat slutpunktsanslutning
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
type	string	Resurstypen.

PrivateEndpointConnectionProperties

Objekt

Egenskaperna för en privat slutpunktsanslutning

Name	Typ	Description
privateEndpoint	PrivateEndpoint	Egenskapen privat slutpunkt för en privat slutpunktsanslutning
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	Det aktuella tillståndet för en privat slutpunktsanslutning

PrivateLinkServiceConnectionState

Objekt

Det aktuella tillståndet för en privat slutpunktsanslutning

Name	Typ	Description
actionsRequired	string	Åtgärder som krävs för en privat slutpunktsanslutning
description	string	Beskrivningen av det aktuella tillståndet för en privat slutpunktsanslutning
status	PrivateLinkServiceConnectionStatus	Status för en privat slutpunktsanslutning

PrivateLinkServiceConnectionStatus

Uppräkning

Status för en privat slutpunktsanslutning

Värde	Description
Approved
Disconnected
Pending
Rejected

ProvisioningServiceDescription

Objekt

Beskrivningen av etableringstjänsten.

Name	Typ	Description
etag	string	Fältet Etag krävs inte . Om den anges i svarstexten måste den också anges som en rubrik enligt den normala ETag-konventionen.
id	string	Resursidentifieraren.
location	string	Resursplatsen.
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	Resursnamnet.
properties	IotDpsPropertiesDescription	Tjänstspecifika egenskaper för en etableringstjänst
resourcegroup	string	Resursgruppen för resursen.
sku	IotDpsSkuInfo	SKU-information för en etableringstjänst.
subscriptionid	string	Resursens prenumerations-ID.
systemData	systemData	Metadata som rör skapande och senaste ändring av resursen.
tags	object	Resurstaggar.
type	string	Resurstypen.

PublicNetworkAccess

Uppräkning

Om begäranden från offentligt nätverk tillåts

Värde	Description
Disabled
Enabled

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Objekt

Beskrivning av den delade åtkomstnyckeln.

Name	Typ	Description
keyName	string	Namnet på nyckeln.
primaryKey	string	Primärt SAS-nyckelvärde.
rights	AccessRightsDescription	Rättigheter som nyckeln har.
secondaryKey	string	Sekundärt SAS-nyckelvärde.

state

Uppräkning

Etableringstjänstens aktuella tillstånd.

Värde	Description
Activating
ActivationFailed
Active
Deleted
Deleting
DeletionFailed
FailingOver
FailoverFailed
Resuming
Suspended
Suspending
Transitioning

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TagsResource

Objekt

En container som endast innehåller taggarna för en resurs, så att användaren kan uppdatera taggarna på en etableringstjänstinstans.

Name	Typ	Description
tags	object	Resurstaggar

Dela via

Iot Dps Resource - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

DPSPatch

Exempelbegäran

Exempelsvar

Definitioner

AccessRightsDescription

AllocationPolicy

createdByType

IotDpsPropertiesDescription

IotDpsSku

IotDpsSkuInfo

IotHubDefinitionDescription

IpFilterActionType

IpFilterRule

IpFilterTargetType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionStatus

ProvisioningServiceDescription

PublicNetworkAccess

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

state

systemData

TagsResource

Ytterligare resurser