Iot Dps Resource - Update

Referência

Serviço:: IoT Hub Device Provisioning Service

Versão da API:: 2022-12-12

Atualize as marcas de um serviço de provisionamento existente. para atualizar outros campos, use o método CreateOrUpdate

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
provisioningServiceName	path	True	string	Nome do serviço de provisionamento para criar ou atualizar.
resourceGroupName	path	True	string	Identificador do grupo de recursos.
subscriptionId	path	True	string	O identificador da assinatura.
api-version	query	True	string	A versão da API.

Corpo da solicitação

Nome	Tipo	Description
tags	object	Etiquetas de recursos

Respostas

Nome	Tipo	Description
200 OK	ProvisioningServiceDescription	O Serviço de Provisionamento foi atualizado com êxito

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

DPSPatch

Solicitação de exemplo

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"
  }
}

Resposta de exemplo

Código de status:: 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
  }
}

Definições

Nome	Description
AccessRightsDescription	Direitos que essa chave tem.
AllocationPolicy	Política de alocação a ser usada por esse serviço de provisionamento.
createdByType	O tipo de identidade que criou o recurso.
IotDpsPropertiesDescription	as propriedades específicas do serviço de um serviço de provisionamento, incluindo chaves, hubs iot vinculados, estado atual e propriedades geradas pelo sistema, como nome do host e idScope
IotDpsSku	Nome do SKU.
IotDpsSkuInfo	Lista de possíveis SKUs do serviço de provisionamento.
IotHubDefinitionDescription	Descrição do hub IoT.
IpFilterActionType	A ação desejada para solicitações capturadas por essa regra.
IpFilterRule	As regras de filtro IP para um serviço de provisionamento.
IpFilterTargetType	Destino para solicitações capturadas por essa regra.
PrivateEndpoint	A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privado
PrivateEndpointConnection	A conexão de ponto de extremidade privado de um serviço de provisionamento
PrivateEndpointConnectionProperties	As propriedades de uma conexão de ponto de extremidade privado
PrivateLinkServiceConnectionState	O estado atual de uma conexão de ponto de extremidade privado
PrivateLinkServiceConnectionStatus	O status de uma conexão de ponto de extremidade privado
ProvisioningServiceDescription	A descrição do serviço de provisionamento.
PublicNetworkAccess	Se as solicitações da Rede Pública são permitidas
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]	Descrição da chave de acesso compartilhado.
state	Estado atual do serviço de provisionamento.
systemData	Metadados relativos à criação e última modificação do recurso.
TagsResource	Um contêiner que contém apenas as marcas de um recurso, permitindo que o usuário atualize as marcas em uma instância do Serviço de Provisionamento.

AccessRightsDescription

Enumeração

Direitos que essa chave tem.

Valor	Description
DeviceConnect
EnrollmentRead
EnrollmentWrite
RegistrationStatusRead
RegistrationStatusWrite
ServiceConfig

AllocationPolicy

Enumeração

Política de alocação a ser usada por esse serviço de provisionamento.

Valor	Description
GeoLatency
Hashed
Static

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

IotDpsPropertiesDescription

Objeto

as propriedades específicas do serviço de um serviço de provisionamento, incluindo chaves, hubs iot vinculados, estado atual e propriedades geradas pelo sistema, como nome do host e idScope

Nome	Tipo	Description
allocationPolicy	AllocationPolicy	Política de alocação a ser usada por esse serviço de provisionamento.
authorizationPolicies	SharedAccessSignatureAuthorizationRule[AccessRightsDescription][]	Lista de chaves de autorização para um serviço de provisionamento.
deviceProvisioningHostName	string	Ponto de extremidade do dispositivo para este serviço de provisionamento.
enableDataResidency	boolean	Opcional. Indica se a instância do DPS tem a Residência de Dados habilitada, removendo a recuperação de desastre entre pares geográficos.
idScope	string	Identificador exclusivo desse serviço de provisionamento.
iotHubs	IotHubDefinitionDescription[]	Lista de hubs IoT associados a esse serviço de provisionamento.
ipFilterRules	IpFilterRule[]	As regras de filtro IP.
portalOperationsHostName	string	Ponto de extremidade do portal para habilitar o CORS para esse serviço de provisionamento.
privateEndpointConnections	PrivateEndpointConnection[]	Conexões de ponto de extremidade privado criadas neste IotHub
provisioningState	string	O estado de provisionamento do ARM do serviço de provisionamento.
publicNetworkAccess	PublicNetworkAccess	Se as solicitações da Rede Pública são permitidas
serviceOperationsHostName	string	Ponto de extremidade de serviço para o serviço de provisionamento.
state	state	Estado atual do serviço de provisionamento.

IotDpsSku

Enumeração

Nome do SKU.

Valor	Description
S1

IotDpsSkuInfo

Objeto

Lista de possíveis SKUs do serviço de provisionamento.

