HttpStatusCode HttpStatusCode HttpStatusCode HttpStatusCode Enum

Definición

Contiene los valores de los códigos de estado definidos para HTTP.Contains the values of status codes defined for HTTP.

public enum class HttpStatusCode
public enum HttpStatusCode
type HttpStatusCode = 
Public Enum HttpStatusCode
Herencia
HttpStatusCodeHttpStatusCodeHttpStatusCodeHttpStatusCode

Campos

Accepted Accepted Accepted Accepted 202

Equivalente al código de estado HTTP 202.Equivalent to HTTP status 202. Accepted indica que se aceptó la solicitud para su posterior procesamiento.Accepted indicates that the request has been accepted for further processing.

AlreadyReported AlreadyReported AlreadyReported AlreadyReported 208
Ambiguous Ambiguous Ambiguous Ambiguous 300

Equivalente al código de estado HTTP 300.Equivalent to HTTP status 300. Ambiguous indica que la información solicitada tiene varias representaciones.Ambiguous indicates that the requested information has multiple representations. La acción predeterminada consiste en tratar este estado como una redirección y seguir el contenido del encabezado Location asociado a esta respuesta.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. Ambiguous es un sinónimo de MultipleChoices.Ambiguous is a synonym for MultipleChoices.

BadGateway BadGateway BadGateway BadGateway 502

Equivalente al código de estado HTTP 502.Equivalent to HTTP status 502. BadGateway indica que un servidor proxy intermedio recibió una respuesta errónea de otro proxy o del servidor de origen.BadGateway indicates that an intermediate proxy server received a bad response from another proxy or the origin server.

BadRequest BadRequest BadRequest BadRequest 400

Equivalente al código de estado HTTP 400.Equivalent to HTTP status 400. BadRequest indica que el servidor no entendió la solicitud.BadRequest indicates that the request could not be understood by the server. Se envía BadRequest cuando ningún otro error es aplicable, se desconoce el error exacto o este no tiene su propio código de error.BadRequest is sent when no other error is applicable, or if the exact error is unknown or does not have its own error code.

Conflict Conflict Conflict Conflict 409

Equivalente al código de estado HTTP 409.Equivalent to HTTP status 409. Conflict indica que no se pudo realizar la solicitud debido a un conflicto en el servidor.Conflict indicates that the request could not be carried out because of a conflict on the server.

Continue Continue Continue Continue 100

Equivalente al código de estado HTTP 100.Equivalent to HTTP status 100. Continue indica que el cliente puede continuar con su solicitud.Continue indicates that the client can continue with its request.

Created Created Created Created 201

Equivalente al código de estado HTTP 201.Equivalent to HTTP status 201. Created indica que la solicitud dio como resultado un nuevo recurso creado antes de enviar la respuesta.Created indicates that the request resulted in a new resource created before the response was sent.

EarlyHints EarlyHints EarlyHints EarlyHints 103
ExpectationFailed ExpectationFailed ExpectationFailed ExpectationFailed 417

Equivalente al código de estado HTTP 417.Equivalent to HTTP status 417. ExpectationFailed indica que el servidor no pudo cumplir la expectativa dada en un encabezado Expect.ExpectationFailed indicates that an expectation given in an Expect header could not be met by the server.

FailedDependency FailedDependency FailedDependency FailedDependency 424
Forbidden Forbidden Forbidden Forbidden 403

Equivalente al código de estado HTTP 403.Equivalent to HTTP status 403. Forbidden indica que el servidor rechaza atender la solicitud.Forbidden indicates that the server refuses to fulfill the request.

Found Found Found Found 302

Equivalente al código de estado HTTP 302.Equivalent to HTTP status 302. Found indica que la información solicitada se encuentra en el URI especificado en el encabezado Location.Found indicates that the requested information is located at the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. Si el método de solicitud original era POST, la solicitud redirigida utilizará el método GET.When the original request method was POST, the redirected request will use the GET method. Found es un sinónimo de Redirect.Found is a synonym for Redirect.

GatewayTimeout GatewayTimeout GatewayTimeout GatewayTimeout 504

Equivalente al código de estado HTTP 504.Equivalent to HTTP status 504. GatewayTimeout indica que un servidor proxy intermedio agotó su tiempo de espera mientras aguardaba una respuesta de otro proxy o del servidor de origen.GatewayTimeout indicates that an intermediate proxy server timed out while waiting for a response from another proxy or the origin server.

