Inspect a plugin Run in API Explorer

GET /plugins/{name}/json

Path parameters

  • name string Required

    The name of the plugin. The :latest tag is optional, and is the default if omitted.

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]
  • 404 application/json

    plugin is not installed

    Hide response attribute Show response attribute object
    • message string Required

      The error message.

  • 500 application/json

    server error

    Hide response attribute Show response attribute object
    • message string Required

      The error message.

GET /plugins/{name}/json
curl \
 --request GET 'http://api.example.com/v1.49/plugins/{name}/json'
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 (404)
{
  "message": "Something went wrong."
}
Response examples (404)
{
  "message": "Something went wrong."
}
Response examples (500)
{
  "message": "Something went wrong."
}
Response examples (500)
{
  "message": "Something went wrong."
}