Encabezados HTTP y parámetros de cadena de búsqueda para la API de XML

La API de XML de Cloud Storage usa varios encabezados HTTP estándar, así como varios encabezados HTTP (personalizados) de extensiones. Varios de los métodos HTTP también admiten parámetros de string de consulta. Los encabezados y los parámetros se describen a continuación.

Resumen de los encabezados HTTP y de los parámetros de string de consulta

La API de XML usa los siguientes encabezados HTTP estándar:

Solicitud Respuesta Ambos
Autorización
Contenido del MD5
Presentadoras
Si se encuentra una coincidencia
Si se modificó
Si la coincidencia coincide
Si no se modificó:
ETag
Lastltima modificación
Ubicación
Control de caché
Disposición del contenido
Codificación del contenido
Idioma del contenido
Duración del contenido
Rango de contenido
Tipo de contenido
Fecha
Autonomía
Codificación de transferencia

La API de XML usa los siguientes encabezados HTTP (personalizados):

Solicitud Respuesta Ambos
x-goog-acl
x-goog-api-version
x-goog-bucket-retention-period
x-goog-content-length-range
x-goog-content-sha256
x-goog-copy-source
x-goog-copy-source-generation
x-goog-copy-source-if-generation-match
x-goog-copy-source-if-match
x-goog-copy-source-if-metageneration-match
x-goog-copy-source-if-modified-since
x-goog-copy-source-if-none-match
x-goog-copy-source-if-unmodified-since
x-goog-date
x-goog-encryption-key
x-goog-encryption-kms-key-name
x-goog-if-generation-match
x-goog-if-metageneration-match
x-goog-metadata-directive
x-goog-project-id
x-goog-reiterable
x-goog-user-project
x-goog-component-count
x-goog-vencimiento
x-goog-generación
x-goog-generación
x-goog-stored-content-encoding
x-goog-stored-content-length
x-goog-custom-time
x-goog-encryption-algorithm
x-goog-encryption-key-sha256
x-goog-hash
x-goog-meta-
x-goog-storage-class

La API de XML usa los siguientes parámetros de cadena de consulta:

ID de clave de acceso
LCA
acción
la facturación
redactar
maíz
defaultObjectAcl
delimitador
tipo de codificación
encriptación
encryptionConfig
generación
marcador de generación
ciclo de vida ubicación
registro
marcador
Marcador
cantidad máxima de claves
Elementos máximos
prefijo
disposición-contenido-respuesta
tipo de contenido de respuesta
Estados
storageClass
etiquetado
ID de carga
NombredeUsuario
proyecto de usuario
control de versiones
versiones
sitio web
Algoritmo X-Goog
Credencial de X-Goog
X-Goog-Date
X-Goog-Expires
X-Goog-SignedHeaders
Firma X-Goog

Encabezados de HTTP estándar

Autorización

Un encabezado de solicitud que contiene una string utilizada para autenticar solicitudes.

Valores válidos Un identificador de autenticación ( Bearer | GOOG1 |AWS ) seguido de una de las siguientes opciones:
  • Un token de OAuth 2.0 válido
  • Una clave de acceso
  • Una firma
Ejemplo Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s- ...
Detalles Para obtener más información sobre cómo usar este encabezado, consulta Autenticación.

Nota:Si tus solicitudes se enrutan a través de un proxy, es posible que debas verificar con tu administrador de red para asegurarte de que el encabezado Authorization que contiene tus credenciales sea el proxy no la quita. Sin el encabezado Authorization, recibirás un error MissingSecurityHeader y se rechazará tu solicitud. Para obtener más información sobre cómo acceder a Cloud Storage a través de un servidor proxy, consulta el tema de solución de problemas.

Cache-Control

Un encabezado de solicitud y respuesta que especifique la configuración de control de caché

Valores válidos Cualquier valor de control de caché válido (consulta la especificación).
Ejemplo Cache-Control: public, max-age=6000
Detalles Debes especificar el control de caché solo para los objetos que son accesibles a todos los usuarios anónimos. Para poder acceder de forma anónima, la LCA de un objeto debe otorgar permiso READ o FULL_CONTROL a AllUsers. Si un objeto es accesible para todos los usuarios anónimos y no especificas una configuración de control de caché, Cloud Storage aplica una configuración de control de caché de 3,600 segundos. Cuando se entrega a través de XML, Cloud Storage respeta el control de caché del objeto según lo establecido por sus metadatos.

Content-Disposition

Un encabezado de solicitud y respuesta que especifica información de presentación sobre los datos que se transmiten

Valores válidos Cualquier valor de disposición de contenido válido (consulta la especificación).
Ejemplo Content-Disposition: attachment; filename=FILENAME
Detalles Si configuras el encabezado de disposición de contenido cuando subes un objeto, se entregará en el momento de la descarga (y, posteriormente, los navegadores web y otros clientes HTTP los interpretarán). Un uso común para la disposición de contenido se establece en attachment;filename=FILENAMEt y, por lo general, el navegador web abre un cuadro de diálogo "Guardar como...".

Content-Encoding

Un encabezado de solicitud y respuesta que especifique el algoritmo de compresión de un objeto

Valores válidos Cualquier algoritmo de compresión válido (consulta la especificación).
Ejemplo Content-Encoding: gzip
Detalles Cloud Storage no comprime ni descomprime los objetos. Si usas este encabezado para especificar un algoritmo de tipo de compresión (por ejemplo, deflate), Cloud Storage conserva el encabezado, pero no comprime ni descomprime el objeto.

Content-Language

Es el código de lenguaje ISO 639-1 del contenido.

Valores válidos Consulta la columna ISO 639-1 de Códigos para la representación de nombres de lenguajes a fin de obtener una lista de códigos de idioma.
Ejemplo Content-Language: en

Duración del contenido

La longitud (en bytes) del cuerpo de la solicitud o respuesta.

Valores válidos Cualquier valor de cero o superior.
Ejemplo Content-Length: 1234
Detalles Esto es obligatorio para todas las solicitudes, excepto las que usan codificación de transferencia fragmentada (consulta la especificación). Si no usas la codificación de transferencia fragmentada y no incluyes el encabezado Content-Length en una solicitud, la solicitud falla y Cloud Storage responde con un código de estado 411 obligatorio.

Contenido del MD5

Resumen MD5 del cuerpo de la solicitud

Valores válidos Un resumen de MD5 válido.
Ejemplo Content-MD5: iB94gawbwUSiZy5FuruIOQ==
Detalles Consulta la especificación. Cloud Storage puede usarlo para verificar la integridad de una operación de PUT.

Rango de contenido

Un encabezado de solicitud o respuesta que especifica un rango de bytes.

Valores válidos Cualquier rango de bytes válido.
Ejemplo Content-Range: bytes 456-987/1234
Detalles

Cuando aparece en una respuesta, el encabezado Content-Range indica el rango de bytes que se muestran como resultado de una solicitud que incluía un encabezado Range.

Cuando se incluye como parte de una solicitud de carga reanudable, Content-Range se usa para consultar la posición actual de la carga o como indicador del punto de partida de el bloque de datos que se sube en la solicitud actual

