Usar pagos del solicitante (original) (raw)

Ir al contenido principal

• Áreas tecnológicas

  • Introducción
  • Guías
  • Referencia
  • Ejemplos
  • Recursos

• Herramientas para varios productos

• Consola

• Descubrir

• Descripción general del producto

• Información general sobre Storage Intelligence

• Empezar

• Compatibilidad de Terraform con Cloud Storage

• Configurar y gestionar Storage Intelligence

• Crear segmentos

• Crear un segmento

• Verificación de segmentos con nombre de dominio

• Acceder a los segmentos y gestionarlos

• Mostrar segmentos

• Cambiar la clase de almacenamiento predeterminada de un segmento

• Mover y cambiar el nombre de los segmentos

• Eliminar segmentos

• Subir y descargar objetos

• Acerca de los objetos

• Información general sobre las subidas y descargas

• Sube objetos

  • Subir objetos desde archivos
  • Subir objetos desde la memoria
  • Subidas multiparte de la API XML
  • Subidas compuestas paralelas
  • Subidas por streaming

• Acceder a objetos y gestionarlos

• Mostrar objetos

• Copiar, cambiar el nombre y mover objetos

• Cambiar la clase de almacenamiento de un objeto

• Herramientas para acceder a objetos y gestionarlos mediante una estructura de directorios

• Transcodificación de objetos

• Eliminar objetos

• Obtener estadísticas sobre los datos almacenados

• Analizar datos almacenados con Gemini Cloud Assist

• Objetos de caché

• Acerca del almacenamiento en caché

• Controlar los ciclos de vida de los datos

• Opciones para controlar los ciclos de vida de los datos

• Hacer solicitudes

• Coherencia en las operaciones de Cloud Storage

• Solicitudes por lotes

• Usar operaciones de larga duración

• Paginación de resultados

• Comodines de URI

• Protección de los datos

• Control de acceso

  • Presentación
  • Filtrado de IPs de los contenedores
    * Introducción
    * Crear un contenedor con reglas de filtrado por IP
    * Crear o actualizar reglas de filtrado de IP en un segmento
    * Obtener reglas de filtrado de segmentos de IP
    * Mostrar reglas de filtrado de IP de un segmento
    * Eliminar reglas de filtrado por IP de un segmento
    * Inhabilitar el filtrado por IP de un bucket
    * Saltarse las reglas de filtrado de IP de los contenedores
  • Casos de uso compartido y colaboración
  • Prácticas recomendadas sobre control de acceso

• Monitorizar datos y uso

• Usar los registros de auditoría de Cloud con Cloud Storage

• Registros de uso y de almacenamiento

• Usar los registros de auditoría de Cloud con operaciones por lotes de almacenamiento

• Usar Cloud Logs con operaciones por lotes de almacenamiento

• Usar los registros de auditoría de Cloud con Estadísticas de almacenamiento

• Usar métricas del lado del cliente de gRPC

• Usar trazas del lado del cliente

• Protección, copias de seguridad y recuperación

• Introducción

• Eliminación no definitiva

  • Introducción
  • Definir y gestionar políticas de eliminación suave
  • Usar objetos eliminados de forma lógica
  • Usar segmentos eliminados temporalmente
  • Definir una duración predeterminada de la conservación de datos para la eliminación no definitiva
  • Usar recomendaciones de eliminación no definitiva
  • Inhabilitar la eliminación no definitiva

• Montar segmentos con Cloud Storage FUSE

• Introducción

• Guía de inicio rápido

• Instalar Cloud Storage FUSE

• Montar segmentos

• Rendimiento

  • Prácticas recomendadas para optimizar el rendimiento
  • Configuraciones basadas en perfiles para cargas de trabajo de IA y aprendizaje automático
  • Valores de configuración automatizados para tipos de máquinas de alto rendimiento
  • Usar archivos YAML de GKE preconfigurados para optimizar el rendimiento de Cloud Storage FUSE

• Trabajar en diferentes productos, nubes y plataformas

• Prácticas recomendadas para cargas de trabajo multimedia

• Interoperabilidad

• Usar Cloud Storage con Big Data

• Integración con los servicios y las herramientas de Google Cloud Platform

• Solucionar problemas

• Solucionar problemas habituales

• Solucionar problemas de Estadísticas de almacenamiento

• Solucionar problemas de Cloud Storage FUSE

Usar pagos del solicitante

Descripción general

En esta página se describe cómo habilitar e inhabilitar Pagos del solicitante, así como cómo comprobar si esta función está habilitada en un segmento.

Roles obligatorios

Para obtener los permisos necesarios para configurar y gestionar Petición de pago, pide a tu administrador que te conceda el rol Administrador de Storage (roles.storage.Admin) en el proyecto que contiene el segmento.

Este rol contiene los permisos necesarios para configurar y gestionar la función de pagos del solicitante. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

• storage.buckets.get
• storage.buckets.update
• resourcemanager.projects.createBillingAssignment
  • Este permiso solo es necesario si no tienes una cuenta de facturación que usar al inhabilitar Peticionario paga. Para obtener más información, consulta los requisitos de uso y acceso.

También puedes obtener estos permisos con otros roles predefinidos o roles personalizados.

Para obtener instrucciones sobre cómo asignar roles en proyectos, consulta Asignar o revocar un rol.

Establecer pagos del solicitante

Para habilitar o inhabilitar los pagos del solicitante en un segmento, sigue estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
   Ir a Contenedores
2. En la lista de contenedores, busca el que quieras definir y localiza la columna El solicitante paga.
   El valor de la columna indica el estado actual de Peticionario paga de ese contenedor.
3. Haga clic en el estado actual de los pagos del solicitante del segmento.
4. En la ventana que aparece, haz clic en Activar o Desactivar, según el estado que quieras definir para Paga el solicitante.

Si está habilitada, aparecerá una burbuja verde y el texto Activado en la columna Pago del solicitante del segmento. Si está inhabilitada, aparecerá una burbuja gris y el texto Desactivado en la columna.

Para saber cómo obtener información detallada sobre los errores de las operaciones de Cloud Storage en la consola de Google Cloud , consulta la sección Solución de problemas.

Línea de comandos

Usa el comando gcloud storage buckets update con la marca adecuada:

gcloud storage buckets update gs://BUCKET_NAME FLAG

Donde:

• BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
• FLAG es --requester-pays para habilitar Requester Pays o --no-requester-pays para inhabilitarlo.

Si la solicitud se hace correctamente, la respuesta será similar a la del siguiente ejemplo:

Updating gs://my-bucket/... Completed 1

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

En el siguiente ejemplo se habilita la función de pagos del solicitante en un segmento:

En el siguiente ejemplo se inhabilita la opción de pagos del solicitante en un segmento:

APIs REST

API JSON

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. Crea un archivo JSON que contenga la siguiente información:
   {
   "billing": {
   "requesterPays": STATE
   }
   }
   STATE puede ser true o false.
3. Usa cURL para llamar a la API JSON con una solicitud de PATCH contenedor:
   curl -X PATCH --data-binary @JSON_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=billing"
   Donde:
   • JSON_FILE_NAME es la ruta del archivo JSON que has creado en el paso 2.
   • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

API XML

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. Crea un archivo XML que contenga la siguiente información: STATE STATE puede ser `Enabled` o `Disabled`.
3. Usa cURL para llamar a la API XML con una solicitud de PUT contenedor y el parámetro de cadena de consulta billing:
   curl -X PUT --data-binary @XML_FILE_NAME \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/BUCKET_NAME?billing"
   Donde:
   • XML_FILE_NAME es la ruta del archivo XML que has creado en el paso 2.
   • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

Comprobar si la función de pagos del solicitante está habilitada

Si quieres comprobar si la función Pagos del solicitante está habilitada en un segmento, sigue estos pasos:

Consola

1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
   Ir a Contenedores
2. En la lista de segmentos, el estado de los pagos del solicitante de cada segmento se encuentra en la columna Pagos del solicitante.

Si está función está habilitada, el estado es verde y aparece la palabra Activados.

Línea de comandos

Usa el comando gcloud storage buckets describe con la marca --format:

gcloud storage buckets describe gs://BUCKET_NAME --format="default(requester_pays)"

Donde BUCKET_NAME es el nombre del contenedor cuyo estado quieres ver. Por ejemplo, my-bucket.

Si la solicitud se hace correctamente, la respuesta será similar a la del siguiente ejemplo:

requester_pays: true

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

