Iot Dps Resource - Update

參考

服務:: IoT Hub Device Provisioning Service

API 版本:: 2022-12-12

更新現有布建服務的標記。若要更新其他欄位，請使用 CreateOrUpdate 方法

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

URI 參數

名稱	位於	必要	類型	Description
provisioningServiceName	path	True	string	要建立或更新的布建服務名稱。
resourceGroupName	path	True	string	資源群組標識碼。
subscriptionId	path	True	string	訂用帳戶識別碼。
api-version	query	True	string	API 的版本。

要求本文

名稱	類型	Description
tags	object	資源標籤

回應

名稱	類型	Description
200 OK	ProvisioningServiceDescription	布建服務已成功更新

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

DPSPatch

範例要求

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

範例回覆

狀態碼:: 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
  }
}

定義

名稱	Description
AccessRightsDescription	此金鑰擁有的許可權。
AllocationPolicy	此布建服務要使用的配置原則。
createdByType	建立資源的身分識別類型。
IotDpsPropertiesDescription	布建服務的服務特定屬性，包括密鑰、連結的 iot 中樞、目前狀態，以及系統產生的屬性，例如主機名和 idScope
IotDpsSku	Sku 名稱。
IotDpsSkuInfo	可能的布建服務 SKU 清單。
IotHubDefinitionDescription	IoT 中樞的描述。
IpFilterActionType	此規則所擷取之要求所需的動作。
IpFilterRule	布建服務的IP篩選規則。
IpFilterTargetType	此規則所擷取的要求目標。
PrivateEndpoint	私人端點連線的私人端點屬性
PrivateEndpointConnection	布建服務的私人端點連線
PrivateEndpointConnectionProperties	私人端點連線的屬性
PrivateLinkServiceConnectionState	私人端點連線的目前狀態
PrivateLinkServiceConnectionStatus	私人端點連線的狀態
ProvisioningServiceDescription	布建服務的描述。
PublicNetworkAccess	是否允許來自公用網路的要求
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]	共用存取金鑰的描述。
state	布建服務的目前狀態。
systemData	與建立和上次修改資源相關的元數據。
TagsResource	只有資源標籤的容器，允許使用者更新布建服務實例上的標記。

AccessRightsDescription

列舉型別

此金鑰擁有的許可權。

值	Description
DeviceConnect
EnrollmentRead
EnrollmentWrite
RegistrationStatusRead
RegistrationStatusWrite
ServiceConfig

AllocationPolicy

列舉型別

此布建服務要使用的配置原則。

值	Description
GeoLatency
Hashed
Static

createdByType

列舉型別

建立資源的身分識別類型。

值	Description
Application
Key
ManagedIdentity
User

IotDpsPropertiesDescription

Object

布建服務的服務特定屬性，包括密鑰、連結的 iot 中樞、目前狀態，以及系統產生的屬性，例如主機名和 idScope

名稱	類型	Description
allocationPolicy	AllocationPolicy	此布建服務要使用的配置原則。
authorizationPolicies	SharedAccessSignatureAuthorizationRule[AccessRightsDescription][]	布建服務的授權金鑰清單。
deviceProvisioningHostName	string	此布建服務的裝置端點。
enableDataResidency	boolean	選擇性。指出 DPS 實例是否已啟用 Data Residency，移除跨異地配對災害復原。
idScope	string	此布建服務的唯一標識符。
iotHubs	IotHubDefinitionDescription[]	與此布建服務相關聯的IoT中樞清單。
ipFilterRules	IpFilterRule[]	IP 篩選規則。
portalOperationsHostName	string	啟用此布建服務的 CORS 入口網站端點。
privateEndpointConnections	PrivateEndpointConnection[]	在此IotHub上建立的私人端點連線
provisioningState	string	布建服務的ARM布建狀態。
publicNetworkAccess	PublicNetworkAccess	是否允許來自公用網路的要求
serviceOperationsHostName	string	布建服務的服務端點。
state	state	布建服務的目前狀態。

IotDpsSku

列舉型別

Sku 名稱。

值	Description
S1

IotDpsSkuInfo

Object

可能的布建服務 SKU 清單。

名稱	類型	Description
capacity	integer (int64)	要布建的單位數目
name	IotDpsSku	Sku 名稱。
tier	string	布建服務的定價層名稱。

IotHubDefinitionDescription

Object

IoT 中樞的描述。

名稱	類型	Description
allocationWeight	integer (int32)	要套用至指定 iot h 的權數。
applyAllocationPolicy	boolean	旗標，用於套用allocationPolicy或不適用於指定的iot中樞。
connectionString	string	IoT 中樞的連接字串。
location	string	IoT 中樞的ARM區域。
name	string	IoT 中樞的主機名。

IpFilterActionType

列舉型別

此規則所擷取之要求所需的動作。

值	Description
Accept
Reject

IpFilterRule

Object

布建服務的IP篩選規則。

名稱	類型	Description
action	IpFilterActionType	此規則所擷取之要求所需的動作。
filterName	string	IP 篩選規則的名稱。
ipMask	string	字串，包含規則 CIDR 表示法中的IP位址範圍。
target	IpFilterTargetType	此規則所擷取的要求目標。

IpFilterTargetType

列舉型別

此規則所擷取的要求目標。

值	Description
all
deviceApi
serviceApi

PrivateEndpoint

Object

私人端點連線的私人端點屬性

名稱	類型	Description
id	string	資源標識碼。

PrivateEndpointConnection

Object

布建服務的私人端點連線

名稱	類型	Description
id	string	資源標識碼。
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	資源名稱。
properties	PrivateEndpointConnectionProperties	私人端點連線的屬性
systemData	systemData	與建立和上次修改資源相關的元數據。
type	string	資源類型。

PrivateEndpointConnectionProperties

Object

私人端點連線的屬性

名稱	類型	Description
privateEndpoint	PrivateEndpoint	私人端點連線的私人端點屬性
privateLinkServiceConnectionState	PrivateLinkServiceConnectionState	私人端點連線的目前狀態

PrivateLinkServiceConnectionState

Object

私人端點連線的目前狀態

名稱	類型	Description
actionsRequired	string	私人端點連線所需的動作
description	string	私人端點連線目前狀態的描述
status	PrivateLinkServiceConnectionStatus	私人端點連線的狀態

PrivateLinkServiceConnectionStatus

列舉型別

私人端點連線的狀態

值	Description
Approved
Disconnected
Pending
Rejected

ProvisioningServiceDescription

Object

布建服務的描述。

名稱	類型	Description
etag	string	不需要 Etag 欄位。如果在回應本文中提供，則也必須根據一般 ETag 慣例，以標頭的形式提供。
id	string	資源標識碼。
location	string	資源位置。
name	string pattern: ^(?![0-9]+$)(?!-)[a-zA-Z0-9-]{2,49}[a-zA-Z0-9]$	資源名稱。
properties	IotDpsPropertiesDescription	布建服務的服務特定屬性
resourcegroup	string	資源的資源群組。
sku	IotDpsSkuInfo	布建服務的 SKU 資訊。
subscriptionid	string	資源的訂用帳戶標識碼。
systemData	systemData	與建立和上次修改資源相關的元數據。
tags	object	資源標籤。
type	string	資源類型。

PublicNetworkAccess

列舉型別

是否允許來自公用網路的要求

值	Description
Disabled
Enabled

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

Object

共用存取金鑰的描述。

名稱	類型	Description
keyName	string	金鑰的名稱。
primaryKey	string	主要 SAS 金鑰值。
rights	AccessRightsDescription	此金鑰擁有的許可權。
secondaryKey	string	次要 SAS 金鑰值。

state

列舉型別

布建服務的目前狀態。

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

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳 (UTC) 。
createdBy	string	建立資源的身分識別。
createdByType	createdByType	建立資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳 (UTC)
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。

TagsResource

Object

只有資源標籤的容器，允許使用者更新布建服務實例上的標記。

名稱	類型	Description
tags	object	資源標籤

共用方式為

Iot Dps Resource - Update

URI 參數

要求本文

回應

安全性

azure_auth

範圍

範例

DPSPatch

範例要求

範例回覆

定義

AccessRightsDescription

AllocationPolicy

createdByType

IotDpsPropertiesDescription

IotDpsSku

IotDpsSkuInfo

IotHubDefinitionDescription

IpFilterActionType

IpFilterRule

IpFilterTargetType

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

PrivateLinkServiceConnectionStatus

ProvisioningServiceDescription

PublicNetworkAccess

SharedAccessSignatureAuthorizationRule[AccessRightsDescription]

state

systemData

TagsResource

其他資源