Los rangos de bytes son inclusivos. Es decir, bytes 0-999 representa los primeros 1,000 bytes en un archivo o objeto.

Para obtener detalles adicionales, en especial, sobre las respuestas a descargas, consulta la especificación.

Content-Type

Es el tipo de MIME de la solicitud o respuesta.

Valores válidos Cualquier tipo de MIME válido (consulta la especificación).
Ejemplo Content-Type: text/html
Detalles Si no especificas un tipo de contenido cuando subes un objeto, el sistema de Cloud Storage usa application/octet-stream de forma predeterminada cuando entrega el objeto.

Fecha

La fecha y hora de la solicitud o respuesta.

Valores válidos Una fecha y hora representadas en el formato HTTP convencional (consulta la especificación).
Ejemplo Date: Wed, 16 Jun 2010 11:11:11 GMT
Detalles Cuando se usa a fin de crear URL firmadas con el proceso de firma de V2, el formato debe estar en formato HTTP convencional. Consulta la sección 7.1.1.2 de la especificaciones. Cuando se usa el proceso de firma de V4, el formato debe estar en el formato básico YYYYMMDD'T'HHMMSS'Z' en formato ISO 8601.

ETag

Un encabezado de respuesta que contiene la etiqueta de la entidad del objeto al que se accede.

Valores válidos Una string de caracteres entre comillas. Para obtener más información, consulta Prácticas recomendadas para ETags y Hash.
Ejemplos ETag: "39a59594290b0f9a30662a56d695b71d"
ETag: "-CKicn4fknbUCEAE="
Detalles Consulta la especificación.

Host

Un encabezado de solicitud que especifica el URI para Cloud Storage.

Valores válidos Un formato válido para el URI.
Ejemplo Host: storage.googleapis.com
Detalles Para obtener más información sobre los URI válidos, consulta Solicita extremos y la especificación del host.

If-Match

Un encabezado de solicitud que especifica una etiqueta de entidad (ETag).

Valores válidos Una etiqueta de entidad válida.
Ejemplo If-Match: "881f7881ac1bc144a2672e45babb8839"
Detalles Solo se puede especificar una etiqueta de entidad (no una lista separada por comas de etiquetas de entidades). Puedes usar este encabezado con los objetos HEAD y el objeto GET de objeto. Si el ETag que especificas con este encabezado es el mismo que el ETag para el objeto, entonces los metadatos o el objeto se muestran. Si la ETag que especificas con este encabezado es diferente de la ETag para el objeto, entonces los metadatos o el objeto no se muestran y Cloud Storage muestra un412 Error de condición previa. Para obtener más detalles, consulta la especificación.

If-Modified-Since

Un encabezado de solicitud que especifica una fecha y hora.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo If-Modified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Detalles Puedes usar este encabezado con los objetos HEAD Object y objeto HEAD. Si un objeto se modificó más adelante de la fecha y hora que especificas con este encabezado, se mostrarán los metadatos o el objeto. Si un objeto se modificó antes de la fecha y la hora que especificas con este encabezado, entonces los metadatos o el objeto no se muestran y Cloud Storage muestra 304 Not Modified.

Para obtener más información sobre el encabezado If-Modified-Since, consulta la especificación. Para obtener más detalles sobre los formatos de fecha HTTP, consulta la especificación, la sección 7.1.1.2.

If-None-Match

Un encabezado de solicitud que especifica una etiqueta de entidad (ETag).

Valores válidos Una etiqueta de entidad válida.
Ejemplo If-None-Match: "881f7881ac1bc144a2672e45babb8839"
Detalles Puedes usar este encabezado con los objetos HEAD Object y objeto HEAD. Si la ETag que especificas con este encabezado es diferente de la ETag para el objeto, entonces los metadatos o el objeto se muestran. Si el ETag que especificas con este encabezado es el mismo que el de ETag, el objeto o los objetos no se mostrarán y Cloud Storage mostrará el mensaje 304 Not Modified. Para obtener más detalles, consulta la especificación.

Si no se modificó:

Un encabezado de solicitud que especifica una fecha y hora.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo If-Unmodified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Detalles Puedes usar este encabezado con los objetos HEAD Object y objeto HEAD. Si el objeto no se modificó más tarde de la fecha que especificas con este encabezado, se mostrarán los metadatos o el objeto. Si el objeto se modificó más adelante de la fecha que especificas con este encabezado, los metadatos o el objeto no se muestran y Cloud Storage muestra un 412 Precondition Failed.

Para obtener más información sobre el encabezado If-Unmoded-Since, consulta la especificación. Para obtener más información sobre los formatos de fecha HTTP, consulta la especificación, la sección 7.1.1.2.

Lastltima modificación

Un encabezado de respuesta que contiene la fecha y hora en que se modificó el objeto por última vez.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT
Detalles Para obtener más información sobre el encabezado Last-Modified, consulta la especificación. Para obtener más información sobre los formatos de fecha HTTP, consulta la especificación, la sección 7.1.1.2.

Ubicación

Un encabezado de respuesta usado para varios fines:

  • En respuesta al inicio de una carga reanudable, se proporciona un URI de sesión para una operación de carga reanudable.
  • En respuesta a una solicitud de autenticación basada en cookies, te proporciona una URL de respuesta única de origen web para la solicitud.
  • En respuesta a una solicitud de descarga a la API de JSON realizada en una URL que no sea www.googleapis.com/download, proporciona un redireccionamiento a la URL de la API de JSON en la que se puede realizar la descarga.
Valores válidos Cualquier URI válido.
Ejemplo Location: https://example.storage.googleapis.com/?upload_id=tvA0...rot
Detalles El encabezado de respuesta Location se muestra cuando inicias una carga reanudable.

Rango

Un encabezado de solicitud que indica el rango de bytes que deseas mostrar y un encabezado de respuesta que indica el rango de bytes que se subieron al sistema de Cloud Storage.

Valores válidos Cualquier rango contiguo de bytes
Ejemplos Range: bytes=0-1999 (primeras 2,000 bytes)
Range: bytes=-2000 (últimos 2,000 bytes)
Range: bytes=2000- (de byte 2,000 al final del archivo)
Detalles

Cuando se incluye como un encabezado en una solicitud de datos del objeto, solo se muestra el rango de bytes especificado para el objeto, lo cual es útil cuando se reanudan las cargas interrumpidas. Una solicitud válida y exitosa da como resultado un código de respuesta 206 parcial Content. Ten en cuenta que, en ciertas circunstancias, se ignora el encabezado de la solicitud range.

Cuando se muestra como parte de una respuesta asociada con una carga reanudable, Range indica la cantidad de bytes subidos actualmente. Luego, puedes usar esta información para continuar la carga.

Los rangos de bytes son inclusivos. Por ejemplo, bytes=0-999 representa los primeros 1,000 bytes en un archivo o objeto. Para obtener más información sobre este encabezado, consulta la especificación.

Codificación de transferencia

Un encabezado de solicitud y respuesta que especifique si se aplicó la codificación de transferencia al cuerpo del mensaje

