Instances - Create

Létrehozza vagy frissíti a példányt.

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

URI-paraméterek

Name In Required Type Description
accountName
path True
  • string

Fióknév.

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

instanceName
path True
  • string

Példány neve.

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

resourceGroupName
path True
  • string

Az erőforráscsoport neve.

subscriptionId
path True
  • string

Az Azure-előfizetés azonosítója.

api-version
query True
  • string

Az ADU séma API-verziója.

Kérelem törzse

Name Required Type Description
location True
  • string

A földrajzi hely, ahol az erőforrás található

properties.diagnosticStorageProperties

Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolási tulajdonságai

properties.enableDiagnostics
  • boolean

A diagnosztikai naplók gyűjteményének engedélyezése vagy letiltása

properties.iotHubs

A fiókhoz társított IoT Hubok listája.

tags
  • object

Erőforráscímkék.

Válaszok

Name Type Description
201 Created

Létre lett hozva a példány létrehozásához vagy frissítéséhez szükséges aszinkron művelet.

Other Status Codes

A művelet meghiúsulásának okát leíró hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

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

Scopes

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Példák

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

Definíciók

AuthenticationType

Hitelesítés típusa

createdByType

Az erőforrást létrehozó identitás típusa.

DiagnosticStorageProperties

Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolási tulajdonságai

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

Instance

Eszközfrissítési példány részletei.

IotHubSettings

Eszközfrissítési fiók integrációja IoT Hub beállításokkal.

ProvisioningState

Kiépítési állapot.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

AuthenticationType

Hitelesítés típusa

Name Type Description
KeyBased
  • string

createdByType

Az erőforrást létrehozó identitás típusa.

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

DiagnosticStorageProperties

Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolási tulajdonságai

Name Type Description
authenticationType

Hitelesítés típusa

connectionString
  • string

A diagnosztikai tárfiók ConnectionString szolgáltatása

resourceId
  • string

A diagnosztikai tárfiók ResourceId azonosítója

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Type Description
info
  • object

A további információk.

type
  • string

A további információtípus.

ErrorDetail

A hiba részletei.

Name Type Description
additionalInfo

A hiba további információi.

code
  • string

A hibakód.

details

A hiba részletei.

message
  • string

A hibaüzenet.

target
  • string

A hiba célja.

ErrorResponse

Hibaválasz

Name Type Description
error

A hibaobjektum.

Instance

Eszközfrissítési példány részletei.

Name Type Description
id
  • string

Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

A földrajzi hely, ahol az erőforrás található

name
  • string

Az erőforrás neve

properties.accountName
  • string

Szülőeszköz-frissítési fiók neve, amelyhez a példány tartozik.

properties.diagnosticStorageProperties

Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolási tulajdonságai

properties.enableDiagnostics
  • boolean

A diagnosztikai naplók gyűjteményének engedélyezése vagy letiltása

properties.iotHubs

A fiókhoz társított IoT Hubok listája.

properties.provisioningState

Kiépítési állapot.

systemData

Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatokat.

tags
  • object

Erőforráscímkék.

type
  • string

Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft. Storage/storageAccounts"

IotHubSettings

Eszközfrissítési fiók integrációja IoT Hub beállításokkal.

Name Type Description
eventHubConnectionString
  • string

EventHub kapcsolati karakterlánc.

ioTHubConnectionString
  • string

IoTHub kapcsolati karakterlánc.

resourceId
  • string

IoTHub-erőforrás azonosítója

ProvisioningState

Kiépítési állapot.

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

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Type Description
createdAt
  • string

Az erőforrás-létrehozás időbélyege (UTC).

createdBy
  • string

Az erőforrást létrehozó identitás.

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt
  • string

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy
  • string

Az erőforrást utoljára módosító identitás.

lastModifiedByType

Az erőforrást utoljára módosító identitás típusa.