API QueryDeviceFile - IoT Platform - IoT Platform: Central de Documentação do Alibaba Cloud

Limites

Máximo de 500 QPS por conta Alibaba Cloud.

Nota

Usuários RAM compartilham a cota da conta.

Depuração

O OpenAPI Explorer calcula assinaturas automaticamente e gera códigos de exemplo do SDK. Recomendamos chamar esta operação no OpenAPI Explorer.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	QueryDeviceFile	Operação a executar. Defina o valor como QueryDeviceFile.
FileId	String	Sim	xL0G67MBLBDtkR7GCfT	ID do arquivo. Chame QueryDeviceFileList para obter os IDs dos arquivos.
IotInstanceId	String	Não	iot_instc_pu*_c-v64	ID da instância. Encontre-o na página Overview no console do IoT Platform. Importante Obrigatório se a instância tiver um ID. A chamada falha sem esse parâmetro. Não obrigatório se a instância não tiver uma página Overview ou ID. Visão geral.
ProductKey	String	Não	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence. Nota Se você especificar este parâmetro, também deverá especificar o parâmetro DeviceName.
DeviceName	String	Não	light	Nome do dispositivo. Nota Se você especificar este parâmetro, também deverá especificar o parâmetro ProductKey.
IotId	String	Não	Q7uOhVRdZRRlDnTLv****00100	ID do dispositivo, emitido pelo IoT Platform. Nota O IotId é um GUID que mapeia para uma combinação de ProductKey e DeviceName. Se especificado, ProductKey e DeviceName não são obrigatórios. Caso tanto o IotId quanto a combinação ProductKey/DeviceName sejam informados, o IotId tem precedência.

Especifique também os parâmetros comuns de solicitação ao chamar esta operação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.system.SystemException	Código de erro retornado em caso de falha. Consulte Códigos de erro.
Data	Struct		Informações do arquivo retornadas em caso de sucesso.
DownloadUrl	String	http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849/aGE/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI&Signature=%2F8	URL para baixe do arquivo.
FileId	String	6UCo1SqbqnQEoh9aKqDQ01****	ID do arquivo.
Name	String	testFile3.txt	Nome do arquivo.
Size	String	102400	Tamanho do arquivo em KB.
UtcCreatedOn	String	2019-03-21T08:45:42.000Z	Hora de criação do arquivo no formato UTC.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada em caso de falha.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada teve êxito. false: A chamada falhou.

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceFile
&ProductKey=a1BwAGV****
&DeviceName=deviceName1
&FileId=6UCo1SqbqnQEoh9aKqD******
&<Common request parameters>

Exemplos de respostas

Formato XML

<QueryDeviceFileResponse>
  <RequestId>93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F</RequestId>
  <Data>
        <Name>testFile3.txt</Name>
        <DownloadUrl>http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******</DownloadUrl>
        <FileId>6UCo1SqbqnQEoh9aKqDQ01****</FileId>
        <UtcCreatedOn>2019-03-21T08:45:42.000Z</UtcCreatedOn>
        <Size>102400</Size>
  </Data>
  <Success>true</Success>
</QueryDeviceFileResponse>

Formato JSON

{
  "RequestId": "93C5276D-5C8A-40D9-BFD6-4BD5B8C1A08F",
  "Data": {
    "Name": "testFile3.txt",
    "DownloadUrl": "http://iotx-file-store.oss-cn-shanghai.aliyuncs.com/device_file/A849******/aGE******/testFile3.txt?Expires=1553162075&OSSAccessKeyId=LTAI****************&Signature=%2F8******",
    "FileId": "6UCo1SqbqnQEoh9aKqDQ01****",
    "UtcCreatedOn": "2019-03-21T08:45:42.000Z",
    "Size": "102400"
  },
  "Success": true
}

Códigos de erro

Consulte a Central de Erros de API para verificar os códigos de erro.