Descripción general de los métodos de solicitud de la API de XML

La API de XML de Cloud Storage admite varios métodos de solicitud HTTP estándar. Cada método puede usar numerosos encabezados de solicitud y encabezados de respuesta. En la documentación de la API de XML, se describen todos los métodos HTTP compatibles, así como los encabezados que se usan con mayor frecuencia para cada método.

Algunos métodos se usan para trabajar con datos y metadatos, según el contexto. Por ejemplo, puedes usar una solicitud de depósito PUT para crear un depósito seguido de una segunda solicitud de depósito PUT a fin de configurar el registro del depósito.

En la siguiente lista, se muestra el método de la API de XML que usas para realizar las tareas de objetos y depósitos.

Convenciones usadas

Convenciones usadas en la documentación de la API de XML:

  • El encabezado Authorization se representa como <authentication string>. Si usas la API de XML para migrar desde otro proveedor de almacenamiento, el Authorization tiene el formato que se analiza en Autenticación en una situación de migración simple. De lo contrario, el encabezado Authorization tiene el formato analizado en Autenticación de OAuth 2.0.

    Si no proporcionas información de autorización cuando sea necesario para realizar una solicitud, Cloud Storage emitirá un error no válido 401. Para obtener más información, consulta los Códigos de estado.

  • El encabezado Host que se usa en la documentación de la API de XML tiene el siguiente formato:

    Host: BUCKET-NAME.storage.googleapis.com
    en el que el nombre del depósito se especifica como parte del nombre de host. En todas las operaciones, excepto el servicio GET, también puedes especificar el depósito como parte de la ruta de URL. Para obtener más información, consulta Solicita extremos.