Instances - Create
Tworzy lub aktualizuje wystąpienie.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}?api-version=2023-07-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
account
|
path | True |
string |
Nazwa konta. Regex pattern: |
instance
|
path | True |
string |
Nazwa wystąpienia. Regex pattern: |
resource
|
path | True |
string |
Nazwa grupy zasobów. |
subscription
|
path | True |
string |
Identyfikator subskrypcji platformy Azure. |
api-version
|
query | True |
string |
Wersja interfejsu API schematu usługi ADU. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
properties.diagnosticStorageProperties |
Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta |
||
properties.enableDiagnostics |
boolean |
Włącza lub wyłącza zbieranie dzienników diagnostycznych |
|
properties.iotHubs |
Lista centrów IoT Hub skojarzonych z kontem. |
||
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
201 Created |
Utworzono operację asynchronizową w celu utworzenia lub zaktualizowania wystąpienia. |
|
Other Status Codes |
Odpowiedź o błędzie opisująca przyczynę niepowodzenia operacji. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | Personifikuj konto użytkownika |
Przykłady
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"
}
}
}
Definicje
Nazwa | Opis |
---|---|
Authentication |
Typ uwierzytelniania |
created |
Typ tożsamości, która utworzyła zasób. |
Diagnostic |
Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Instance |
Szczegóły wystąpienia usługi Device Update. |
Iot |
Integracja konta usługi Device Update z ustawieniami IoT Hub. |
Provisioning |
Stan aprowizacji. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
AuthenticationType
Typ uwierzytelniania
Nazwa | Typ | Opis |
---|---|---|
KeyBased |
string |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DiagnosticStorageProperties
Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta
Nazwa | Typ | Opis |
---|---|---|
authenticationType |
Typ uwierzytelniania |
|
connectionString |
string |
ConnectionString konta magazynu diagnostycznego |
resourceId |
string |
ResourceId konta magazynu diagnostycznego |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt błędu. |
Instance
Szczegóły wystąpienia usługi Device Update.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
name |
string |
Nazwa zasobu |
properties.accountName |
string |
Nadrzędna nazwa konta aktualizacji urządzenia, do którego należy wystąpienie. |
properties.diagnosticStorageProperties |
Właściwości magazynu zbierania dzienników diagnostycznych zainicjowane przez klienta |
|
properties.enableDiagnostics |
boolean |
Włącza lub wyłącza zbieranie dzienników diagnostycznych |
properties.iotHubs |
Lista centrów IoT Hub skojarzonych z kontem. |
|
properties.provisioningState |
Stan aprowizacji. |
|
systemData |
Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
IotHubSettings
Integracja konta usługi Device Update z ustawieniami IoT Hub.
Nazwa | Typ | Opis |
---|---|---|
resourceId |
string |
Identyfikator zasobu usługi IoTHub |
ProvisioningState
Stan aprowizacji.
Nazwa | Typ | Opis |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Failed |
string |
|
Succeeded |
string |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobu (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |