Name

gun:put - Create or replace a resource

Description

put(ConnPid, Path, Headers)
    -> put(ConnPid, Path, Headers, #{})

put(ConnPid, Path, Headers, ReqOpts)
    -> StreamRef

put(ConnPid, Path, Headers, Body)
    -> put(ConnPid, Path, Headers, Body, #{})

put(ConnPid, Path, Headers, Body, ReqOpts)
    -> StreamRef

ConnPid   :: pid()
Path      :: iodata()
Headers   :: gun:req_headers()
Body      :: iodata()
ReqOpts   :: gun:req_opts()
StreamRef :: gun:stream_ref()

Create or replace a resource.

The behavior of this function varies depending on whether a body is provided.

The function put/3,4 does not send a body. It must be sent separately using gun:data(3).

The function put/4,5 sends the entire request, including the request body, immediately. It is therefore not possible to use gun:data(3) after that. You should provide a content-type header. Gun will set the content-length header automatically.

Arguments

ConnPid: The pid of the Gun connection process.
Path: Path to the resource.
Headers: Additional request headers.
Body: Request body.
ReqOpts: Request options.

Return value

A reference that identifies the newly created stream is returned. It is this reference that must be passed in subsequent calls and will be received in messages related to this new stream.

Changelog

2.0: Implicit body detection has been removed. The body must now be provided either directly (even if empty) or using separate calls.
1.0: Function introduced.

Examples

Put a resource

StreamRef = gun:put(ConnPid, "/lang/fr_FR/hello",
    [{<<"content-type">>, <<"text/plain">>}],
    <<"Bonjour !">>).

Put a resource in multiple calls

StreamRef = gun:put(ConnPid, "/lang/fr_FR/hello", [
    {<<"content-type">>, <<"text/plain">>}
]).
gun:data(ConnPid, StreamRef, fin, <<"Bonjour !">>).

Put a resource with request options

StreamRef = gun:put(ConnPid, "/lang/fr_FR/hello",
    [{<<"content-type">>, <<"text/plain">>}],
    <<"Bonjour !">>,
    #{reply_to => ReplyToPid}).