Add support for creating backups (POST /v2/app/{app}/backup/)

Author: Jonathan Visser

src/Service/Backup.php

@@ -44,4 +44,24 @@ public function getList(string $app, array $params = []): array
 
         return $backups;
     }
+
+    /**
+     * Create a new snapshot backup. This requires sla-standard to be enabled
+     * on the Hypernode.
+     *
+     * @param string $app Name of the Hypernode
+     * @return string Response message
+     * @throws HypernodeApiClientException
+     * @throws HypernodeApiServerException
+     */
+    public function create(string $app): string
+    {
+        $url = sprintf(self::V2_APP_BACKUP_URL, $app);
+
+        $response = $this->client->api->post($url);
+
+        $this->client->maybeThrowApiExceptions($response);
+
+        return $this->client->getJsonFromResponse($response);
+    }
 }

tests/unit/Service/BackupTest.php

@@ -131,4 +131,42 @@ public function testGetListRaisesServerExceptions()
 
         $this->client->backup->getList('johndoe');
     }
+
+    public function testCreate()
+    {
+        $this->responses->append(
+            new Response(200, [], json_encode('Backup creation initiated')),
+        );
+
+        $result = $this->client->backup->create('johndoe');
+
+        $request = $this->responses->getLastRequest();
+        $this->assertEquals('POST', $request->getMethod());
+        $this->assertEquals('/v2/app/johndoe/backup/', $request->getUri());
+        $this->assertEquals('Backup creation initiated', $result);
+    }
+
+    public function testCreateRaisesClientExceptions()
+    {
+        $badRequestResponse = new Response(400, [], json_encode(
+            'Creating backups requires sla-standard to be enabled.'
+        ));
+        $this->responses->append($badRequestResponse);
+
+        $this->expectExceptionObject(new HypernodeApiClientException($badRequestResponse));
+
+        $this->client->backup->create('johndoe');
+    }
+
+    public function testCreateRaisesServerExceptions()
+    {
+        $badRequestResponse = new Response(500, [], json_encode([
+            'non_field_errors' => ['Something went wrong processing your request.']
+        ]));
+        $this->responses->append($badRequestResponse);
+
+        $this->expectExceptionObject(new HypernodeApiServerException($badRequestResponse));
+
+        $this->client->backup->create('johndoe');
+    }
 }