Transferencia a través de una red privada administrada por Google

Console

La opción de red privada administrada por Google se habilita con una casilla de verificación en el paso Elige la configuración de la creación de un trabajo de transferencia.

Para crear un trabajo nuevo con la red privada administrada por Google, haz lo siguiente:

1. Ve a la página Servicio de transferencia de almacenamiento en la consola de Cloud de Confiance .

   Ir al Servicio de transferencia de almacenamiento

2. Haz clic en Crear trabajo de transferencia. Se muestra la página Crea un trabajo de transferencia.

3. En Tipo de fuente, selecciona Amazon S3.

4. Como Tipo de destino, selecciona Google Cloud Storage.

5. Selecciona tu Modo de programación. Las transferencias por lotes se ejecutan de forma única o programada. Las transferencias basadas en eventos supervisan continuamente la fuente y transfieren datos cuando se agregan o modifican.

   Para configurar una transferencia basada en eventos, sigue las instrucciones que se indican en Transferencias basadas en eventos.

6. Haz clic en Próximo paso.

7. En el campo Nombre del bucket o la carpeta, ingresa el nombre del bucket de origen.

   El nombre del bucket es el nombre que aparece en la consola de administración de AWS.

8. Selecciona el método de autenticación de Amazon Web Services (AWS). Consulta Configura el acceso a una fuente: Amazon S3 para obtener más información.

   • Recurso de Secret: Selecciona esta opción para usar una credencial de Amazon guardada en Secret Manager. Selecciona un secreto de la lista o ingresa uno de forma manual en el formato projects/PROJECT_NUMBER/secrets/SECRET_NAME.

   • Clave de acceso: Ingresa tu clave de acceso en el campo ID de clave de acceso y el secreto asociado con tu clave de acceso en el campo Clave de acceso secreta.

   • Rol de IAM de AWS para la federación de identidades: Ingresa tu ARN en el campo ARN del rol de IAM de AWS con la siguiente sintaxis:

     • Regiones de AWS estándar:

       arn:aws:iam::AWS_ACCOUNT:role/AWS_ROLE_NAME

     • Regiones de AWS GovCloud:

       arn:aws-us-gov:iam::AWS_ACCOUNT:role/AWS_ROLE_NAME

     Reemplaza lo siguiente:

     • AWS_ACCOUNT: El ID de la cuenta de AWS sin guiones.
     • AWS_ROLE_NAME: Es el nombre del rol de AWS. Si tu organización usa rutas de acceso para organizar los roles, incluye la ruta de acceso con el nombre del rol. Por ejemplo, developers/transfer_user.

     Para obtener más información sobre los ARN, consulta ARN de IAM.

9. Si se trata de una transferencia basada en eventos, ingresa el ARN de la cola de Amazon SQS, que tiene el siguiente formato:

   • Regiones de AWS estándar:

     arn:aws:sqs:us-east-1:1234567890:event-queue

   • Regiones de AWS GovCloud:

     arn:aws-us-gov:sqs:us-gov-east-1:1234567890:event-queue

10. De manera opcional, elige filtrar objetos por prefijo, por fecha de última modificación o por clase de almacenamiento. Si especificaste una carpeta como ubicación de origen, los filtros de prefijo son relativos a esa carpeta. Por ejemplo, si tu fuente es my-test-bucket/path/, un filtro de inclusión de file incluye todos los archivos que comienzan con my-test-bucket/path/file.

11. Haz clic en Próximo paso.

12. En el campo Bucket o carpeta, ingresa el bucket de destino y el nombre de la carpeta (opcional) o haz clic en Explorar para seleccionar un bucket de una lista de buckets existentes en tu proyecto actual. Para crear un bucket nuevo, haz clic en Crear nuevo bucket.

13. Haz clic en Próximo paso.

14. Elige tus opciones de programación:

    Nota: El Servicio de transferencia de almacenamiento muestra programas de trabajos de transferencia en tu zona horaria local, pero esta almacena esas horas en horario universal coordinado (UTC). Si te ves afectado por el horario de verano, es posible que experimentes un cambio en el programa del trabajo de transferencia cuando comience o finalice el horario de verano.

    1. En la lista desplegable Ejecutar una vez, selecciona una de las siguientes opciones:

       • Ejecutar una vez: Ejecuta una sola transferencia, a la hora que selecciones.

       • Ejecutar todos los días: Ejecuta una transferencia a diario a partir de la hora que selecciones.

         Puedes ingresar una Fecha de finalización opcional o dejar en blanco Fecha de finalización para ejecutar la transferencia de forma continua.

       • Ejecutar cada semana: Ejecuta una transferencia semanal, a la hora que seleccionas.

       • Ejecutar con frecuencia personalizada: Ejecuta una transferencia con la frecuencia que seleccionas. Puedes elegir repetir la transferencia a un intervalo regular de horas, días o semanas.

         Puedes ingresar una Fecha de finalización opcional o dejar en blanco Fecha de finalización para ejecutar la transferencia de forma continua.

       • Ejecutar a pedido: No activará una ejecución cuando se cree este trabajo de transferencia. Deberás iniciar el trabajo de forma manual.

    2. En la lista desplegable A partir de ahora, selecciona una de las siguientes opciones:

       • Inicio ahora: Inicia la transferencia después de hacer clic en Crear.
       • A partir del: Inicia la transferencia en la fecha y hora que seleccionaste. Haz clic en Calendario para mostrar un calendario y seleccionar la fecha de inicio.

