다음을 통해 공유


Microsoft.Devices provisioningServices 2022-12-12

Bicep 리소스 정의

provisioningServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Devices/provisioningServices 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Devices/provisioningServices@2022-12-12' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'S1'
  }
  etag: 'string'
  properties: {
    allocationPolicy: 'string'
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    enableDataResidency: bool
    iotHubs: [
      {
        allocationWeight: int
        applyAllocationPolicy: bool
        connectionString: 'string'
        location: 'string'
      }
    ]
    ipFilterRules: [
      {
        action: 'string'
        filterName: 'string'
        ipMask: 'string'
        target: 'string'
      }
    ]
    portalOperationsHostName: 'string'
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    provisioningState: 'string'
    publicNetworkAccess: 'string'
    state: 'string'
  }
  resourcegroup: 'string'
  subscriptionid: 'string'
}

속성 값

provisioningServices

Name Description
name 리소스 이름 string(필수)

문자 제한: 3-64

유효한 문자:
영숫자 및 하이픈

영숫자로 끝납니다.
위치 리소스 위치입니다. string(필수)
tags 리소스 태그입니다. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 프로비저닝 서비스에 대한 SKU 정보입니다. IotDpsSkuInfo (필수)
etag Etag 필드는 필요하지 않습니다 . 응답 본문에 제공된 경우 일반 ETag 규칙에 따라 헤더로도 제공해야 합니다. 문자열
properties 프로비저닝 서비스에 대한 서비스별 속성 IotDpsPropertiesDescription (필수)
리소스 그룹 리소스의 리소스 그룹입니다. string
subscriptionid 리소스의 구독 ID입니다. 문자열

IotDpsPropertiesDescription

Name Description
allocationPolicy 이 프로비저닝 서비스에서 사용할 할당 정책입니다. 'GeoLatency'
'해시'
'Static'
authorizationPolicies 프로비저닝 서비스에 대한 권한 부여 키 목록입니다. SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
enableDataResidency 선택 사항입니다.
DPS instance Data Residency 사용하도록 설정되어 있는지를 나타내며 지역 쌍 간 재해 복구를 제거합니다.
bool
iotHubs 이 프로비저닝 서비스와 연결된 IoT Hub 목록입니다. IotHubDefinitionDescription[]
ipFilterRules IP 필터 규칙입니다. IpFilterRule[]
portalOperationsHostName 이 프로비저닝 서비스에 CORS를 사용하도록 설정하는 포털 엔드포인트입니다. string
privateEndpointConnections 이 IotHub에서 만든 프라이빗 엔드포인트 연결 PrivateEndpointConnection[]
provisioningState 프로비저닝 서비스의 ARM 프로비저닝 상태입니다. 문자열
publicNetworkAccess 공용 네트워크의 요청 허용 여부 'Disabled'
'Enabled'
state 프로비저닝 서비스의 현재 상태입니다. '활성화'
'ActivationFailed'
'활성'
'Deleted'
'삭제 중'
'DeletionFailed'
'FailOver'
'FailoverFailed'
'Resuming'
'일시 중단됨'
'일시 중단'
'전환'

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Name Description
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. 'DeviceConnect'
'EnrollmentRead'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig'(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. 'DeviceConnect'
'EnrollmentRead'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig'(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열

IotHubDefinitionDescription

Name Description
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 iot 허브에 대해 allocationPolicy를 적용하거나 적용하지 않는 플래그입니다. bool
connectionString IoT Hub의 연결 문자열입니다. string(필수)
위치 IoT Hub의 ARM 지역입니다. string(필수)

IpFilterRule

Name Description
action 이 규칙에서 캡처한 요청에 대해 원하는 작업입니다. '수락'
'Reject'(필수)
filterName IP 필터 규칙의 이름입니다. string(필수)
ipMask 규칙에 대한 CIDR 표기법의 IP 주소 범위를 포함하는 문자열입니다. string(필수)
대상 이 규칙에서 캡처한 요청의 대상입니다. 'all'
'deviceApi'
'serviceApi'

PrivateEndpointConnection

Name Description
properties 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties (필수)

