Microsoft.Devices provisioningServices 2020-09-01-preview
Bicep リソース定義
provisioningServices リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Devices/provisioningServices リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.Devices/provisioningServices@2020-09-01-preview' = {
etag: 'string'
identity: {
identityType: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
allocationPolicy: 'string'
authorizationPolicies: [
{
keyName: 'string'
primaryKey: 'string'
rights: 'string'
secondaryKey: 'string'
}
]
encryption: {
identity: {
userAssignedIdentity: 'string'
}
keySource: 'string'
keyVaultProperties: [
{
keyIdentifier: 'string'
}
]
}
iotHubs: [
{
allocationWeight: int
applyAllocationPolicy: bool
connectionString: 'string'
location: 'string'
}
]
ipFilterRules: [
{
action: 'string'
filterName: 'string'
ipMask: 'string'
target: 'string'
}
]
privateEndpointConnections: [
{
properties: {
privateEndpoint: {}
privateLinkServiceConnectionState: {
actionsRequired: 'string'
description: 'string'
status: 'string'
}
}
}
]
provisioningState: 'string'
publicNetworkAccess: 'string'
state: 'string'
}
sku: {
capacity: int
name: 'string'
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
ArmIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| identityType | ID の種類。 使用可能な値は、SystemAssigned と UserAssigned のみです。 例: SystemAssigned、UserAssigned の両方の場合はコンマ区切り。 | 糸 |
| userAssignedIdentities | IoT DPS リソースに関連付けられている UserAssigned ID のセット。 | armIdentityUserAssignedIdentities の |
ArmIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
ArmUserIdentity
| 名前 | 形容 | 価値 |
|---|
EncryptionKeyIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| userAssignedIdentity | ユーザー割り当て ID。 | 糸 |
EncryptionPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| 同一性 | KeyVault の暗号化キーへのアクセスに使用される ID。 | EncryptionKeyIdentity |
| keySource | 暗号化キーのソース。 通常、Microsoft.KeyVault | 糸 |
| keyVaultProperties | KeyVault で構成された暗号化キーのプロパティ。 | KeyVaultKeyProperties[] |
IotDpsPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationPolicy | このプロビジョニング サービスで使用される割り当てポリシー。 | 'GeoLatency' 'Hashed' 'Static' |
| authorizationPolicies | プロビジョニング サービスの承認キーの一覧。 | SharedAccessSignatureAuthorizationRuleAccessRightsDescription[] |
| 暗号化 | IoT DPS インスタンスの暗号化プロパティ。 | EncryptionPropertiesDescription |
| iotHubs | このプロビジョニング サービスに関連付けられている IoT ハブの一覧。 | IotHubDefinitionDescription[] |
| ipFilterRules | IP フィルター規則。 | IpFilterRule[] |
| privateEndpointConnections | この IotHub で作成されたプライベート エンドポイント接続 | PrivateEndpointConnection[] |
| provisioningState | プロビジョニング サービスの ARM プロビジョニング状態。 | 糸 |
| publicNetworkAccess | パブリック ネットワークからの要求が許可されるかどうか | 'Disabled' 'Enabled' |
| 状態 | プロビジョニング サービスの現在の状態。 | 'アクティブ化中' 'ActivationFailed' 'Active' 'Deleted' '削除中' 'DeletionFailed' 'FailingOver' 'FailoverFailed' 'Resuming' 'Suspended' 'Suspending' 'Transitioning' |
IotDpsSkuInfo
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | プロビジョニングするユニット数 | int |
| 名前 | SKU 名。 | 'S1' |
IotHubDefinitionDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationWeight | 特定の IoT h に適用する重み。 | int |
| applyAllocationPolicy | 特定の IoT ハブに対して allocationPolicy を適用するかどうかを示すフラグ。 | bool |
| connectionString | IoT ハブの接続文字列。 | string (必須) |
| 場所 | IoT ハブの ARM リージョン。 | string (必須) |
IpFilterRule
| 名前 | 形容 | 価値 |
|---|---|---|
| アクション | このルールによってキャプチャされた要求に対して必要なアクション。 | 'Accept' 'Reject' (必須) |
| filterName | IP フィルター規則の名前。 | string (必須) |
| ipMask | 規則の IP アドレス範囲を CIDR 表記で含む文字列。 | string (必須) |
| ターゲット | このルールによってキャプチャされた要求のターゲット。 | 'all' 'deviceApi' 'serviceApi' |
KeyVaultKeyProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| keyIdentifier | キーの識別子。 | 糸 |
Microsoft.Devices/provisioningServices
| 名前 | 形容 | 価値 |
|---|---|---|
| etag | Etag フィールドは 必要ありません。 応答本文で指定する場合は、通常の ETag 規則に従ってヘッダーとしても指定する必要があります。 | 糸 |
| 同一性 | IotDps インスタンスのマネージド ID。 | armIdentity の |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| プロパティ | プロビジョニング サービスのサービス固有のプロパティ | IotDpsPropertiesDescription (必須) |
| sku | プロビジョニング サービスの SKU 情報。 | IotDpsSkuInfo (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
PrivateEndpoint
| 名前 | 形容 | 価値 |
|---|
PrivateEndpointConnection
| 名前 | 形容 | 価値 |
|---|---|---|
| プロパティ | プライベート エンドポイント接続のプロパティ | PrivateEndpointConnectionProperties (必須) |
PrivateEndpointConnectionProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| privateEndpoint | プライベート エンドポイント接続のプライベート エンドポイント プロパティ | PrivateEndpoint を |
| privateLinkServiceConnectionState | プライベート エンドポイント接続の現在の状態 | PrivateLinkServiceConnectionState (必須) |
PrivateLinkServiceConnectionState
| 名前 | 形容 | 価値 |
|---|---|---|
| actionsRequired | プライベート エンドポイント接続に必要なアクション | 糸 |
| 形容 | プライベート エンドポイント接続の現在の状態の説明 | string (必須) |
| 地位 | プライベート エンドポイント接続の状態 | 'Approved' 'Disconnected' 'Pending' 'Rejected' (必須) |
ResourceTags
| 名前 | 形容 | 価値 |
|---|
SharedAccessSignatureAuthorizationRuleAccessRightsDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| keyName | キーの名前。 | string (必須) |
| primaryKey | プライマリ SAS キーの値。 | 糸 |
| 権利 | このキーが持つ権限。 | 'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (必須) |
| secondaryKey | セカンダリ SAS キー値。 | 糸 |
クイック スタートのサンプル
次のクイック スタート サンプルでは、このリソースの種類をデプロイします。
| Bicep ファイル | 形容 |
|---|---|
| IoT Hub Device Provisioning Service を作成する | このテンプレートを使用すると、IoT ハブと IoT Hub Device Provisioning Service を作成し、2 つのサービスをリンクできます。 |
ARM テンプレート リソース定義
provisioningServices リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Devices/provisioningServices リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.Devices/provisioningServices",
"apiVersion": "2020-09-01-preview",
"name": "string",
"etag": "string",
"identity": {
"identityType": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"allocationPolicy": "string",
"authorizationPolicies": [
{
"keyName": "string",
"primaryKey": "string",
"rights": "string",
"secondaryKey": "string"
}
],
"encryption": {
"identity": {
"userAssignedIdentity": "string"
},
"keySource": "string",
"keyVaultProperties": [
{
"keyIdentifier": "string"
}
]
},
"iotHubs": [
{
"allocationWeight": "int",
"applyAllocationPolicy": "bool",
"connectionString": "string",
"location": "string"
}
],
"ipFilterRules": [
{
"action": "string",
"filterName": "string",
"ipMask": "string",
"target": "string"
}
],
"privateEndpointConnections": [
{
"properties": {
"privateEndpoint": {
},
"privateLinkServiceConnectionState": {
"actionsRequired": "string",
"description": "string",
"status": "string"
}
}
}
],
"provisioningState": "string",
"publicNetworkAccess": "string",
"state": "string"
},
"sku": {
"capacity": "int",
"name": "string"
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
ArmIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| identityType | ID の種類。 使用可能な値は、SystemAssigned と UserAssigned のみです。 例: SystemAssigned、UserAssigned の両方の場合はコンマ区切り。 | 糸 |
| userAssignedIdentities | IoT DPS リソースに関連付けられている UserAssigned ID のセット。 | armIdentityUserAssignedIdentities の |
ArmIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
ArmUserIdentity
| 名前 | 形容 | 価値 |
|---|
EncryptionKeyIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| userAssignedIdentity | ユーザー割り当て ID。 | 糸 |
EncryptionPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| 同一性 | KeyVault の暗号化キーへのアクセスに使用される ID。 | EncryptionKeyIdentity |
| keySource | 暗号化キーのソース。 通常、Microsoft.KeyVault | 糸 |
| keyVaultProperties | KeyVault で構成された暗号化キーのプロパティ。 | KeyVaultKeyProperties[] |
IotDpsPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationPolicy | このプロビジョニング サービスで使用される割り当てポリシー。 | 'GeoLatency' 'Hashed' 'Static' |
| authorizationPolicies | プロビジョニング サービスの承認キーの一覧。 | SharedAccessSignatureAuthorizationRuleAccessRightsDescription[] |
| 暗号化 | IoT DPS インスタンスの暗号化プロパティ。 | EncryptionPropertiesDescription |
| iotHubs | このプロビジョニング サービスに関連付けられている IoT ハブの一覧。 | IotHubDefinitionDescription[] |
| ipFilterRules | IP フィルター規則。 | IpFilterRule[] |
| privateEndpointConnections | この IotHub で作成されたプライベート エンドポイント接続 | PrivateEndpointConnection[] |
| provisioningState | プロビジョニング サービスの ARM プロビジョニング状態。 | 糸 |
| publicNetworkAccess | パブリック ネットワークからの要求が許可されるかどうか | 'Disabled' 'Enabled' |
| 状態 | プロビジョニング サービスの現在の状態。 | 'アクティブ化中' 'ActivationFailed' 'Active' 'Deleted' '削除中' 'DeletionFailed' 'FailingOver' 'FailoverFailed' 'Resuming' 'Suspended' 'Suspending' 'Transitioning' |
IotDpsSkuInfo
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | プロビジョニングするユニット数 | int |
| 名前 | SKU 名。 | 'S1' |
IotHubDefinitionDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationWeight | 特定の IoT h に適用する重み。 | int |
| applyAllocationPolicy | 特定の IoT ハブに対して allocationPolicy を適用するかどうかを示すフラグ。 | bool |
| connectionString | IoT ハブの接続文字列。 | string (必須) |
| 場所 | IoT ハブの ARM リージョン。 | string (必須) |
IpFilterRule
| 名前 | 形容 | 価値 |
|---|---|---|
| アクション | このルールによってキャプチャされた要求に対して必要なアクション。 | 'Accept' 'Reject' (必須) |
| filterName | IP フィルター規則の名前。 | string (必須) |
| ipMask | 規則の IP アドレス範囲を CIDR 表記で含む文字列。 | string (必須) |
| ターゲット | このルールによってキャプチャされた要求のターゲット。 | 'all' 'deviceApi' 'serviceApi' |
KeyVaultKeyProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| keyIdentifier | キーの識別子。 | 糸 |
Microsoft.Devices/provisioningServices
| 名前 | 形容 | 価値 |
|---|---|---|
| apiVersion | API のバージョン | '2020-09-01-preview' |
| etag | Etag フィールドは 必要ありません。 応答本文で指定する場合は、通常の ETag 規則に従ってヘッダーとしても指定する必要があります。 | 糸 |
| 同一性 | IotDps インスタンスのマネージド ID。 | armIdentity の |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| プロパティ | プロビジョニング サービスのサービス固有のプロパティ | IotDpsPropertiesDescription (必須) |
| sku | プロビジョニング サービスの SKU 情報。 | IotDpsSkuInfo (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
| 種類 | リソースの種類 | 'Microsoft.Devices/provisioningServices' |
PrivateEndpoint
| 名前 | 形容 | 価値 |
|---|
PrivateEndpointConnection
| 名前 | 形容 | 価値 |
|---|---|---|
| プロパティ | プライベート エンドポイント接続のプロパティ | PrivateEndpointConnectionProperties (必須) |
PrivateEndpointConnectionProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| privateEndpoint | プライベート エンドポイント接続のプライベート エンドポイント プロパティ | PrivateEndpoint を |
| privateLinkServiceConnectionState | プライベート エンドポイント接続の現在の状態 | PrivateLinkServiceConnectionState (必須) |
PrivateLinkServiceConnectionState
| 名前 | 形容 | 価値 |
|---|---|---|
| actionsRequired | プライベート エンドポイント接続に必要なアクション | 糸 |
| 形容 | プライベート エンドポイント接続の現在の状態の説明 | string (必須) |
| 地位 | プライベート エンドポイント接続の状態 | 'Approved' 'Disconnected' 'Pending' 'Rejected' (必須) |
ResourceTags
| 名前 | 形容 | 価値 |
|---|
SharedAccessSignatureAuthorizationRuleAccessRightsDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| keyName | キーの名前。 | string (必須) |
| primaryKey | プライマリ SAS キーの値。 | 糸 |
| 権利 | このキーが持つ権限。 | 'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (必須) |
| secondaryKey | セカンダリ SAS キー値。 | 糸 |
クイック スタート テンプレート
次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。
| テンプレート | 形容 |
|---|---|
|
IoT Hub と Ubuntu エッジ シミュレーター を作成する Azure にデプロイする |
このテンプレートでは、IOT ハブと仮想マシン Ubuntu エッジ シミュレーターが作成されます。 |
|
IoT Hub Device Provisioning Service を作成する Azure にデプロイする |
このテンプレートを使用すると、IoT ハブと IoT Hub Device Provisioning Service を作成し、2 つのサービスをリンクできます。 |
Terraform (AzAPI プロバイダー) リソース定義
provisioningServices リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.Devices/provisioningServices リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Devices/provisioningServices@2020-09-01-preview"
name = "string"
etag = "string"
identity = {
identityType = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
body = jsonencode({
properties = {
allocationPolicy = "string"
authorizationPolicies = [
{
keyName = "string"
primaryKey = "string"
rights = "string"
secondaryKey = "string"
}
]
encryption = {
identity = {
userAssignedIdentity = "string"
}
keySource = "string"
keyVaultProperties = [
{
keyIdentifier = "string"
}
]
}
iotHubs = [
{
allocationWeight = int
applyAllocationPolicy = bool
connectionString = "string"
location = "string"
}
]
ipFilterRules = [
{
action = "string"
filterName = "string"
ipMask = "string"
target = "string"
}
]
privateEndpointConnections = [
{
properties = {
privateEndpoint = {
}
privateLinkServiceConnectionState = {
actionsRequired = "string"
description = "string"
status = "string"
}
}
}
]
provisioningState = "string"
publicNetworkAccess = "string"
state = "string"
}
})
sku = {
capacity = int
name = "string"
}
tags = {
{customized property} = "string"
}
}
プロパティ値
ArmIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| identityType | ID の種類。 使用可能な値は、SystemAssigned と UserAssigned のみです。 例: SystemAssigned、UserAssigned の両方の場合はコンマ区切り。 | 糸 |
| userAssignedIdentities | IoT DPS リソースに関連付けられている UserAssigned ID のセット。 | armIdentityUserAssignedIdentities の |
ArmIdentityUserAssignedIdentities
| 名前 | 形容 | 価値 |
|---|
ArmUserIdentity
| 名前 | 形容 | 価値 |
|---|
EncryptionKeyIdentity
| 名前 | 形容 | 価値 |
|---|---|---|
| userAssignedIdentity | ユーザー割り当て ID。 | 糸 |
EncryptionPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| 同一性 | KeyVault の暗号化キーへのアクセスに使用される ID。 | EncryptionKeyIdentity |
| keySource | 暗号化キーのソース。 通常、Microsoft.KeyVault | 糸 |
| keyVaultProperties | KeyVault で構成された暗号化キーのプロパティ。 | KeyVaultKeyProperties[] |
IotDpsPropertiesDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationPolicy | このプロビジョニング サービスで使用される割り当てポリシー。 | 'GeoLatency' 'Hashed' 'Static' |
| authorizationPolicies | プロビジョニング サービスの承認キーの一覧。 | SharedAccessSignatureAuthorizationRuleAccessRightsDescription[] |
| 暗号化 | IoT DPS インスタンスの暗号化プロパティ。 | EncryptionPropertiesDescription |
| iotHubs | このプロビジョニング サービスに関連付けられている IoT ハブの一覧。 | IotHubDefinitionDescription[] |
| ipFilterRules | IP フィルター規則。 | IpFilterRule[] |
| privateEndpointConnections | この IotHub で作成されたプライベート エンドポイント接続 | PrivateEndpointConnection[] |
| provisioningState | プロビジョニング サービスの ARM プロビジョニング状態。 | 糸 |
| publicNetworkAccess | パブリック ネットワークからの要求が許可されるかどうか | 'Disabled' 'Enabled' |
| 状態 | プロビジョニング サービスの現在の状態。 | 'アクティブ化中' 'ActivationFailed' 'Active' 'Deleted' '削除中' 'DeletionFailed' 'FailingOver' 'FailoverFailed' 'Resuming' 'Suspended' 'Suspending' 'Transitioning' |
IotDpsSkuInfo
| 名前 | 形容 | 価値 |
|---|---|---|
| 能力 | プロビジョニングするユニット数 | int |
| 名前 | SKU 名。 | 'S1' |
IotHubDefinitionDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| allocationWeight | 特定の IoT h に適用する重み。 | int |
| applyAllocationPolicy | 特定の IoT ハブに対して allocationPolicy を適用するかどうかを示すフラグ。 | bool |
| connectionString | IoT ハブの接続文字列。 | string (必須) |
| 場所 | IoT ハブの ARM リージョン。 | string (必須) |
IpFilterRule
| 名前 | 形容 | 価値 |
|---|---|---|
| アクション | このルールによってキャプチャされた要求に対して必要なアクション。 | 'Accept' 'Reject' (必須) |
| filterName | IP フィルター規則の名前。 | string (必須) |
| ipMask | 規則の IP アドレス範囲を CIDR 表記で含む文字列。 | string (必須) |
| ターゲット | このルールによってキャプチャされた要求のターゲット。 | 'all' 'deviceApi' 'serviceApi' |
KeyVaultKeyProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| keyIdentifier | キーの識別子。 | 糸 |
Microsoft.Devices/provisioningServices
| 名前 | 形容 | 価値 |
|---|---|---|
| etag | Etag フィールドは 必要ありません。 応答本文で指定する場合は、通常の ETag 規則に従ってヘッダーとしても指定する必要があります。 | 糸 |
| 同一性 | IotDps インスタンスのマネージド ID。 | armIdentity の |
| 場所 | リソースの場所。 | string (必須) |
| 名前 | リソース名 | string (必須) |
| プロパティ | プロビジョニング サービスのサービス固有のプロパティ | IotDpsPropertiesDescription (必須) |
| sku | プロビジョニング サービスの SKU 情報。 | IotDpsSkuInfo (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 |
| 種類 | リソースの種類 | "Microsoft.Devices/provisioningServices@2020-09-01-preview" |
PrivateEndpoint
| 名前 | 形容 | 価値 |
|---|
PrivateEndpointConnection
| 名前 | 形容 | 価値 |
|---|---|---|
| プロパティ | プライベート エンドポイント接続のプロパティ | PrivateEndpointConnectionProperties (必須) |
PrivateEndpointConnectionProperties
| 名前 | 形容 | 価値 |
|---|---|---|
| privateEndpoint | プライベート エンドポイント接続のプライベート エンドポイント プロパティ | PrivateEndpoint を |
| privateLinkServiceConnectionState | プライベート エンドポイント接続の現在の状態 | PrivateLinkServiceConnectionState (必須) |
PrivateLinkServiceConnectionState
| 名前 | 形容 | 価値 |
|---|---|---|
| actionsRequired | プライベート エンドポイント接続に必要なアクション | 糸 |
| 形容 | プライベート エンドポイント接続の現在の状態の説明 | string (必須) |
| 地位 | プライベート エンドポイント接続の状態 | 'Approved' 'Disconnected' 'Pending' 'Rejected' (必須) |
ResourceTags
| 名前 | 形容 | 価値 |
|---|
SharedAccessSignatureAuthorizationRuleAccessRightsDescription
| 名前 | 形容 | 価値 |
|---|---|---|
| keyName | キーの名前。 | string (必須) |
| primaryKey | プライマリ SAS キーの値。 | 糸 |
| 権利 | このキーが持つ権限。 | 'DeviceConnect' 'EnrollmentRead' 'EnrollmentWrite' 'RegistrationStatusRead' 'RegistrationStatusWrite' 'ServiceConfig' (必須) |
| secondaryKey | セカンダリ SAS キー値。 | 糸 |