Partilhar via


IotHubServiceErrorCode Enumeração

Definição

Códigos de erro para erros comuns de resposta do Hub IoT.

public enum IotHubServiceErrorCode
type IotHubServiceErrorCode = 
Public Enum IotHubServiceErrorCode
Herança
IotHubServiceErrorCode

Campos

ArgumentInvalid 400004

Algo no conteúdo da solicitação é inválido. Verifique a mensagem de erro para obter mais informações sobre o que é inválido.

ArgumentNull 400005

Algo no conteúdo é inesperadamente nulo. Verifique a mensagem de erro para obter mais informações sobre o que é inválido.

BulkRegistryOperationFailure 400013

Foi encontrado um erro ao processar operações de registro em massa.

Como esse erro está no intervalo de código de status HTTP 4xx, o serviço teria detectado um problema com a solicitação de trabalho ou a entrada do usuário.

DeviceAlreadyExists 409001

Já existe um dispositivo com a mesma ID de dispositivo no Hub IoT.

Isso pode ser retornado ao chamar CreateAsync(Device, CancellationToken) com um dispositivo que já existe no Hub IoT.

DeviceDefinedMultipleTimes 400011

Um dispositivo com a mesma ID estava presente várias vezes na solicitação de entrada para operações de registro de dispositivo em massa.

Para obter mais informações sobre operações de registro em massa, consulte https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry.

DeviceMaximumQueueDepthExceeded 403004

A causa subjacente é que o número de mensagens de nuvem para dispositivo enfileiradas para o dispositivo excede o limite da fila.

Você precisará receber e concluir/rejeitar as mensagens do lado do dispositivo antes de poder enfileirar mensagens adicionais. Se você quiser descartar as mensagens enfileiradas no momento, poderá limpar a fila de mensagens do dispositivo. Para obter mais informações sobre operações de mensagem de nuvem para dispositivo, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d.

DeviceNotFound 404001

A operação falhou porque o dispositivo não pode ser encontrado pelo Hub IoT.

O dispositivo não está registrado ou desabilitado. Pode ser gerado por operações como GetAsync(String, CancellationToken).

DeviceNotOnline 404103

A operação falhou porque o dispositivo solicitado não está online ou não registrou o retorno de chamada do método direto.

InvalidOperation 400003

O cliente solicitou uma operação que o hub reconhece como inválida. Verifique a mensagem de erro para obter mais informações sobre o que é inválido.

InvalidProtocolVersion 400001

A versão da API usada pelo SDK não é compatível com o ponto de extremidade do Hub IoT usado nessa conexão.

Normalmente, isso significaria que a região do hub ainda não dá suporte à versão da API. É necessário considerar o downgrade para uma versão anterior do SDK que usa uma versão mais antiga da API ou usar um hub em uma região compatível com ele.

IotHubFormatError 400006

Retornado pelo serviço se um objeto JSON fornecido por essa biblioteca não puder ser analisado, por exemplo, se o JSON fornecido for UpdateAsync(String, ClientTwin, Boolean, CancellationToken) inválido.

IotHubQuotaExceeded 403002

O número total de mensagens no hub excedeu a cota alocada.

Aumente as unidades para esse hub para aumentar a cota. Para obter mais informações sobre cota, consulte https://aka.ms/iothubthrottling.

IotHubSuspended 400020

A operação falhou porque o hub IoT foi suspenso.

IotHubUnauthorizedAccess 401002

O token SAS expirou ou o hub IoT não pôde autenticar o cabeçalho, a regra ou a chave de autenticação. Para obter mais informações, consulte https://docs.microsoft.com/azure/iot-hub/iot-hub-troubleshoot-error-401003-iothubunauthorized.

MessageTooLarge 413001

Quando a mensagem for muito grande para o Hub IoT, você receberá esse erro.

Você deve tentar reduzir o tamanho da mensagem e enviar novamente. Para obter mais informações sobre tamanhos de mensagem, consulte Cotas e limitação do hub IoT | Outros limites

ModuleAlreadyExistsOnDevice 409301

A operação falhou porque tentou adicionar um módulo a um dispositivo quando esse dispositivo já tem um módulo registrado com a mesma ID. Esse problema pode ser corrigido removendo o módulo existente do dispositivo primeiro com DeleteAsync(Module, Boolean, CancellationToken). Esse código de erro só é retornado de métodos como CreateAsync(Module, CancellationToken).

ModuleNotFound 404010

A operação falhou porque o módulo não pode ser encontrado pelo hub IoT.

O módulo não está registrado ou desabilitado. Pode ser gerado por operações como GetAsync(String, String, CancellationToken).

PreconditionFailed 412001

A ETag na solicitação não corresponde à ETag do recurso existente, de acordo com RFC7232.

A ETag é um mecanismo para proteger contra as condições de corrida de vários clientes atualizando o mesmo recurso e substituindo uns aos outros. Para obter a ETag atualizada para um gêmeo, consulte GetAsync(String, CancellationToken) ou GetAsync(String, String, CancellationToken).

ServerError 500001

O hub IoT encontrou um problema no lado do servidor.

Pode haver várias causas para uma resposta de erro 500xxx. Em todos os casos, é mais provável que o problema seja transitório. Os nós do hub IoT podem ocasionalmente enfrentar falhas transitórias. Quando seu aplicativo tenta se conectar a um nó que está tendo problemas, você recebe esse erro. Para atenuar erros de 500xxx, emita uma nova tentativa do aplicativo.

ServiceUnavailable 503001

No momento, o Hub IoT não consegue processar a solicitação. Esse é um erro transitório e repetível.

ThrottlingException 429001

Os limites de limitação do hub IoT foram excedidos para a operação solicitada. Para obter mais informações, cotas e limitação do hub IoT.

TooManyDevices 413002

Muitos dispositivos foram incluídos na operação em massa.

Verifique a resposta para obter detalhes. Para obter mais informações, consulte https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry.

Unknown 0

Usado quando o código de erro retornado pelo hub não é reconhecido. Se encontrado, relate o problema para que ele possa ser adicionado aqui.

Aplica-se a