Configuración de alojamiento estático de sitios web para un bucket

Funciones

OBS le permite almacenar recursos de páginas web estáticas como páginas web HTML, archivos flash, vídeos y audios en un bucket. Cuando un cliente accede a estos recursos desde el endpoint del sitio web del bucket, el navegador puede resolver y presentar directamente los recursos al cliente. Esta operación es aplicable a:

• Redirigir todas las solicitudes a un endpoint del sitio web.
• Agregar las reglas de enrutamiento que redirigen solicitudes específicas.

Puede realizar esta operación para crear o actualizar la configuración del sitio web de un bucket.

Para realizar esta operación, debe tener el permiso PutBucketWebsite. De forma predeterminada, solo el propietario del bucket puede realizar esta operación. El propietario del bucket puede conceder el permiso a otros usuarios configurando la política de bucket o la política de usuario.

Evite usar (.) de períodos en el nombre del bucket de destino. De lo contrario, pueden producirse errores en el certificado de autenticación de cliente cuando los usuarios usan HTTPS para el acceso.

El tamaño máximo de una solicitud de configuración de red para un bucket es de 10 KB.

Sintaxis de solicitud

1
2
3
4
5
6
7
8
9

PUT /?website HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Content-Length: length
Date: date
Authorization: authorization
<WebsiteConfiguration> 
    <RedirectAllRequestsTo> 
        <HostName>hostName</HostName> 
    </RedirectAllRequestsTo> 
</WebsiteConfiguration>

Parámetros de solicitud

Esta solicitud no contiene ningún parámetro.

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 3.

Elementos de solicitud.

Esta solicitud contiene los elementos para especificar la configuración del sitio web en formato XML.

• Para redirigir todas las solicitudes de sitio web enviadas al extremo del sitio web del bucket, agregue los elementos como se describe en Tabla 1.

  Tabla 1 Elementos para redirigir todas las solicitudes de sitios web

  Elemento	Descripción	Obligatorio
  WebsiteConfiguration	Nodo raíz configurado en el sitio web Tipo: element Antepasado: ninguno	Sí
  RedirectAllRequestsTo	Describe el comportamiento de redirección para cada solicitud al endpoint del sitio web de este bucket. Si este elemento está presente, no se permiten otros hermanos. Tipo: element Antepasado: WebsiteConfiguration	Sí
  HostName	Nombre del host al que se redirigirán las solicitudes Tipo: string Antepasado: RedirectAllRequestsTo	Sí
  Protocol	El protocolo HTTP o HTTPS utilizado para redirigir solicitudes. El protocolo predeterminado es HTTP. Tipo: string Antepasado: RedirectAllRequestsTo	No

