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=2023-07-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta. Regex pattern: |
instance
|
path | True |
string |
Nombre de instancia. Regex pattern: |
resource
|
path | True |
string |
El nombre del grupo de recursos. |
subscription
|
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
Nombre | Requerido | Tipo | 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
Nombre | Tipo | 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 la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nombre | 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=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"
}
}
}
Definiciones
Nombre | Description |
---|---|
Authentication |
Tipo de autenticación |
created |
Tipo de identidad que creó el recurso. |
Diagnostic |
Propiedades de almacenamiento de recopilación de registros de diagnóstico iniciadas por el cliente |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Instance |
Detalles de la instancia de Device Update. |
Iot |
Integración de la cuenta de Device Update con la configuración de IoT Hub. |
Provisioning |
Estado de aprovisionamiento. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
AuthenticationType
Tipo de autenticación
Nombre | Tipo | Description |
---|---|---|
KeyBased |
string |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | 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
Nombre | Tipo | 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.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | 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
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
Instance
Detalles de la instancia de Device Update.
Nombre | Tipo | 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 la cuenta de Device Update primaria a la 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 |
Metadatos de Azure Resource Manager que contienen información sobre los valores 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 la configuración de IoT Hub.
Nombre | Tipo | Description |
---|---|---|
resourceId |
string |
Identificador de recurso de IoTHub |
ProvisioningState
Estado de aprovisionamiento.
Nombre | Tipo | 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.
Nombre | Tipo | 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. |