Updates - Import Update

Service:

Device Update

API-versie:

2020-09-01

Nieuwe updateversie importeren.

POST https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates?action=import

URI-parameters

Name	In	Vereist	Type	Description
accountEndpoint	path	True	string	Accounteindpunt.
instanceId	path	True	string	Accountexemplaren-id.
action	query	True	ImportAction	Updateactie importeren.

Aanvraagbody

Name	Vereist	Type	Description
files	True	FileImportMetadata[]	Een of meer bestandseigenschappen bijwerken, zoals bestandsnaam en bron-URL.
importManifest	True	ImportManifestMetadata	Importeer manifestmetagegevens zoals bron-URL, bestandsgrootte/hashes, enzovoort.

Antwoorden

Name	Type	Description
202 Accepted		Geaccepteerde aanvraag voor het importeren van updates; de locatie van de achtergrondbewerking om de status bij te houden, wordt opgegeven in Operation-Location antwoordheader. Kopteksten Location: string Operation-Location: string
429 Too Many Requests		Te veel aanvragen; er is een frequentielimiet voor het aantal bewerkingen dat binnen een periode kan worden uitgevoerd en er is ook een limiet voor het aantal gelijktijdige import- en verwijderbewerkingen op de achtergrond.

Beveiliging

azure_auth_implicit

Impliciete stroom voor Azure Active Directory OAuth2

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

azure_auth_code

Azure Active Directory OAuth2 AccessCode Flow

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

azure_auth_application

Azure Active Directory OAuth2-toepassingsstroom

Type: oauth2
Stroom: application
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiken

Name	Description
.default	bereik van clientreferenties

azure_auth_password

Azure Active Directory OAuth2-wachtwoordstroom

Type: oauth2
Stroom: password
Token-URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Updates_ImportUpdate

Voorbeeldaanvraag

HTTP

POST https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates?action=import

{
  "importManifest": {
    "url": "http://test.blob.core.windows.net/test/uploadimportMan.json",
    "sizeInBytes": 816,
    "hashes": {
      "sha256": "O19LyyncPe1AGstOdkcmozLV8pSbBdqrE18HdYVohRc="
    }
  },
  "files": [
    {
      "filename": "file1.bin",
      "url": "http://test.blob.core.windows.net/test/upload1v5uww1q"
    },
    {
      "filename": "file2.bin",
      "url": "http://test.blob.core.windows.net/test/uploadkrmn5yw0"
    },
    {
      "filename": "file3.bin",
      "url": "http://test.blob.core.windows.net/test/uploaddq52ky5m"
    }
  ]
}

Voorbeeldrespons

Statuscode:

202

Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f
Operation-Location: /deviceupdate/instanceId/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Statuscode:

429

Definities

Name	Description
FileImportMetadata	Metagegevens die een updatebestand beschrijven.
ImportAction	Updateactie importeren.
ImportManifestMetadata	Metagegevens die het importmanifest beschrijven, een document waarin de bestanden en andere metagegevens over een updateversie worden beschreven.
ImportUpdateInput	Metagegevens van update-invoer importeren.

FileImportMetadata

Metagegevens die een updatebestand beschrijven.

Name	Type	Description
filename	string	Werk de bestandsnaam bij zoals opgegeven in het importmanifest.
url	string	Azure Blob-locatie van waaruit het updatebestand kan worden gedownload door Device Update voor IoT Hub. Dit is meestal een alleen-lezen BLOB-URL met het kenmerk ALLEEN-lezen en een vervaldatum die is ingesteld op ten minste 4 uur.

ImportAction

Updateactie importeren.

Name	Type	Description
import	string	Importactie.

ImportManifestMetadata

Metagegevens die het importmanifest beschrijven, een document waarin de bestanden en andere metagegevens over een updateversie worden beschreven.

Name	Type	Description
hashes	object	Een JSON-object met de hash('s) van het bestand. Er is ten minste SHA256-hash vereist. Dit object kan worden gezien als een set sleutel-waardeparen waarbij de sleutel het hash-algoritme is en de waarde de hash is van het bestand dat is berekend met dat algoritme.
sizeInBytes	integer	Bestandsgrootte in aantal bytes.
url	string	Azure Blob-locatie van waaruit het importmanifest kan worden gedownload door Device Update voor IoT Hub. Dit is meestal een alleen-lezen BLOB-URL met het kenmerk ALLEEN-lezen en een vervaldatum die is ingesteld op ten minste 4 uur.

ImportUpdateInput

Metagegevens van update-invoer importeren.

Name	Type	Description
files	FileImportMetadata[]	Een of meer bestandseigenschappen bijwerken, zoals bestandsnaam en bron-URL.
importManifest	ImportManifestMetadata	Importeer manifestmetagegevens zoals bron-URL, bestandsgrootte/hashes, enzovoort.