Valores válidos chunked
Ejemplo Transfer-Encoding: chunked
Detalles Este encabezado especifica si se fragmentó el cuerpo del mensaje de una solicitud o respuesta. Si es así, el servidor entrega el contenido en una serie de fragmentos con una porción final que tiene una longitud de cero. Si especificas Transfer-Encoding: Chunked, no necesitas especificar un Content-Length. Esto puede ser útil si no conoces la longitud del cuerpo del mensaje por adelantado, como cuando se realiza una carga de transmisión. Para obtener más detalles sobre transferencias de codificación, consulta la especificación. Para obtener más detalles sobre la codificación de transferencia fragmentada, consulta la especificación.

Encabezados HTTP de extensión (personalizado)

x-goog-acl

Un encabezado de solicitud que aplica LCA predefinidas (en cascada) a un depósito o objeto cuando lo subes o creas un elemento.

Valores válidos Para depósitos: project-private, private, public-read, public-read-write, authenticated-read

Para objetos: project-private, private, bucket-owner-read, bucket-owner-full-control, public-read, authenticated-read

Ejemplo x-goog-acl: private
Detalles Cuando un usuario sube un objeto o crea un depósito sin especificar ninguna LCA, se aplica la LCA private. Para obtener más información sobre las LCA predefinidas, consulta Control de acceso.

x-goog-api-version

Este encabezado es obsoleto y no se usa.

x-goog-bucket-retention-period

Un encabezado de solicitud que agrega una política de retención a un depósito nuevo

Valores válidos Un número entero entre 1 y 3,155,760,000.
Ejemplo x-goog-bucket-retention-period: 32000
Detalles Este encabezado de solicitud solo se puede usar cuando se crea un depósito nuevo. Cuando se incluye el encabezado, el depósito nuevo obtiene una política de retención desbloqueada con una duración, en segundos, determinada por el valor de este encabezado.

x-goog-component-count

Un encabezado de respuesta que indica la cantidad de componentes de un objeto compuesto

Valores válidos Un número entero mayor o igual que 1.
Ejemplo x-goog-component-count: 32
Detalles Este encabezado de respuesta solo se muestra cuando el objeto al que se accede es un objeto compuesto. El encabezado muestra la cantidad de componentes que conforman el objeto.

x-goog-content-length-range

Un encabezado de solicitud PUT. Cuando se usa, Cloud Storage solo acepta la solicitud si el tamaño del contenido de la solicitud está dentro del rango especificado del encabezado.

Valores válidos Un par MIN,MAX
Ejemplo x-goog-content-length-range: 0,256
Detalles Los valores del tamaño del contenido son inclusivos y se proporcionan en bytes. Si el tamaño del contenido de la solicitud está en el rango especificado, se entrega como se solicitó. Si el tamaño del contenido de la solicitud está fuera del rango especificado, la solicitud falla y se muestra un código 400 Bad Request en la respuesta. Si se usa x-goog-content-length-range en una solicitud que no es PUT, el encabezado se ignora de forma silenciosa.

x-goog-content-sha256

Un encabezado de solicitud que contiene un hash del cuerpo de la solicitud.

Valores válidos Un hash SHA-256 en minúscula, con codificación hexadecimal o UNSIGNED-PAYLOAD
Ejemplo x-goog-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Detalles Este encabezado es obligatorio para las solicitudes que usan una firma en el encabezado Authorization. x-goog-content-sha256 debe coincidir con el valor que usaste para la parte de carga útil de tu solicitud canónica.

x-goog-copy-source

Un encabezado de solicitud que especifica el depósito de origen y el objeto para una operación de copia.

Valores válidos Ruta de acceso /BUCKET_NAME/OBJECT_NAME
Ejemplo x-goog-copy-source: travel-maps/paris.jpg
Detalles Este encabezado de solicitud especifica la ruta de acceso al objeto de origen. Una ruta de acceso válida debe incluir el depósito y el objeto, separados por una barra (/). Ten en cuenta que la ruta del objeto de origen debe ser una URL legal, por lo que generalmente debe estar codificado en un porcentaje.

Debes tener el permiso READ en el objeto de origen y, al menos, el permiso WRITE en el depósito de destino para usar este encabezado.

Si los objetos de origen y de destino son iguales (incluida la generación), la copia se trata como una actualización de los metadatos. Para obtener más información sobre cómo controlar el comportamiento de actualización y reemplazo, consulta x-goog-metadata-directive.

x-goog-copy-source-generation

Es un encabezado de solicitud que especifica la generación del objeto que se copiará.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-copy-source-generation: 1360044097839000
Detalles El encabezado de esta solicitud se puede usar con x-goog-copy-source para especificar la generación del objeto que se copiará. No es válida sin el encabezado x-goog-copy-source. Si no existe tal generación del objeto de origen, Cloud Storage muestra un código de estado 404 Not Found.

Si los objetos de origen y de destino son iguales (incluida la generación), la copia se trata como una actualización de los metadatos. Para obtener más información sobre cómo controlar el comportamiento de actualización o reemplazo, consulta x-goog-metadata-directive.

x-goog-copy-source-if-generation-match

Un encabezado de solicitud que especifique la solicitud de copia correspondiente solo se ejecutará si el objeto de origen x-goog-generation coincide con el valor especificado. Este encabezado solo es válido cuando se usa con x-goog-copy-source.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-copy-source-if-generation-match: 1360044097835000
Detalles Este encabezado de solicitud se puede usar para copiar condicionalmente el objeto de origen solo si tiene la generación especificada. Si la generación no coincide, Cloud Storage muestra un código de error 412 Precondition Failed.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-copy-source-if-match

Un encabezado de solicitud que especifica las condiciones para una operación de copia.

Valores válidos Una etiqueta de entidad (ETag)
Ejemplo x-goog-copy-source-if-match: 53fc311c15eda0a031809982ccf92aac
Detalles Solo se puede especificar una etiqueta de entidad (no una lista separada por comas de etiquetas de entidades). Este encabezado de solicitud solo se puede usar si realizas una operación de copia con el encabezado de la solicitud x-goog-copy-source. Si la ETag que especificas con este encabezado de solicitud coincide con el ETag del objeto de origen, la operación de copia continúa. Si el ETag no coincide, Cloud Storage muestra un código de error 412 Precondition Failed.

x-goog-copy-source-if-metageneration-match

Un encabezado de solicitud que especifique la solicitud correspondiente solo se permitirá si el metageneration del objeto de origen coincide con el valor de este encabezado.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-copy-source-if-metageneration-match: 4
Detalles Si la metageneración del objeto de origen coincide con el encabezado x-goog-copy-source-if-metageneration-match, la solicitud se completará de forma correcta y Google Cloud Storage mostrará el estado HTTP 200 OK. Si la metageneración no coincide, Cloud Storage muestra un código de error 412 Precondition Failed.

Este valor solo puede usarse con x-goog-copy-source-if-generation-match o x-goog-copy-source-generation y tratar de usarla sin ninguno dará como resultado un código de error de argumento no válido HTTP 400 BadRequest.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-copy-source-if-modified-since

