?> addRegion - WeAreCAS
s3

addRegion

Descripción

Agrega o reemplaza regiones personalizadas para el entorno S3. Esta acción permite a los administradores definir endpoints S3 a medida, más allá de las regiones estándar de AWS, lo que es útil para conectarse a almacenamientos de objetos compatibles con S3 locales o de terceros.

s3.addRegion { host="cadena", name="cadena", nossl=booleano, port=entero_64_bits, region="cadena", sslallowed=booleano, sslport=entero_64_bits, sslrequired=booleano };
Parámetros
ParámetroDescripción
hostEspecifica el servidor al que CAS se conecta en AWS o en un entorno compatible con S3.
nameEspecifica un nombre único para la región que se está agregando o reemplazando.
nosslEspecifica que SSL o TLS está deshabilitado durante la transferencia de datos. El valor predeterminado es FALSE.
portEspecifica el puerto HTTP para conectarse sin usar SSL. Si no se especifica un valor de puerto, se utiliza el valor predeterminado (0).
regionEspecifica el código de región de la región que se está agregando o reemplazando.
sslallowedEspecifica que se permite SSL al comunicarse con el entorno S3. Este valor se ignora si se especifica el parámetro sslrequired. El valor predeterminado es TRUE.
sslportEspecifica el puerto HTTP para conectarse a S3 con SSL. Si no se especifica un valor de puerto, se utiliza el valor predeterminado (0).
sslrequiredEspecifica que todas las comunicaciones con el entorno S3 se realizan mediante SSL. El valor predeterminado es TRUE.
Preparación de datos
Creación de Datos de Ejemplo

Esta acción no requiere datos de entrada en una tabla CAS, ya que su propósito es configurar el entorno del servidor. Por lo tanto, no se necesita un paso de creación de datos.

1/* No se necesita creación de datos para esta acción */

Ejemplos

Este ejemplo muestra cómo agregar una nueva región S3 personalizada llamada 'my-custom-region' que apunta al host 's3.my-company.com'.

Código SAS® / CAS
¡Copiado!
1PROC CAS;
2 S3.addRegion name='my-custom-region' host='s3.my-company.com';
3RUN;
Resultado :
La acción agrega la nueva configuración de región al servidor CAS. No se devuelve ninguna tabla de resultados, pero el éxito se puede verificar a través del código de estado o listando las regiones con la acción `s3.listRegions`.

Este ejemplo demuestra cómo agregar o reemplazar una región S3 llamada 'my-secure-region', especificando el host, el código de región, y configurando explícitamente los puertos para conexiones SSL y no SSL, al tiempo que se requiere SSL.

Código SAS® / CAS
¡Copiado!
1PROC CAS;
2 S3.addRegion name='my-secure-region'
3 host='secure.s3.my-company.com'
4 region='corp-east-1'
5 port=9000
6 sslport=9090
7 sslrequired=true;
8RUN;
Resultado :
La acción configura la región 'my-secure-region' con los detalles de conexión especificados. La comunicación con este endpoint requerirá SSL en el puerto 9090. El éxito se confirma a través del código de estado de la acción y se puede verificar la configuración con `s3.listRegions`.

FAQ

¿Cuál es el propósito de la acción addRegion?
¿Cuáles son los parámetros requeridos para la acción addRegion?
¿Qué especifica el parámetro 'host'?
¿Para qué se utiliza el parámetro 'nossl'?
¿Cuál es la función del parámetro 'sslrequired'?

Escenarios asociados

Caso de uso
Conexión a Almacenamiento S3 On-Premise Seguro

Una firma de análisis financiero necesita conectar su entorno SAS Viya a un sistema de almacenamiento de objetos compatible con S3 (como MinIO) desplegado en su centro de datos ...

Caso de uso
Actualización de un Endpoint de Región S3 Durante una Migración de Proveedor

Una empresa de e-commerce está migrando su proveedor de almacenamiento de objetos. Inicialmente, configuran un endpoint para el nuevo proveedor, pero se dan cuenta de que la URL...

Caso de uso
Gestión de Errores por Omisión de Parámetros Obligatorios

Un administrador de sistemas junior está intentando configurar una nueva región S3 por primera vez. Comete errores comunes, como omitir parámetros obligatorios. El objetivo es v...