Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateProfile
Crea il profilo locale o partner da utilizzare per AS2 i trasferimenti.
Sintassi della richiesta
{
"As2Id": "string",
"CertificateIds": [ "string" ],
"ProfileType": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel JSON formato.
- As2Id
-
Il
As2Idè il AS2-name, come definito nel RFC4130. Per i trasferimenti in entrata, questa è l' AS2-Fromintestazione per i AS2 messaggi inviati dal partner. Per i connettori in uscita, questa è l'AS2-Tointestazione dei AS2 messaggi inviati al partner tramite l'operazione.StartFileTransferAPI Questo ID non può includere spazi.Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[\p{Print}\s]*Campo obbligatorio: sì
- CertificateIds
-
Una serie di identificativi dei certificati importati. Utilizzi questo identificativo per lavorare con i profili e i profili dei partner.
Tipo: matrice di stringhe
Vincoli di lunghezza: lunghezza fissa di 22.
Modello:
cert-([0-9a-f]{17})Campo obbligatorio: no
- ProfileType
-
Determina il tipo di profilo da creare:
-
LOCALSpecificare di creare un profilo locale. Un profilo locale rappresenta l'organizzazione o la parte del server Transfer Family AS2 abilitata. -
PARTNERSpecificare di creare un profilo partner. Un profilo partner rappresenta un'organizzazione remota, esterna a Transfer Family.
Tipo: stringa
Valori validi:
LOCAL | PARTNERCampo obbligatorio: sì
-
- Tags
-
Coppie chiave-valore che possono essere utilizzate per raggruppare e cercare AS2 profili.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 50 item.
Campo obbligatorio: no
Sintassi della risposta
{
"ProfileId": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- ProfileId
-
L'identificatore univoco del AS2 profilo, restituito dopo l'esito positivo della API chiamata.
Tipo: stringa
Vincoli di lunghezza: lunghezza fissa di 19.
Modello:
p-([0-9a-f]{17})
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- InternalServiceError
-
Questa eccezione viene generata quando si verifica un errore nel servizio. AWS Transfer Family
HTTPCodice di stato: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
HTTPCodice di stato: 500
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
HTTPCodice di stato: 400
Esempi
Esempio
L'esempio seguente crea un profilo e ne restituisce l'ID.
I certificati IDs vengono creati all'esecuzioneimport-certificate, uno per il certificato di firma e uno per il certificato di crittografia.
aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk c-987654aaaa321bbbb
Risposta di esempio
La API chiamata restituisce l'ID del profilo per il nuovo profilo.
{ "ProfileId": "p-11112222333344444" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questo API codice in una delle lingue specifiche AWS SDKs, consulta quanto segue:
