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 del partner da utilizzare per i trasferimenti AS2.
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 in formato JSON.
- As2Id
-
As2Idè il nome AS2, come definito nella RFC 4130. Per i trasferimenti in entrata, questa è l'intestazione AS2-Fromdei messaggi AS2 inviati dal partner. Per i connettori in uscita, questa è l'intestazioneAS2-Todei messaggi AS2 inviati al partner utilizzando l'operazione APIStartFileTransfer. 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 abilitato per AS2. -
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 profili AS2.
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'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- ProfileId
-
L'identificatore univoco per il profilo AS2, restituito dopo l'esito positivo della chiamata API.
▬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
Codice di stato HTTP: 500
- InvalidRequestException
-
Questa eccezione viene generata quando il client invia una richiesta non valida.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.
Codice di stato HTTP: 500
- ThrottlingException
-
La richiesta è stata negata a causa del throttling della richiesta.
Codice di stato HTTP: 400
Esempi
Esempio
L'esempio seguente crea un profilo e ne restituisce l'ID.
Gli ID dei certificati vengono creati durante l'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 chiamata API restituisce l'ID del profilo per il nuovo profilo.
{ "ProfileId": "p-11112222333344444" }
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
