폴더 권한 API - Amazon Managed Grafana
폴더에 대한 권한 가져오기폴더 권한 업데이트

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

폴더 권한 API

폴더 API를 사용하여 폴더에 대한 권한을 업데이트하거나 검색할 수 있습니다.

folderId=-1권한은 뷰어 및 편집자 역할을 가진 사용자의 기본 권한입니다. 사용자, 팀 또는 역할 (뷰어 또는 편집자) 에 대한 권한을 설정할 수 있습니다. 관리자의 권한은 설정할 수 없습니다. 관리자는 항상 모든 항목에 액세스할 수 있기 때문입니다.

permission필드의 권한 등급은 다음과 같습니다.

  • 1 = 보기

  • 2 = 편집하기

  • 4 = 관리자

참고

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

폴더에 대한 권한 가져오기

GET /api/folders/:uid/permissions

지정된 폴더의 기존 권한을 모두 가져옵니다uid.

요청 예제

GET /api/folders/nErXDvCkzz/permissions HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

응답의 예

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Content-Length: 551

[
  {
    "id": 1,
    "folderId": -1,
    "created": "2017-06-20T02:00:00+02:00",
    "updated": "2017-06-20T02:00:00+02:00",
    "userId": 0,
    "userLogin": "",
    "userEmail": "",
    "teamId": 0,
    "team": "",
    "role": "Viewer",
    "permission": 1,
    "permissionName": "View",
    "uid": "nErXDvCkzz",
    "title": "",
    "slug": "",
    "isFolder": false,
    "url": ""
  },
  {
    "id": 2,
    "dashboardId": -1,
    "created": "2017-06-20T02:00:00+02:00",
    "updated": "2017-06-20T02:00:00+02:00",
    "userId": 0,
    "userLogin": "",
    "userEmail": "",
    "teamId": 0,
    "team": "",
    "role": "Editor",
    "permission": 2,
    "permissionName": "Edit",
    "uid": "",
    "title": "",
    "slug": "",
    "isFolder": false,
    "url": ""
  }
]

상태 코드:

  • 200 — 좋아요

  • 401 — 승인되지 않았습니다

  • 403 — 액세스가 거부되었습니다.

  • 404 — 폴더를 찾을 수 없음

폴더 권한 업데이트

POST /api/folders/:uid/permissions

폴더 권한을 업데이트합니다. 이 작업을 수행하면 기존 권한이 요청에 포함되지 않은 경우 해당 권한이 제거됩니다.

요청 예제

POST /api/folders/nErXDvCkzz/permissions
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
{
  "items": [
    {
      "role": "Viewer",
      "permission": 1
    },
    {
      "role": "Editor",
      "permission": 2
    },
    {
      "teamId": 1,
      "permission": 1
    },
    {
      "userId": 11,
      "permission": 4
    }
  ]
}

JSON 본문 스키마:

  • items — 추가 또는 업데이트할 권한 항목. 목록에서 생략된 기존 항목은 제거됩니다.

응답의 예

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Content-Length: 35

{"message":"Folder permissions updated","id":1,"title":"Department ABC"}

상태 코드:

  • 200 — 생성됨

  • 401 — 승인되지 않았습니다

  • 403 — 액세스가 거부되었습니다.

  • 404 — 대시보드를 찾을 수 없음