다음을 통해 공유

Microsoft.Devices provisioningServices

  • 아티클

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Devices/provisioningServices@2025-02-01-preview' = {
  etag: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    allocationPolicy: 'string'
    authorizationPolicies: [
      {
        keyName: 'string'
        primaryKey: 'string'
        rights: 'string'
        secondaryKey: 'string'
      }
    ]
    enableDataResidency: bool
    iotHubs: [
      {
        allocationWeight: int
        applyAllocationPolicy: bool
        authenticationType: 'string'
        connectionString: 'string'
        location: 'string'
        selectedUserAssignedIdentityResourceId: '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'
  sku: {
    capacity: int
    name: 'string'
  }
  subscriptionid: 'string'
  tags: {
    {customized property}: 'string'
  }
}

속성 값

IotDpsPropertiesDescription

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

IotDpsSkuInfo

이름 묘사 값
용량 프로비전할 단위 수 int
이름 Sku 이름입니다. 'S1'

IotHubDefinitionDescription

이름 묘사 값
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 IoT 허브에 대해 allocationPolicy를 적용하거나 적용하지 않는 플래그입니다. bool
authenticationType IotHub MI 인증 유형: KeyBased, UserAssigned, SystemAssigned. 'KeyBased'
'SystemAssigned'
'UserAssigned'
connectionString IoT Hub의 연결 문자열입니다. 문자열
위치 IoT Hub의 ARM 지역입니다. string(필수)
selectedUserAssignedIdentityResourceId IoT Hub와 연결된 선택한 사용자 할당 ID 리소스 ID입니다. authenticationType이 UserAssigned인 경우 이 작업이 필요합니다. 문자열

IpFilterRule

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

ManagedServiceIdentity

이름 묘사 값
형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

Microsoft.Devices/provisioningServices

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

PrivateEndpoint

이름 묘사 값

PrivateEndpointConnection

이름 묘사 값
속성 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties(필수)

PrivateEndpointConnectionProperties

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

PrivateLinkServiceConnectionState

이름 묘사 값
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 문자열
묘사 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명입니다. string(필수)
상태 프라이빗 엔드포인트 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'Rejected'(필수)

ResourceTags

이름 묘사 값

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

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

UserAssignedIdentities

이름 묘사 값

UserAssignedIdentity

이름 묘사 값

빠른 시작 샘플

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

Bicep 파일 묘사
IoT Hub Device Provisioning Service 만들기 이 템플릿을 사용하면 IoT Hub 및 IoT Hub Device Provisioning Service를 만들고 두 서비스를 함께 연결할 수 있습니다.

ARM 템플릿 리소스 정의

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

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

리소스 형식

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

{
  "type": "Microsoft.Devices/provisioningServices",
  "apiVersion": "2025-02-01-preview",
  "name": "string",
  "etag": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "allocationPolicy": "string",
    "authorizationPolicies": [
      {
        "keyName": "string",
        "primaryKey": "string",
        "rights": "string",
        "secondaryKey": "string"
      }
    ],
    "enableDataResidency": "bool",
    "iotHubs": [
      {
        "allocationWeight": "int",
        "applyAllocationPolicy": "bool",
        "authenticationType": "string",
        "connectionString": "string",
        "location": "string",
        "selectedUserAssignedIdentityResourceId": "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",
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "subscriptionid": "string",
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

IotDpsPropertiesDescription

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

IotDpsSkuInfo

이름 묘사 값
용량 프로비전할 단위 수 int
이름 Sku 이름입니다. 'S1'

IotHubDefinitionDescription

이름 묘사 값
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 IoT 허브에 대해 allocationPolicy를 적용하거나 적용하지 않는 플래그입니다. bool
authenticationType IotHub MI 인증 유형: KeyBased, UserAssigned, SystemAssigned. 'KeyBased'
'SystemAssigned'
'UserAssigned'
connectionString IoT Hub의 연결 문자열입니다. 문자열
위치 IoT Hub의 ARM 지역입니다. string(필수)
selectedUserAssignedIdentityResourceId IoT Hub와 연결된 선택한 사용자 할당 ID 리소스 ID입니다. authenticationType이 UserAssigned인 경우 이 작업이 필요합니다. 문자열

IpFilterRule

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

ManagedServiceIdentity

이름 묘사 값
형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

Microsoft.Devices/provisioningServices

이름 묘사 값
apiVersion api 버전 '2025-02-01-preview'
etag Etag 필드가 필요하지 . 응답 본문에 제공된 경우 일반 ETag 규칙에 따라 헤더로도 제공해야 합니다. 문자열
신원 프로비저닝 서비스에 대한 관리 ID입니다. ManagedServiceIdentity
위치 리소스 위치입니다. string(필수)
이름 리소스 이름 string(필수)
속성 프로비저닝 서비스에 대한 서비스별 속성 IotDpsPropertiesDescription(필수)
리소스 그룹 리소스의 리소스 그룹입니다. 문자열
sku 프로비저닝 서비스에 대한 SKU 정보입니다. IotDpsSkuInfo (필수)
subscriptionid 리소스의 구독 ID입니다. 문자열
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.Devices/provisioningServices'

PrivateEndpoint

이름 묘사 값

PrivateEndpointConnection

이름 묘사 값
속성 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties(필수)

PrivateEndpointConnectionProperties

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

PrivateLinkServiceConnectionState

이름 묘사 값
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 문자열
묘사 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명입니다. string(필수)
상태 프라이빗 엔드포인트 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'Rejected'(필수)

ResourceTags

이름 묘사 값

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

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

UserAssignedIdentities

이름 묘사 값

UserAssignedIdentity

이름 묘사 값

빠른 시작 템플릿

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

템플렛 묘사
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@2025-02-01-preview"
  name = "string"
  etag = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  resourcegroup = "string"
  sku = {
    capacity = int
    name = "string"
  }
  subscriptionid = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      allocationPolicy = "string"
      authorizationPolicies = [
        {
          keyName = "string"
          primaryKey = "string"
          rights = "string"
          secondaryKey = "string"
        }
      ]
      enableDataResidency = bool
      iotHubs = [
        {
          allocationWeight = int
          applyAllocationPolicy = bool
          authenticationType = "string"
          connectionString = "string"
          location = "string"
          selectedUserAssignedIdentityResourceId = "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"
    }
  })
}

속성 값

IotDpsPropertiesDescription

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

IotDpsSkuInfo

이름 묘사 값
용량 프로비전할 단위 수 int
이름 Sku 이름입니다. 'S1'

IotHubDefinitionDescription

이름 묘사 값
allocationWeight 지정된 iot h에 적용할 가중치입니다. int
applyAllocationPolicy 지정된 IoT 허브에 대해 allocationPolicy를 적용하거나 적용하지 않는 플래그입니다. bool
authenticationType IotHub MI 인증 유형: KeyBased, UserAssigned, SystemAssigned. 'KeyBased'
'SystemAssigned'
'UserAssigned'
connectionString IoT Hub의 연결 문자열입니다. 문자열
위치 IoT Hub의 ARM 지역입니다. string(필수)
selectedUserAssignedIdentityResourceId IoT Hub와 연결된 선택한 사용자 할당 ID 리소스 ID입니다. authenticationType이 UserAssigned인 경우 이 작업이 필요합니다. 문자열

IpFilterRule

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

ManagedServiceIdentity

이름 묘사 값
형 관리 서비스 ID의 유형입니다(SystemAssigned 및 UserAssigned 형식이 모두 허용되는 경우). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'(필수)
userAssignedIdentities 리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다. UserAssignedIdentities

Microsoft.Devices/provisioningServices

이름 묘사 값
etag Etag 필드가 필요하지 . 응답 본문에 제공된 경우 일반 ETag 규칙에 따라 헤더로도 제공해야 합니다. 문자열
신원 프로비저닝 서비스에 대한 관리 ID입니다. ManagedServiceIdentity
위치 리소스 위치입니다. string(필수)
이름 리소스 이름 string(필수)
속성 프로비저닝 서비스에 대한 서비스별 속성 IotDpsPropertiesDescription(필수)
리소스 그룹 리소스의 리소스 그룹입니다. 문자열
sku 프로비저닝 서비스에 대한 SKU 정보입니다. IotDpsSkuInfo (필수)
subscriptionid 리소스의 구독 ID입니다. 문자열
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.Devices/provisioningServices@2025-02-01-preview"

PrivateEndpoint

이름 묘사 값

PrivateEndpointConnection

이름 묘사 값
속성 프라이빗 엔드포인트 연결의 속성 PrivateEndpointConnectionProperties(필수)

PrivateEndpointConnectionProperties

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

PrivateLinkServiceConnectionState

이름 묘사 값
actionsRequired 프라이빗 엔드포인트 연결에 필요한 작업 문자열
묘사 프라이빗 엔드포인트 연결의 현재 상태에 대한 설명입니다. string(필수)
상태 프라이빗 엔드포인트 연결의 상태입니다. '승인됨'
'연결 끊김'
'보류 중'
'Rejected'(필수)

ResourceTags

이름 묘사 값

SharedAccessSignatureAuthorizationRuleAccessRightsDescription

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

UserAssignedIdentities

이름 묘사 값

UserAssignedIdentity

이름 묘사 값