S3 REST API i metoda POST

Tak, mylisz siÄ™ w mapowaniu CRUD do metod HTTP.

Pomimo popularnego użycia i powszechnego nieporozumienia, w tym wysoko ocenianych odpowiedzi tutaj na Stack Overflow, POST nie jest "poprawną metodą tworzenia zasobów". Semantyka innych metod jest określona przez protokół HTTP, ale semantyka POST jest określona przez sam docelowy typ nośnika. POST jest metodą używaną do każdej operacji, która nie jest standaryzowana przez HTTP, więc może być używana do tworzenia, ale może również być używane do aktualizacji lub czegokolwiek innego, czego nie zrobiono jeszcze inną metodą. Na przykład, źle jest używać POST do pobierania, ponieważ masz się do tego standaryzowane, ale dobrze jest używać POST do tworzenia zasobu, gdy klient nie może użyć PUT z jakiegoś powodu.

W ten sam sposób, PUT nie jest "poprawną metodą aktualizacji zasobu". PUT jest metodą używaną do całkowitego zastąpienia zasobu, ignorując jego aktualny stan. Możesz użyć PUT do tworzenia, jeśli masz cały reprezentacji, której oczekuje serwer, i możesz użyć PUT do aktualizacji, jeśli zapewnisz pełną reprezentację, w tym części, których nie zmienisz, ale nie jest poprawne używanie PUT do częściowych aktualizacji, ponieważ prosisz serwer o uwzględnienie bieżącego stanu zasobu. PATCH jest metodą, aby to zrobić.

W języku nieformalnym, co każda metoda mówi do serwera to:

• POST : Weź te dane i zastosuj je do zasobu zidentyfikowanego przez dany URI, zgodnie z zasadami, które udokumentowaÅ‚eÅ› dla typu noÅ›nika zasobów.

• UmieĹ "ciÄ ‡ : zastÄ ... piÄ ‡ to co jest identyfikowane przez dany URI tymi danymi, ignorujÄ ... c to co Juĺľ tam jest, jeĹ" li cokolwiek tam jest.

• PATCH: jeÅ›li zasób zidentyfikowany przez podany URI nadal ma ten sam stan, jaki miaÅ‚ przy ostatnim sprawdzaniu, Zastosuj do niego to rozróżnienie.

Zauważ, że create lub update nie jest wspomniane i nie jest częścią semantyki tych metody. Możesz tworzyć za pomocą POST I PUT, ale nie PATCH, ponieważ zależy to od aktualnego stanu. Możesz aktualizować dowolną z nich, ale z patchem masz aktualizację warunkową do stanu, z którego chcesz aktualizować, z PUT możesz aktualizować zastępując cały obiekt, więc jest to operacja idempotentna, a z postem prosisz serwer, aby zrobił to zgodnie z predefiniowanymi regułami.

Przy okazji, Nie wiem, czy sensowne jest mówienie, że API jest LUB NIE JEST zgodne z REST, ponieważ REST jest Architektura styl , nie spec czy standard, ale nawet biorąc pod uwagę, że bardzo niewiele API, które twierdzą, że są odpoczynkiem, jest naprawdę spokojnych, w większości przypadków, ponieważ nie są hipertekstem napędzanym {34]}. AWS S3 zdecydowanie nie jest RESTful, chociaż gdzie to nosi na twoje pytanie, ich użycie metod HTTP jest zgodne ze standardem HTTP przez większość czasu.