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

Exclui um arquivo carregado do dispositivo para o IoT Platform.

Limites

Cada conta Alibaba Cloud pode executar no máximo 500 consultas por segundo (QPS).

Nota

Os usuários RAM de uma conta Alibaba Cloud compartilham a cota dessa conta.

Depuração

O Alibaba Cloud oferece o OpenAPI Explorer para simplificar o uso da API. O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DeleteDeviceFile	A operação a ser executada. Defina o valor como DeleteDeviceFile.
FileId	String	Sim	6UCo1SqbqnQEoh9aK4561****	ID do arquivo. Chame a operação QueryDeviceFileList e visualize o ID do arquivo na resposta.
IotInstanceId	String	Não	iot_instc_pu***_c-v64********	ID da instância. Visualize o ID da instância na página Overview no console do IoT Platform. Importante Se a instância tiver um ID, configure este parâmetro. Caso contrário, a chamada falhará. Se a instância não tiver uma página Overview ou ID, não é necessário definir este parâmetro. Para obter mais informações, consulte Visão geral.
ProductKey	String	Não	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence. Nota Ao especificar este parâmetro, especifique também o parâmetro DeviceName.
DeviceName	String	Não	light	Nome do dispositivo. Nota Ao especificar este parâmetro, especifique também o parâmetro ProductKey.
IotId	String	Não	Q7uOhVRdZRRlDnTLv****00100	ID do dispositivo. Identificador exclusivo emitido pelo IoT Platform para o dispositivo. Nota Se você especificar este parâmetro, não será necessário especificar ProductKey ou DeviceName. O parâmetro IotId define um identificador globalmente exclusivo (GUID) do dispositivo, correspondente à combinação de ProductKey e DeviceName. Se você especificar tanto o IotId quanto a combinação de ProductKey e DeviceName, o IotId terá precedência.

Além dos parâmetros específicos desta operação, especifique os parâmetros de solicitação comuns ao chamá-la. Para obter mais informações, consulte Parâmetros de solicitação comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.system.SystemException	Código de erro retornado se a chamada falhar. Para obter mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada se a chamada falhar.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada foi bem-sucedida. false: A chamada falhou.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

<DeleteDeviceFileResponse>
  <RequestId>C25255EA-9F6E-4E04-85FE-AC1E9C136EBB</RequestId>
  <Success>true</Success>
</DeleteDeviceFileResponse>

Formato JSON

{
    "RequestId": "C25255EA-9F6E-4E04-85FE-AC1E9C136EBB",
    "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.