Gone Gone Gone Gone 410

Equivalente al código de estado HTTP 410.Equivalent to HTTP status 410. Gone indica que el recurso solicitado ya no está disponible.Gone indicates that the requested resource is no longer available.

HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported HttpVersionNotSupported 505

Equivalente al código de estado HTTP 505.Equivalent to HTTP status 505. HttpVersionNotSupported indica que el servidor no admite la versión HTTP solicitada.HttpVersionNotSupported indicates that the requested HTTP version is not supported by the server.

IMUsed IMUsed IMUsed IMUsed 226
InsufficientStorage InsufficientStorage InsufficientStorage InsufficientStorage 507
InternalServerError InternalServerError InternalServerError InternalServerError 500

Equivalente al código de estado HTTP 500.Equivalent to HTTP status 500. InternalServerError indica que se produjo un error genérico en el servidor.InternalServerError indicates that a generic error has occurred on the server.

LengthRequired LengthRequired LengthRequired LengthRequired 411

Equivalente al código de estado HTTP 411.Equivalent to HTTP status 411. LengthRequired indica que falta el encabezado Content-Length requerido.LengthRequired indicates that the required Content-length header is missing.

Locked Locked Locked Locked 423
LoopDetected LoopDetected LoopDetected LoopDetected 508
MethodNotAllowed MethodNotAllowed MethodNotAllowed MethodNotAllowed 405

Equivalente al código de estado HTTP 405.Equivalent to HTTP status 405. MethodNotAllowed indica que no se permite el método de solicitud (POST o GET) en el recurso solicitado.MethodNotAllowed indicates that the request method (POST or GET) is not allowed on the requested resource.

MisdirectedRequest MisdirectedRequest MisdirectedRequest MisdirectedRequest 421
Moved Moved Moved Moved 301

Equivalente al código de estado HTTP 301.Equivalent to HTTP status 301. Moved indica que la información solicitada se ha trasladado al URI especificado en el encabezado Location.Moved indicates that the requested information has been moved to the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. Si el método de solicitud original era POST, la solicitud redirigida utilizará el método GET.When the original request method was POST, the redirected request will use the GET method. Moved es un sinónimo de MovedPermanently.Moved is a synonym for MovedPermanently.

MovedPermanently MovedPermanently MovedPermanently MovedPermanently 301

Equivalente al código de estado HTTP 301.Equivalent to HTTP status 301. MovedPermanently indica que la información solicitada se ha trasladado al URI especificado en el encabezado Location.MovedPermanently indicates that the requested information has been moved to the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. MovedPermanently es un sinónimo de Moved.MovedPermanently is a synonym for Moved.

MultipleChoices MultipleChoices MultipleChoices MultipleChoices 300

Equivalente al código de estado HTTP 300.Equivalent to HTTP status 300. MultipleChoices indica que la información solicitada tiene varias representaciones.MultipleChoices indicates that the requested information has multiple representations. La acción predeterminada consiste en tratar este estado como una redirección y seguir el contenido del encabezado Location asociado a esta respuesta.The default action is to treat this status as a redirect and follow the contents of the Location header associated with this response. MultipleChoices es un sinónimo de Ambiguous.MultipleChoices is a synonym for Ambiguous.

MultiStatus MultiStatus MultiStatus MultiStatus 207
NetworkAuthenticationRequired NetworkAuthenticationRequired NetworkAuthenticationRequired NetworkAuthenticationRequired 511
NoContent NoContent NoContent NoContent 204

Equivalente al código de estado HTTP 204.Equivalent to HTTP status 204. NoContent indica que la solicitud se procesó correctamente y la respuesta está intencionadamente en blanco.NoContent indicates that the request has been successfully processed and that the response is intentionally blank.

NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation NonAuthoritativeInformation 203

Equivalente al código de estado HTTP 203.Equivalent to HTTP status 203. NonAuthoritativeInformation indica que la metainformación devuelta procede de una copia almacenada en la memoria caché en lugar del servidor de origen y, por tanto, puede ser incorrecta.NonAuthoritativeInformation indicates that the returned metainformation is from a cached copy instead of the origin server and therefore may be incorrect.

NotAcceptable NotAcceptable NotAcceptable NotAcceptable 406

