Generate 1.27 version

Author: joelwurtz

docker-swagger.yaml

@@ -19,10 +19,10 @@ produces:
 consumes:
   - "application/json"
   - "text/plain"
-basePath: "/v1.26"
+basePath: "/v1.27"
 info:
   title: "Docker Engine API"
-  version: "1.26"
+  version: "1.27"
   x-logo:
     url: "https://docs.docker.com/images/logo-docker-main.png"
   description: |
@@ -44,18 +44,19 @@ info:
 
     The API is usually changed in each release of Docker, so API calls are versioned to ensure that clients don't break.
 
-    For Docker Engine >= 1.13.1, the API version is 1.26. To lock to this version, you prefix the URL with `/v1.26`. For example, calling `/info` is the same as calling `/v1.26/info`.
+    For Docker Engine >= 17.03.1, the API version is 1.27. To lock to this version, you prefix the URL with `/v1.27`. For example, calling `/info` is the same as calling `/v1.27/info`.
 
     Engine releases in the near future should support this version of the API, so your client will continue to work even if it is talking to a newer Engine.
 
     In previous versions of Docker, it was possible to access the API without providing a version. This behaviour is now deprecated will be removed in a future version of Docker.
 
     The API uses an open schema model, which means server may add extra properties to responses. Likewise, the server will ignore any extra query parameters and request body properties. When you write clients, you need to ignore additional properties in responses to ensure they do not break when talking to newer Docker daemons.
 
-    This documentation is for version 1.26 of the API, which was introduced with Docker 1.13.1. Use this table to find documentation for previous versions of the API:
+    This documentation is for version 1.27 of the API, which was introduced with Docker 17.03.1. Use this table to find documentation for previous versions of the API:
 
     Docker version  | API version | Changes
     ----------------|-------------|---------
+    1.13.1 & 17.03.0 | [1.26](https://docs.docker.com/engine/api/v1.26/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-26-api-changes)
     1.13.0 | [1.25](https://docs.docker.com/engine/api/v1.25/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-25-api-changes)
     1.12.x | [1.24](https://docs.docker.com/engine/api/v1.24/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-24-api-changes)
     1.11.x | [1.23](https://docs.docker.com/engine/api/v1.23/) | [API changes](https://docs.docker.com/engine/api/version-history/#v1-23-api-changes)
@@ -117,8 +118,6 @@ tags:
       Run new commands inside running containers. See the [command-line reference](https://docs.docker.com/engine/reference/commandline/exec/) for more information.
 
       To exec a command in a container, you first need to create an exec instance, then start it. These two API endpoints are wrapped up in a single command-line command, `docker exec`.
-  - name: "Secret"
-    x-displayName: "Secrets"
   # Swarm things
   - name: "Swarm"
     x-displayName: "Swarm"
@@ -136,6 +135,10 @@ tags:
     x-displayName: "Tasks"
     description: |
       A task is a container running on a swarm. It is the atomic scheduling unit of swarm. Swarm mode must be enabled for these endpoints to work.
+  - name: "Secret"
+    x-displayName: "Secrets"
+    description: |
+      Secrets are sensitive data that can be used by services. Swarm mode must be enabled for these endpoints to work.
   # System things
   - name: "Plugin"
     x-displayName: "Plugins"
@@ -3377,7 +3380,13 @@ paths:
       description: |
         This endpoint returns a live stream of a container’s resource usage statistics.
 
-        The `precpu_stats` is the CPU statistic of last read, which is used for calculating the CPU usage percentage. It is not the same as the `cpu_stats` field.
+        The `precpu_stats` is the CPU statistic of last read, which is used
+        for calculating the CPU usage percentage. It is not the same as the
+        `cpu_stats` field.
+
+        If either `precpu_stats.online_cpus` or `cpu_stats.online_cpus` is
+        nil then for compatibility with older daemons the length of the
+        corresponding `cpu_usage.percpu_usage` array should be used.
       operationId: "ContainerStats"
       produces:
         - "application/json"
@@ -3457,6 +3466,7 @@ paths:
                   total_usage: 100215355
                   usage_in_kernelmode: 30000000
                 system_cpu_usage: 739306590000000
+                online_cpus: 4
                 throttling_data:
                   periods: 0
                   throttled_periods: 0
@@ -3472,6 +3482,7 @@ paths:
                   total_usage: 100093996
                   usage_in_kernelmode: 30000000
                 system_cpu_usage: 9492140000000
+                online_cpus: 4
                 throttling_data:
                   periods: 0
                   throttled_periods: 0
@@ -6499,7 +6510,7 @@ paths:
           schema:
             $ref: "#/definitions/ErrorResponse"
       parameters:
-        - name: "name"
+        - name: "remote"
           in: "query"
           description: "The name of the plugin. The `:latest` tag is optional, and is the default if omitted."
           required: true
@@ -6830,14 +6841,6 @@ paths:
             type: "array"
             items:
               $ref: "#/definitions/Node"
-        400:
-          description: "bad parameter"
-          schema:
-            $ref: "#/definitions/ErrorResponse"
-        404:
-          description: "no such node"
-          schema:
-            $ref: "#/definitions/ErrorResponse"
         500:
           description: "server error"
           schema:
@@ -7930,6 +7933,10 @@ paths:
           description: "server error"
           schema:
             $ref: "#/definitions/ErrorResponse"
+        503:
+          description: "node is not part of a swarm"
+          schema:
+            $ref: "#/definitions/ErrorResponse"
       parameters:
         - name: "id"
           in: "path"

src/Client.php

@@ -30,7 +30,7 @@ public static function create($httpClient = null)
         if (null === $httpClient) {
             $httpClient = \Http\Discovery\HttpClientDiscovery::find();
             $plugins = [];
-            $uri = \Http\Discovery\UriFactoryDiscovery::find()->createUri('v1.26');
+            $uri = \Http\Discovery\UriFactoryDiscovery::find()->createUri('v1.27');
             $plugins[] = new \Http\Client\Common\Plugin\AddPathPlugin($uri);
             $httpClient = new \Http\Client\Common\PluginClient($httpClient, $plugins);
         }

src/Exception/SecretUpdateServiceUnavailableException.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file has been auto generated by Jane,
+ *
+ * Do no edit it directly.
+ */
+
+namespace Docker\API\Exception;
+
+class SecretUpdateServiceUnavailableException extends \RuntimeException implements ServerException
+{
+    private $errorResponse;
+
+    public function __construct(\Docker\API\Model\ErrorResponse $errorResponse)
+    {
+        parent::__construct('node is not part of a swarm', 503);
+        $this->errorResponse = $errorResponse;
+    }
+
+    public function getErrorResponse()
+    {
+        return $this->errorResponse;
+    }
+}

src/Resource/ContainerAsyncResourceTrait.php

@@ -369,7 +369,13 @@ public function containerExport(string $id, array $parameters = [], string $fetc
     /**
      * This endpoint returns a live stream of a container’s resource usage statistics.
 
-    The `precpu_stats` is the CPU statistic of last read, which is used for calculating the CPU usage percentage. It is not the same as the `cpu_stats` field.
+    The `precpu_stats` is the CPU statistic of last read, which is used
+    for calculating the CPU usage percentage. It is not the same as the
+    `cpu_stats` field.
+
+    If either `precpu_stats.online_cpus` or `cpu_stats.online_cpus` is
+    nil then for compatibility with older daemons the length of the
+    corresponding `cpu_usage.percpu_usage` array should be used.
 
      *
      * @param string $id         ID or name of the container

src/Resource/ContainerResourceTrait.php

@@ -334,7 +334,13 @@ public function containerExport(string $id, array $parameters = [], string $fetc
     /**
      * This endpoint returns a live stream of a container’s resource usage statistics.
 
-    The `precpu_stats` is the CPU statistic of last read, which is used for calculating the CPU usage percentage. It is not the same as the `cpu_stats` field.
+    The `precpu_stats` is the CPU statistic of last read, which is used
+    for calculating the CPU usage percentage. It is not the same as the
+    `cpu_stats` field.
+
+    If either `precpu_stats.online_cpus` or `cpu_stats.online_cpus` is
+    nil then for compatibility with older daemons the length of the
+    corresponding `cpu_usage.percpu_usage` array should be used.
 
      *
      * @param string $id         ID or name of the container

src/Resource/NodeAsyncResourceTrait.php

@@ -23,8 +23,6 @@ trait NodeAsyncResourceTrait
      * @param string                 $fetch             Fetch mode (object or response)
      * @param \Amp\CancellationToken $cancellationToken Token to cancel the request
      *
-     * @throws \Docker\API\Exception\NodeListBadRequestException
-     * @throws \Docker\API\Exception\NodeListNotFoundException
      * @throws \Docker\API\Exception\NodeListInternalServerErrorException
      * @throws \Docker\API\Exception\NodeListServiceUnavailableException
      *
@@ -47,12 +45,6 @@ public function nodeList(array $parameters = [], string $fetch = self::FETCH_OBJ
                 if (200 === $response->getStatus()) {
                     return $this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\Node[]', 'json');
                 }
-                if (400 === $response->getStatus()) {
-                    throw new \Docker\API\Exception\NodeListBadRequestException($this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\ErrorResponse', 'json'));
-                }
-                if (404 === $response->getStatus()) {
-                    throw new \Docker\API\Exception\NodeListNotFoundException($this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\ErrorResponse', 'json'));
-                }
                 if (500 === $response->getStatus()) {
                     throw new \Docker\API\Exception\NodeListInternalServerErrorException($this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\ErrorResponse', 'json'));
                 }

src/Resource/NodeResourceTrait.php

@@ -22,8 +22,6 @@ trait NodeResourceTrait
      * }
      * @param string $fetch Fetch mode (object or response)
      *
-     * @throws \Docker\API\Exception\NodeListBadRequestException
-     * @throws \Docker\API\Exception\NodeListNotFoundException
      * @throws \Docker\API\Exception\NodeListInternalServerErrorException
      * @throws \Docker\API\Exception\NodeListServiceUnavailableException
      *
@@ -43,12 +41,6 @@ public function nodeList(array $parameters = [], string $fetch = self::FETCH_OBJ
             if (200 === $response->getStatusCode()) {
                 return $this->serializer->deserialize((string) $response->getBody(), 'Docker\\API\\Model\\Node[]', 'json');
             }
-            if (400 === $response->getStatusCode()) {
-                throw new \Docker\API\Exception\NodeListBadRequestException($this->serializer->deserialize((string) $response->getBody(), 'Docker\\API\\Model\\ErrorResponse', 'json'));
-            }
-            if (404 === $response->getStatusCode()) {
-                throw new \Docker\API\Exception\NodeListNotFoundException($this->serializer->deserialize((string) $response->getBody(), 'Docker\\API\\Model\\ErrorResponse', 'json'));
-            }
             if (500 === $response->getStatusCode()) {
                 throw new \Docker\API\Exception\NodeListInternalServerErrorException($this->serializer->deserialize((string) $response->getBody(), 'Docker\\API\\Model\\ErrorResponse', 'json'));
             }

src/Resource/PluginAsyncResourceTrait.php

@@ -53,7 +53,7 @@ public function pluginList(array $parameters = [], string $fetch = self::FETCH_O
     /**
      * @param array $parameters {
      *
-     *     @var string $name The name of the plugin. The `:latest` tag is optional, and is the default if omitted.
+     *     @var string $remote The name of the plugin. The `:latest` tag is optional, and is the default if omitted.
      * }
      *
      * @param string                 $fetch             Fetch mode (object or response)
@@ -67,7 +67,7 @@ public function getPluginPrivileges(array $parameters = [], string $fetch = self
     {
         return \Amp\call(function () use ($parameters, $fetch, $cancellationToken) {
             $queryParam = new QueryParam();
-            $queryParam->addQueryParameter('name', true, ['string']);
+            $queryParam->addQueryParameter('remote', true, ['string']);
             $url = '/plugins/privileges';
             $url = $url . ('?' . $queryParam->buildQueryString($parameters));
             $headers = array_merge(['Accept' => ['application/json']], $queryParam->buildHeaders($parameters));

src/Resource/PluginResourceTrait.php

@@ -48,7 +48,7 @@ public function pluginList(array $parameters = [], string $fetch = self::FETCH_O
     /**
      * @param array $parameters {
      *
-     *     @var string $name The name of the plugin. The `:latest` tag is optional, and is the default if omitted.
+     *     @var string $remote The name of the plugin. The `:latest` tag is optional, and is the default if omitted.
      * }
      *
      * @param string $fetch Fetch mode (object or response)
@@ -60,7 +60,7 @@ public function pluginList(array $parameters = [], string $fetch = self::FETCH_O
     public function getPluginPrivileges(array $parameters = [], string $fetch = self::FETCH_OBJECT)
     {
         $queryParam = new QueryParam($this->streamFactory);
-        $queryParam->addQueryParameter('name', true, ['string']);
+        $queryParam->addQueryParameter('remote', true, ['string']);
         $url = '/plugins/privileges';
         $url = $url . ('?' . $queryParam->buildQueryString($parameters));
         $headers = array_merge(['Accept' => ['application/json']], $queryParam->buildHeaders($parameters));

src/Resource/SecretAsyncResourceTrait.php

@@ -204,6 +204,7 @@ public function secretInspect(string $id, array $parameters = [], string $fetch
      *
      * @throws \Docker\API\Exception\SecretUpdateNotFoundException
      * @throws \Docker\API\Exception\SecretUpdateInternalServerErrorException
+     * @throws \Docker\API\Exception\SecretUpdateServiceUnavailableException
      *
      * @return \Amp\Promise<\Amp\Artax\Response|null>
      */
@@ -231,6 +232,9 @@ public function secretUpdate(string $id, \Docker\API\Model\SecretSpec $body, arr
                 if (500 === $response->getStatus()) {
                     throw new \Docker\API\Exception\SecretUpdateInternalServerErrorException($this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\ErrorResponse', 'json'));
                 }
+                if (503 === $response->getStatus()) {
+                    throw new \Docker\API\Exception\SecretUpdateServiceUnavailableException($this->serializer->deserialize((yield $response->getBody()), 'Docker\\API\\Model\\ErrorResponse', 'json'));
+                }
             }
 
             return $response;