Un encabezado de solicitud que especifica las condiciones para una operación de copia.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo x-goog-copy-source-if-modified-since: Fri, 19 Feb 2010 14:05:04 GMT
Detalles Este encabezado de solicitud solo se puede usar si realizas una operación de copia con el encabezado de la solicitud x-goog-copy-source. Si la fecha y hora que especificas son anteriores a la fecha Last-Modified del objeto de origen, el objeto se copia. Si la fecha y la hora son posteriores, Cloud Storage muestra un código de error 412 Precondition Failed.

Para obtener más información sobre el encabezado HTTP If-Modified-Since (que, además de la fuente de copia, se aplica a este caso práctico), consulta la especificación. Para obtener más información sobre los formatos de fecha HTTP, consulta la especificación, la sección 7.1.1.2.

x-goog-copy-source-if-none-match

Un encabezado de solicitud que especifica las condiciones para una operación de copia.

Valores válidos Una etiqueta de entidad (ETag)
Ejemplo x-goog-copy-source-if-none-match: 53fc311c15eda0a031809982ccf92aac
Detalles Este encabezado de solicitud solo se puede usar si realizas una operación de copia con el encabezado de la solicitud x-goog-copy-source. Si la ETag que especificas con este encabezado de solicitud no coincide con la ETag del objeto de origen, la operación de copia continúa. Si la ETag coincide, Cloud Storage muestra un código de error 412 Precondition Failed. Para obtener más información sobre el encabezado HTTP If-None-Match (que no es la fuente de copia, se aplica a este caso práctico), consulta la especificación.

x-goog-copy-source-if-unmodified-since

Un encabezado de solicitud que especifica las condiciones para una operación de copia.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo x-goog-copy-source-if-unmodified-since: Fri, 19 Feb 2010 14:05:04 GMT
Detalles Este encabezado de solicitud solo se puede usar si realizas una operación de copia con el encabezado de la solicitud x-goog-copy-source. Si la fecha y hora que especificas son posteriores a la fecha Last-Modified del objeto de origen, el objeto se copia. Si la fecha y la hora son anteriores, Cloud Storage muestra un código de error 412 Precondition Failed.

Para obtener más información sobre el encabezado HTTP If-UnModified-Since (que, además de la fuente de copia, se aplica a este caso práctico), consulta la especificación. Para obtener más información sobre los formatos de fecha HTTP, consulta la especificación, la sección 7.1.1.2.

x-goog-custom-time

Un encabezado de solicitud y respuesta para metadatos de objeto de marca de tiempo personalizados

Valores válidos Una fecha y hora representadas en formato RFC 3339.
Ejemplo x-goog-custom-time: 2020-04-12T23:20:50.52Z
Detalles Este encabezado se puede incluir durante las solicitudes PUT o POST del objeto. El valor que especifiques en el encabezado se almacena con el objeto y se muestra en un encabezado de respuesta cuando realizas una solicitud GET o HEAD en el objeto. El tiempo personalizado para un objeto se suele usar con la Administración del ciclo de vida de los objetos.

x-goog-date

Un encabezado de solicitud que especifica una marca de tiempo para las solicitudes autenticadas.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo x-goog-date: Fri, 19 Feb 2010 14:05:04 GMT
Detalles Cuando se usa a fin de crear URL firmadas con el proceso de firma de V2, el formato debe tener un formato HTTP convencional. Consulta la sección 7.1.1.2 de la especificaciones. Cuando se usa el proceso de firma de V4, el formato debe estar en el formato básico YYYYMMDD'T'HHMMSS'Z' en formato ISO 8601.

x-goog-encryption-algorithm

Un encabezado de solicitud y respuesta que especifique el algoritmo de encriptación que se utilizará.

Valores válidos AES256
Ejemplo x-goog-encryption-algorithm: AES256
Detalles Este encabezado de solicitud y respuesta se utiliza cuando proporcionas claves de encriptación proporcionadas por el cliente.

x-goog-encryption-key

Un encabezado de solicitud que especifica una clave de encriptación AES-256.

Valores válidos Una string codificada en Base64 RFC 4648 de una clave de encriptación AES-256 válida
Ejemplo x-goog-encryption-key: NwbyGGmcKAX4FxGpOERG2Ap33m5NVOgmXznSGTEvG0I=
Detalles Este encabezado de solicitud se usa cuando proporcionas claves de encriptación proporcionadas por el cliente.

x-goog-encryption-key-sha256

Un encabezado de solicitud y respuesta que especifica el hash SHA256 de la clave de encriptación.

Valores válidos Una string codificada en Base64 RFC 4648 de un hash SHA256 válido para una clave de encriptación
Ejemplo x-goog-encryption-key-sha256: +eBzkZBt1Mj2CZx69L3c8yXoZB6DtRLlSvXMJB9JGIQ=
Detalles Este encabezado de solicitud se usa cuando proporcionas claves de encriptación proporcionadas por el cliente.

x-goog-encryption-kms-key-name

Un encabezado de solicitud que especifica una clave de encriptación de Cloud KMS.

Valores válidos Un recurso de clave de encriptación de Cloud KMS.
Ejemplo x-goog-encryption-kms-key-name: projects/my-project/locations/us-east1/keyRings/my-keyring/cryptoKeys/my-key
Detalles Este encabezado de solicitud se usa cuando deseas encriptar un objeto específico con una clave de encriptación administrada por el cliente.

x-goog-vencimiento

Un encabezado de respuesta que especifica cuándo se borrará el objeto al que se accedió, según la configuración del ciclo de vida.

Valores válidos Una fecha y hora representada en formato HTTP convencional
Ejemplo x-goog-expiration: Tue, 25 June 2013 00:00:00 GMT
Detalles Este encabezado de respuesta solo se muestra para objetos en un depósito con la administración del ciclo de vida habilitada si se cumplen ciertas condiciones. Para obtener más información, consulta el comportamiento del ciclo de vida del objeto.

x-goog-generación

Un encabezado de respuesta que indica a qué versión de los datos del objeto estás accediendo

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-generation: 1360044097835000
Detalles Cada vez que se crea o reemplaza un objeto, Cloud Storage le asigna una generación de forma automática. La generación cambia cada vez que se reemplazan los datos del objeto. Sin embargo, no hay una relación definida entre las generaciones en diferentes objetos.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-if-generation-match

Un encabezado de solicitud que especifica la solicitud correspondiente solo se permite si el x-goog-generation del objeto coincide con el valor de este encabezado.

Valores válidos Cero o cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-if-generation-match: 1360044097835000
Detalles Si la generación del objeto coincide con el encabezado x-goog-if-generation-match, la solicitud se completará de forma correcta y Google Cloud Storage mostrará el estado HTTP 200 OK. Si la generación no coincide, Google Cloud Storage muestra un código de error HTTP 412 Precondition Failed.

Si estableces el encabezado x-goog-if-generation-match en 0, Google Cloud Storage solo realiza la solicitud especificada si el objeto no existe actualmente. Por ejemplo, puedes realizar una solicitud PUT para crear un objeto nuevo con un x-goog-if-generation-match, y el objeto solo se creará si aún no existe como una versión publicada. Si el objeto existe, la solicitud se anula.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-if-metageneration-match

Un encabezado de solicitud que especifica la solicitud correspondiente solo se permite si el x-goog-metageneration del objeto coincide con el valor de este encabezado.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-if-metageneration-match: 4
Detalles Si la metageneración de objetos coincide con el encabezado x-goog-if-metageneration-match, la solicitud se completará de forma correcta y Google Cloud Storage mostrará el estado HTTP 200 OK. Si la metageneración no coincide, Cloud Storage muestra un código de error HTTP 412 Precondition Failed.

Este encabezado de solicitud solo debe usarse con el encabezado x-goog-if-generation-match para garantizar que las actualizaciones de metadatos se realicen en realidad con la generación del objeto que tiene pensado actualizar, por lo que puede realizar operaciones de lectura, modificación y escritura.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-metadata-directive

Un encabezado de solicitud que especifica el manejo de metadatos durante una operación de copia.

Ten en cuenta que las LCA de objeto, cuando están presentes, nunca se copian. Si corresponde, el objeto nuevo recibe las LCA especificadas en el encabezado de la solicitud x-goog-acl o las LCA de objeto predeterminadas establecidas para el depósito que contiene el objeto nuevo.

Valores válidos COPY | REPLACE
Ejemplo x-goog-metadata-directive: REPLACE
Detalles

Solo se usa con el encabezado de solicitud x-goog-copy-source. El valor predeterminado es COPY.

Si especificas COPY, los metadatos del objeto de origen se aplican al objeto recién creado.

Si especificas REPLACE, la operación aplica los metadatos proporcionados en la solicitud al objeto recién creado.

Cuando copias un objeto de este modo que reescribe el objeto de origen, debes incluir x-goog-metadata-directive: REPLACE. El encabezado es opcional en todos los demás casos.

x-goog-generación

Un encabezado de respuesta que indica a qué versión de los metadatos del objeto estás accediendo

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo x-goog-metageneration: 1
Detalles Cada vez que se crea o reemplaza un objeto, Cloud Storage asigna de forma automática una metageneración de 1. La metageneración aumenta cada vez que se actualizan los metadatos de los objetos (actualización de LCA o actualizaciones de metadatos). Esto significa que una metageneración más grande siempre implica una versión más reciente de los metadatos del objeto. Sin embargo, no existe una relación definida entre diferentes generaciones en objetos diferentes, ni incluso generaciones diferentes del mismo objeto. Cada generación del objeto tiene su propia versión de metageneración que solo pertenece a su generación.

Para obtener más información, consulta Usa versiones de objetos.

x-goog-hash

Un encabezado de solicitud y respuesta para expresar las sumas de verificación codificadas en Base64 o CRC32C de un objeto. Como encabezado de solicitud para las solicitudes de carga, los hash proporcionados se validan con los valores calculados por Cloud Storage.

Valores válidos Ya sea md5=BASE64_ENCODED_MD5 o crc32c=BASE64_ENCODED_CRC32C. Especifica los valores CRC32c en orden de bytes de mayor nivel. Además, ten en cuenta que HTTP considera los valores de encabezado separados por comas como equivalentes a encabezados separados con claves idénticas.
Ejemplos x-goog-hash: crc32c=n03x6A==
x-goog-hash: md5=Ojk9c3dhfxgoKVVHYwFbHQ==
x-goog-hash: crc32c=n03x6A==,md5=Ojk9c3dhfxgoKVVHYwFbHQ==
Detalles Cloud Storage almacena hashes de MD5 para todos los objetos no compuestos. CRC32C están disponibles para todos los objetos.

x-goog-meta-

Un encabezado de solicitud y respuesta que te permite definir metadatos personalizados para un objeto.

Valores válidos Cualquier nombre de encabezado válido.
Ejemplo x-goog-meta-reviewer: jane
Detalles Para usar este encabezado, agrega tu nombre del encabezado personalizado al prefijo x-goog-meta- y, luego, agrega el encabezado y su valor asociado a tu solicitud PUT o POST. Por ejemplo, si tus objetos están asociados con varios proyectos, puedes agregar la información específica del proyecto a los metadatos del objeto mediante la creación de varios encabezados de solicitud, como x-goog-meta-project-name. x-goog-meta-project-number y x-goog-meta-project-manager. Luego, puedes establecer un valor para estos encabezados de solicitud durante una solicitud PUT o POST como se muestra en el siguiente ejemplo:

PUT /kitten.jpg HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Wed, 17 Jun 2020 11:11:11 GMT
Content-Type: image/jpg
Content-Length: 554
Authorization: Bearer 1/zVNpoQNsOSxZKqOZgckhpQ
x-goog-meta-project-name: Sales Projections
x-goog-meta-project-number: 878973
x-goog-meta-project-manager: W. Loman
    

Los encabezados x-goog-meta- se almacenan con un objeto y siempre se muestran en un encabezado de respuesta cuando realizas una solicitud GET o HEAD en un objeto. El uso de encabezados como metadatos personalizados genera un cargo, como se explica en Precios y asistencia.

Nota:Todos los encabezados personalizados y sus valores asociados deben contener solo caracteres US-ASCI imprimibles.

Nota:Recomendamos que limites el tamaño total de los encabezados personalizados a unos pocos KB,

x-goog-project-id

Un encabezado de solicitud que especifique el proyecto en el que está trabajando.

Valores válidos Cualquier número o nombre de proyecto válido.
Ejemplos x-goog-project-id: 000111222333
x-goog-project-id: my-project-name
x-goog-project-id: example.com:my-google-apps-for-work-project-name
Detalles Este encabezado de solicitud le indica a Cloud Storage de qué proyecto crear un depósito o en qué proyecto enumerar los depósitos. Es opcional para estas tareas si configuraste un proyecto predeterminado para el acceso interoperable.

x-goog-reiterable

Un encabezado de solicitud que inicia una operación de carga reanudable

Valores válidos start
Ejemplo x-goog-resumable: start
Detalles Este encabezado de notificación notifica al sistema de Cloud Storage que deseas iniciar una carga reanudable. El encabezado se puede usar solo con una solicitud de objeto POST y solo para cargas reanudables.

x-goog-storage-class

Un encabezado de solicitud y respuesta que indica la clase de almacenamiento de un objeto.

Valores válidos STANDARD, NEARLINE, COLDLINE, ARCHIVE, MULTI_REGIONAL, REGIONAL
Ejemplo x-goog-storage-class: NEARLINE
Detalles Este encabezado se puede incluir en solicitudes PUT Object y POST Object para establecer un objeto en una clase de almacenamiento más allá de la clase de almacenamiento predeterminada del depósito asociado. El encabezado se incluye en todas las respuestas de GET Object.

x-goog-stored-content-encoding

Un encabezado de respuesta que indica la codificación de contenido del objeto como se almacena en Cloud Storage, independientemente de cualquier negociación basada en servidor que pueda ocurrir para solicitudes individuales del objeto.

