HttpError 类

从 Dataverse Web API 引发 HTTP 请求失败的异常。

构造函数

HttpError(message: str, status_code: int, is_transient: bool = False, subcode: str | None = None, service_error_code: str | None = None, correlation_id: str | None = None, client_request_id: str | None = None, service_request_id: str | None = None, traceparent: str | None = None, body_excerpt: str | None = None, retry_after: int | None = None, details: Dict[str, Any] | None = None)

参数

名称	说明
message 必需	str 人工可读 HTTP 错误消息，通常来自 API 错误响应。
status_code 必需	int HTTP 状态代码（例如 400、404、500）。
is_transient	bool 错误是否是暂时性的（429、503、504），在重试时可能会成功。 默认值: False
subcode	str | None 可选 HTTP 状态类别（例如 "4xx"， "5xx"）。 默认值: None
service_error_code	str | None API 响应中特定于 Dataverse 的可选错误代码。 默认值: None
correlation_id	str | None 可选客户端生成的关联 ID，用于跟踪 SDK 调用中的请求。 默认值: None
client_request_id	str | None 向出站标头注入的可选客户端生成的请求 ID。 默认值: None
service_request_id	str | None Dataverse 服务器返回的可选 x-ms-service-request-id 值。 默认值: None
traceparent	str | None 分布式跟踪的可选 W3C 跟踪上下文。 默认值: None
body_excerpt	str | None 诊断响应正文的可选摘录。 默认值: None
retry_after	int | None 在重试（从 Retry-After 标头）之前等待的可选秒数。 默认值: None
details	dict | None 可选其他诊断详细信息。 默认值: None