Equivalente al código de estado HTTP 406.Equivalent to HTTP status 406. NotAcceptable indica que el cliente ha señalado con encabezados Accept que ya no aceptará ninguna de las representaciones disponibles del recurso.NotAcceptable indicates that the client has indicated with Accept headers that it will not accept any of the available representations of the resource.

NotExtended NotExtended NotExtended NotExtended 510
NotFound NotFound NotFound NotFound 404

Equivalente al código de estado HTTP 404.Equivalent to HTTP status 404. NotFound indica que el recurso solicitado no existe en el servidor.NotFound indicates that the requested resource does not exist on the server.

NotImplemented NotImplemented NotImplemented NotImplemented 501

Equivalente al código de estado HTTP 501.Equivalent to HTTP status 501. NotImplemented indica que el servidor no admite la función solicitada.NotImplemented indicates that the server does not support the requested function.

NotModified NotModified NotModified NotModified 304

Equivalente al código de estado HTTP 304.Equivalent to HTTP status 304. NotModified indica que está actualizada la copia en caché del cliente.NotModified indicates that the client's cached copy is up to date. No se transfiere el contenido del recurso.The contents of the resource are not transferred.

OK OK OK OK 200

Equivalente al código de estado HTTP 200.Equivalent to HTTP status 200. OK indica que la solicitud se realizó correctamente y la información solicitada se incluye en la respuesta.OK indicates that the request succeeded and that the requested information is in the response. Este es el código de estado más habitual que se va a recibir.This is the most common status code to receive.

PartialContent PartialContent PartialContent PartialContent 206

Equivalente al código de estado HTTP 206.Equivalent to HTTP status 206. PartialContent indica que la respuesta es una respuesta parcial conforme a una solicitud GET que incluye un intervalo de bytes.PartialContent indicates that the response is a partial response as requested by a GET request that includes a byte range.

PaymentRequired PaymentRequired PaymentRequired PaymentRequired 402

Equivalente al código de estado HTTP 402.Equivalent to HTTP status 402. PaymentRequired se reserva para un uso futuro.PaymentRequired is reserved for future use.

PermanentRedirect PermanentRedirect PermanentRedirect PermanentRedirect 308
PreconditionFailed PreconditionFailed PreconditionFailed PreconditionFailed 412

Equivalente al código de estado HTTP 412.Equivalent to HTTP status 412. PreconditionFailed indica que se ha producido un error en una condición establecida para esta solicitud y no es posible realizar la solicitud. Las condiciones se establecen con encabezados de solicitud condicionales como If-Match, If-None-Match o If-Unmodified-Since.PreconditionFailed indicates that a condition set for this request failed, and the request cannot be carried out. Conditions are set with conditional request headers like If-Match, If-None-Match, or If-Unmodified-Since.

PreconditionRequired PreconditionRequired PreconditionRequired PreconditionRequired 428
Processing Processing Processing Processing 102
ProxyAuthenticationRequired ProxyAuthenticationRequired ProxyAuthenticationRequired ProxyAuthenticationRequired 407

Equivalente al código de estado HTTP 407.Equivalent to HTTP status 407. ProxyAuthenticationRequired indica que el proxy solicitado requiere autenticación.ProxyAuthenticationRequired indicates that the requested proxy requires authentication. El encabezado Proxy-authenticate contiene los detalles de cómo realizar la autenticación.The Proxy-authenticate header contains the details of how to perform the authentication.

Redirect Redirect Redirect Redirect 302

Equivalente al código de estado HTTP 302.Equivalent to HTTP status 302. Redirect indica que la información solicitada se encuentra en el URI especificado en el encabezado Location.Redirect indicates that the requested information is located at the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. Si el método de solicitud original era POST, la solicitud redirigida utilizará el método GET.When the original request method was POST, the redirected request will use the GET method. Redirect es un sinónimo de Found.Redirect is a synonym for Found.

RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb RedirectKeepVerb 307

Equivalente al código de estado HTTP 307.Equivalent to HTTP status 307. RedirectKeepVerb indica que la información de la solicitud se encuentra en el URI especificado en el encabezado Location.RedirectKeepVerb indicates that the request information is located at the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. Si el método de solicitud original era POST, la solicitud redirigida también utilizará el método GET.When the original request method was POST, the redirected request will also use the POST method. RedirectKeepVerb es un sinónimo de TemporaryRedirect.RedirectKeepVerb is a synonym for TemporaryRedirect.

RedirectMethod RedirectMethod RedirectMethod RedirectMethod 303

