Propriétés et commandes de l'adaptateur

Le présent chapitre fournit une description détaillée de l'adaptateur.

Clé d'accès

Spécifie la clé de l'utilisateur AWS pour la connexion. Cette clé d'accès est utilisée pour signer les demandes par programmation envoyées aux appels d'API AWS via l'adaptateur. La commande d'adaptateur correspondante est -AK (ou -ACCESSKEY).

Clé secrète

Spécifie la clé de l'utilisateur AWS pour la connexion. Comme le nom d'utilisateur et le mot de passe, l'ID de clé d'accès et la clé d'accès secrète sont obligatoires afin d'authentifier l'objet S3 pour une requête Get ou Put. La commande d'adaptateur correspondante est -SK (ou -SECRETKEY).

Nom de la région

Spécifie le nom pour se connecter à une région AWS pour le compte de l'utilisateur IAM. La commande d'adaptateur correspondante est -R (ou -REGION).

Nom du bucket

Spécifie le nom dans lequel un objet S3 résiderait. Au cours de la configuration, l'adaptateur S3 fournit des options pour sélectionner le nom de compartiment parmi les compartiments disponibles. La commande d'adaptateur correspondante est -B (ou -BUCKET).

Nom du dossier

Spécifie le nom de dossier dans lequel l'objet S3 peut résider à l'intérieur d'un compartiment. Cette propriété est optionnelle, car un objet peut résider directement à l'intérieur d'un compartiment ou dans un dossier. Lorsque la propriété Dossier n'est pas spécifiée, l'adaptateur choisit le chemin direct du compartiment pour accéder à l'objet. Autrement, le nom du dossier est préfixé au nom de la clé. La commande d'adaptateur correspondante est -F (ou -FOLDER).

Nom de l'objet

Spécifie le nom de l'objet S3 auquel accéder. Une clé peut résider directement dans un compartiment ou un dossier à l'intérieur d'un compartiment. La commande d'adaptateur correspondante est -K (ou -KEY).

Type de contenu

Spécifie le champ qui indique le type de support du corps d'entité envoyé à Amazon S3. Si le type n'est pas défini, l'adaptateur choisit le type par défaut : un type MIME standard qui décrit le format du contenu. Pour plus d'informations, voir https://www.w3.org/Protocols/rfc1341/4_Content-Type.html.

Type : Chaîne

Valeur par défaut : binary/octet-stream

Valeurs valides : Types MIME

Contraintes : Aucun

La commande d'adaptateur correspondante est -CT (ou -CONTENTTYPE).

Langue de travail

Définit l'en-tête HTTP de langue du contenu, qui spécifie la ou les langues naturelles de l'audience prévue pour l'entité encadrée. Si aucune langue n'est définie, l'adaptateur S3 utilise la valeur par défaut "en". La commande d'adaptateur correspondante est -CL (ou -CONTENTLANG).

Chiffrement

Spécifie l'algorithme de cryptage côté serveur lors du chiffrement de l'objet en utilisant les clés gérées par AWS. Lorsque la propriété n'est pas spécifiée, les données téléchargées sur S3 restent non chiffrées. La commande d'adaptateur correspondante est -E (ou -ENCRYPTION).

Valeurs valides : AES256, KMS.

AES256: Advanced Encryption Standard 256 bits est une technique de cryptage de données ou de fichiers. Le résultat du processus est téléchargeable dans un fichier texte. AES effectue tous ses calculs en octets plutôt qu'en bits. Par conséquent, AES traite les 256 bits d'un bloc de texte simple comme 16 octets. Il utilise 14 tours pour des clés de 256 bits. Pour plus d'informations, voir https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html.

KMS : Il représente AWS Key Management Service (AWS KMS). Les clés principales que l'utilisateur crée dans AWS KMS sont utilisées pour chiffrer ou déchiffrer l'objet téléchargé sur S3. Pour plus d'informations sur la technique de chiffrement KMS, voir https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html.

Journalisation

Spécifie le niveau de journalisation à utiliser pour le fichier journal (fichier de trace) produit par l'adaptateur. La valeur par défaut est Désactivé. La valeur Informatif permet de consigner les messages d'information et d'erreur, la valeur Erreurs uniquement permet de consigner uniquement les messages d'erreur et la valeur Prolixe permet de consigner les messages de débogage et de niveau de trace en plus des messages d'information et d'erreur.

La journalisation peut être spécifiée à l'aide de la commande :

-T [E|V] [+] [file_path]

-T Journalisation des messages d'information de l'adaptateur.

-TE Consigne uniquement les erreurs d'adaptateur pendant l'exécution de la mappe.

-TV Utilisation de la journalisation prolixe (débogage). Le fichier journal consigne toute l'activité lorsque l'adaptateur génère ou consomme des messages.

+ Ajout des informations de trace à un fichier existant. Omettez ce mot clé pour créer un nouveau fichier journal.

file_path Le chemin d'accès complet au journal de trace de l'adaptateur. Si vous omettez ce mot clé, l'adaptateur crée le fichier journal m4azblob.mtr dans le répertoire de mappe.

Ajouter un journal

Spécifie l'indicateur qui signale l'action à effectuer lorsque le fichier journal spécifié existe déjà. Lorsque la valeur est true, les messages du journal sont ajoutés au fichier. Lorsque la valeur est false, le fichier est tronqué et les messages sont écrits dans le fichier vide. La valeur par défaut est true.

Mode lecture

Indique si vous souhaitez supprimer, conserver ou répertorier les données après avoir lu les données à partir du compartiment S3. La valeur par défaut est Conserver. Il existe trois valeurs :

Liste : Pour répertorier tous les objets du compartiment S3
Conserver : Pour conserver un objet dans le compartiment S3
Supprimer : Pour supprimer un objet après la lecture des données

Les commandes d'adaptateur correspondantes sont -KP (ou -KEYPREFIX) et -KD (ou -KEYDELIMITER).

Caractère générique

Si le mode Lecture est Liste, tous les objets sont répertoriés dans le compartiment S3. Pour filtrer les objets souhaités à partir des objets répertoriés dans le compartiment, spécifiez les options Préfixe de clé et/ou Délimiteur de clé. Les préfixes et les délimiteurs sont utilisés pour organiser les objets dans le compartiment S3.

Nœud final

Spécifie le nœud final pour la connexion et l'accès aux compartiments compatibles S3 ou S3 par l'adaptateur Amazon S3. S'il n'est pas spécifié, l'adaptateur Amazon S3 se connecte au nœud final du service Amazon S3 en fonction de la région spécifiée.

Pour accéder à un compartiment compatible S3 hébergé par un service de stockage d'objets autre que le service Amazon S3 défaut, vous devez spécifier l'option Nœud final. L'option Région est facultative. La commande d'adaptateur correspondante est -EP (ou -ENDPOINT).

Chemin du fichier journal

Indique l'emplacement du fichier journal dans lequel les messages journaux sont écrits. S'il n'est pas spécifié, le système utilise le nom du fichier journal par défaut m4s3.trc et stocke le fichier dans le répertoire où se trouve la carte compilée exécutée.