Instances - Create

인스턴스를 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}?api-version=2020-03-01-preview

URI 매개 변수

Name In Required Type Description
accountName
path True
  • string

계정 이름입니다.

Regex pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

instanceName
path True
  • string

인스턴스 이름입니다.

Regex pattern: ^[A-Za-z0-9]+(-[A-Za-z0-9]+)*$

resourceGroupName
path True
  • string

리소스 그룹 이름입니다.

subscriptionId
path True
  • string

Azure 구독 ID입니다.

api-version
query True
  • string

ADU 스키마 API 버전입니다.

요청 본문

Name Required Type Description
location True
  • string

리소스가 있는 지리적 위치

properties.diagnosticStorageProperties

고객이 시작한 진단 로그 수집 스토리지 속성

properties.enableDiagnostics
  • boolean

진단 로그 수집을 사용하거나 사용하지 않도록 설정

properties.iotHubs

계정과 연결된 IoT Hub 목록입니다.

tags
  • object

리소스 태그.

응답

Name Type Description
201 Created

인스턴스를 만들거나 업데이트하는 비동기 작업이 만들어졌습니다.

Other Status Codes

작업 실패 이유를 설명하는 오류 응답입니다.

보안

azure_auth

OAuth2 흐름을 Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Creates or updates Instance

Sample Request

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DeviceUpdate/accounts/contoso/instances/blue?api-version=2020-03-01-preview

{
  "location": "westus2",
  "properties": {
    "iotHubs": [
      {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub",
        "ioTHubConnectionString": "string",
        "eventHubConnectionString": "string"
      }
    ],
    "enableDiagnostics": false,
    "diagnosticStorageProperties": {
      "authenticationType": "KeyBased",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount",
      "connectionString": "string"
    }
  }
}

Sample Response

{
  "name": "blue",
  "location": "westus2",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.DeviceUpdate/accounts/contoso/instances/blue",
  "type": "Microsoft.DeviceUpdate/accounts/instances",
  "properties": {
    "provisioningState": "Accepted",
    "accountName": "contoso",
    "iotHubs": [
      {
        "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Devices/IotHubs/blue-contoso-hub"
      }
    ],
    "enableDiagnostics": false,
    "diagnosticStorageProperties": {
      "authenticationType": "KeyBased",
      "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/adu-resource-group/providers/Microsoft.Storage/storageAccounts/testAccount"
    }
  }
}

정의

AuthenticationType

인증 유형

createdByType

리소스를 만든 ID의 형식입니다.

DiagnosticStorageProperties

고객이 시작한 진단 로그 수집 스토리지 속성

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

Instance

디바이스 업데이트 인스턴스 세부 정보입니다.

IotHubSettings

IoT Hub 설정과 디바이스 업데이트 계정 통합

ProvisioningState

프로비전 상태입니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

AuthenticationType

인증 유형

Name Type Description
KeyBased
  • string

createdByType

리소스를 만든 ID의 형식입니다.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DiagnosticStorageProperties

고객이 시작한 진단 로그 수집 스토리지 속성

Name Type Description
authenticationType

인증 유형

connectionString
  • string

진단 스토리지 계정의 ConnectionString

resourceId
  • string

진단 스토리지 계정의 ResourceId

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name Type Description
info
  • object

추가 정보입니다.

type
  • string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name Type Description
additionalInfo

오류 추가 정보입니다.

code
  • string

오류 코드입니다.

details

오류 세부 정보입니다.

message
  • string

오류 메시지입니다.

target
  • string

오류 대상입니다.

ErrorResponse

오류 응답

Name Type Description
error

오류 개체입니다.

Instance

디바이스 업데이트 인스턴스 세부 정보입니다.

Name Type Description
id
  • string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

리소스가 있는 지리적 위치

name
  • string

리소스의 이름입니다.

properties.accountName
  • string

인스턴스가 속한 부모 디바이스 업데이트 계정 이름입니다.

properties.diagnosticStorageProperties

고객이 시작한 진단 로그 수집 스토리지 속성

properties.enableDiagnostics
  • boolean

진단 로그 수집을 사용하거나 사용하지 않도록 설정

properties.iotHubs

계정과 연결된 IoT Hub 목록입니다.

properties.provisioningState

프로비전 상태입니다.

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

tags
  • object

리소스 태그.

type
  • string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft. Storage/storageAccounts"

IotHubSettings

IoT Hub 설정과 디바이스 업데이트 계정 통합

Name Type Description
eventHubConnectionString
  • string

EventHub 연결 문자열.

ioTHubConnectionString
  • string

IoTHub 연결 문자열.

resourceId
  • string

IoTHub 리소스 ID

ProvisioningState

프로비전 상태입니다.

Name Type Description
Accepted
  • string
Canceled
  • string
Creating
  • string
Deleted
  • string
Failed
  • string
Succeeded
  • string

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name Type Description
createdAt
  • string

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy
  • string

리소스를 만든 ID입니다.

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt
  • string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy
  • string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

리소스를 마지막으로 수정한 ID의 형식입니다.