Nome	Tipo	Description
capacity	integer (int64)	O número de unidades a serem provisionadas
name	IotDpsSku	Nome do SKU.
tier	string	Nome do tipo de preço do serviço de provisionamento.

IotHubDefinitionDescription

Objeto

Descrição do hub IoT.

Nome	Tipo	Description
allocationWeight	integer (int32)	peso a ser aplicado a um determinado iot h.
applyAllocationPolicy	boolean	sinalizador para aplicar allocationPolicy ou não para um determinado hub iot.
connectionString	string	Cadeia de conexão do hub IoT.
location	string	Região do ARM do hub IoT.
name	string	Nome do host do hub IoT.

IpFilterActionType

Enumeração

A ação desejada para solicitações capturadas por essa regra.

Valor	Description
Accept
Reject

IpFilterRule

Objeto

As regras de filtro IP para um serviço de provisionamento.

Nome	Tipo	Description
action	IpFilterActionType	A ação desejada para solicitações capturadas por essa regra.
filterName	string	O nome da regra de filtro IP.
ipMask	string	Uma cadeia de caracteres que contém o intervalo de endereços IP na notação CIDR para a regra.
target	IpFilterTargetType	Destino para solicitações capturadas por essa regra.

IpFilterTargetType

Enumeração

Destino para solicitações capturadas por essa regra.

Valor	Description
all
deviceApi
serviceApi

PrivateEndpoint

Objeto

A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privado

Nome	Tipo	Description
id	string	O identificador de recurso.

PrivateEndpointConnection

Objeto

A conexão de ponto de extremidade privado de um serviço de provisionamento

Nome	Tipo	Description
id	string	O identificador de recurso.
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	O nome do recurso.
properties	PrivateEndpointConnectionProperties	As propriedades de uma conexão de ponto de extremidade privado
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
type	string	O tipo de recurso.

PrivateEndpointConnectionProperties

Objeto

As propriedades de uma conexão de ponto de extremidade privado

Nome	Tipo	Description
privateEndpoint	PrivateEndpoint	A propriedade de ponto de extremidade privado de uma conexão de ponto de extremidade privado
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	O estado atual de uma conexão de ponto de extremidade privado

PrivateLinkServiceConnectionState

Objeto

O estado atual de uma conexão de ponto de extremidade privado

Nome	Tipo	Description
actionsRequired	string	Ações necessárias para uma conexão de ponto de extremidade privado
description	string	A descrição do estado atual de uma conexão de ponto de extremidade privado
status	PrivateLinkServiceConnectionStatus	O status de uma conexão de ponto de extremidade privado

PrivateLinkServiceConnectionStatus

Enumeração

O status de uma conexão de ponto de extremidade privado

Valor	Description
Approved
Disconnected
Pending
Rejected

ProvisioningServiceDescription

Objeto

A descrição do serviço de provisionamento.

Nome	Tipo	Description
etag	string	O campo Etag não é necessário. Se for fornecido no corpo da resposta, ele também deverá ser fornecido como um cabeçalho de acordo com a convenção ETag normal.
id	string	O identificador de recurso.
location	string	O local do recurso.
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	O nome do recurso.
properties	IotDpsPropertiesDescription	Propriedades específicas do serviço para um serviço de provisionamento
resourcegroup	string	O grupo de recursos do recurso.
sku	IotDpsSkuInfo	Informações de SKU para um serviço de provisionamento.
subscriptionid	string	A ID da assinatura do recurso.
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
tags	object	As marcas de recurso.
type	string	O tipo de recurso.

PublicNetworkAccess

Enumeração

Se as solicitações da Rede Pública são permitidas

Valor	Description
Disabled
Enabled

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Objeto

Descrição da chave de acesso compartilhado.

Nome	Tipo	Description
keyName	string	Nome da chave.
primaryKey	string	Valor da chave SAS primária.
rights	AccessRightsDescription	Direitos que essa chave tem.
secondaryKey	string	Valor de chave SAS secundário.

state

Enumeração

Estado atual do serviço de provisionamento.

Valor	Description
Activating
ActivationFailed
Active
Deleted
Deleting
DeletionFailed
FailingOver
FailoverFailed
Resuming
Suspended
Suspending
Transitioning

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TagsResource

Objeto

Um contêiner que contém apenas as marcas de um recurso, permitindo que o usuário atualize as marcas em uma instância do Serviço de Provisionamento.

Nome	Tipo	Description
tags	object	Etiquetas de recursos

Compartilhar via

Iot Dps Resource - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

DPSPatch

Solicitação de exemplo

Resposta de exemplo

Definições

AccessRightsDescription

AllocationPolicy

createdByType

IotDpsPropertiesDescription

IotDpsSku

IotDpsSkuInfo

IotHubDefinitionDescription

IpFilterActionType

IpFilterRule

IpFilterTargetType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionStatus

ProvisioningServiceDescription

PublicNetworkAccess

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

state

systemData

TagsResource

Recursos adicionais