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=2023-07-01
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nome da conta. Regex pattern: |
instance
|
path | True |
string |
Nome da instância. Regex pattern: |
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
path | True |
string |
A ID de assinatura do Azure. |
api-version
|
query | True |
string |
Versão da API de esquema da ADU. |
Corpo da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
location | True |
string |
A localização geográfica em que 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
Nome | Tipo | 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
Fluxo OAuth2 do Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | 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=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"
}
}
}
Definições
Nome | Description |
---|---|
Authentication |
Tipo de autenticação |
created |
O tipo de identidade que criou o recurso. |
Diagnostic |
Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Instance |
Detalhes da instância de Atualização de Dispositivo. |
Iot |
Integração da conta de Atualização de Dispositivo com Hub IoT configurações. |
Provisioning |
Estado de provisionamento. |
system |
Metadados relativos à criação e à última modificação do recurso. |
AuthenticationType
Tipo de autenticação
Nome | Tipo | Description |
---|---|---|
KeyBased |
string |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DiagnosticStorageProperties
Propriedades de armazenamento da coleção de logs de diagnóstico iniciadas pelo cliente
Nome | Tipo | 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 do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
Nome | Tipo | 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
Nome | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
Instance
Detalhes da instância de Atualização de Dispositivo.
Nome | Tipo | 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 em que 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.Storage/storageAccounts" |
IotHubSettings
Integração da conta de Atualização de Dispositivo com Hub IoT configurações.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
ID do recurso do IoTHub |
ProvisioningState
Estado de provisionamento.
Nome | Tipo | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Failed |
string |
|
Succeeded |
string |
systemData
Metadados relativos à criação e à última modificação do recurso.
Nome | Tipo | 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. |