Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateProfile
Crea el perfil local o de socio que se utilizará en las AS2 transferencias.
Sintaxis de la solicitud
{
"As2Id": "string
",
"CertificateIds": [ "string
" ],
"ProfileType": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en JSON formato.
- As2Id
-
As2Id
Es el AS2nombre, tal como se define en el RFC4130. En el caso de las transferencias entrantes, este es el AS2-From
encabezado de los AS2 mensajes enviados por el socio. En el caso de los conectores salientes, este es elAS2-To
encabezado de los AS2 mensajes que se envían al socio mediante laStartFileTransfer
API operación. Este ID no puede incluir espacios.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
[\p{Print}\s]*
Obligatorio: sí
- CertificateIds
-
Una matriz de identificadores de los certificados importados. Este identificador se utiliza para trabajar con perfiles y perfiles de socios.
Tipo: matriz de cadenas
Limitaciones de longitud: longitud fija de 22.
Patrón:
cert-([0-9a-f]{17})
Obligatorio: no
- ProfileType
-
Determina el tipo de perfil que se va a crear:
-
Especifique
LOCAL
para crear un perfil local. Un perfil local representa la organización o parte del servidor Transfer Family AS2 habilitado. -
Especifique
PARTNER
para crear un perfil de socio. Un perfil de socio representa una organización remota, externa a Transfer Family.
Tipo: cadena
Valores válidos:
LOCAL | PARTNER
Obligatorio: sí
-
- Tags
-
Pares clave-valor que se pueden usar para agrupar y buscar perfiles. AS2
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 50 artículos.
Obligatorio: no
Sintaxis de la respuesta
{
"ProfileId": "string"
}
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
- ProfileId
-
El identificador único del AS2 perfil, que se devuelve después de que la API llamada se realice correctamente.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
p-([0-9a-f]{17})
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServiceError
-
Esta excepción se produce cuando se produce un error en el AWS Transfer Family servicio.
HTTPCódigo de estado: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
HTTPCódigo de estado: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
HTTPCódigo de estado: 500
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
HTTPCódigo de estado: 400
Ejemplos
Ejemplo
En el siguiente ejemplo, se crea un perfil y se devuelve el identificador del perfil.
Los certificados IDs se crean cuando se ejecutaimport-certificate
, uno para el certificado de firma y otro para el certificado de cifrado.
aws transfer create-profile --as2-id MYCORP --certificate-ids c-abcdefg123456hijk c-987654aaaa321bbbb
Respuesta de ejemplo
La API llamada devuelve el ID de perfil del nuevo perfil.
{ "ProfileId": "p-11112222333344444" }
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: