API: Support paging in the admin orgs list API (#26932)

* Add page/limit to org search

* Update docs

* Fix test per PR feedback

docs/sources/http_api/org.md

@@ -325,7 +325,7 @@ Content-Type: application/json
 Content-Type: application/json
 
 ```
-
+
 ### Get Users in Organization
 
 `GET /api/orgs/:orgId/users`
@@ -339,6 +339,8 @@ Content-Type: application/json
 Accept: application/json
 Content-Type: application/json
 ```
+Note: The api will only work when you pass the admin name and password
+to the request HTTP URL, like http://admin:admin@localhost:3000/api/orgs/1/users
 
 
 **Example Response**:

pkg/api/org.go

@@ -160,11 +160,18 @@ func DeleteOrgByID(c *models.ReqContext) Response {
 }
 
 func SearchOrgs(c *models.ReqContext) Response {
+	perPage := c.QueryInt("perpage")
+	if perPage <= 0 {
+		perPage = 1000
+	}
+
+	page := c.QueryInt("page")
+
 	query := models.SearchOrgsQuery{
 		Query: c.Query("query"),
 		Name:  c.Query("name"),
-		Page:  0,
+		Page:  page,
-		Limit: 1000,
+		Limit: perPage,
 	}
 
 	if err := bus.Dispatch(&query); err != nil {

pkg/services/sqlstore/org_test.go

@@ -35,6 +35,38 @@ func TestAccountDataAccess(t *testing.T) {
 			So(len(query.Result), ShouldEqual, 3)
 		})
 
+		Convey("Given we have organizations, we can limit and paginate search", func() {
+			for i := 1; i < 4; i++ {
+				cmd := &models.CreateOrgCommand{Name: fmt.Sprint("Org #", i)}
+				err := CreateOrg(cmd)
+				So(err, ShouldBeNil)
+			}
+
+			Convey("Should be able to search with defaults", func() {
+				query := &models.SearchOrgsQuery{}
+				err := SearchOrgs(query)
+
+				So(err, ShouldBeNil)
+				So(len(query.Result), ShouldEqual, 3)
+			})
+
+			Convey("Should be able to limit search", func() {
+				query := &models.SearchOrgsQuery{Limit: 1}
+				err := SearchOrgs(query)
+
+				So(err, ShouldBeNil)
+				So(len(query.Result), ShouldEqual, 1)
+			})
+
+			Convey("Should be able to limit and paginate search", func() {
+				query := &models.SearchOrgsQuery{Limit: 2, Page: 1}
+				err := SearchOrgs(query)
+
+				So(err, ShouldBeNil)
+				So(len(query.Result), ShouldEqual, 1)
+			})
+		})
+
 		Convey("Given single org mode", func() {
 			setting.AutoAssignOrg = true
 			setting.AutoAssignOrgId = 1