List plugins Run in API Explorer

GET /plugins

Returns information about installed plugins.

Query parameters

  • filters string

    A JSON encoded value of the filters (a map[string][]string) to process on the plugin list.

    Available filters:

    • capability=<capability name>
    • enable=<true>|<false>

Responses

  • 200 application/json

    No error

    Hide response attributes Show response attributes object
    • Id string
    • Name string Required
    • Enabled boolean Required

      True if the plugin is running. False if the plugin is not running, only installed.

    • Settings object Required

      Settings that can be modified by users.

      Hide Settings attributes Show Settings attributes object
      • Mounts array[object] Required
        Hide Mounts attributes Show Mounts attributes object
        • Name string Required
        • Description string Required
        • Settable array[string] Required
        • Source string Required
        • Destination string Required
        • Type string Required
        • Options array[string] Required
      • Env array[string] Required
      • Args array[string] Required
      • Devices array[object] Required
        Hide Devices attributes Show Devices attributes object
        • Name string Required
        • Description string Required
        • Settable array[string] Required
        • Path string Required
    • PluginReference string

      plugin remote reference used to push/pull the plugin

    • Config object Required

      The config of a plugin.

      Hide Config attributes Show Config attributes object
      • DockerVersion string

        Docker Version used to create the plugin

      • Description string Required
      • Documentation string Required
      • Interface object Required

        The interface between Docker and the plugin

        Hide Interface attributes Show Interface attributes object
        • Types array[object] Required
          Hide Types attributes Show Types attributes object
          • Prefix string Required
          • Capability string Required
          • Version string Required
        • Socket string Required
        • ProtocolScheme string

          Protocol to use for clients connecting to the plugin.

          Values are or moby.plugins.http/v1.

      • Entrypoint array[string] Required
      • WorkDir string Required
      • User object
        Hide User attributes Show User attributes object
        • UID integer(uint32)
        • GID integer(uint32)
      • Network object Required
        Hide Network attribute Show Network attribute object
        • Type string Required
      • Linux object Required
        Hide Linux attributes Show Linux attributes object
        • Capabilities array[string] Required
        • AllowAllDevices boolean Required
        • Devices array[object] Required
          Hide Devices attributes Show Devices attributes object
          • Name string Required
          • Description string Required
          • Settable array[string] Required
          • Path string Required
      • PropagatedMount string Required
      • IpcHost boolean Required
      • PidHost boolean Required
      • Mounts array[object] Required
        Hide Mounts attributes Show Mounts attributes object
        • Name string Required
        • Description string Required
        • Settable array[string] Required
        • Source string Required
        • Destination string Required
        • Type string Required
        • Options array[string] Required
      • Env array[object] Required
        Hide Env attributes Show Env attributes object
        • Name string Required
        • Description string Required
        • Settable array[string] Required
        • Value string Required
      • Args object Required
        Hide Args attributes Show Args attributes object
        • Name string Required
        • Description string Required
        • Settable array[string] Required
        • Value array[string] Required
      • rootfs object
        Hide rootfs attributes Show rootfs attributes object
        • type string
        • diff_ids array[string]
  • 500 application/json

    Server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.

GET /plugins
curl \
 --request GET 'http://api.example.com/v1.44/plugins'
Response examples (200)
[
  {
    "Id": "5724e2c8652da337ab2eedd19fc6fc0ec908e4bd907c7421bf6a8dfc70c4c078",
    "Name": "tiborvass/sample-volume-plugin",
    "Enabled": true,
    "Settings": {
      "Mounts": [
        {
          "Name": "some-mount",
          "Description": "This is a mount that's used by the plugin.",
          "Settable": [
            "string"
          ],
          "Source": "/var/lib/docker/plugins/",
          "Destination": "/mnt/state",
          "Type": "bind",
          "Options": [
            "rbind",
            "rw"
          ]
        }
      ],
      "Env": [
        "DEBUG=0"
      ],
      "Args": [
        "string"
      ],
      "Devices": [
        {
          "Name": "string",
          "Description": "string",
          "Settable": [
            "string"
          ],
          "Path": "/dev/fuse"
        }
      ]
    },
    "PluginReference": "localhost:5000/tiborvass/sample-volume-plugin:latest",
    "Config": {
      "DockerVersion": "17.06.0-ce",
      "Description": "A sample volume plugin for Docker",
      "Documentation": "https://docs.docker.com/engine/extend/plugins/",
      "Interface": {
        "Types": [
          "docker.volumedriver/1.0"
        ],
        "Socket": "plugins.sock",
        "ProtocolScheme": "some.protocol/v1.0"
      },
      "Entrypoint": [
        "/usr/bin/sample-volume-plugin",
        "/data"
      ],
      "WorkDir": "/bin/",
      "User": {
        "UID": 1000,
        "GID": 1000
      },
      "Network": {
        "Type": "host"
      },
      "Linux": {
        "Capabilities": [
          "CAP_SYS_ADMIN",
          "CAP_SYSLOG"
        ],
        "AllowAllDevices": false,
        "Devices": [
          {
            "Name": "string",
            "Description": "string",
            "Settable": [
              "string"
            ],
            "Path": "/dev/fuse"
          }
        ]
      },
      "PropagatedMount": "/mnt/volumes",
      "IpcHost": false,
      "PidHost": false,
      "Mounts": [
        {
          "Name": "some-mount",
          "Description": "This is a mount that's used by the plugin.",
          "Settable": [
            "string"
          ],
          "Source": "/var/lib/docker/plugins/",
          "Destination": "/mnt/state",
          "Type": "bind",
          "Options": [
            "rbind",
            "rw"
          ]
        }
      ],
      "Env": [
        {
          "Name": "DEBUG",
          "Value": "0",
          "Settable": null,
          "Description": "If set, prints debug messages"
        }
      ],
      "Args": {
        "Name": "args",
        "Description": "command line arguments",
        "Settable": [
          "string"
        ],
        "Value": [
          "string"
        ]
      },
      "rootfs": {
        "type": "layers",
        "diff_ids": [
          "sha256:675532206fbf3030b8458f88d6e26d4eb1577688a25efec97154c94e8b6b4887",
          "sha256:e216a057b1cb1efc11f8a268f37ef62083e70b1b38323ba252e25ac88904a7e8"
        ]
      }
    }
  }
]
Response examples (500)
{
  "message": "Something went wrong."
}
Response examples (500)
{
  "message": "Something went wrong."
}