Cabeceras y códigos de error comunes
Las transferencias de datos utilizan muchos protocolos estándares y tienen requisitos exclusivos. Manténgase al día en lo referente a cabeceras y códigos de error comunes.
Cabeceras de solicitud comunes
La siguiente tabla describe los encabezados de solicitud comunes compatibles. IBM Cloud® Object Storage ignora cualquier encabezado común que no figure en la lista siguiente si se envía como parte de una solicitud, aunque algunas solicitudes pueden admitir encabezados adicionales tal y como se definen en este documento.
| Cabecera | Nota |
|---|---|
| Autorización | Obligatoria para todas las solicitudes (señal OAuth2 bearer). |
ibm-service-instance-id |
Obligatoria para las solicitudes para crear o para obtener una lista de grupos. |
Content-MD5 |
El hash MD5 binario de 128 bits codificado en base 64, que se utiliza como comprobación de integridad para garantizar que la carga útil no se ha modificado durante el tránsito. La codificación base64 se debe llevar a cabo en la salida binaria del hash MD5, no en la representación hexadecimal. |
x-amz-checksum-crc32 |
Esta cabecera es la suma de comprobación de 32 bits CRC32 codificada en Base64 del objeto. |
x-amz-checksum-crc32c |
Esta cabecera es la suma de comprobación de 32 bits CRC32C codificada en Base64 del objeto. |
x-amz-checksum-crc64nvme |
Esta cabecera es la suma de comprobación de 64 bits CRC64NVME codificada en Base64 del objeto. La suma de comprobación de CRC64NVME es siempre una suma de comprobación de objeto completo. |
x-amz-checksum-sha1 |
Este encabezado es el Base64 codificado, 160-bit SHA1 digest del objeto. |
x-amz-checksum-sha256 |
Este encabezado es el Base64 codificado, 256-bit SHA256 digest del objeto. |
x-amz-sdk-checksum-algorithm |
Indica el algoritmo utilizado para crear la suma de comprobación del objeto cuando se utiliza el SDK. |
Expect |
El valor 100-continue espera a que el sistema reconozca que las cabeceras son apropiadas antes de enviar la carga útil. |
host |
El punto final o la sintaxis de 'host virtual' de {bucket-name}.{endpoint}. Generalmente esta cabecera se añade automáticamente. Para obtener más información sobre puntos finales, consulte Puntos finales y ubicaciones de almacenamiento |
Cache-Control |
Se puede utilizar para especificar el comportamiento de la memoria caché en la cadena de solicitud/respuesta. Para obtener más información, visite http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9 |
Metadatos personalizados
Una ventaja de utilizar Object Storage es la posibilidad de añadir metadatos personalizados mediante el envío de pares de clave-valor como cabeceras. Estas cabeceras adoptan la forma de x-amz-meta-{KEY}. Ten en cuenta que, a diferencia
de AWS S3, IBM Cloud Object Storage combina varios encabezados con la misma clave de metadatos en una lista de valores separados por comas.
Cabeceras de respuesta comunes
En la tabla siguiente se describen las cabeceras de respuesta comunes.
| Cabecera | Nota |
|---|---|
Content-Length |
La longitud del cuerpo de la solicitud en bytes. |
Connection |
Indica si la conexión está abierta o cerrada. |
Date |
Indicación de fecha y hora de la solicitud. |
ETag |
Valor de hash MD5 de la solicitud. |
Server |
Nombre del servidor que responde. |
X-Clv-Request-Id |
Identificador exclusivo que se genera por solicitud. |
Cabeceras de respuesta de ciclo de vida
En la tabla siguiente se describen las cabeceras de respuesta para objetos archivados
| Cabecera | Nota |
|---|---|
x-amz-restore |
Se incluye si el objeto se ha restaurado o si hay una restauración en curso. |
x-amz-storage-class |
Devuelve « GLACIER » o « ACCELERATED » si está archivado o se ha restaurado temporalmente. |
x-ibm-archive-transition-time |
Devuelve la fecha y la hora en que se ha planificado la transición del objeto al nivel de archivado. |
x-ibm-transition |
Se incluye si el objeto tiene metadatos de transición y devuelve el nivel y el tiempo original de la transición. |
x-ibm-restored-copy-storage-class |
Se incluye si un objeto se encuentra en los estados RestoreInProgress o Restored y devuelve la clase de almacenamiento del grupo. |
Consulta la documentación de la API para ver una lista de los códigos de error