Compartilhar via


ErrorCode Enumeração

Definição

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

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

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

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á há um dispositivo com a mesma ID de dispositivo no Hub IoT.

Isso pode ser retornado ao chamar AddDeviceAsync(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 da nuvem para o 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 mensagens da nuvem para o 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 GetDeviceAsync(String).

InvalidErrorCode 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.

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. Deve-se considerar fazer 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 que dê suporte a 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 para UpdateTwinAsync(String, Twin, String) for inválido.

IotHubQuotaExceeded 403002

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

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

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 RemoveModuleAsync(Module). Esse código de erro só é retornado de métodos como AddModuleAsync(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 GetModuleAsync(String, String).

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 GetTwinAsync(String, CancellationToken) ou GetTwinAsync(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 ocasionalmente podem 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 seu aplicativo.

ServiceUnavailable 503001

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

ThrottleBacklogLimitExceeded 429002

Os limites de limitação do hub IoT foram excedidos para a operação solicitada.

Para obter mais informações, confira Cotas e limitação do hub IoT.

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.

Aplica-se a