HttpStatusCode 列舉

定義

包含依據 RFC 9110 第 15 節定義的 HTTP 狀態碼值。

public enum class HttpStatusCode
public enum HttpStatusCode
type HttpStatusCode = 
Public Enum HttpStatusCode
繼承
HttpStatusCode

欄位

名稱 Description
Continue 100

相當於 HTTP 狀態 100。 Continue 表示客戶端可以繼續執行其請求。

SwitchingProtocols 101

相當於 HTTP 狀態 101。 SwitchingProtocols 表示協定版本或協定正在變更。

Processing 102

相當於 HTTP 狀態 102。 Processing 表示伺服器已接受完整請求,但尚未完成。

EarlyHints 103

相當於 HTTP 狀態 103。 EarlyHints 向用戶端表示伺服器很可能會發送包含標頭欄位的最終回應。

OK 200

相當於 HTTP 狀態 200。 OK 表示請求已成功,且所請求的資訊已包含在回應中。 這是最常見的狀態代碼。

Created 201

相當於 HTTP 狀態 201。 Created 表示請求在回應發送前已產生新資源。

Accepted 202

相當於 HTTP 狀態 202。 Accepted 表示請求已被接受,需進一步處理。

NonAuthoritativeInformation 203

相當於 HTTP 狀態 203。 NonAuthoritativeInformation 表示回傳的元資訊來自快取副本,而非原始伺服器,因此可能不正確。

NoContent 204

相當於 HTTP 狀態 204。 NoContent 表示請求已成功處理,且回應是故意空白的。

ResetContent 205

相當於 HTTP 狀態 205。 ResetContent 表示用戶端應該重置(而非重新載入)目前資源。

PartialContent 206

相當於 HTTP 狀態 206。 PartialContent 表示回應是部分回應,這是由包含位元組範圍的 GET 請求所要求的。

MultiStatus 207

相當於 HTTP 狀態 207。 MultiStatus 表示在網路分散式撰寫與版本管理(WebDAV)操作期間,單一回應的多個狀態碼。 回應主體包含描述狀態碼的 XML。

AlreadyReported 208

相當於 HTTP 狀態 208。 AlreadyReported 表示 WebDAV 綁定的成員已在多狀態回應的前一部分被列舉,且不會再被納入。

IMUsed 226

相當於 HTTP 狀態 226。 IMUsed 表示伺服器已完成該資源的請求,回應則是對當前實例施加一個或多個實例操作的結果。

Ambiguous 300

相當於 HTTP 狀態 300。 Ambiguous 表示所請求資訊具有多種表示方式。 預設操作是將此狀態視為重定向,並依照與此回應相關的 Location 標頭內容執行。 AmbiguousMultipleChoices同義。

MultipleChoices 300

相當於 HTTP 狀態 300。 MultipleChoices 表示所請求資訊具有多種表示方式。 預設操作是將此狀態視為重定向,並依照與此回應相關的 Location 標頭內容執行。 MultipleChoicesAmbiguous同義。

Moved 301

相當於 HTTP 狀態 301。 Moved 表示所請求的資訊已被移至位置標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。 MovedMovedPermanently同義。

MovedPermanently 301

相當於 HTTP 狀態 301。 MovedPermanently 表示所請求的資訊已被移至位置標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 MovedPermanentlyMoved同義。

Found 302

相當於 HTTP 狀態 302。 Found 表示所請求的資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。 FoundRedirect同義。

Redirect 302

相當於 HTTP 狀態 302。 Redirect 表示所請求的資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。 RedirectFound同義。

RedirectMethod 303

相當於 HTTP 狀態 303。 RedirectMethod 自動將用戶端導向至 Location 標頭中指定的 URI,這是 POST 的結果。 對 Location 標頭指定的資源的請求會以 GET 進行。 RedirectMethodSeeOther同義。

SeeOther 303

