Instances - Create

Cria ou atualiza a instância.

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 URI

Name In Required Type Description
accountName
path True
  • string

Nome da conta.

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

instanceName
path True
  • string

Nome da instância.

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

resourceGroupName
path True
  • string

O nome do grupo de recursos.

subscriptionId
path True
  • string

A ID de assinatura do Azure.

api-version
query True
  • string

Versão da API de esquema do ADU.

Corpo da solicitação

Name Required Type Description
location True
  • string

A localização geográfica onde o recurso reside

properties.diagnosticStorageProperties

Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente

properties.enableDiagnostics
  • boolean

Habilita ou desabilita a coleção de logs de diagnóstico

properties.iotHubs

Lista de Hubs IoT associados à conta.

tags
  • object

Marcas de recurso.

Respostas

Name Type Description
201 Created

A operação assíncrona para criar ou atualizar a Instância foi criada.

Other Status Codes

Resposta de erro que descreve o motivo da falha na operação.

Segurança

azure_auth

Azure Active Directory fluxo OAuth2.

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

Scopes

Name Description
user_impersonation Representar sua conta de usuário

Exemplos

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

Definições

AuthenticationType

Tipo de autenticação

createdByType

O tipo de identidade que criou o recurso.

DiagnosticStorageProperties

Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente

ErrorAdditionalInfo

As informações adicionais sobre o erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

Instance

Detalhes da instância de Atualização do Dispositivo.

IotHubSettings

Integração da conta de Atualização de Dispositivo com configurações de Hub IoT.

ProvisioningState

Estado de provisionamento.

systemData

Metadados relativos à criação e última modificação do recurso.

AuthenticationType

Tipo de autenticação

Name Type Description
KeyBased
  • string

createdByType

O tipo de identidade que criou o recurso.

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

DiagnosticStorageProperties

Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente

Name Type Description
authenticationType

Tipo de autenticação

connectionString
  • string

ConnectionString da conta de armazenamento de diagnóstico

resourceId
  • string

ResourceId da conta de armazenamento de diagnóstico

ErrorAdditionalInfo

As informações adicionais sobre o erro de gerenciamento de recursos.

Name Type Description
info
  • object

As informações adicionais.

type
  • string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Type Description
additionalInfo

As informações adicionais do erro.

code
  • string

O código de erro.

details

Os detalhes do erro.

message
  • string

A mensagem de erro.

target
  • string

O destino do erro.

ErrorResponse

Resposta de erro

Name Type Description
error

O objeto de erro.

Instance

Detalhes da instância de Atualização do Dispositivo.

Name Type Description
id
  • string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

A localização geográfica onde o recurso reside

name
  • string

O nome do recurso

properties.accountName
  • string

Nome da Conta de Atualização de Dispositivo Pai ao qual a Instância pertence.

properties.diagnosticStorageProperties

Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente

properties.enableDiagnostics
  • boolean

Habilita ou desabilita a coleção de logs de diagnóstico

properties.iotHubs

Lista de Hubs IoT associados à conta.

properties.provisioningState

Estado de provisionamento.

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

tags
  • object

Marcas de recurso.

type
  • string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft. Armazenamento/storageAccounts"

IotHubSettings

Integração da conta de Atualização de Dispositivo com configurações de Hub IoT.

Name Type Description
eventHubConnectionString
  • string

EventHub cadeia de conexão.

ioTHubConnectionString
  • string

cadeia de conexão do IoTHub.

resourceId
  • string

ID de recurso do IoTHub

ProvisioningState

Estado de provisionamento.

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

systemData

Metadados relativos à criação e última modificação do recurso.

Name Type Description
createdAt
  • string

O carimbo de data/hora da criação de recursos (UTC).

createdBy
  • string

A identidade que criou o recurso.

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt
  • string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy
  • string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

O tipo de identidade que modificou o recurso pela última vez.