Valores válidos La codificación de contenido especificada en la carga del objeto o identity.
Ejemplo x-goog-stored-content-encoding: gzip
Detalles Si se subió un objeto sin codificación de contenido, el valor de este encabezado es identity.

x-goog-stored-content-length

Un encabezado de respuesta que indica la longitud del contenido (en bytes) del objeto como se almacena en Cloud Storage, independientemente de cualquier negociación basada en servidor que pueda ocurrir para solicitudes individuales del objeto.

Valores válidos Cualquier valor de byte de cero o superior
Ejemplo x-goog-stored-content-length: 350
Detalles Ninguna

x-goog-user-project

Un encabezado de solicitud que especifique un proyecto de usuario para facturar los cargos de acceso asociados con la solicitud.

Valores válidos El ID del proyecto de un proyecto de Google Cloud existente
Ejemplo x-goog-user-project: my-project
Detalles Se factura al proyecto especificado en el encabezado por los cargos asociados con la solicitud. Este encabezado se usa, por ejemplo, cuando se realizan solicitudes a depósitos que tienen habilitados los pagos del solicitante.

Parámetros de string de consulta

En los ejemplos de parámetros de cadena de consulta descritos en esta sección, no se muestran los URI, pero se supone que están relacionados con storage.googleapis.com. Como se describe en Solicita extremos, también puedes especificar el nombre del depósito como parte del nombre de host, por ejemplo, BUCKET-NAME.storage.googleapis.com. Si especificas el depósito como parte del nombre de host, no incluyas el nombre del depósito como parte de la ruta del URI. Por ejemplo, los siguientes son equivalentes para obtener la LCA de un objeto:

  • https://storage.googleapis.com/BUCKET-NAME/object-name?acl
  • https://BUCKET-NAME.storage.googleapis.com/object-name?acl

ID de clave de acceso

Un parámetro de cadena de consulta que te permite identificar qué clave HMAC deseas actualizar o borrar.

Valores válidos Un ID de acceso asociado con una clave HMAC.
Ejemplo /?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
/?Action=DeleteAccessKey&AccessKeyId=GOOG1EXAMPLE
Detalles El parámetro de string de consulta AccessKeyId te permite especificar qué clave HMAC quieres actualizar o borrar. Debes usar AccessKeyId junto con el parámetro de búsqueda Action. Para obtener información sobre cómo recuperar el ID de acceso para tu clave HMAC, consulta Obtén información sobre la clave HMAC.

acl

Un parámetro de cadena de consulta que te permite recuperar o cambiar la lista de control de acceso de un depósito o un objeto

Valores válidos ninguna
Ejemplo /BUCKET_NAME?acl
/BUCKET_NAME/OBJECT_NAME?acl
Detalles Opcional para las siguientes solicitudes: depósito PUT, objeto PUT, depósito GET y objeto GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifica las LCA que deseas aplicar. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

Acción

Parámetro de string de consulta que te permite identificar qué operación de clave HMAC se debe realizar.

Valores válidos ListAccessKeys, CreateAccessKey, UpdateAccessKey, DeleteAccessKey
Ejemplo /?Action=ListAccessKeys
Detalles El parámetro de string de consulta Action te permite especificar qué operación de clave HMAC realizar: list, create, update o delete.

billing

Un parámetro de cadena de consulta que te permite habilitar, inhabilitar o verificar el estado de la función Pagos del solicitante de un depósito.

Valores válidos Dentro del cuerpo de la solicitud: Enabled, Disabled.
Ejemplo /BUCKET_NAME?billing
Detalles Opcional para las siguientes solicitudes: GET Bucket, PUT Bucket. Cuando se usa en una solicitud GET Bucket, el estado actual de la función Pagos del solicitante se muestra en el cuerpo de la respuesta. Cuando se usa en una solicitud PUT Bucket, el cuerpo de la solicitud debe contener un elemento <BillingConfiguration> que especifique si se habilita o inhabilita la función. Para obtener más información sobre cómo configurar la función pagos del solicitante con la API de XML, consulta Configura pagos del solicitante de depósitos.

compose

Un parámetro de cadena de consulta que te permite componer una secuencia de objetos existentes en un nuevo objeto compuesto (se usa solo con la API de XML).

Valores válidos ninguna
Ejemplo /BUCKET_NAME/OBJECT_NAME?compose
Detalles Opcional para las solicitudes de objeto PUT. Se debe proporcionar un documento XML de ComposeRequest en el cuerpo de la solicitud. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

cors

Un parámetro de cadena de consulta que te permite recuperar o cambiar el uso compartido de recursos multiorigen (CORS) para un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?cors
Detalles Opcional para las siguientes solicitudes: depósito PUT, depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifica el CORS que deseas aplicar. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

defaultObjectAcl

Un parámetro de cadena de consulta que te permite recuperar o cambiar la lista de control de acceso de objeto predeterminada de un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?defaultObjectAcl
Detalles Opcional para las solicitudes de depósito PUT y depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifique la LCA que se aplica de forma predeterminada a los objetos nuevos agregados al depósito. No puedes usar ningún subrecurso adicional con este parámetro de consulta. Consulta Configura las LCA de objeto predeterminadas para obtener más información.

delimiter

Un carácter o grupo de caracteres que se usa para restringir una lista de objetos durante una solicitud de depósito GET.

Valores válidos Cualquier carácter o carácter Unicode.
Ejemplo /?delimiter=/
Detalles

delimiter simplifica una lista de objetos que usan un esquema de nombres similar a directorios. Cuando se especifica, los objetos cuyos nombres no contienen el delimitador se muestran como lo harían en los elementos Contents de la respuesta. Si el nombre de un objeto contiene el delimitador, la parte del nombre del objeto y la primera instancia del delimitador aparecerán en un elemento CommonPrefixes de la respuesta.

Puedes usar un delimiter junto con un parámetro prefix. En este caso, prefix limita los resultados solo a objetos cuyos nombres coinciden con prefix.

delimiter se suele establecer en /, pero puede ser cualquier secuencia de caracteres. Para ver un ejemplo de cómo usar un delimiter, consulta el ejemplo de delimitador.

tipo de codificación

Un parámetro de cadena de consulta para codificar los nombres de objetos en URL en respuestas a las solicitudes de listado de objetos

Valores válidos url
Ejemplo /bucket?encoding-type=url
Detalles Es opcional cuando se enumera objetos en un depósito. Cuando se incluyen en la solicitud, los nombres de los objetos que se muestran están codificados en URL. Esto es útil si alguno de los nombres de objeto incluye caracteres Unicode que el XML 1.0 no puede analizar.

encriptación

Un parámetro de cadena de consulta que te permite recuperar la información de encriptación de un objeto.

Valores válidos ninguna
Ejemplo /object?encryption
Detalles Opcional para las solicitudes de objeto GET. Cuando el objeto consultado está encriptado por una clave de encriptación proporcionada por el cliente, el algoritmo de encriptación y el SHA-256 de la clave se muestran en un elemento Encryption. Cuando el objeto de consulta se encripta con una clave de encriptación administrada por el cliente, el recurso de clave de Cloud Key Management Service se muestra en un elemento Encryption. En todos los demás casos, se muestra un elemento Encryption vacío.