Equivalente al código de estado HTTP 303.Equivalent to HTTP status 303. RedirectMethod redirige automáticamente el cliente al URI especificado en el encabezado Location como resultado de una acción POST.RedirectMethod automatically redirects the client to the URI specified in the Location header as the result of a POST. La solicitud al recurso especificado por el encabezado Location se realizará con GET.The request to the resource specified by the Location header will be made with a GET. RedirectMethod es un sinónimo de SeeOther.RedirectMethod is a synonym for SeeOther.

RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable RequestedRangeNotSatisfiable 416

Equivalente al código de estado HTTP 416.Equivalent to HTTP status 416. RequestedRangeNotSatisfiable indica que no se puede devolver el intervalo de datos solicitado desde el recurso, porque el comienzo del intervalo se encuentra delante del comienzo del recurso o porque el final del intervalo se encuentra detrás del final del recurso.RequestedRangeNotSatisfiable indicates that the range of data requested from the resource cannot be returned, either because the beginning of the range is before the beginning of the resource, or the end of the range is after the end of the resource.

RequestEntityTooLarge RequestEntityTooLarge RequestEntityTooLarge RequestEntityTooLarge 413

Equivalente al código de estado HTTP 413.Equivalent to HTTP status 413. RequestEntityTooLarge indica que la solicitud es demasiado grande para que el servidor la pueda procesar.RequestEntityTooLarge indicates that the request is too large for the server to process.

RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge RequestHeaderFieldsTooLarge 431
RequestTimeout RequestTimeout RequestTimeout RequestTimeout 408

Equivalente al código de estado HTTP 408.Equivalent to HTTP status 408. RequestTimeout indica que el cliente no envió una solicitud en el intervalo de tiempo durante el cual el servidor la esperaba.RequestTimeout indicates that the client did not send a request within the time the server was expecting the request.

RequestUriTooLong RequestUriTooLong RequestUriTooLong RequestUriTooLong 414

Equivalente al código de estado HTTP 414.Equivalent to HTTP status 414. RequestUriTooLong indica que el URI es demasiado largo.RequestUriTooLong indicates that the URI is too long.

ResetContent ResetContent ResetContent ResetContent 205

Equivalente al código de estado HTTP 205.Equivalent to HTTP status 205. ResetContent indica que el cliente debe restablecer (no recargar) el recurso actual.ResetContent indicates that the client should reset (not reload) the current resource.

SeeOther SeeOther SeeOther SeeOther 303

Equivalente al código de estado HTTP 303.Equivalent to HTTP status 303. SeeOther redirige automáticamente el cliente al URI especificado en el encabezado Location como resultado de una acción POST.SeeOther automatically redirects the client to the URI specified in the Location header as the result of a POST. La solicitud al recurso especificado por el encabezado Location se realizará con GET.The request to the resource specified by the Location header will be made with a GET. SeeOther es un sinónimo de RedirectMethodSeeOther is a synonym for RedirectMethod

ServiceUnavailable ServiceUnavailable ServiceUnavailable ServiceUnavailable 503

Equivalente al código de estado HTTP 503.Equivalent to HTTP status 503. ServiceUnavailable indica que el servidor está temporalmente no disponible, normalmente por motivos de sobrecarga o mantenimiento.ServiceUnavailable indicates that the server is temporarily unavailable, usually due to high load or maintenance.

SwitchingProtocols SwitchingProtocols SwitchingProtocols SwitchingProtocols 101

Equivalente al código de estado HTTP 101.Equivalent to HTTP status 101. SwitchingProtocols indica que se está modificando la versión de protocolo o el protocolo.SwitchingProtocols indicates that the protocol version or protocol is being changed.

TemporaryRedirect TemporaryRedirect TemporaryRedirect TemporaryRedirect 307

Equivalente al código de estado HTTP 307.Equivalent to HTTP status 307. TemporaryRedirect indica que la información de la solicitud se encuentra en el URI especificado en el encabezado Location.TemporaryRedirect indicates that the request information is located at the URI specified in the Location header. La acción predeterminada cuando se recibe este estado es seguir el encabezado Location asociado a la respuesta.The default action when this status is received is to follow the Location header associated with the response. Si el método de solicitud original era POST, la solicitud redirigida también utilizará el método GET.When the original request method was POST, the redirected request will also use the POST method. TemporaryRedirect es un sinónimo de RedirectKeepVerb.TemporaryRedirect is a synonym for RedirectKeepVerb.

TooManyRequests TooManyRequests TooManyRequests TooManyRequests 429
Unauthorized Unauthorized Unauthorized Unauthorized 401

Equivalente al código de estado HTTP 401.Equivalent to HTTP status 401. Unauthorized indica que el recurso solicitado requiere autenticación.Unauthorized indicates that the requested resource requires authentication. El encabezado WWW-Authenticate contiene los detalles de cómo realizar la autenticación.The WWW-Authenticate header contains the details of how to perform the authentication.

UnavailableForLegalReasons UnavailableForLegalReasons UnavailableForLegalReasons UnavailableForLegalReasons 451
UnprocessableEntity UnprocessableEntity UnprocessableEntity UnprocessableEntity 422
UnsupportedMediaType UnsupportedMediaType UnsupportedMediaType UnsupportedMediaType 415

Equivalente al código de estado HTTP 415.Equivalent to HTTP status 415. UnsupportedMediaType indica que el tipo de la solicitud no es compatible.UnsupportedMediaType indicates that the request is an unsupported type.

Unused Unused Unused Unused 306

Equivalente al código de estado HTTP 306.Equivalent to HTTP status 306. Unused es una extensión propuesta de la especificación HTTP/1.1 que no está totalmente especificada.Unused is a proposed extension to the HTTP/1.1 specification that is not fully specified.

UpgradeRequired UpgradeRequired UpgradeRequired UpgradeRequired 426

Equivalente al código de estado HTTP 426.Equivalent to HTTP status 426. UpgradeRequired indica que el cliente debería cambiar a otro protocolo como TLS/1.0.UpgradeRequired indicates that the client should switch to a different protocol such as TLS/1.0.

UseProxy UseProxy UseProxy UseProxy 305

Equivalente al código de estado HTTP 305.Equivalent to HTTP status 305. UseProxy indica que la solicitud debe utilizar el servidor proxy en el URI especificado en el encabezado Location.UseProxy indicates that the request should use the proxy server at the URI specified in the Location header.

VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates VariantAlsoNegotiates 506

Ejemplos

En el ejemplo siguiente se compara el estado devuelto HttpWebResponse por un con un miembro HttpStatusCode de la clase para determinar el estado de una respuesta.The following example compares the status returned by an HttpWebResponse with a member of the HttpStatusCode class to determine the status of a response.

HttpWebRequest^ httpReq = dynamic_cast<HttpWebRequest^>(WebRequest::Create( "http://www.contoso.com" ));
httpReq->AllowAutoRedirect = false;
HttpWebResponse^ httpRes = dynamic_cast<HttpWebResponse^>(httpReq->GetResponse());
if ( httpRes->StatusCode == HttpStatusCode::Moved )
{
   // Code for moved resources goes here.
}

// Close the response.
httpRes->Close();
HttpWebRequest httpReq = (HttpWebRequest)WebRequest.Create("http://www.contoso.com");
httpReq.AllowAutoRedirect = false;

HttpWebResponse httpRes = (HttpWebResponse)httpReq.GetResponse();

if (httpRes.StatusCode==HttpStatusCode.Moved) 
{
    // Code for moved resources goes here.
}

// Close the response.
httpRes.Close();
Dim httpReq As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
httpReq.AllowAutoRedirect = False
       
Dim httpRes As HttpWebResponse = CType(httpReq.GetResponse(), HttpWebResponse)
       
If httpRes.StatusCode = HttpStatusCode.Moved Then
    ' Code for moved resources goes here.
End If

httpRes.Close()

Comentarios

La HttpStatusCode enumeración contiene los valores de los códigos de estado definidos en RFC 2616 para http 1,1.The HttpStatusCode enumeration contains the values of the status codes defined in RFC 2616 for HTTP 1.1.

El estado de una solicitud HTTP se incluye en la HttpWebResponse.StatusCode propiedad.The status of an HTTP request is contained in the HttpWebResponse.StatusCode property.
Si la HttpWebRequest.AllowAutoRedirect propiedad es false, los valores de enumeración siguientes hacen que se produzca una excepción:If the HttpWebRequest.AllowAutoRedirect property is false, the following enumeration values cause an exception to be thrown:

  • Ambiguous
  • Found
  • MultipleChoices
  • Redirect
  • RedirectKeepVerb
  • RedirectMethod
  • SeeOther
  • TemporaryRedirect

Se aplica a