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.
UpdateConnector
Met à jour certains paramètres d'un connecteur existant. Indiquez le ConnectorId
connecteur que vous souhaitez mettre à jour, ainsi que les nouvelles valeurs des paramètres à mettre à jour.
Syntaxe de la requête
{
"AccessRole": "string
",
"As2Config": {
"BasicAuthSecretId": "string
",
"Compression": "string
",
"EncryptionAlgorithm": "string
",
"LocalProfileId": "string
",
"MdnResponse": "string
",
"MdnSigningAlgorithm": "string
",
"MessageSubject": "string
",
"PartnerProfileId": "string
",
"SigningAlgorithm": "string
"
},
"ConnectorId": "string
",
"LoggingRole": "string
",
"SecurityPolicyName": "string
",
"SftpConfig": {
"TrustedHostKeys": [ "string
" ],
"UserSecretId": "string
"
},
"Url": "string
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- 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, leAccessRole
doit fournir un accès en lecture et en écriture au répertoire parent de l'emplacement du fichier utilisé dans la requêteStartFileTransfer
. En outre, vous devez fournir un accès en lecture et en écriture au répertoire parent des fichiers que vous souhaitez envoyer avecStartFileTransfer
.Si vous utilisez l'authentification de base pour votre connecteur AS2, le rôle d'accès nécessite l'
secretsmanager:GetSecretValue
autorisation 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'unekms: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:GetSecretValue
autorisation 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 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 : oui
- LoggingRole
-
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
-
Spécifie le nom de la politique de sécurité pour le connecteur.
Type : chaîne
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 100.
Modèle :
TransferSFTPConnectorSecurityPolicy-[A-Za-z0-9-]+
Obligatoire : non
- SftpConfig
-
Structure contenant les paramètres d'un objet de connecteur SFTP.
Type : objet SftpConnectorConfig
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
Syntaxe de la réponse
{
"ConnectorId": "string"
}
Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- ConnectorId
-
Renvoie l'identifiant de l'objet connecteur que vous mettez à jour.
Type : chaîne
Contraintes de longueur : longueur fixe de 19.
Modèle :
c-([0-9a-f]{17})
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- InternalServiceError
-
Cette exception est levée lorsqu'une erreur se produit dans le AWS Transfer Family service.
Code d’état HTTP : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
Code d’état HTTP : 400
- ResourceExistsException
-
La ressource demandée n'existe pas ou existe dans une région autre que celle spécifiée pour la commande.
Code d’état HTTP : 400
- ResourceNotFoundException
-
Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.
Code d’état HTTP : 400
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
Code d’état HTTP : 500
- ThrottlingException
-
La demande a été refusée suite à une limitation des demandes.
Code d’état HTTP : 400
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 :