15. Haz clic en Próximo paso.

16. Elige la configuración del trabajo de transferencia.

    1. En el campo Descripción, ingresa una descripción de la transferencia. Como práctica recomendada, ingresa una descripción que sea significativa y única para que puedas distinguir los trabajos.

    2. De forma opcional, proporciona un manifiesto para especificar los objetos exactos que se transferirán.

    3. En Opciones de metadatos, selecciona la clase de almacenamiento y el comportamiento de la hora de creación que desees. Consulta Conservación de metadatos para obtener más información.

    4. En Cuándo reemplazar, selecciona una de las siguientes opciones:

       • Nunca: No reemplaza un archivo de destino si el archivo fuente tiene el mismo nombre. Se omite el archivo de origen.
       • Si es diferente: Reemplaza los archivos de destino si el archivo de origen con el mismo nombre tiene diferentes ETags o valores de suma de verificación.
       • Siempre: Siempre reemplaza los archivos de destino cuando el archivo de origen tiene el mismo nombre, incluso si son idénticos.

    5. En Cuándo borrar, selecciona una de las siguientes opciones:

       • Nunca: Nunca borres archivos de origen o de destino.

       • Borrar archivos de la fuente después de la transferencia: Borra los archivos de la fuente después de transferirlos al destino. Si no se transfiere un archivo fuente, por ejemplo, porque ya existe en el destino, no se borra.

         Importante: Si no tienes una copia de seguridad local, esta opción es una acción no reversible.

       • Borra los archivos del destino si no están también en el origen: Si los archivos en el bucket de Cloud Storage de destino no están también en el origen, borra los archivos del bucket de Cloud Storage.

         Esta opción garantiza que el bucket de destino de Cloud Storage coincida exactamente con tu fuente.

    6. Elige opciones de enrutamiento de red:

       • Selecciona Usar red privada administrada.

    7. En Opciones de registro, selecciona Habilitar el registro en Cloud Logging si deseas generar un registro detallado de las acciones realizadas en cada archivo transferido. Se aplican los costos de Cloud Logging. Consulta Acciones de transferencia de registros para obtener más detalles.

    8. De manera opcional, selecciona Obtén actualizaciones del estado de la operación de transferencia a través de notificaciones de Cloud Pub/Sub, elige tu tema de Pub/Sub y selecciona los eventos que activan las notificaciones. Consulta las notificaciones de Pub/Sub para obtener más detalles.

    9. En Elige el tipo de cuenta de servicio, selecciona la identidad que se usará:

       • Agente de servicio del Servicio de transferencia de almacenamiento: El agente de servicio predeterminado administrado por Google recibe automáticamente acceso a los buckets de origen y destino.
       • Agente de servicio administrado por el usuario: Usa una cuenta de servicio personalizada que hayas creado. Antes de seleccionar esta opción, asegúrate de que a tu cuenta de servicio se le haya otorgado acceso al bucket de origen, al bucket de destino y a Pub/Sub. Consulta Cómo usar un agente de servicio administrado por el usuario.

17. Haz clic en Crear para crear el trabajo de transferencia.

gcloud CLI

Gcloud CLI no admite la configuración de transferencias a través de una red privada administrada por Google. Usa la consola de Cloud de Confiance o la API de REST para habilitar esta opción.

Bibliotecas cliente

Las bibliotecas cliente del Servicio de transferencia de almacenamiento no admiten la configuración de transferencias a través de una red privada administrada por Google. Usa la consola de Cloud de Confiance o la API de REST para habilitar esta opción.

API de REST

Para configurar una transferencia con la API de REST, establece el campo booleano transferSpec.awsS3DataSource.managedPrivateNetwork en true dentro de la carga útil de la solicitud JSON cuando llames a transferJobs.create o transferJobs.patch.

Solicitud HTTP

POST https://storagetransfer.googleapis.com/v1/transferJobs

Cuerpo de la solicitud

{
  "description": "S3 to Cloud Storage over Google-managed private network",
  "status": "ENABLED",
  "projectId": "PROJECT_ID",
  "transferSpec": {
    "awsS3DataSource": {
      "bucketName": "AWS_SOURCE_NAME",
      "managedPrivateNetwork": true,
      "awsAccessKey": {
        "accessKeyId": "AWS_ACCESS_KEY_ID",
        "secretAccessKey": "AWS_SECRET_ACCESS_KEY"
      }
    },
    "gcsDataSink": {
      "bucketName": "GCS_SINK_NAME"
    },
    "transferOptions": {
      "overwriteWhen": "DIFFERENT",
      "deleteObjectsFromSourceAfterTransfer": false
    }
  }
}

En este ejemplo, se usan credenciales de acceso de AWS para la autenticación. Consulta Configura el acceso a Amazon S3 para obtener detalles sobre el uso de la identidad federada o las credenciales en Secret Manager.