HttpStatusCode 列舉
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
包含依據 RFC 9110 第 15 節定義的 HTTP 狀態碼值。
public enum class HttpStatusCode
public enum HttpStatusCode
type HttpStatusCode =
Public Enum 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 標頭內容執行。
|
| MultipleChoices | 300 | 相當於 HTTP 狀態 300。
MultipleChoices 表示所請求資訊具有多種表示方式。 預設操作是將此狀態視為重定向,並依照與此回應相關的 Location 標頭內容執行。
|
| Moved | 301 | 相當於 HTTP 狀態 301。
Moved 表示所請求的資訊已被移至位置標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。
|
| MovedPermanently | 301 | 相當於 HTTP 狀態 301。
MovedPermanently 表示所請求的資訊已被移至位置標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。
|
| Found | 302 | 相當於 HTTP 狀態 302。
Found 表示所請求的資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。
|
| Redirect | 302 | 相當於 HTTP 狀態 302。
Redirect 表示所請求的資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始請求方法為 POST 時,重定向請求會使用 GET 方法。
|
| RedirectMethod | 303 | 相當於 HTTP 狀態 303。
RedirectMethod 自動將用戶端導向至 Location 標頭中指定的 URI,這是 POST 的結果。 對 Location 標頭指定的資源的請求會以 GET 進行。
|
| SeeOther | 303 | 相當於 HTTP 狀態 303。
SeeOther 自動將用戶端導向至 Location 標頭中指定的 URI,這是 POST 的結果。 對 Location 標頭指定的資源的請求會以 GET 進行。
|
| 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 方法。
|
| TemporaryRedirect | 307 | 相當於 HTTP 狀態 307。
TemporaryRedirect 表示請求資訊位於 Location 標頭中指定的 URI。 當收到此狀態時,預設的操作是跟隨與回應相關的位置標頭。 當原始要求方法為 POST 時,重新導向的要求也會使用 POST 方法。
|
| 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 表示請求是良好格式,但因語義錯誤無法執行。
|
| 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 表示用戶端需要認證才能取得網路存取;它主要用於攔截用來控制網路存取的代理伺服器。 |