docs(35/rbac) permissions endpoints update

Kong · May 13, 2019 · 5a8305b · 5a8305b
1 parent cc09700
commit 5a8305b
Showing 1 changed file with 99 additions and 81 deletions.
diff --git a/app/enterprise/0.35-x/admin-api/rbac/reference.md b/app/enterprise/0.35-x/admin-api/rbac/reference.md
@@ -576,7 +576,7 @@ HTTP 200 OK
 **Response**
 
 ```
-HTTP 204 OK
+HTTP 204 No Content
 ```
 
 ---
@@ -618,16 +618,16 @@ HTTP 201 Created
   "actions": [
     "delete",
     "create",
-    "update",
     "read"
   ],
-  "created_at": 1529005234000,
-  "entity_id": "124572ea-f571-46fd-8662-8cbd3192f572",
-  "entity_type": "apis",
+  "created_at": 1557771505,
+  "entity_id": "*",
+  "entity_type": "wildcard",
   "negative": false,
-  "role_id": "432d7b69-ab71-4567-8089-a02600cdddf6"
+  "role": {
+    "id": "bba049fa-bf7e-40ef-8e89-553dda292e99"
+  }
 }
-
 ```
 
 ---
@@ -652,16 +652,16 @@ HTTP 200 Ok
   "actions": [
     "delete",
     "create",
-    "update",
     "read"
   ],
-  "created_at": 1529005234000,
-  "entity_id": "124572ea-f571-46fd-8662-8cbd3192f572",
-  "entity_type": "apis",
+  "created_at": 1557771505,
+  "entity_id": "*",
+  "entity_type": "wildcard",
   "negative": false,
-  "role_id": "432d7b69-ab71-4567-8089-a02600cdddf6"
+  "role": {
+    "id": "bba049fa-bf7e-40ef-8e89-553dda292e99"
+  }
 }
-
 ```
 
 ---
@@ -685,20 +685,20 @@ HTTP 200 Ok
 {
   "data": [
     {
-      "created_at": 1529005234000,
-      "role_id": "432d7b69-ab71-4567-8089-a02600cdddf6",
-      "entity_id": "124572ea-f571-46fd-8662-8cbd3192f572",
-      "negative": false,
-      "entity_type": "apis",
       "actions": [
         "delete",
         "create",
-        "update",
         "read"
-      ]
+      ],
+      "created_at": 1557771505,
+      "entity_id": "*",
+      "entity_type": "wildcard",
+      "negative": false,
+      "role": {
+        "id": "bba049fa-bf7e-40ef-8e89-553dda292e99"
+      }
     }
-  ],
-  "total": 1
+  ]
 }
 ```
 
@@ -728,14 +728,16 @@ HTTP 200 OK
 
 ```json
 {
-  "created_at": 1529052531000,
-  "role_id": "22ffce18-afef-4f19-a1b2-2071f52e2f30",
-  "entity_id": "1d947f65-4879-43f0-ad93-f7cf4f05cc51",
-  "negative": false,
-  "entity_type": "apis",
   "actions": [
-    "read"
-  ]
+    "update"
+  ],
+  "created_at": 1557771505,
+  "entity_id": "*",
+  "entity_type": "wildcard",
+  "negative": false,
+  "role": {
+    "id": "bba049fa-bf7e-40ef-8e89-553dda292e99"
+  }
 }
 ```
 
@@ -775,21 +777,29 @@ HTTP 200 OK
 ```
 ```json
 {
-  "entities": {
-    "1d947f65-4879-43f0-ad93-f7cf4f05cc51": [
-      "delete",
-      "create",
-      "update",
-      "read"
-    ]
-  },
   "endpoints": {
-    "default": {
-      "/default/routes": [
-        "read"
-      ]
+    "*": {
+      "*": {
+        "actions": [
+          "delete",
+          "create",
+          "update",
+          "read"
+        ],
+        "negative": false
+      },
+      "/*/rbac/*": {
+        "actions": [
+          "delete",
+          "create",
+          "update",
+          "read"
+        ],
+        "negative": true
+      }
     }
-  }
+  },
+  "entities": {}
 }
 ```
 
@@ -816,20 +826,22 @@ HTTP 201 Created
 ```
 ```json
 {
- "roles": [
-  {
-   "created_at": 1501524270000,
-   "id": "9bd49829-2a8b-41fd-b7fc-28e63c100676",
-   "name": "developer"
+  "roles": [
+    {
+      "created_at": 1557772263,
+      "id": "aae80073-095f-4553-ba9a-bee5ed3b8b91",
+      "name": "doc-knight"
+    }
+  ],
+  "user": {
+    "comment": null,
+    "created_at": 1557772232,
+    "enabled": true,
+    "id": "b65ca712-7ceb-4114-87f4-5c310492582c",
+    "name": "gruce-wayne",
+    "user_token": "$2b$09$gZnMKK/mm/d2rAXN7gL63uL43mjdX/62iwMqdyCQwLyC0af3ce/1K",
+    "user_token_ident": "88ea3"
   }
- ],
- "user": {
-  "created_at": 1501524409000,
-  "enabled": true,
-  "id": "11cbd5cf-e4e0-47b6-968b-73b062440a4e",
-  "name": "bob",
-  "user_token": "1VHzdFqU24GmoeAlsoE7V95gWn1OoPjS"
- }
 }
 ```
 
@@ -850,21 +862,30 @@ HTTP 201 Created
 HTTP 200 OK
 ```
 ```json
+
 {
- "roles": [
-  {
-   "created_at": 1501524270000,
-   "id": "9bd49829-2a8b-41fd-b7fc-28e63c100676",
-   "name": "developer"
+  "roles": [
+    {
+      "comment": "Read access to all endpoints, across all workspaces",
+      "created_at": 1557765500,
+      "id": "a1c810ee-8366-4654-ba0c-963ffb9ccf2e",
+      "name": "read-only"
+    },
+    {
+      "created_at": 1557772263,
+      "id": "aae80073-095f-4553-ba9a-bee5ed3b8b91",
+      "name": "doc-knight"
+    }
+  ],
+  "user": {
+    "comment": null,
+    "created_at": 1557772232,
+    "enabled": true,
+    "id": "b65ca712-7ceb-4114-87f4-5c310492582c",
+    "name": "gruce-wayne",
+    "user_token": "$2b$09$gZnMKK/mm/d2rAXN7gL63uL43mjdX/62iwMqdyCQwLyC0af3ce/1K",
+    "user_token_ident": "88ea3"
   }
- ],
- "user": {
-  "created_at": 1501524409000,
-  "enabled": true,
-  "id": "11cbd5cf-e4e0-47b6-968b-73b062440a4e",
-  "name": "bob",
-  "user_token": "1VHzdFqU24GmoeAlsoE7V95gWn1OoPjS"
- }
 }
 ```
 
@@ -893,9 +914,6 @@ HTTP 204 No Content
 
 ---
 
-
-[Admin API]: /{{page.kong_version}}/admin-api/
-
 ## List a User's Permissions
 **Endpoint**
 
@@ -912,17 +930,17 @@ HTTP 200 OK
 ```
 ```json
 {
-  "entities": {
-    "1d947f65-4879-43f0-ad93-f7cf4f05cc51": [
-      "read"
-    ]
-  },
   "endpoints": {
-    "default": {
-      "/default/routes": [
-        "read"
-      ]
+    "*": {
+      "*": {
+        "actions": [
+          "read"
+        ],
+        "negative": false
+      }
     }
-  }
+  },
+  "entities": {}
 }
+
 ```