Inicia una carga reanudable con una solicitud POST. Esta solicitud inicial genera un URI de sesión para su uso en solicitudes PUT posteriores que suben los datos. La solicitud inicial también te permite especificar metadatos para el objeto. Una vez que se completa una carga reanudable, el objeto subido reemplaza cualquier objeto existente con el mismo nombre. Para obtener sugerencias sobre cómo subir a Cloud Storage, consulta las prácticas recomendadas.
Para cargas simples con la API de XML, realiza una solicitud de objeto PUT en lugar de usar el objeto POST.
Parámetros de string de consulta
Esta solicitud no suele incluir parámetros de cadena de consulta.
Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.
Solicita encabezados
Se pueden usar los siguientes encabezados de solicitud.
| Header | Descripción | Obligatorio |
|---|---|---|
Authorization |
La string de autenticación para la solicitud. | Sí |
Cache-Control |
Las condiciones en las que se debe almacenar en caché un objeto de acceso público. Cache-Control también se usa para determinar si un objeto se puede transformar. |
No |
Content-Disposition |
Un encabezado que especifica información de presentación sobre cómo se transmiten los datos del objeto. | No |
Content-Encoding |
El algoritmo de compresión que se usó para comprimir el objeto que estás subiendo. | No |
Content-Language |
Es el código de lenguaje ISO 639-1 del contenido. | No |
Content-Length |
La longitud del cuerpo de la solicitud sin encabezados (en bytes). Para iniciar una carga reanudable, este valor es 0. |
Sí |
Content-Type |
El tipo de MIME del objeto que se subirá. Si no especificas un tipo de contenido, Cloud Storage usa la configuración predeterminada application/octet-stream cuando entrega el objeto. |
No (recomendado) |
Date |
La fecha y la hora de la solicitud. | Sí |
Host |
El URI para Cloud Storage. Para obtener más información, consulta Solicita extremos. | Sí |
x-goog-acl |
La LCA predefinida que deseas aplicar al objeto. | No |
x-goog-custom-time |
Una fecha y hora especificadas por el usuario. | No |
x-goog-encryption-kms-key-name |
La clave de encriptación administrada por el cliente que se usa para encriptar el objeto. | No |
x-goog-if-generation-match |
Si la generación que especificas es la misma que el objeto que vas a reemplazar, entonces el objeto se reemplaza. También puedes especificar 0 como un valor especial para indicar que el nuevo objeto solo se crea si no hay un objeto existente. | No |
x-goog-if-metageneration-match |
Si la metageneración que especificas es la misma que el objeto que intentas actualizar, los metadatos del objeto se actualizan. Esto solo se permite si se especifica x-goog-if-generation. Si combinas estas dos propiedades de generación, puedes implementar actualizaciones seguras de lectura, modificación y escritura. |
No |
x-goog-meta- |
Un encabezado de extensión que se puede usar para almacenar metadatos personalizados. | No |
x-goog-resumable |
Indica que esta solicitud inicia la carga reanudable. Este encabezado debe usar el valor start |
Sí |
x-goog-storage-class |
Otorga a un objeto una clase de almacenamiento más que la clase de almacenamiento predeterminada del depósito asociado. | No |
x-goog-user-project |
El proyecto al que se facturarán los cargos asociados con la solicitud. | No |
Para proporcionar una clave de encriptación proporcionada por el cliente junto con la carga de objetos, usa los encabezados que aparecen en la página Clave de encriptación proporcionada por el cliente en tu solicitud.
Elementos de cuerpo de la solicitud
Esta solicitud no incluye un documento XML en el cuerpo de la solicitud.
Encabezados de respuesta
La respuesta incluye un encabezado Location que indica el URI de sesión que se usará cuando se suban los datos del objeto.
Elementos del cuerpo de la respuesta
La respuesta no incluye un documento XML en el cuerpo de la respuesta.
Ejemplo
En el siguiente ejemplo se sube un objeto llamado paris.jpg a un depósito llamado travel-maps.
Solicitud
POST /paris.jpg HTTP/2 Host: travel-maps.storage.googleapis.com Date: Thu, 10 Dec 2020 18:11:50 GMT Content-Type: image/jpg Content-Length: 0 X-Goog-Resumable: start Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Respuesta
HTTP/2 201 Content-Type: text/plain; charset=utf-8 X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Content-Length: 0 Date: Thu, 10 Dec 2020 18:11:53 GMT Server: UploadServer