APIs REST

API JSON

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. Usa cURL para llamar a la API JSON con una solicitud de GET contenedor:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=billing"
   Donde BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

API XML

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. Usa cURL para llamar a la API XML con una solicitud de GET contenedor y el parámetro de cadena de consulta billing:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://storage.googleapis.com/BUCKET_NAME?billing"
   Donde BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.

Acceder a segmentos con pagos del solicitante

En el siguiente ejemplo, se muestra cómo incluir un proyecto de facturación para poder descargar un objeto almacenado en un segmento de Pagos del solicitante. Sigue un procedimiento similar para realizar otras peticiones en el segmento de pagos del solicitante o en objetos dentro de él. Consulta los requisitos de acceso de Peticionario paga para ver los requisitos previos.

Consola

1. En la Google Cloud consola, ve a la página Segmentos de Cloud Storage.
   Ir a Contenedores
2. En la lista de segmentos, haz clic en el nombre del segmento que contiene el objeto que quieres descargar.
3. En la ventana que aparece, usa el menú desplegable para seleccionar un proyecto para la facturación.
4. Marca la casilla para confirmar que tienes autorización para usar el proyecto seleccionado con fines de facturación.
5. Haz clic en Guardar.
6. Descarga el objeto como lo harías normalmente.

Para saber cómo obtener información detallada sobre los errores de las operaciones de Cloud Storage en la consola de Google Cloud , consulta la sección Solución de problemas.

Línea de comandos

Usa la marca --billing-project en tu solicitud:

gcloud storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION --billing-project=PROJECT_IDENTIFIER

Donde:

• BUCKET_NAME es el nombre del segmento que contiene el objeto que estás descargando. Por ejemplo, my-bucket.
• OBJECT_NAME es el nombre del objeto que vas a descargar. Por ejemplo, pets/dog.png.
• SAVE_TO_LOCATION es la ruta local donde vas a guardar el objeto. Por ejemplo, Desktop/Images.
• PROJECT_IDENTIFIER es el ID o el número del proyecto que se va a facturar. Por ejemplo, my-project.

Bibliotecas de cliente

C++

Para obtener más información, consulta ladocumentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

C#

Para obtener más información, consulta ladocumentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Go

Para obtener más información, consulta ladocumentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Java

Para obtener más información, consulta ladocumentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Node.js

Para obtener más información, consulta ladocumentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

PHP

Para obtener más información, consulta ladocumentación de referencia de la API PHP de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Python

Para obtener más información, consulta ladocumentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

Ruby

Para obtener más información, consulta ladocumentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

APIs REST

API JSON

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. En tu solicitud, incluye el conjunto de parámetros de cadena de consulta userProject con el ID del proyecto que se va a facturar:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -o "SAVE_TO_LOCATION" \
   "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media&userProject=PROJECT_IDENTIFIER"
   Donde:
   • SAVE_TO_LOCATION es la ubicación en la que quieres guardar el objeto. Por ejemplo, Desktop/dog.png.
   • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
   • OBJECT_NAME es el nombre codificado como URL del objeto que quieres descargar. Por ejemplo, pets/dog.png, codificado como URL pets%2Fdog.png.
   • PROJECT_IDENTIFIER es el ID o el número del proyecto que se va a facturar. Por ejemplo, my-project.

API XML

1. Tener gcloud CLI instalado e inicializado, lo que te permite generar un token de acceso para el encabezado Authorization.
2. En tu solicitud, incluye el encabezado x-goog-user-project con el ID del proyecto al que se le facturará:
   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   -o "SAVE_TO_LOCATION" \
   "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
   Donde:
   • PROJECT_ID es el ID del proyecto que se va a facturar. Por ejemplo, my-project.
   • SAVE_TO_LOCATION es la ubicación en la que quieres guardar el objeto. Por ejemplo, Desktop/dog.png.
   • BUCKET_NAME es el nombre del segmento correspondiente. Por ejemplo, my-bucket.
   • OBJECT_NAME es el nombre codificado como URL del objeto que quieres descargar. Por ejemplo, pets/dog.png, codificado como URL pets%2Fdog.png.

Siguientes pasos

• Consulta más información sobre Pagos del solicitante.
• Hacer que los datos estén disponibles públicamente.

A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.

Última actualización: 2025-12-15 (UTC).