Smithy-mallin tuonti
Smithy on AWS:n API-mallinnuskieli. Restorm tuo siitä molemmat esitysmuodot.
Tuonti
Section titled “Tuonti”Tiedosto ▸ Tuo (Ctrl+I) ja sitten:
.smithy-tiedosto (mallinnuskieli);- tai JSON AST, jonka
smithy buildtuottaa.
Molemmat päätyvät samaan sisäiseen malliin.
Mitä tuodaan
Section titled “Mitä tuodaan”| Elementti | Mitä Restorm tekee siitä |
|---|---|
Jokainen service / resource | Kansio |
Jokainen operaatio, jolla on @http | HTTP-pyyntö |
@httpLabel | Polkuparametri |
@httpQuery | Kyselyparametri |
@httpHeader | Otsake |
| Dokumentaatio ja tyypit | API-dokumentaatio ja luettelotyypit |
Rajoitukset (tuonnin versio 1)
Section titled “Rajoitukset (tuonnin versio 1)”- Operaatio ilman
@http-piirrettä on vain dokumentaatiota: se näkyy API-dokumentaatiossa mutta ei tuota pyyntöä. - SigV4-todennusta ei kytketä valmiiksi: määritä se käsin.
- Muita kuin REST-protokollasidontoja (
awsJson1_1,awsQuery…) ei mallinneta. - Luettelot, sanakirjat ja unionit eivät ole ensiluokkaisia muotoja.
- Validointipiirteet (
@pattern,@length,@paginated,@readonly…) ohitetaan hiljaisesti. - Smithyn protokollatestit ohitetaan.
Päivittäminen
Section titled “Päivittäminen”Smithy kuuluu uudelleen synkronoitaviin muotoihin. Katso Päivitys lähteestä.