조직 API

Amazon 관리형 Grafana 워크스페이스에서 조직과 작업하려면 조직 API를 사용하십시오.

참고

아마존 관리형 그라파나 워크스페이스에서 Grafana API를 사용하려면 유효한 Grafana API 토큰이 있어야 합니다. API 요청의 필드에 이를 포함시키세요. Authorization API 호출을 인증하기 위한 토큰을 생성하는 방법에 대한 자세한 내용은 을 참조하십시오토큰으로 인증.

현재 조직 가져오기

GET /api/org/

요청 예제

GET /api/org/ HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

응답의 예

HTTP/1.1 200
Content-Type: application/json

{
  "id":1,
  "name":"Main Org."
}

현재 조직 내 모든 사용자 가져오기

GET /api/org/users

필수 권한: 범위가 있는 org.users:read 작업 users:*

요청 예제

GET /api/org/users HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

응답의 예

HTTP/1.1 200
Content-Type: application/json

[
  {
    "orgId": 1,
    "userId": 1,
    "email": "admin@localhost",
    "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae",
    "login": "admin",
    "role": "Admin",
    "lastSeenAt": "2019-08-09T11:02:49+02:00",
    "lastSeenAtAge": "< 1m"
  }
]

현재 조직 내 모든 사용자 가져오기 (조회)

GET /api/org/users/lookup

현재 조직 내의 모든 사용자를 반환하지만 세부 정보는 더 적게 표시합니다. 조직 관리자 역할을 가진 사용자, 모든 폴더의 관리자 또는 모든 팀의 관리자가 액세스할 수 있습니다. 팀 구성원을 추가할 때와 폴더/대시보드 권한을 편집할 때 사용자 목록을 제공하기 위해 Grafana UI에서 주로 사용됩니다.

요청 예제

GET /api/org/users/lookup HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

응답의 예

HTTP/1.1 200
Content-Type: application/json

[
  {
    "userId": 1,
    "login": "admin",
    "avatarUrl": "/avatar/46d229b033af06a191ff2267bca9ae"
  }
]

지정된 사용자를 업데이트합니다.

PATCH /api/org/users/:userId

필수 권한: 범위를 포함한 org.users.role:update 작업 users:*

요청 예제

PATCH /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "role": "Viewer",
}

응답의 예

HTTP/1.1 200
Content-Type: application/json

{"message":"Organization user updated"}

현재 조직의 사용자를 삭제합니다.

DELETE /api/org/users/:userId

필수 권한: org.users:remove 범위가 있는 작업 users:*

요청 예제

DELETE /api/org/users/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

응답의 예

HTTP/1.1 200
Content-Type: application/json

{"message":"User removed from organization"}

현재 조직 업데이트

PUT /api/org

요청 예제

PUT /api/org HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "name":"Main Org."
}

응답의 예

HTTP/1.1 200
Content-Type: application/json

{"message":"Organization updated"}

현재 조직에 사용자 추가

POST /api/org/users

필수 권한: 범위가 있는 org.users:add 작업 users:*

요청 예제

POST /api/org/users HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "role": "Admin",
  "loginOrEmail": "admin"
}

응답의 예

HTTP/1.1 200
Content-Type: application/json

{"message":"User added to organization","userId":1}