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

Registra vários dispositivos em um produto. Os DeviceNames desses dispositivos são gerados aleatoriamente.

Observações de uso

Use um dos métodos a seguir para registrar vários dispositivos:

Para gerar DeviceNames aleatórios, chame a operação BatchRegisterDevice.

Siga as etapas abaixo para registrar os dispositivos e visualizar o resultado:

1. Chame a operação BatchRegisterDevice para registrar vários dispositivos. Uma resposta bem-sucedida indica que a solicitação de registro foi enviada. O processo real de registro ocorre de forma assíncrona e leva alguns minutos.

2. Chame a operação QueryBatchRegisterDeviceStatus para consultar o resultado do registro dos dispositivos.

3. Chame a operação QueryPageByApplyId para visualizar os detalhes dos dispositivos registrados, incluindo os parâmetros DeviceName, DeviceSecret e IotId.
Para especificar DeviceNames personalizados, chame a operação BatchRegisterDeviceWithApplyId. Para mais informações, consulte BatchRegisterDeviceWithApplyId.

Limites

É possível criar no máximo 10.000 dispositivos em uma única chamada.
Cada conta Alibaba Cloud pode executar no máximo 10 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 da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	BatchRegisterDevice	A operação a ser executada. Defina o valor como BatchRegisterDevice.
Count	Integer	Sim	100	O número de dispositivos a serem registrados. Nota É possível registrar até 10.000 dispositivos em uma única chamada.
ProductKey	String	Sim	a1BwAGV****	A ProductKey do produto ao qual os dispositivos pertencem.
IotInstanceId	String	Não	iot_instc_pu***_c-v64********	O 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 mais informações, consulte Visão geral.

Além dos parâmetros específicos da operação mencionados anteriormente, especifique os parâmetros de solicitação comuns ao chamar esta operação. Para 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	O código de erro retornado se a chamada falhar. Para mais informações, consulte Códigos de erro.
Data	Struct		Os dados retornados se a chamada for bem-sucedida.
ApplyId	Long	1295006	O ID da aplicação (ApplyId) retornado para a solicitação se a chamada for bem-sucedida.
ErrorMessage	String	A system exception occurred.	A mensagem de erro retornada se a chamada falhar.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	O 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=BatchRegisterDevice
&ProductKey=a1BwAGV****
&Count=10
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<BatchRegisterDeviceResponse>
  <Data>
        <ApplyId>12345678</ApplyId>
  </Data>
  <RequestId>92C67DC1-41B5-45F8-9AFD-1FB42448D405</RequestId>
  <Success>true</Success>
</BatchRegisterDeviceResponse>

Formato JSON

{
    "Data": {
        "ApplyId": 12345678
    },
    "RequestId": "92C67DC1-41B5-45F8-9AFD-1FB42448D405",
    "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.