相當於 HTTP 狀態 303。 SeeOther 自動將用戶端導向至 Location 標頭中指定的 URI,這是 POST 的結果。 對 Location 標頭指定的資源的請求會以 GET 進行。 SeeOtherRedirectMethod同義。

NotModified 304

相當於 HTTP 狀態 304。 NotModified 表示用戶端快取的副本是最新的。 資源內容不會被轉移。

UseProxy 305

相當於 HTTP 狀態 305。 UseProxy 表示請求應使用位於 Location 標頭中指定的 URI 的代理伺服器。

Unused 306

相當於 HTTP 狀態 306。 Unused 是 HTTP/1.1 規範的一個提案擴充,尚未完全規範。

RedirectKeepVerb 307

相當於 HTTP 狀態 307。 RedirectKeepVerb 表示請求資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始要求方法為 POST 時,重新導向的要求也會使用 POST 方法。 RedirectKeepVerbTemporaryRedirect同義。

TemporaryRedirect 307

相當於 HTTP 狀態 307。 TemporaryRedirect 表示請求資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始要求方法為 POST 時,重新導向的要求也會使用 POST 方法。 TemporaryRedirectRedirectKeepVerb同義。

PermanentRedirect 308

相當於 HTTP 狀態 308。 PermanentRedirect 表示請求資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始要求方法為 POST 時,重新導向的要求也會使用 POST 方法。

BadRequest 400

相當於 HTTP 狀態 400。 BadRequest 表示伺服器無法理解該請求。 BadRequest 當沒有其他錯誤適用,或確切錯誤未知或沒有自己的錯誤碼時會發送。

Unauthorized 401

相當於 HTTP 狀態 401。 Unauthorized 表示所請求的資源需要認證。 WWW-Authenticate 標頭包含如何執行認證的詳細資訊。

PaymentRequired 402

相當於 HTTP 狀態 402。 PaymentRequired 保留給未來使用。

Forbidden 403

相當於 HTTP 狀態 403。 Forbidden 表示伺服器拒絕執行該請求。

NotFound 404

相當於 HTTP 狀態 404。 NotFound 表示該請求的資源不存在於伺服器上。

MethodNotAllowed 405

相當於 HTTP 狀態 405。 MethodNotAllowed 表示請求方法(POST 或 GET)在所請求的資源上不被允許。

NotAcceptable 406

相當於 HTTP 狀態 406。 NotAcceptable 表示客戶端已以 Accept 標頭表示不接受任何可用的資源表示方式。

ProxyAuthenticationRequired 407

相當於 HTTP 狀態 407。 ProxyAuthenticationRequired 表示所請求的代理需要驗證。 Proxy-authenticate 標頭包含如何執行認證的詳細資訊。

RequestTimeout 408

相當於 HTTP 狀態 408。 RequestTimeout 表示用戶端未在伺服器預期的時間內發送請求。

Conflict 409

相當於 HTTP 狀態 409。 Conflict 表示因伺服器衝突無法執行請求。

Gone 410

相當於 HTTP 狀態 410。 Gone 表示所請求的資源已不再可用。

LengthRequired 411

相當於 HTTP 狀態 411。 LengthRequired 表示缺少所需的 Content-length 標頭。

PreconditionFailed 412

相當於 HTTP 狀態 412。 PreconditionFailed 表示該請求設定的條件失敗,且無法執行該請求。條件以條件請求標頭設定,如 If-Match、If-None-Match 或 If-Unmodified-Since 等。

RequestEntityTooLarge 413

相當於 HTTP 狀態 413。 RequestEntityTooLarge 表示請求過大,伺服器無法處理。

RequestUriTooLong 414

相當於 HTTP 狀態 414。 RequestUriTooLong 表示 URI 過長。

UnsupportedMediaType 415

相當於 HTTP 狀態 415。 UnsupportedMediaType 表示請求為不支援型態。

RequestedRangeNotSatisfiable 416

