?> addRegion - WeAreCAS
s3

addRegion

Description

L'action `addRegion` dans le jeu d'actions S3 est utilisée pour ajouter ou remplacer des régions personnalisées pour l'environnement S3 (Simple Storage Service) d'Amazon Web Services (AWS). Cela permet à SAS Viya de se connecter à des points de terminaison S3 qui ne sont pas des régions AWS standard, comme des déploiements S3 sur site (on-premises) ou d'autres fournisseurs de stockage compatibles S3. En définissant une région personnalisée, vous spécifiez l'hôte, le port et les paramètres SSL nécessaires pour que CAS puisse interagir avec ce stockage externe.

s3.addRegion { host="chaîne", name="chaîne", nossl=TRUE | FALSE, port=entier_64_bits, region="chaîne", sslallowed=TRUE | FALSE, sslport=entier_64_bits, sslrequired=TRUE | FALSE };
Paramètres
ParamètreDescription
hostSpécifie le serveur auquel CAS se connecte sur AWS.
nameSpécifie un nom unique pour la région que vous ajoutez ou remplacez.
nosslSpécifie que SSL ou TLS est désactivé pendant le transfert de données.
portSpécifie le port HTTP pour se connecter sans utiliser SSL. Si aucune valeur de port n'est spécifiée, la valeur par défaut est utilisée.
regionSpécifie le code de région de la région que vous ajoutez ou remplacez.
sslallowedSpécifie que SSL est autorisé lors de la communication avec l'environnement S3. Cette valeur est ignorée si le paramètre SSLREQUIRED est spécifié.
sslportSpécifie le port HTTP pour se connecter à S3 avec SSL. Si aucune valeur de port n'est spécifiée, la valeur par défaut est utilisée.
sslrequiredSpécifie que toutes les communications avec l'environnement S3 doivent être effectuées en utilisant SSL.
Préparation des Données
Aucune donnée nécessaire

Cette action ne nécessite pas de table CAS en entrée car elle gère la configuration du serveur CAS.

1/* Pas de code de création de données nécessaire pour cet exemple */

Exemples

Cet exemple montre comment ajouter une nouvelle région S3 personnalisée nommée 'mon-datacenter' qui pointe vers un serveur de stockage compatible S3 sur site.

Code SAS® / CAS
Copié !
1PROC CAS;
2 S3.addRegion name='mon-datacenter' host='s3.mondatacenter.local';
3RUN;
Résultat :
L'action s'exécute avec succès et la nouvelle région est ajoutée à la configuration du serveur CAS. Une note de succès sera affichée dans le journal.

Cet exemple ajoute une région S3 personnalisée pour un fournisseur de stockage cloud tiers. Il spécifie un nom, un hôte, un code de région, et configure les ports pour les connexions non-SSL et SSL, tout en exigeant que SSL soit utilisé.

Code SAS® / CAS
Copié !
1PROC CAS;
2 S3.addRegion
3 name='autre-fournisseur-cloud'
4 region='custom-west-1'
5 host='storage.autrecloud.com'
6 port=8080
7 sslport=8443
8 sslrequired=true;
9RUN;
Résultat :
L'action configure une nouvelle région nommée 'autre-fournisseur-cloud'. Les journaux CAS confirmeront que la région a été ajoutée avec succès. Toute tentative de connexion à cette région via une caslib S3 utilisera SSL sur le port 8443.

FAQ

Quelle est la fonction de l'action `addRegion` dans le jeu d'actions S3 ?
À quoi sert le paramètre `host` dans l'action `addRegion` ?
Quelle est l'utilité du paramètre `name` ?
Que spécifie le paramètre `nossl` ?
Comment utiliser le paramètre `port` ?
Quel est le rôle du paramètre `region` ?
Quand faut-il utiliser le paramètre `sslallowed` ?
À quoi sert le paramètre `sslport` ?
Que signifie le paramètre `sslrequired` ?

Scénarios associés

Cas d'usage
Intégration Standard avec un Stockage S3 sur Site (On-Premise)

Une entreprise de grande distribution utilise un cluster MinIO (stockage objet compatible S3) sur son infrastructure interne pour centraliser les données de ventes quotidiennes....

Cas d'usage
Configuration pour un Environnement Hybride et Sécurisé

Une institution financière gère un environnement cloud hybride. Les données sensibles des clients sont stockées chez un fournisseur de cloud spécialisé qui impose des connexions...

Cas d'usage
Test des Cas Limites et de la Gestion des Erreurs

L'équipe d'administration de la plateforme SAS souhaite documenter les comportements en cas de mauvaise configuration pour former les utilisateurs et éviter les erreurs de déplo...