Instances - Create
Létrehozza vagy frissíti a példányt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DeviceUpdate/accounts/{accountName}/instances/{instanceName}?api-version=2023-07-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
Fióknév. Regex pattern: |
instance
|
path | True |
string |
Példány neve. Regex pattern: |
resource
|
path | True |
string |
Az erőforráscsoport neve. |
subscription
|
path | True |
string |
Az Azure-előfizetés azonosítója. |
api-version
|
query | True |
string |
Az ADU séma API-verziója. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
location | True |
string |
A földrajzi hely, ahol az erőforrás él |
properties.diagnosticStorageProperties |
Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolótulajdonságai |
||
properties.enableDiagnostics |
boolean |
A diagnosztikai naplók gyűjteményének engedélyezése vagy letiltása |
|
properties.iotHubs |
A fiókhoz társított IoT Hubok listája. |
||
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
201 Created |
Létre lett hozva a példány létrehozásához vagy frissítéséhez szükséges aszinkron művelet. |
|
Other Status Codes |
A művelet meghiúsulásának okát leíró hibaválasz. |
Biztonság
azure_auth
Azure Active Directory OAuth2-folyamat.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | A felhasználói fiók megszemélyesítése |
Példák
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"
}
}
}
Definíciók
Name | Description |
---|---|
Authentication |
Hitelesítés típusa |
created |
Az erőforrást létrehozó identitás típusa. |
Diagnostic |
Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolótulajdonságai |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Instance |
Eszközfrissítési példány részletei. |
Iot |
Eszközfrissítési fiók integrációja IoT Hub beállításokkal. |
Provisioning |
Kiépítési állapot. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
AuthenticationType
Hitelesítés típusa
Name | Típus | Description |
---|---|---|
KeyBased |
string |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DiagnosticStorageProperties
Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolótulajdonságai
Name | Típus | Description |
---|---|---|
authenticationType |
Hitelesítés típusa |
|
connectionString |
string |
A diagnosztikai tárfiók ConnectionString szolgáltatása |
resourceId |
string |
A diagnosztikai tárfiók ResourceId azonosítója |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további adattípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
Instance
Eszközfrissítési példány részletei.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A földrajzi hely, ahol az erőforrás él |
name |
string |
Az erőforrás neve |
properties.accountName |
string |
Szülőeszköz-frissítési fiók neve, amelyhez a példány tartozik. |
properties.diagnosticStorageProperties |
Ügyfél által kezdeményezett diagnosztikai naplógyűjtemény tárolótulajdonságai |
|
properties.enableDiagnostics |
boolean |
A diagnosztikai naplók gyűjteményének engedélyezése vagy letiltása |
properties.iotHubs |
A fiókhoz társított IoT Hubok listája. |
|
properties.provisioningState |
Kiépítési állapot. |
|
systemData |
Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatokat. |
|
tags |
object |
Erőforráscímkék. |
type |
string |
Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
IotHubSettings
Eszközfrissítési fiók integrációja IoT Hub beállításokkal.
Name | Típus | Description |
---|---|---|
resourceId |
string |
IoTHub-erőforrás azonosítója |
ProvisioningState
Kiépítési állapot.
Name | Típus | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Creating |
string |
|
Deleted |
string |
|
Failed |
string |
|
Succeeded |
string |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az erőforrást utoljára módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |