你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Iot Dps Resource - Update
更新现有预配服务的标记。 若要更新其他字段,请使用 CreateOrUpdate 方法
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/provisioningServices/{provisioningServiceName}?api-version=2018-01-22
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
provisioning
|
path | True |
string |
要创建或更新的预配服务的名称。 |
resource
|
path | True |
string |
资源组标识符。 |
subscription
|
path | True |
string |
订阅标识符。 |
api-version
|
query | True |
string |
API 的版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
tags |
object |
资源标记 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
预配服务已成功更新 |
安全性
azure_auth
Azure Active Directory OAuth2 流。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
DPSPatch
Sample Request
PATCH https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/provisioningServices/myFirstProvisioningService?api-version=2018-01-22
{
"tags": {
"foo": "bar"
}
}
Sample Response
{
"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"
},
"type": "Microsoft.Devices/ProvisioningServices",
"id": "/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/ProvisioningServices/myFirstProvisioningService",
"tags": {
"foo": "bar"
},
"sku": {
"name": "S1",
"tier": "Standard",
"capacity": 1
}
}
定义
名称 | 说明 |
---|---|
Access |
此密钥具有的权限。 |
Allocation |
此预配服务要使用的分配策略。 |
Iot |
预配服务的服务特定属性,包括密钥、链接的 IoT 中心、当前状态和系统生成的属性(如主机名和 idScope) |
Iot |
SKU 名称。 |
Iot |
可能的预配服务 SKU 列表。 |
Iot |
IoT 中心的说明。 |
Provisioning |
预配服务的说明。 |
Shared |
共享访问密钥的说明。 |
state |
预配服务的当前状态。 |
Tags |
仅保存资源的标记的容器,允许用户更新预配服务实例上的标记。 |
AccessRightsDescription
此密钥具有的权限。
名称 | 类型 | 说明 |
---|---|---|
DeviceConnect |
string |
|
EnrollmentRead |
string |
|
EnrollmentWrite |
string |
|
RegistrationStatusRead |
string |
|
RegistrationStatusWrite |
string |
|
ServiceConfig |
string |
AllocationPolicy
此预配服务要使用的分配策略。
名称 | 类型 | 说明 |
---|---|---|
GeoLatency |
string |
|
Hashed |
string |
|
Static |
string |
IotDpsPropertiesDescription
预配服务的服务特定属性,包括密钥、链接的 IoT 中心、当前状态和系统生成的属性(如主机名和 idScope)
名称 | 类型 | 说明 |
---|---|---|
allocationPolicy |
此预配服务要使用的分配策略。 |
|
authorizationPolicies |
Shared |
预配服务的授权密钥列表。 |
deviceProvisioningHostName |
string |
此预配服务的设备终结点。 |
idScope |
string |
此预配服务的唯一标识符。 |
iotHubs |
与此预配服务关联的 IoT 中心列表。 |
|
provisioningState |
string |
预配服务的 ARM 预配状态。 |
serviceOperationsHostName |
string |
用于预配服务的服务终结点。 |
state |
预配服务的当前状态。 |
IotDpsSku
SKU 名称。
名称 | 类型 | 说明 |
---|---|---|
S1 |
string |
IotDpsSkuInfo
可能的预配服务 SKU 列表。
名称 | 类型 | 说明 |
---|---|---|
capacity |
integer |
要预配的单位数 |
name |
SKU 名称。 |
|
tier |
string |
预配服务的定价层名称。 |
IotHubDefinitionDescription
IoT 中心的说明。
名称 | 类型 | 说明 |
---|---|---|
allocationWeight |
integer |
要应用于给定 iot h 的权重。 |
applyAllocationPolicy |
boolean |
用于为给定 iot 中心应用 allocationPolicy 或不应用的标志。 |
connectionString |
string |
连接字符串 og IoT 中心。 |
location |
string |
IoT 中心的 ARM 区域。 |
name |
string |
IoT 中心的主机名。 |
ProvisioningServiceDescription
预配服务的说明。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
Etag 字段 不 是必需的。 如果响应正文中提供了它,则还必须根据常规 ETag 约定将其作为标头提供。 |
id |
string |
资源标识符。 |
location |
string |
资源位置。 |
name |
string |
资源名称。 |
properties |
预配服务的服务特定属性 |
|
sku |
预配服务的 SKU 信息。 |
|
tags |
object |
资源标记。 |
type |
string |
资源类型。 |
SharedAccessSignatureAuthorizationRule[AccessRightsDescription]
共享访问密钥的说明。
名称 | 类型 | 说明 |
---|---|---|
keyName |
string |
密钥的名称。 |
primaryKey |
string |
主 SAS 密钥值。 |
rights |
此密钥具有的权限。 |
|
secondaryKey |
string |
辅助 SAS 密钥值。 |
state
预配服务的当前状态。
名称 | 类型 | 说明 |
---|---|---|
Activating |
string |
|
ActivationFailed |
string |
|
Active |
string |
|
Deleted |
string |
|
Deleting |
string |
|
DeletionFailed |
string |
|
FailingOver |
string |
|
FailoverFailed |
string |
|
Resuming |
string |
|
Suspended |
string |
|
Suspending |
string |
|
Transitioning |
string |
TagsResource
仅保存资源的标记的容器,允许用户更新预配服务实例上的标记。
名称 | 类型 | 说明 |
---|---|---|
tags |
object |
资源标记 |