| package client // import "github.com/docker/docker/client" |
| |
| import ( |
| "context" |
| "net/url" |
| "time" |
| |
| timetypes "github.com/docker/docker/api/types/time" |
| ) |
| |
| // ContainerStop stops a container. In case the container fails to stop |
| // gracefully within a time frame specified by the timeout argument, |
| // it is forcefully terminated (killed). |
| // |
| // If the timeout is nil, the container's StopTimeout value is used, if set, |
| // otherwise the engine default. A negative timeout value can be specified, |
| // meaning no timeout, i.e. no forceful termination is performed. |
| func (cli *Client) ContainerStop(ctx context.Context, containerID string, timeout *time.Duration) error { |
| query := url.Values{} |
| if timeout != nil { |
| query.Set("t", timetypes.DurationToSecondsString(*timeout)) |
| } |
| resp, err := cli.post(ctx, "/containers/"+containerID+"/stop", query, nil, nil) |
| ensureReaderClosed(resp) |
| return err |
| } |