PrivateEndpointConnectionProperties

Name Description
privateEndpoint 프라이빗 엔드포인트 연결의 프라이빗 엔드포인트 속성 PrivateEndpoint
privateLinkServiceConnectionState 프라이빗 엔드포인트 연결의 현재 상태 PrivateLinkServiceConnectionState (필수)

PrivateEndpoint

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

PrivateLinkServiceConnectionState

Name Description
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 문자열
description 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명 string(필수)
상태 프라이빗 엔드포인트 연결의 상태 '승인됨'
'연결 끊김'
'보류 중'
'거부됨'(필수)

IotDpsSkuInfo

Name Description
용량 프로비전할 단위 수 int
name Sku 이름입니다. 'S1'

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿 Description
IOT Hub 및 Ubuntu 에지 시뮬레이터 만들기

Azure에 배포
이 템플릿은 IOT Hub 및 Virtual Machine Ubuntu 에지 시뮬레이터를 만듭니다.
IoT Hub Device Provisioning Service 만들기

Azure에 배포
이 템플릿을 사용하면 IoT Hub와 IoT Hub Device Provisioning Service를 만들고 두 서비스를 함께 연결할 수 있습니다.

ARM 템플릿 리소스 정의

provisioningServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Devices/provisioningServices 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Devices/provisioningServices",
  "apiVersion": "2022-12-12",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "S1"
  },
  "etag": "string",
  "properties": {
    "allocationPolicy": "string",
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string",
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "enableDataResidency": "bool",
    "iotHubs": [
      {
        "allocationWeight": "int",
        "applyAllocationPolicy": "bool",
        "connectionString": "string",
        "location": "string"
      }
    ],
    "ipFilterRules": [
      {
        "action": "string",
        "filterName": "string",
        "ipMask": "string",
        "target": "string"
      }
    ],
    "portalOperationsHostName": "string",
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {},
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "provisioningState": "string",
    "publicNetworkAccess": "string",
    "state": "string"
  },
  "resourcegroup": "string",
  "subscriptionid": "string"
}

속성 값

provisioningServices

Name Description
형식 리소스 종류 'Microsoft.Devices/provisioningServices'
apiVersion 리소스 api 버전 '2022-12-12'
name 리소스 이름 string(필수)

문자 제한: 3-64

유효한 문자:
영숫자 및 하이픈

영숫자로 끝납니다.
위치 리소스 위치입니다. string(필수)
tags 리소스 태그입니다. 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
sku 프로비저닝 서비스에 대한 SKU 정보입니다. IotDpsSkuInfo (필수)
etag Etag 필드는 필요하지 않습니다 . 응답 본문에 제공된 경우 일반 ETag 규칙에 따라 헤더로도 제공해야 합니다. 문자열
properties 프로비저닝 서비스에 대한 서비스별 속성 IotDpsPropertiesDescription (필수)
리소스 그룹 리소스의 리소스 그룹입니다. 문자열
subscriptionid 리소스의 구독 ID입니다. 문자열

IotDpsPropertiesDescription

Name Description
allocationPolicy 이 프로비저닝 서비스에서 사용할 할당 정책입니다. 'GeoLatency'
'해시'
'Static'
authorizationPolicies 프로비저닝 서비스에 대한 권한 부여 키 목록입니다. SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
enableDataResidency 선택 사항입니다.
DPS instance Data Residency 사용하도록 설정되어 있는지를 나타내며 지역 쌍 간 재해 복구를 제거합니다.
bool
iotHubs 이 프로비저닝 서비스와 연결된 IoT Hub 목록입니다. IotHubDefinitionDescription[]
ipFilterRules IP 필터 규칙입니다. IpFilterRule[]
portalOperationsHostName 이 프로비저닝 서비스에 CORS를 사용하도록 설정하는 포털 엔드포인트입니다. 문자열
privateEndpointConnections 이 IotHub에서 만든 프라이빗 엔드포인트 연결 PrivateEndpointConnection[]
provisioningState 프로비저닝 서비스의 ARM 프로비저닝 상태입니다. 문자열
publicNetworkAccess 공용 네트워크의 요청 허용 여부 '사용 안 함'
'사용'
state 프로비전 서비스의 현재 상태입니다. '활성화'
'ActivationFailed'
'활성'
'Deleted'
'삭제 중'
'DeletionFailed'
'FailOver'
'FailoverFailed'
'Resuming'
'일시 중단됨'
'일시 중단'
'전환'

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Name Description
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. 'DeviceConnect'
'EnrollmentRead'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig'(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. 'DeviceConnect'
'EnrollmentRead'
'EnrollmentWrite'
'RegistrationStatusRead'
'RegistrationStatusWrite'
'ServiceConfig'(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열

IotHubDefinitionDescription

Name Description
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 iot 허브에 대해 allocationPolicy를 적용하기 위한 플래그입니다. bool
connectionString IoT Hub의 연결 문자열입니다. string(필수)
위치 IoT Hub의 ARM 지역입니다. string(필수)

IpFilterRule

Name Description
action 이 규칙에서 캡처한 요청에 대해 원하는 작업입니다. '수락'
'Reject'(필수)
filterName IP 필터 규칙의 이름입니다. string(필수)
ipMask 규칙에 대한 CIDR 표기법의 IP 주소 범위를 포함하는 문자열입니다. string(필수)
대상 이 규칙에서 캡처한 요청의 대상입니다. 'all'
'deviceApi'
'serviceApi'

PrivateEndpointConnection

Name Description
properties 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties (필수)

PrivateEndpointConnectionProperties

Name Description
privateEndpoint 프라이빗 엔드포인트 연결의 프라이빗 엔드포인트 속성 PrivateEndpoint
privateLinkServiceConnectionState 프라이빗 엔드포인트 연결의 현재 상태 PrivateLinkServiceConnectionState (필수)

PrivateEndpoint

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

PrivateLinkServiceConnectionState

Name Description
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 string
description 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명 string(필수)
상태 프라이빗 엔드포인트 연결의 상태 '승인됨'
'연결 끊김'
'보류 중'
'거부됨'(필수)

IotDpsSkuInfo

Name Description
용량 프로비전할 단위 수 int
name Sku 이름입니다. 'S1'

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플릿 Description
IOT Hub 및 Ubuntu 에지 시뮬레이터 만들기

Azure에 배포
이 템플릿은 IOT Hub 및 Virtual Machine Ubuntu 에지 시뮬레이터를 만듭니다.
IoT Hub Device Provisioning Service 만들기

Azure에 배포
이 템플릿을 사용하면 IoT Hub와 IoT Hub Device Provisioning Service를 만들고 두 서비스를 함께 연결할 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

provisioningServices 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Devices/provisioningServices 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Devices/provisioningServices@2022-12-12"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      allocationPolicy = "string"
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      enableDataResidency = bool
      iotHubs = [
        {
          allocationWeight = int
          applyAllocationPolicy = bool
          connectionString = "string"
          location = "string"
        }
      ]
      ipFilterRules = [
        {
          action = "string"
          filterName = "string"
          ipMask = "string"
          target = "string"
        }
      ]
      portalOperationsHostName = "string"
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {}
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      provisioningState = "string"
      publicNetworkAccess = "string"
      state = "string"
    }
    resourcegroup = "string"
    subscriptionid = "string"
    sku = {
      capacity = int
      name = "S1"
    }
    etag = "string"
  })
}

속성 값

provisioningServices

Name Description
형식 리소스 종류 "Microsoft.Devices/provisioningServices@2022-12-12"
name 리소스 이름 string(필수)

문자 제한: 3-64

유효한 문자:
영숫자 및 하이픈

영숫자로 끝납니다.
위치 리소스 위치입니다. string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
tags 리소스 태그입니다. 태그 이름 및 값의 사전입니다.
sku 프로비저닝 서비스에 대한 Sku 정보입니다. IotDpsSkuInfo (필수)
etag Etag 필드는 필요하지 않습니다 . 응답 본문에 제공된 경우 일반적인 ETag 규칙에 따라 헤더로도 제공해야 합니다. 문자열
properties 프로비저닝 서비스에 대한 서비스별 속성 IotDpsPropertiesDescription (필수)
리소스 그룹 리소스의 리소스 그룹입니다. 문자열
subscriptionid 리소스의 구독 ID입니다. string