相當於 HTTP 狀態 416。 RequestedRangeNotSatisfiable 表示無法返回從資源請求的資料範圍,因為該範圍的起點在資源開始之前,或範圍的結束在資源結束之後。

ExpectationFailed 417

相當於 HTTP 狀態 417。 ExpectationFailed 表示 Expect 標頭中給出的期望無法被伺服器滿足。

MisdirectedRequest 421

相當於 HTTP 狀態 421。 MisdirectedRequest 表示請求是針對無法產生回應的伺服器。

UnprocessableEntity 422

相當於 HTTP 狀態 422。 UnprocessableEntity 表示請求是良好格式,但因語義錯誤無法執行。 UnprocessableEntityUnprocessableContent同義。

Locked 423

相當於 HTTP 狀態 423。 Locked 表示來源或目的資源被鎖定。

FailedDependency 424

相當於 HTTP 狀態 424。 FailedDependency 表示該方法無法對資源執行,因為請求的動作依賴另一個動作,而該動作失敗。

UpgradeRequired 426

相當於 HTTP 狀態 426。 UpgradeRequired 表示用戶端應切換至其他協定,如 TLS/1.0。

PreconditionRequired 428

相當於 HTTP 狀態 428。 PreconditionRequired 表示伺服器要求請求必須是有條件的。

TooManyRequests 429

相當於 HTTP 狀態 429。 TooManyRequests 表示使用者在限定時間內發送了過多請求。

RequestHeaderFieldsTooLarge 431

相當於 HTTP 狀態 431。 RequestHeaderFieldsTooLarge 表示伺服器不願處理請求,因為其標頭欄位(無論是單一標頭欄位或所有標頭欄位加起來)過大。

UnavailableForLegalReasons 451

相當於 HTTP 狀態 451。 UnavailableForLegalReasons 表示伺服器因法律要求而拒絕存取該資源。

InternalServerError 500

相當於 HTTP 狀態 500。 InternalServerError 表示伺服器上發生了通用錯誤。

NotImplemented 501

相當於 HTTP 狀態 501。 NotImplemented 表示伺服器不支援所請求的功能。

BadGateway 502

相當於 HTTP 狀態 502。 BadGateway 表示中介代理伺服器收到來自另一個代理伺服器或原始伺服器的錯誤回應。

ServiceUnavailable 503

相當於 HTTP 狀態 503。 ServiceUnavailable 表示伺服器暫時無法使用,通常是因為負載過高或維護過重。

GatewayTimeout 504

相當於 HTTP 狀態 504。 GatewayTimeout 表示中間代理伺服器在等待其他代理或原始伺服器回應時超時。

HttpVersionNotSupported 505

相當於 HTTP 狀態 505。 HttpVersionNotSupported 表示伺服器不支援所請求的 HTTP 版本。

VariantAlsoNegotiates 506

相當於 HTTP 狀態 506。 VariantAlsoNegotiates 表示所選變體資源本身已設定為進行透明內容協商,因此並非協商過程中的適當終點。

InsufficientStorage 507

相當於 HTTP 狀態 507。 InsufficientStorage 表示伺服器無法儲存完成請求所需的表示。

LoopDetected 508

相當於 HTTP 狀態 508。 LoopDetected 表示伺服器在處理一個 WebDAV 請求時遇到無限迴圈,導致操作終止,該請求為「深度:無限」。 此狀態碼是為了向下相容,讓用戶端無法察覺多狀態回應中出現的 208 狀態碼 AlreadyReported

NotExtended 510

相當於 HTTP 狀態 510。 NotExtended 表示伺服器需要進一步擴展請求才能完成。

NetworkAuthenticationRequired 511

相當於 HTTP 狀態 511。 NetworkAuthenticationRequired 表示用戶端需要認證才能取得網路存取;它主要用於攔截用來控制網路存取的代理伺服器。

適用於