Importare un modello Smithy

Smithy è il linguaggio di modellazione di API di AWS. Restorm ne importa entrambe le rappresentazioni.

Importare

File ▸ Importa (Ctrl+I) e poi:

• un file .smithy (il linguaggio di modellazione);
• oppure l’AST JSON prodotto da smithy build.

Entrambi convergono verso lo stesso modello interno.

Che cosa viene importato

Elemento	Ciò che Restorm ne fa
Ogni service / resource	Una cartella
Ogni operazione che porta @http	Una richiesta HTTP
@httpLabel	Un parametro di percorso
@httpQuery	Un parametro di query
@httpHeader	Un header
Documentazione e tipi	La documentazione di API e le enumerazioni

Limiti (versione 1 dell’importazione)

• Un’operazione senza trait @http è soltanto documentale: compare nella documentazione di API ma non produce una richiesta.
• L’autenticazione SigV4 non è precablata: va configurata a mano.
• I binding di protocollo non REST (awsJson1_1, awsQuery…) non sono modellati.
• Elenchi, dizionari e union non sono forme di primo piano.
• I trait di validazione (@pattern, @length, @paginated, @readonly…) vengono ignorati in silenzio.
• I test di protocollo Smithy vengono ignorati.

Aggiornare

Smithy fa parte dei formati risincronizzabili. Si veda Aggiornare dalla sorgente.