No puedes usar ningún subrecurso adicional con este parámetro de consulta.

encryptionConfig

Un parámetro de cadena de consulta que te permite establecer o recuperar la clave de encriptación administrada por el cliente predeterminada que usa un depósito.

Valores válidos ninguna
Ejemplo /bucket?encryptionConfig
Detalles Opcional para las solicitudes Depósito GET. Cuando el depósito consultado tiene una clave de encriptación administrada por el cliente predeterminada, se muestra el nombre del recurso de la clave dentro de un elemento EncryptionConfiguration.

Es opcional para solicitudes Bucket PUT. Cuando la solicitud incluye un recurso de clave de encriptación administrada por el cliente en el cuerpo de la solicitud, esa clave se convierte en la clave de encriptación predeterminada del depósito. Cuando la solicitud incluye un elemento EncryptionConfiguration vacío, toda clave predeterminada existente se quita del depósito.

generación

Un valor que indica qué generación del objeto se debe recuperar.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo ?generation=1360887759327000
Detalles El parámetro de string de consulta generation te permite especificar en qué versión del objeto operar.

marcador de generación

Un valor que indica el número de generación en el que deseas que comience una lista de objetos.

Valores válidos Cualquier número positivo (valor de 64 bits)
Ejemplo ?generation-marker=1360887759327000
Detalles El parámetro de string de consulta generation-marker es un punto de partida para las listas paginadas en depósitos con versiones. Se debe usar junto con marker para especificar completamente el objeto y la generación de dónde comenzar la lista. Cualquier versión de objeto con un valor mayor que el generation-marker especificado (incluida la versión publicada si tiene una generación mayor) se muestra en la lista de objetos, al igual que los objetos que son lexicográficamente mayores que los marker

lifecycle

Un parámetro de cadena de consulta que te permite recuperar o cambiar las políticas de administración del ciclo de vida de un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?lifecycle
Detalles Opcional para las siguientes solicitudes: depósito PUT, depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifica la configuración del ciclo de vida. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

ubicación

Un parámetro de cadena de consulta que te permite recuperar la restricción de location para un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?location
Detalles Opcional para las siguientes solicitudes: depósito GET.

logging

Un parámetro de cadena de consulta que te permite recuperar o cambiar la configuración de registro de un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?logging
Detalles Opcional para las siguientes solicitudes: depósito PUT, depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifica la configuración de registro. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

marcador

Es una string que indica dónde quieres comenzar una lista de objetos.

Valores válidos Cualquier string
Ejemplo ?marker=test
Detalles El parámetro de string de consulta marker es una string de caracteres Unicode que especifica qué objeto deseas que comience una lista de objetos después. La lista de objetos que se muestran son los que son lexicográficamente mayores que la marker.

Marcador

Un token de página que te permite enumerar las páginas posteriores de claves HMAC.

Valores válidos Una string proporcionada en una respuesta list anterior si IsTruncated es true
Ejemplo ?Action=ListAccessKeys&Marker=AERPALERN/NEXT/TOKEN
Detalles El parámetro de string de consulta Marker es un token de continuación que se usa para desplazarse por los conjuntos de resultados grandes cuando se enumeran las claves HMAC de un proyecto determinado. Si IsTruncated es true en una respuesta list anterior, usa el token Marker proporcionado en las solicitudes list posteriores hasta que IsTruncated sea false. Debes usar Marker junto con el parámetro de búsqueda Action. Para obtener más información, consulta GET de HMAC.

cantidad máxima de claves

Un número entero que limita la cantidad de objetos que se muestran en una sola "página".

Valores válidos Cualquier número superior a 0.
Ejemplo ?max-keys=100
Detalles El parámetro de string de consulta max-keys es un número entero que especifica la cantidad máxima de objetos que deseas mostrar en una lista de objetos. Si una solicitud puede mostrar más objetos de los que permite max-keys, el elemento de respuesta IsTruncated contiene un valor True.

Elementos máximos

Un número entero que limita la cantidad de claves HMAC que se muestran en una sola página de resultados.

Valores válidos Cualquier número superior a 0.
Ejemplo ?Action=ListAccessKeys&MaxItems=100
Detalles El parámetro de string de consulta MaxItems es un número entero que especifica la cantidad máxima de claves HMAC que se muestran en una sola página de resultados. Si una solicitud puede mostrar más claves de las que permite MaxItems, el elemento de respuesta IsTruncated contiene un valor true. Debes usar MaxItems junto con el parámetro de búsqueda Action. El servicio puede mostrar menos resultados que el máximo especificado.

prefix

Una string que restringe una lista de objetos a esos objetos que tienen un prefijo específico.

Valores válidos Cualquier prefijo válido.
Ejemplo ?prefix=/europe/france
Detalles El parámetro de string de consulta prefix es una string de caracteres Unicode que restringe la lista a objetos cuyos nombres comienzan con el valor prefix especificado. Puedes usar el parámetro de string de consulta prefix junto con el parámetro de string de consulta delimiter para crear un subconjunto más pequeño de objetos.

disposición-contenido-respuesta

Un parámetro de cadena de consulta que permite anular la disposición de contenido para las solicitudes GET autenticadas.

Valores válidos Encabezado con codificación URL para mostrar en lugar de la disposición del contenido del objeto subyacente.
Ejemplo ?response-content-disposition=attachment%3B%20filename%3D%22foo%22
Detalles Permite que las solicitudes GET autenticadas anulen la disposición de contenido que se muestra en los encabezados.

Para obtener más información, consulta la especificación.

tipo de contenido de respuesta

Un parámetro de cadena de consulta que permite anular el tipo de contenido para solicitudes GET autenticadas.

Valores válidos Encabezado con codificación URL para mostrar en lugar del tipo de contenido del objeto subyacente.
Ejemplo ?response-content-type=text%2Fhtml
Detalles Permite que las solicitudes GET autenticadas anulen la disposición de contenido que se muestra en los encabezados.

Para obtener más información, consulta la especificación.

Estado

Un parámetro de cadena de consulta que te permite habilitar o inhabilitar una clave HMAC.

Valores válidos Active, Inactive
Ejemplo ?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
Detalles El parámetro de string de consulta Status te permite cambiar el estado de una clave HMAC entre Active y Inactive. Debes usar Status junto con los parámetros de consulta Action y AccessKeyId.

storageClass

Un parámetro de cadena de consulta que te permite establecer o recuperar la clase de almacenamiento de un depósito.

Valores válidos Dentro del cuerpo de la solicitud: STANDARD, NEARLINE, ARCHIVE, COLDLINE, MULTI_REGIONAL, REGIONAL,DURABLE_REDUCED_AVAILABILITY
Ejemplo /BUCKET_NAME?storageClass
Detalles Opcional para las siguientes solicitudes: GET Bucket, PUT Bucket. Cuando se usa en una solicitud GET Bucket, la clase de almacenamiento del depósito especificado se muestra en el cuerpo de la respuesta. Cuando se usa en una solicitud PUT Bucket, el cuerpo de la solicitud debe contener un elemento <StorageClass> que especifique la clase de almacenamiento que deseas asignar al depósito. Para obtener más información sobre cómo configurar la clase de almacenamiento de un depósito con la API de XML, consulta Configura la clase de almacenamiento del depósito.