• Para configurar reglas de redirección, agregue los elementos como se describe en Tabla 2.

  Tabla 2 Elementos para agregar reglas que redirigen solicitudes

  Elemento	Descripción	Obligatorio
  WebsiteConfiguration	Elemento raíz para la configuración del sitio web Tipo: element Antepasado: ninguno	Sí
  IndexDocument	Elemento Suff Tipo: element Antepasado: WebsiteConfiguration	Sí
  Suffix	Suffix que se agrega a una solicitud iniciada para un directorio en el endpoint del sitio web. Por ejemplo, si el suffix es index.html y solicita samplebucket/images/, los datos que se devuelven serán para el objeto con el nombre de clave images/index.html en el bucket samplebucket. Suffix no puede estar vacío ni contener barras diagonales (/). Tipo: string Antepasado: IndexDocument	Sí
  ErrorDocument	Elemento Key Tipo: element Antepasado: WebsiteConfiguration	No
  Key	Clave de objeto que se utiliza cuando se produce un error 4XX. Este elemento identifica la página que se devuelve cuando se produce un error 4XX. Tipo: string Antepasado: ErrorDocument Condición: Requerido cuando se especifica ErrorDocument.	No
  RoutingRules	Elemento Routing Tipo: element Antepasado: WebsiteConfiguration	No
  RoutingRule	Elemento de una regla de redirección. Una regla de redirección contiene una Condition y una Redirect. Cuando se coincide con la Condition, Redirect entra en efecto. Tipo: element Antepasado: RoutingRules Se requiere al menos el elemento RoutingRule.	Sí
  Condition	Elemento para describir una condición que debe cumplirse para que se aplique la redirección especificada. Tipo: element Antepasado: RoutingRule	No
  KeyPrefixEquals	Prefijo de nombre de clave de objeto cuando se aplica la redirección. Por ejemplo: Para redirigir la solicitud del objeto ExamplePage.html, KeyPrefixEquals se establece en ExamplePage.html. Tipo: string Antepasado: Condition Condición: Requerido cuando se especifica el elemento antecesor Condition y no se especifica HttpErrorCodeReturnedEquals hermano. Si se especifican dos condiciones, ambas condiciones deben ser verdaderas para que se aplique el Redirect.	No
  HttpErrorCodeReturnedEquals	Código de error HTTP devuelto después de que Redirect haya tenido efecto. El Redirect especificado se aplica solo cuando el código de error devuelto es igual a este valor. Por ejemplo: Si desea redirigir las solicitudes a NotFound.html cuando se devuelve el código de error HTTP 404, establezca HttpErrorCodeReturnedEquals en 404 en Condition, y establezca ReplaceKeyWith en NotFound.html en Redirect. Tipo: string Antepasado: Condition Condición: Requerido cuando se especifica el elemento antepasado Condition y no se especifica KeyPrefixEquals del mismo nivel. Si se especifican varias condiciones, Redirect solo tiene efecto después de que se cumplan todas las condiciones.	No
  Redirect	Elemento para la información de redirección. Puede redirigir las solicitudes a otro host, a otra página web o con otro protocolo. Puede especificar un código de error que se devolverá después de un error. Tipo: element Antepasado: RoutingRule	Sí
  Protocol	Protocolo utilizado en la solicitud de redirección Tipo: string Antepasado: Redirect Opciones de valor: http, https Condición: No es necesario si uno de los hermanos está presente.	No
  HostName	Nombre de host utilizado en la solicitud de redirección. Tipo: string Antepasado: Redirect Condición: No es necesario si uno de los hermanos está presente.	No
  ReplaceKeyPrefixWith	Prefijo de clave de objeto utilizado en la solicitud de redirección. Por ejemplo: Para redirigir todas las solicitudes de documentos (objetos bajo) a documentos (objetos bajo), establezca KeyPrefixEquals a documentos en Condition y ReplaceKeyPrefixWith a documentos en Redirect. Tipo: string Antepasado: Redirect Condición: No es necesario si uno de los hermanos está presente. Puede estar presente solo si no se proporciona ReplaceKeyWith.	No
  ReplaceKeyWith	Clave de objeto utilizada en la solicitud de redirección. Por ejemplo, redirigir solicitudes a error.html. Tipo: string Antepasado: Redirect Condición: No es necesario si uno de los hermanos está presente. Puede estar presente solo si no se proporciona ReplaceKeyPrefixWith.	No
  HttpRedirectCode	Código de estado HTTP devuelto después de la solicitud de redirección Tipo: string Antepasado: Redirect Condición: No es necesario si uno de los hermanos está presente.	No

Sintaxis de respuesta

1
2
3

HTTP/1.1 status_code
Date: date
Content-Length: length

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta no contiene elemento.

Respuestas de error

No se devuelven respuestas de error especiales. Para obtener más información sobre las respuestas de error, consulte Tabla 2.

Modelo de solicitud

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

PUT /?website HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: WED, 01 Jul 2015 03:40:29 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:pUK7Yp0yebnq4P6gqzVjoS7whoM=
Content-Length: 194

<WebsiteConfiguration xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <RedirectAllRequestsTo>
    <HostName>www.huaweicloud.com</HostName>
  </RedirectAllRequestsTo>
</WebsiteConfiguration>

Modelo de respuesta

1
2
3
4
5
6

HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF2600000164360D144670B9D02AABC6
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSItqMZ/AoFUX97l1xx8s67V3cCQtXWk
Date: WED, 01 Jul 2015 03:40:29 GMT
Content-Length: 0