IotDpsPropertiesDescription

Name Description
allocationPolicy 이 프로비저닝 서비스에서 사용할 할당 정책입니다. "GeoLatency"
"해시됨"
"Static"
authorizationPolicies 프로비저닝 서비스에 대한 권한 부여 키 목록입니다. SharedAccessSignatureAuthorizationRuleAccessRightsDe...[]
enableDataResidency 선택 사항입니다.
DPS instance Data Residency 사용하도록 설정되어 있는지를 나타내며 지역 쌍 간 재해 복구를 제거합니다.
bool
iotHubs 이 프로비저닝 서비스와 연결된 IoT Hub 목록입니다. IotHubDefinitionDescription[]
ipFilterRules IP 필터 규칙입니다. IpFilterRule[]
portalOperationsHostName 이 프로비저닝 서비스에 CORS를 사용하도록 설정하는 포털 엔드포인트입니다. 문자열
privateEndpointConnections 이 IotHub에서 만든 프라이빗 엔드포인트 연결 PrivateEndpointConnection[]
provisioningState 프로비저닝 서비스의 ARM 프로비저닝 상태입니다. 문자열
publicNetworkAccess 공용 네트워크의 요청 허용 여부 "사용 안 함"
"사용"
state 프로비저닝 서비스의 현재 상태입니다. "활성화 중"
"ActivationFailed"
"활성"
"삭제됨"
"삭제 중"
"DeletionFailed"
"FailOver"
"FailoverFailed"
"다시 열거 중"
"일시 중단됨"
"일시 중단"
"전환 중"

SharedAccessSignatureAuthorizationRuleAccessRightsDe...

Name Description
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. "DeviceConnect"
"EnrollmentRead"
"EnrollmentWrite"
"RegistrationStatusRead"
"RegistrationStatusWrite"
"ServiceConfig"(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열
keyName 키 이름입니다. string(필수)
primaryKey 기본 SAS 키 값입니다. string
권한 이 키에 있는 권한입니다. "DeviceConnect"
"EnrollmentRead"
"EnrollmentWrite"
"RegistrationStatusRead"
"RegistrationStatusWrite"
"ServiceConfig"(필수)
secondaryKey 보조 SAS 키 값입니다. 문자열

IotHubDefinitionDescription

Name Description
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 iot 허브에 대해 allocationPolicy를 적용하거나 적용하지 않는 플래그입니다. bool
connectionString IoT Hub의 연결 문자열입니다. string(필수)
위치 IoT Hub의 ARM 지역입니다. string(필수)

IpFilterRule

Name Description
action 이 규칙에서 캡처한 요청에 대해 원하는 작업입니다. "수락"
"거부"(필수)
filterName IP 필터 규칙의 이름입니다. string(필수)
ipMask 규칙에 대한 CIDR 표기법의 IP 주소 범위를 포함하는 문자열입니다. string(필수)
대상 이 규칙에서 캡처한 요청의 대상입니다. "all"
"deviceApi"
"serviceApi"

PrivateEndpointConnection

Name Description
properties 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties (필수)

PrivateEndpointConnectionProperties

Name Description
privateEndpoint 프라이빗 엔드포인트 연결의 프라이빗 엔드포인트 속성 PrivateEndpoint
privateLinkServiceConnectionState 프라이빗 엔드포인트 연결의 현재 상태 PrivateLinkServiceConnectionState (필수)

PrivateEndpoint

이 개체에는 배포 중에 설정할 속성이 포함되어 있지 않습니다. 모든 속성은 ReadOnly입니다.

PrivateLinkServiceConnectionState

Name Description
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 문자열
description 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명 string(필수)
상태 프라이빗 엔드포인트 연결의 상태 "승인됨"
"연결 끊김"
"보류 중"
"거부됨"(필수)

IotDpsSkuInfo

Name Description
용량 프로비전할 단위 수 int
name Sku 이름입니다. "S1"