etiquetado

Un parámetro de cadena de consulta que te permite establecer o recuperar las etiquetas aplicadas a un depósito.

Valores válidos Dentro del cuerpo de la solicitud: una etiqueta, asignada como un par key:value.
Ejemplo /BUCKET_NAME?tagging
Detalles Opcional para las siguientes solicitudes: GET Bucket, PUT Bucket. Cuando se usan en una solicitud GET Bucket, las etiquetas aplicadas al depósito especificado se muestran en el cuerpo de la respuesta. Cuando se usa en una solicitud PUT Bucket, el cuerpo de la solicitud debe contener un elemento <Tagging> que especifique las etiquetas que deseas aplicar al depósito. Para obtener más información sobre la aplicación de etiquetas con la API de XML, consulta Configura etiquetas de depósitos.

ID de carga

Un parámetro de cadena de consulta que especifica ese ID de carga para una operación de carga reanudable. upload_id es parte del URI de sesión, pero debes guardar el URI de sesión completo porque define de manera única el URI de solicitud para las operaciones de carga reanudables posteriores. El URI de sesión se obtiene del encabezado de respuesta Location.

Valores válidos Cualquier ID de carga válido.
Ejemplo /?upload_id=tvA0ExBntDaOKdxL46u1NkHxNb...B2Uowrot HTTP/1.1
Detalles Los ID de carga vencen después de una semana. Te recomendamos que inicies una carga reanudable tan pronto como obtengas el ID de carga y que reanudes una carga interrumpida poco después de que se produzca la interrupción.

Si usas un ID de carga vencido en una solicitud, recibirás el código de estado 404 Not Found. En este caso, tendrás que volver a iniciar la carga reanudable, obtener un ID de carga nuevo y, luego, iniciar la carga desde el principio con el ID de carga nuevo.

El ID de carga está vinculado a la ubicación que se creó. Por lo tanto, si creas en una ubicación y la usas en otra, tu rendimiento se verá afectado.

El ID de carga es un token del portador, lo que significa que la propiedad es un autenticador. Por lo tanto, debes tener cuidado de no filtrar ID de carga.

NombredeUsuario

Un parámetro de cadena de consulta que te permite identificar la cuenta de servicio para la que deseas crear, actualizar o enumerar una clave HMAC.

Valores válidos Una dirección de correo electrónico de cuenta de servicio válida.
Ejemplo /?Action=CreateAccessKey&UserName=serviceAccount@proj.iam.gserviceaccount.com
Detalles UserName es obligatorio para crear una clave HMAC y opcional a fin de actualizar una clave o enumerar claves asociadas a un proyecto. Debes usar UserName junto con el parámetro de búsqueda Action.

proyecto de usuario

Un parámetro de cadena de consulta que especifica un ID del proyecto para facturar los cargos de acceso asociados con la solicitud.

Valores válidos Cualquier ID de proyecto válido.
Ejemplo ?userProject=example-project
Detalles Los proyectos asociados con la solicitud se facturan al proyecto especificado en este parámetro. userProject se usa, por ejemplo, cuando se realizan solicitudes a depósitos que tengan pagos del solicitante habilitados.

En general, las solicitudes XML que requieren un ID del proyecto deben proporcionar una en el encabezado x-goog-user-project, en lugar del parámetro userProject.

versioning

Un parámetro de cadena de consulta que te permite recuperar o cambiar la configuración del control de versiones de un depósito.

Valores válidos ninguna
Ejemplo /OBJECT_NAME?versioning
Detalles Opcional para las siguientes solicitudes: depósito PUT, depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifique la configuración de control de versiones que deseas aplicar. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

versions

Un parámetro de cadena de consulta que te permite recuperar toda la generación de objetos en un depósito con versión.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?versions=True
Detalles Opcional para las siguientes solicitudes: depósito GET.

sitio web

Un parámetro de cadena de consulta que te permite recuperar o cambiar la configuración del sitio web de un depósito.

Valores válidos ninguna
Ejemplo /BUCKET_NAME?websiteConfig
Detalles Opcional para las siguientes solicitudes: depósito PUT, depósito GET. Si envías una solicitud PUT, debes incluir un documento XML en el cuerpo de la solicitud que especifique la configuración del sitio web que deseas aplicar. No puedes usar ningún subrecurso adicional con este parámetro de consulta.

Algoritmo X-Goog

Un parámetro de cadena de consulta para determinar el algoritmo de URL firmadas de V4.

Valores válidos GOOG4-RSA-SHA256
GOOG4-HMAC-SHA256
AWS4-HMAC-SHA256
Detalles Se usa específicamente para las solicitudes firmadas de V4, como las URL firmadas.

Credencial de X-Goog

Un parámetro de cadena de consulta para determinar el tipo de credencial usada.

Valores válidos Service_Account_Email/Date/Region/goog4_request
Google_HMAC_Access_Key_ID/Date/Region/goog4_request
AWS_HMAC_Access_Key_ID/Date/Region/aws4_request
Ejemplo Mediante una cuenta de servicio de Google: example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
Usa HMAC: GOOGTS7C7FUP3AIRVJTE2BCD%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
Detalles Se usa específicamente para las solicitudes firmadas de V4, como las URL firmadas.

X-Goog-Date (parámetro de consulta)

La fecha y la hora en que se puede utilizar la URL firmada

Valores válidos Cualquier fecha posterior a AAAAMMDD'T'HHMMSS'Z'
Ejemplo ?X-Goog-Date=20181026T181309Z
Detalles El formato utilizado es el formato básico ISO 8601 AAAAMMDD'T'HHMMSS'Z'.

X-Goog-Expires

Un parámetro de cadena de consulta para determinar cuánto tiempo está activa una URL firmada de V4.

Valores válidos 1 segundo de hasta 604800 segundos
Ejemplo ?X-Goog-Expires=900
Detalles La cantidad de tiempo que la URL firmada siguió siendo válida, medida en segundos a partir del valor en X-Goog-Date (parámetro de consulta). El valor máximo es de 7 días o 604800 segundos.

X-Goog-SignedHeaders

Un parámetro de cadena de consulta para determinar los encabezados firmados en una URL firmada de V4.

Valores válidos El único encabezado obligatorio es host. Cualquier encabezado que esté firmado con una firma de URL firmada de V4 debe estar en esta lista.
Ejemplos ?X-Goog-SignedHeaders=host
?X-Goog-SignedHeaders=host,x-goog-acl
Detalles Encabezados que debían incluirse como parte de cualquier solicitud que utilizara la URL firmada

Firma X-Goog

Un parámetro de cadena de consulta con el valor de una firma de URL firmada de V4

Valores válidos Firma de la URL firmada
Ejemplo ?X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7
Detalles La string de autenticación que permitió que las solicitudes que usan esta URL firmada accedan al recurso designado