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

Limites de QPS

Cada conta pode chamar esta API até 50 vezes por segundo.

Nota

Usuários RAM compartilham a cota da conta Alibaba Cloud.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar o OpenAPI Explorer para chamar esta operação. A ferramenta 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	QueryImportedDeviceByApplyId	Operação a executar. Defina o valor como QueryImportedDeviceByApplyId.
ApplyId	Long	Sim	1295006	ID da solicitação. Chame a operação BatchImportDevice para obter esse ID.
PageNo	Integer	Sim	1	Número da página a retornar. Valores válidos: 1 a 10000.
PageSize	Integer	Sim	10	Quantidade de entradas a retornar por página. Valor padrão: 10. Valor máximo: 50.
IotInstanceId	String	Não	iot-1n8t****	ID da instância. Encontre o ID na página Overview do console IoT Platform. Importante Se a instância tiver um ID, especifique-o. Caso contrário, a chamada falhará. Se não houver página Overview ou ID gerado para a instância, omita este parâmetro. Para mais informações, consulte Visão geral.

Além dos parâmetros específicos desta operação, especifique os parâmetros comuns de solicitação ao fazer esta chamada. Para mais detalhes, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalPage	Integer	100	Número total de páginas retornadas.
PageNo	Integer	1	Número da página retornada.
PageSize	Integer	10	Quantidade de entradas retornadas por página.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	ID da solicitação.
ProductKey	String	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence.
DeviceList	Array of device		Detalhes dos dispositivos retornados.
device
DeviceName	String	light	DeviceName do dispositivo. Importante Mantenha esta informação confidencial.
DeviceSecret	String	b4d43f7******10ba5e5	DeviceSecret do dispositivo. Importante Mantenha esta informação confidencial.
ProductKey	String	a1BwAGV****	ProductKey do produto ao qual o dispositivo pertence.
Sn	String	QC4******001	Número de série (SN) do dispositivo. Nota Este parâmetro estará vazio se nenhum SN for especificado para o dispositivo.
Code	String	iot.system.SystemException	Código de erro retornado caso a chamada falhe. Para mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada caso a chamada falhe.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. Valores válidos: true: A chamada foi bem-sucedida. false: A chamada falhou.

Exemplos

Exemplo de solicitação

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryImportedDeviceByApplyId
&ApplyId=1295006
&PageNo=1
&PageSize=10
&IotInstanceId=iot-1n8t****
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

<QueryImportedDeviceByApplyIdResponse>
  <TotalPage>100</TotalPage>
  <PageSize>10</PageSize>
  <PageNo>1</PageNo>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <ProductKey>a1BwAGV****</ProductKey>
  <DeviceList>
        <device>
              <DeviceSecret>b4d43f7******10ba5e5</DeviceSecret>
              <Sn>QC4******001</Sn>
              <ProductKey>a1BwAGV****</ProductKey>
              <DeviceName>light</DeviceName>
        </device>
  </DeviceList>
  <Success>true</Success>
</QueryImportedDeviceByApplyIdResponse>

Formato JSON

{
    "TotalPage": 100,
    "PageSize": 10,
    "PageNo": 1,
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "ProductKey": "a1BwAGV****",
    "DeviceList": {
        "device": {
            "DeviceSecret": "b4d43f7******10ba5e5",
            "Sn": "QC4******001",
            "ProductKey": "a1BwAGV****",
            "DeviceName": "light"
        }
    },
    "Success": true
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
200	iot.device.DeviceApplyIsNotFound	The application ID for the device does not exist.	O ID da solicitação especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.