Updates - Get File

Serviço:

Device Update

Versão da API:

2020-09-01

Obtenha um arquivo de atualização específico da versão.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}/files/{fileId}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountEndpoint	path	True	string	Ponto de extremidade da conta.
fileId	path	True	string	Identificador de arquivo.
instanceId	path	True	string	Identificador de instância de conta.
name	path	True	string	Nome da atualização.
provider	path	True	string	Atualizar provedor.
version	path	True	string	Atualizar versão.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
If-None-Match		string	Define a condição If-None-Match. A operação será executada somente se a ETag no servidor não corresponder a esse valor.

Respostas

Nome	Tipo	Description
200 OK	File	A entidade de arquivo solicitada.
404 Not Found		Não encontrado.
429 Too Many Requests		Muitas solicitações; há um limite de taxa em quantas operações podem ser executadas em um período de tempo.
Other Status Codes		Não modificado.

Segurança

azure_auth_implicit

Fluxo Implícito do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_code

Fluxo do AccessCode do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

azure_auth_application

Fluxo de Aplicativos OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: application
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
.default	escopo da credencial do cliente

azure_auth_password

Fluxo de senha do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: password
URL do Token: https://login.microsoftonline.com/common/oauth2/v2.0/token

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Updates_GetFile

Solicitação de exemplo

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0/files/abc123

Resposta de exemplo

Código de status:

200

{
  "fileId": "abc123",
  "fileName": "1v5uww1q.my2",
  "sizeInBytes": 1862311,
  "hashes": {
    "sha256": "OVokcktf61lQXs17MzJCsM98lk48H1Wu1hy7Sp6lLfI="
  },
  "mimeType": "application/BuildAsync-s4jwikgq.44h",
  "etag": "\"26bd8eba-4bb2-4960-a357-ca4d60b5fb4b\""
}

Código de status:

304

Código de status:

404

Código de status:

429

Definições

File

Atualizar metadados de arquivo.

Nome	Tipo	Description
etag	string	Arquivo ETag.
fileId	string	Identidade do arquivo, gerada pelo servidor no momento da importação.
fileName	string	Nome do arquivo.
hashes	object	Mapeamento do algoritmo de hash para valores de hash codificados em base64.
mimeType	string	Tipo MIME de arquivo.
sizeInBytes	integer	Tamanho do arquivo em número de bytes.