Instances - Create

Crea o actualiza la instancia.

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

Parámetros de identificador URI

Name In Required Type Description
accountName
path True
  • string

Nombre de la cuenta.

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

instanceName
path True
  • string

Nombre de instancia.

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

resourceGroupName
path True
  • string

El nombre del grupo de recursos.

subscriptionId
path True
  • string

El identificador de la suscripción de Azure.

api-version
query True
  • string

Versión de la API de esquema de ADU.

Cuerpo de la solicitud

Name Required Type Description
location True
  • string

Ubicación geográfica donde reside el recurso

properties.diagnosticStorageProperties

Propiedades de almacenamiento de recopilación de registros de diagnóstico iniciadas por el cliente

properties.enableDiagnostics
  • boolean

Habilita o deshabilita la recopilación de registros de diagnóstico

properties.iotHubs

Lista de instancias de IoT Hub asociadas a la cuenta.

tags
  • object

Etiquetas del recurso.

Respuestas

Name Type Description
201 Created

Se creó una operación asincrónica para crear o actualizar la instancia.

Other Status Codes

Respuesta de error que describe el motivo del error de operación.

Seguridad

azure_auth

Azure Active Directory flujo de OAuth2.

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

Scopes

Name Description
user_impersonation Suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

AuthenticationType

Tipo de autenticación

createdByType

Tipo de identidad que creó el recurso.

DiagnosticStorageProperties

Propiedades de almacenamiento de recopilación de registros de diagnóstico iniciadas por el cliente

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

Instance

Detalles de la instancia de Device Update.

IotHubSettings

Integración de la cuenta de Device Update con IoT Hub configuración.

ProvisioningState

Estado de aprovisionamiento.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AuthenticationType

Tipo de autenticación

Name Type Description
KeyBased
  • string

createdByType

Tipo de identidad que creó el recurso.

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

DiagnosticStorageProperties

Propiedades de almacenamiento de recopilación de registros de diagnóstico iniciadas por el cliente

Name Type Description
authenticationType

Tipo de autenticación

connectionString
  • string

ConnectionString de la cuenta de almacenamiento de diagnóstico

resourceId
  • string

ResourceId de la cuenta de almacenamiento de diagnóstico

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Name Type Description
info
  • object

Información adicional.

type
  • string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Name Type Description
additionalInfo

Información adicional del error.

code
  • string

Código de error.

details

Los detalles del error.

message
  • string

El mensaje de error.

target
  • string

Destino del error.

ErrorResponse

Respuesta de error

Name Type Description
error

Objeto de error.

Instance

Detalles de la instancia de Device Update.

Name Type Description
id
  • string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Ubicación geográfica donde reside el recurso

name
  • string

Nombre del recurso.

properties.accountName
  • string

Nombre de cuenta de Device Update primario al que pertenece la instancia.

properties.diagnosticStorageProperties

Propiedades de almacenamiento de recopilación de registros de diagnóstico iniciadas por el cliente

properties.enableDiagnostics
  • boolean

Habilita o deshabilita la recopilación de registros de diagnóstico

properties.iotHubs

Lista de instancias de IoT Hub asociadas a la cuenta.

properties.provisioningState

Estado de aprovisionamiento.

systemData

Los metadatos de Azure Resource Manager que contienen información de createdBy y modifiedBy.

tags
  • object

Etiquetas del recurso.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft. Storage/storageAccounts"

IotHubSettings

Integración de la cuenta de Device Update con IoT Hub configuración.

Name Type Description
eventHubConnectionString
  • string

EventHub cadena de conexión.

ioTHubConnectionString
  • string

Cadena de conexión de IoTHub.

resourceId
  • string

Identificador de recurso de IoTHub

ProvisioningState

Estado de aprovisionamiento.

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

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.