Instances - Create
instance 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}?api-version=2023-07-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
계정 이름입니다. Regex pattern: |
instance
|
path | True |
string |
인스턴스 이름입니다. Regex pattern: |
resource
|
path | True |
string |
리소스 그룹 이름입니다. |
subscription
|
path | True |
string |
Azure 구독 ID입니다. |
api-version
|
query | True |
string |
ADU 스키마 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
properties.diagnosticStorageProperties |
고객이 시작한 진단 로그 수집 스토리지 속성 |
||
properties.enableDiagnostics |
boolean |
진단 로그 컬렉션을 사용하거나 사용하지 않도록 설정 |
|
properties.iotHubs |
계정과 연결된 IoT Hub 목록입니다. |
||
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
201 Created |
인스턴스를 만들거나 업데이트하는 비동기 작업이 만들어졌습니다. |
|
Other Status Codes |
작업 실패 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 흐름.
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=2023-07-01
{
"location": "westus2",
"properties": {
"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",
"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"
}
}
}
정의
Name | Description |
---|---|
Authentication |
인증 유형 |
created |
리소스를 만든 ID의 형식입니다. |
Diagnostic |
고객이 시작한 진단 로그 수집 스토리지 속성 |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Instance |
디바이스 업데이트 instance 세부 정보. |
Iot |
IoT Hub 설정과 디바이스 업데이트 계정 통합. |
Provisioning |
프로비저닝 상태. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
AuthenticationType
인증 유형
Name | 형식 | Description |
---|---|---|
KeyBased |
string |
createdByType
리소스를 만든 ID의 형식입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DiagnosticStorageProperties
고객이 시작한 진단 로그 수집 스토리지 속성
Name | 형식 | Description |
---|---|---|
authenticationType |
인증 유형 |
|
connectionString |
string |
진단 스토리지 계정의 ConnectionString |
resourceId |
string |
진단 스토리지 계정의 ResourceId |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
Instance
디바이스 업데이트 instance 세부 정보.
Name | 형식 | 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 | 형식 | Description |
---|---|---|
resourceId |
string |
IoTHub 리소스 ID |
ProvisioningState
프로비저닝 상태.
Name | 형식 | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Failed |
string |
|
Succeeded |
string |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |