DescribedConnector - AWS Transfer Family
Table des matièresconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DescribedConnector

Décrit les paramètres du connecteur, tels qu'identifiés par leConnectorId.

Table des matières

Arn

Nom de ressource Amazon (ARN) unique pour le connecteur.

Type : chaîne

Contraintes de longueur : longueur minimale de 20. Longueur maximale de 1600.

Modèle : arn:\S+

Obligatoire : oui

AccessRole

Les connecteurs sont utilisés pour envoyer des fichiers en utilisant le protocole AS2 ou SFTP. Pour le rôle d'accès, indiquez le nom de ressource Amazon (ARN) du AWS Identity and Access Management rôle à utiliser.

Pour connecteurs AS2

Avec AS2, vous pouvez envoyer des fichiers en appelant StartFileTransfer et en spécifiant les chemins de fichier dans le paramètre de requête, SendFilePaths. Nous utilisons le répertoire parent du fichier (par exemple, pour --send-file-paths /bucket/dir/file.txt, le répertoire parent est /bucket/dir/) pour stocker temporairement un fichier de messages AS2 traité, stocker le MDN lorsque nous les recevons du partenaire et écrire un fichier JSON final contenant les métadonnées pertinentes de la transmission. Ainsi, le AccessRole doit fournir un accès en lecture et en écriture au répertoire parent de l'emplacement du fichier utilisé dans la requête StartFileTransfer. En outre, vous devez fournir un accès en lecture et en écriture au répertoire parent des fichiers que vous souhaitez envoyer avec StartFileTransfer.

Si vous utilisez l'authentification de base pour votre connecteur AS2, le rôle d'accès nécessite l'secretsmanager:GetSecretValueautorisation d'accès au secret. Si le secret est chiffré à l'aide d'une clé gérée par le client au lieu de la clé AWS gérée dans Secrets Manager, le rôle doit également disposer d'une kms:Decrypt autorisation pour cette clé.

Pour connecteurs SFTP

Assurez-vous que le rôle d'accès fournit un accès en lecture et en écriture au répertoire parent de l'emplacement du fichier utilisé dans la StartFileTransfer demande. Assurez-vous également que le rôle fournit l'secretsmanager:GetSecretValueautorisation de AWS Secrets Manager.

Type : chaîne

Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.

Modèle : arn:.*role/\S+

Obligatoire : non

As2Config

Structure contenant les paramètres d'un objet du connecteur AS2.

Type : objet As2ConnectorConfig

Obligatoire : non

ConnectorId

Identifiant unique du connecteur.

Type : chaîne

Contraintes de longueur : longueur fixe de 19.

Modèle : c-([0-9a-f]{17})

Obligatoire : non

LoggingRole

Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (IAM) qui permet à un connecteur d'activer la CloudWatch journalisation des événements Amazon S3. Lorsque cette option est configurée, vous pouvez consulter l'activité du connecteur dans vos CloudWatch journaux.

Type : chaîne

Contraintes de longueur : longueur minimale de 20. Longueur maximale de 2048.

Modèle : arn:.*role/\S+

Obligatoire : non

SecurityPolicyName

Nom textuel de la politique de sécurité pour le connecteur spécifié.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 100.

Modèle : TransferSFTPConnectorSecurityPolicy-[A-Za-z0-9-]+

Obligatoire : non

ServiceManagedEgressIpAddresses

Liste des adresses IP de sortie de ce connecteur. Ces adresses IP sont attribuées automatiquement lorsque vous créez le connecteur.

Type : tableau de chaînes

Modèle : \d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}

Obligatoire : non

SftpConfig

Structure contenant les paramètres d'un objet de connecteur SFTP.

Type : objet SftpConnectorConfig

Obligatoire : non

Tags

Paires clé-valeur qui peuvent être utilisées pour regrouper et rechercher des connecteurs.

Type : tableau d’objets Tag

Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.

Obligatoire : non

Url

URL du point de terminaison AS2 ou SFTP du partenaire.

Type : chaîne

Contraintes de longueur : longueur minimum de 0. Longueur maximale de 255.

Obligatoire : non

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :