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.
CreateProfile
Crée le profil local ou partenaire à utiliser pour les AS2 transferts.
Syntaxe de la requête
{
"As2Id": "string",
"CertificateIds": [ "string" ],
"ProfileType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
La demande accepte les données suivantes au JSON format suivant.
- As2Id
-
As2IdIl s'agit du AS2-name, tel que défini dans le RFC4130. Pour les transferts entrants, il s'agit de l' AS2-Fromen-tête des AS2 messages envoyés par le partenaire. Pour les connecteurs sortants, il s'agit de l'AS2-Toen-tête des AS2 messages envoyés au partenaire à l'aide de l'StartFileTransferAPIopération. Cet identifiant ne peut pas inclure d'espaces.Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 128.
Modèle :
[\p{Print}\s]*Obligatoire : oui
- CertificateIds
-
Un tableau d'identifiants pour les certificats importés. Vous utilisez cet identifiant pour travailler avec des profils et des profils de partenaires.
Type : tableau de chaînes
Contraintes de longueur : longueur fixe de 22.
Modèle :
cert-([0-9a-f]{17})Obligatoire : non
- ProfileType
-
Détermine le type de profil à créer :
-
Spécifiez
LOCALpour créer un profil local. Un profil local représente l'organisation ou le groupe de serveurs Transfer Family AS2 activé. -
Spécifiez
PARTNERpour créer un profil de partenaire. Un profil de partenaire représente une organisation distante, externe à Transfer Family.
Type : String
Valeurs valides :
LOCAL | PARTNERObligatoire : oui
-
- Tags
-
Paires clé-valeur qui peuvent être utilisées pour regrouper et rechercher AS2 des profils.
Type : tableau d’objets Tag
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.
Obligatoire : non
Syntaxe de la réponse
{
"ProfileId": "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 sous JSON forme formatée par le service.
- ProfileId
-
Identifiant unique du AS2 profil, renvoyé une fois l'APIappel réussi.
Type : String
Contraintes de longueur : longueur fixe de 19.
Modèle :
p-([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.
HTTPCode de statut : 500
- InvalidRequestException
-
Cette exception est levée lorsque le client soumet une demande mal formée.
HTTPCode de statut : 400
- ResourceNotFoundException
-
Cette exception est levée lorsqu'aucune ressource n'est trouvée par le service AWS Transfer Family.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué car le service AWS Transfer Family n'est pas disponible.
HTTPCode de statut : 500
- ThrottlingException
-
La demande a été refusée suite à une limitation des demandes.
HTTPCode de statut : 400
Exemples
Exemple
L'exemple suivant crée un profil et renvoie son ID.
Les certificats IDs sont créés lors de l'exécutionimport-certificate, un pour le certificat de signature et un pour le certificat de chiffrement.
aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk c-987654aaaa321bbbb
Exemple de réponse
L'APIappel renvoie l'ID de profil du nouveau profil.
{ "ProfileId": "p-11112222333344444" }
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
