你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ErrorCode 枚举

  • 参考

定义

命名空间:
Microsoft.Azure.Devices.Common.Exceptions
程序集:
Microsoft.Azure.Devices.dll
包:
Microsoft.Azure.Devices v1.38.1

常见 IoT 中心响应错误的错误代码。

public enum ErrorCode
type ErrorCode = 
Public Enum ErrorCode
继承
Enum
ErrorCode

字段

ArgumentInvalid 400004

请求有效负载中的某些内容无效。 有关无效内容的详细信息，请查看错误消息。
ArgumentNull 400005

有效负载中的某些内容意外为 null。 有关无效内容的详细信息，请查看错误消息。
BulkRegistryOperationFailure 400013

处理批量注册表操作时遇到错误。

由于此错误位于 4xx HTTP 状态代码范围内，因此服务检测到作业请求或用户输入存在问题。

DeviceAlreadyExists 409001

IoT 中心内已有具有相同设备 ID 的设备。

当使用 IoT 中心内已存在的设备进行调用 AddDeviceAsync(Device, CancellationToken) 时，可以返回此值。

DeviceDefinedMultipleTimes 400011

在批量设备注册表操作的输入请求中多次出现具有相同 ID 的设备。

有关批量注册表操作的详细信息，请参阅 https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry。

DeviceMaximumQueueDepthExceeded 403004

根本原因是设备排队的云到设备消息数超出了队列限制。

需要接收和完成/拒绝来自设备端的消息，然后才能将任何其他消息排入队列。 如果要放弃当前排队的消息，可以 清除设备消息队列。 有关云到设备的消息操作的详细信息，请参阅 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d。

DeviceNotFound 404001

操作失败，因为 IoT 中心找不到设备。

设备未注册或已禁用。 可能由等 GetDeviceAsync(String)操作引发。

InvalidErrorCode 0

在无法识别中心返回的错误代码时使用。 如果遇到问题，请报告问题，以便可以在此处添加。
InvalidOperation 400003

客户端已请求中心识别为无效的操作。 有关无效内容的详细信息，请查看错误消息。
InvalidProtocolVersion 400001

此连接中使用的 IoT 中心终结点不支持 SDK 使用的 API 版本。

这通常意味着中心的区域尚不支持 API 版本。 应考虑降级到使用较旧 API 版本的 SDK 早期版本，或在支持它的区域中使用中心。

IotHubFormatError 400006

如果无法分析此库提供的 JSON 对象（例如，如果提供的 UpdateTwinAsync(String, Twin, String) JSON 无效），则由服务返回。
IotHubQuotaExceeded 403002

中心上的消息总数超过了分配的配额。

增加此中心的单位数以增加配额。 有关配额的详细信息，请参阅 https://aka.ms/iothubthrottling。

IotHubUnauthorizedAccess 401002

SAS 令牌已过期，或者 IoT 中心无法对身份验证标头、规则或密钥进行身份验证。 有关详细信息，请参阅 https://docs.microsoft.com/azure/iot-hub/iot-hub-troubleshoot-error-401003-iothubunauthorized。
MessageTooLarge 413001

当消息对于 IoT 中心来说太大时，将收到此错误。

应尝试减小消息大小，然后再次发送。 有关消息大小的详细信息，请参阅 IoT 中心配额和限制 |其他限制
ModuleAlreadyExistsOnDevice 409301

操作失败，因为它尝试将模块添加到设备时，该设备已经向该设备注册了具有相同 ID 的模块。此问题可以通过先使用 RemoveModuleAsync(Module)从设备中删除现有模块来修复。 此错误代码仅从等 AddModuleAsync(Module, CancellationToken)方法返回。
ModuleNotFound 404010

操作失败，因为 IoT 中心找不到该模块。

模块未注册或已禁用。 可能由等 GetModuleAsync(String, String)操作引发。

PreconditionFailed 412001

根据 RFC7232，请求中的 ETag 与现有资源的 ETag 不匹配。

ETag 是一种机制，用于防止多个客户端更新同一资源并相互覆盖的争用条件。 若要获取孪生体的最新 ETag，请参阅 GetTwinAsync(String, CancellationToken) 或 GetTwinAsync(String, String, CancellationToken)。

ServerError 500001

IoT 中心遇到服务器端问题。

500xxx 错误响应可能有多种原因。 在所有情况下，此问题很可能是暂时性的。 IoT 中心节点偶尔会遇到暂时性故障。 当应用程序尝试连接到出现问题的节点时，会收到此错误。 若要缓解 500xxx 错误，请从应用程序发出重试。

ServiceUnavailable 503001

IoT 中心当前无法处理请求。 这是暂时性的可重试错误。
ThrottleBacklogLimitExceeded 429002

已超出所请求操作的 IoT 中心限制。

有关详细信息，请参阅 IoT 中心配额和限制。

ThrottlingException 429001

已超出所请求操作的 IoT 中心限制。 有关详细信息，请参阅 IoT 中心配额和限制。
TooManyDevices 413002

批量操作中包含过多设备。

有关详细信息，请查看响应。 有关详细信息，请参阅 https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry。

适用于