Instances - Create

Erstellt oder aktualisiert Instanz.

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

URI-Parameter

Name In Required Type Description
accountName
path True
  • string

Kontoname.

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

instanceName
path True
  • string

Der Instanzname.

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

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe.

subscriptionId
path True
  • string

Die Azure-Abonnement-ID.

api-version
query True
  • string

ADU-Schema-API-Version.

Anforderungstext

Name Required Type Description
location True
  • string

Der geografische Standort, an dem die Ressource lebt

properties.diagnosticStorageProperties

Speichereigenschaften der vom Kunden initiierten Diagnoseprotokollsammlung

properties.enableDiagnostics
  • boolean

Aktiviert oder deaktiviert die Diagnoseprotokollsammlung

properties.iotHubs

Liste der IoT Hubs, die dem Konto zugeordnet sind.

tags
  • object

Ressourcentags.

Antworten

Name Type Description
201 Created

Asynchroner Vorgang zum Erstellen oder Aktualisieren der Instanz wurde erstellt.

Other Status Codes

Fehlerantwort, die den Grund für Den Vorgangsfehler beschreibt.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

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

Scopes

Name Description
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

AuthenticationType

Authentifizierungstyp

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

DiagnosticStorageProperties

Speichereigenschaften der vom Kunden initiierten Diagnoseprotokollsammlung

ErrorAdditionalInfo

Fehler bei der Ressourcenverwaltung.

ErrorDetail

Fehlerdetails.

ErrorResponse

Fehlerantwort

Instance

Details zur Geräteaktualisierungsinstanz.

IotHubSettings

Geräteaktualisierungskontointegration mit IoT Hub Einstellungen.

ProvisioningState

Bereitstellungsstatus.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

AuthenticationType

Authentifizierungstyp

Name Type Description
KeyBased
  • string

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

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

DiagnosticStorageProperties

Speichereigenschaften der vom Kunden initiierten Diagnoseprotokollsammlung

Name Type Description
authenticationType

Authentifizierungstyp

connectionString
  • string

ConnectionString des Diagnosespeicherkontos

resourceId
  • string

ResourceId des Diagnosespeicherkontos

ErrorAdditionalInfo

Fehler bei der Ressourcenverwaltung.

Name Type Description
info
  • object

Die zusätzlichen Informationen.

type
  • string

Der zusätzliche Infotyp.

ErrorDetail

Fehlerdetails.

Name Type Description
additionalInfo

Der Fehler zusätzliche Informationen.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

Das Fehlerobjekt.

Instance

Details zur Geräteaktualisierungsinstanz.

Name Type Description
id
  • string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Der geografische Standort, an dem die Ressource lebt

name
  • string

Der Name der Ressource

properties.accountName
  • string

Name des übergeordneten Geräteupdatekontos, zu dem die Instanz gehört.

properties.diagnosticStorageProperties

Speichereigenschaften der vom Kunden initiierten Diagnoseprotokollsammlung

properties.enableDiagnostics
  • boolean

Aktiviert oder deaktiviert die Diagnoseprotokollsammlung

properties.iotHubs

Liste der IoT Hubs, die dem Konto zugeordnet sind.

properties.provisioningState

Bereitstellungsstatus.

systemData

Azure Resource Manager Metadaten, die "createdBy" und "modifiedBy"-Informationen enthalten.

tags
  • object

Ressourcentags.

type
  • string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft. Storage/storageAccounts"

IotHubSettings

Geräteaktualisierungskontointegration mit IoT Hub Einstellungen.

Name Type Description
eventHubConnectionString
  • string

EventHub Verbindungszeichenfolge.

ioTHubConnectionString
  • string

IoTHub-Verbindungszeichenfolge.

resourceId
  • string

IoTHub-Ressourcen-ID

ProvisioningState

Bereitstellungsstatus.

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

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Type Description
createdAt
  • string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy
  • string

Die Identität, die die Ressource erstellt hat.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt
  • string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy
  • string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.