Instances - Create

Tworzy lub aktualizuje wystąpienie.

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

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta.

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

instanceName
path True
  • string

Nazwa wystąpienia.

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

resourceGroupName
path True
  • string

Nazwa grupy zasobów.

subscriptionId
path True
  • string

Identyfikator subskrypcji platformy Azure.

api-version
query True
  • string

Wersja interfejsu API schematu usługi ADU.

Treść żądania

Name Required Type Description
location True
  • string

Lokalizacja geograficzna, w której znajduje się zasób

properties.diagnosticStorageProperties

Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta

properties.enableDiagnostics
  • boolean

Włącza lub wyłącza zbieranie dzienników diagnostycznych

properties.iotHubs

Lista centrów IoT Hub skojarzonych z kontem.

tags
  • object

Tagi zasobów.

Odpowiedzi

Name Type Description
201 Created

Utworzono operację asynchronizową w celu utworzenia lub zaktualizowania wystąpienia.

Other Status Codes

Odpowiedź o błędzie opisująca przyczynę niepowodzenia operacji.

Zabezpieczenia

azure_auth

Azure Active Directory przepływ OAuth2.

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

Scopes

Name Description
user_impersonation Personifikuj konto użytkownika

Przykłady

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"
    }
  }
}

Definicje

AuthenticationType

Typ uwierzytelniania

createdByType

Typ tożsamości, która utworzyła zasób.

DiagnosticStorageProperties

Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

Instance

Szczegóły wystąpienia usługi Device Update.

IotHubSettings

Integracja konta usługi Device Update z ustawieniami IoT Hub.

ProvisioningState

Stan aprowizacji.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AuthenticationType

Typ uwierzytelniania

Name Type Description
KeyBased
  • string

createdByType

Typ tożsamości, która utworzyła zasób.

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

DiagnosticStorageProperties

Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta

Name Type Description
authenticationType

Typ uwierzytelniania

connectionString
  • string

ConnectionString konta magazynu diagnostycznego

resourceId
  • string

ResourceId konta magazynu diagnostycznego

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Name Type Description
info
  • object

Dodatkowe informacje.

type
  • string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Name Type Description
additionalInfo

Dodatkowe informacje o błędzie.

code
  • string

Kod błędu.

details

Szczegóły błędu.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Name Type Description
error

Obiekt błędu.

Instance

Szczegóły wystąpienia usługi Device Update.

Name Type Description
id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Lokalizacja geograficzna, w której znajduje się zasób

name
  • string

Nazwa zasobu

properties.accountName
  • string

Nadrzędna nazwa konta aktualizacji urządzenia, do którego należy wystąpienie.

properties.diagnosticStorageProperties

Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta

properties.enableDiagnostics
  • boolean

Włącza lub wyłącza zbieranie dzienników diagnostycznych

properties.iotHubs

Lista centrów IoT Hub skojarzonych z kontem.

properties.provisioningState

Stan aprowizacji.

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

IotHubSettings

Integracja konta usługi Device Update z ustawieniami IoT Hub.

Name Type Description
eventHubConnectionString
  • string

EventHub parametry połączenia.

ioTHubConnectionString
  • string

Parametry połączenia usługi IoTHub.

resourceId
  • string

Identyfikator zasobu usługi IoTHub

ProvisioningState

Stan aprowizacji.

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

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Name Type Description
createdAt
  • string

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy
  • string

Tożsamość, która utworzyła zasób.

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt
  • string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy
  • string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.