Add POST body for registry start GC (#1028)

* Add POST body for /v2/registry/<registry name/garbage-collection

* Update permission to run garbage collection

* Fix curl and python code snippet

---------

Co-authored-by: Nayan Das <dastms@gmail.com>

Author: nayanjd-do

specification/resources/registry/examples/curl/registry_run_garbageCollection.yml

@@ -3,4 +3,5 @@ source: |-
   curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
+    -d '{ "type": "unreferenced blobs only"}' \
     "https://api.digitalocean.com/v2/registry/example/garbage-collection"

specification/resources/registry/examples/python/registry_run_garbageCollection.yml

@@ -4,5 +4,10 @@ source: |-
   from pydo import Client
 
   client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
+  
+  req = {
+        "type": "unreferenced blobs only"
+        
+  }
 
-  resp = client.registry.run_garbage_collection(registry_name="example")
+  resp = client.registry.run_garbage_collection(registry_name="example",body=req)

specification/resources/registry/models/registry_run_gc.yml

@@ -0,0 +1,11 @@
+type: object
+
+properties:
+  type:
+    type: string
+    enum:
+      - untagged manifests only
+      - unreferenced blobs only
+      - untagged manifests and unreferenced blobs
+    example: unreferenced blobs only
+    description: Type of the garbage collection to run against this registry 

specification/resources/registry/registry_run_garbageCollection.yml

@@ -28,6 +28,14 @@ description: |
 tags:
   - Container Registry
 
+requestBody:
+  required: false
+
+  content:
+    application/json:
+      schema:
+        $ref: 'models/registry_run_gc.yml'
+
 parameters:
   - $ref: 'parameters.yml#/registry_name'
 
@@ -56,4 +64,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'registry:create'
+    - 'registry:update'