Aracılığıyla paylaş

Çalışma Alanı API'sini kullanarak pano izinlerini yönetme

Bu öğreticide Çalışma Alanı API'sini kullanarak pano izinlerinin nasıl yönetileceğini gösterir. Her adım örnek bir istek ve yanıt ile API araçlarını ve özelliklerini birlikte kullanma hakkında açıklamalar içerir.

Önkoşullar

Yol parametreleri

Bu makaledeki her uç nokta isteği için workspace_object_type ve workspace_object_idiki yol parametresi gerekir.

  • workspace_object_type: AI/BI panoları için nesne türü şeklindedir dashboards.
  • workspace_object_id: Bu, panoyla ilişkilendirilmiş olana karşılık gelir resource_id . Bu değeri almak için GET /api/2.0/workspace/list veya GET /api/2.0/workspace/get-status kullanabilirsiniz. benzeri 32 karakterlik bir dizedir 01eec14769f616949d7a44244a53ed10.

Çalışma alanı nesnelerini listeleme örneği için bkz . 1. Adım: Çalışma alanı dizinini keşfetme. Çalışma Alanı Listesi API'sinin ayrıntıları için bkz GET . /api/2.0/workspace/list .

Çalışma alanı nesnesi izin düzeylerini alma

Bu bölümde, Çalışma alanı nesnesi izin düzeylerini al uç noktası kullanılarak, kullanıcının bir panoda sahip olabileceği izin düzeyleri alınır. bkz. GET /api/workspace/workspace/getpermissionlevels.

Aşağıdaki örnekte, istek yukarıda açıklanan örnek yol parametrelerini içerir. Yanıt, istekte belirtilen panoya uygulanabilecek izinleri içerir.

GET /api/2.0/permissions/dashboards/01eec14769f616949d7a44244a53ed10/permissionLevels

Response:
{
        "permission_levels": [
                {
                        "permission_level": "CAN_READ",
                        "description": "Can view the Lakeview dashboard"
                },
                {
                        "permission_level": "CAN_RUN",
                        "description": "Can view, attach/detach, and run the Lakeview dashboard"
                },
                {
                        "permission_level": "CAN_EDIT",
                        "description": "Can view, attach/detach, run, and edit the Lakeview dashboard"
                },
                {
                        "permission_level": "CAN_MANAGE",
                        "description": "Can view, attach/detach, run, edit, and change permissions of the Lakeview dashboard"
                }
        ]
}

Çalışma alanı nesnesi izin ayrıntılarını alma

Çalışma alanı nesnesi izinlerini al uç noktası belirli bir çalışma alanı nesnesine atanan izinleri alır. bkz. GET /api/workspace/workspace/getpermissions.

Aşağıdaki örnekte, önceki örnekte pano için bir istek ve yanıt gösterilmektedir. Yanıt, pano ve pano üzerinde izinleri olan kullanıcılar ve gruplar hakkındaki ayrıntıları içerir. Bu nesnedeki izinler, yanıtın access_control_list bölümündeki her iki öğe için de devralındı. İlk girdide, izinler çalışma alanında bir klasörden devralınır. İkinci girdi, adminsgrubundaki üyelik tarafından devralınan izinleri gösterir.


GET /api/2.0/permissions/dashboards/01eec14769f616949d7a44244a53ed10

Response:
{
"object_id": "/dashboards/490384175243923",
"object_type": "dashboard",
"access_control_list": [
  {
  "user_name": "first.last@example.com",
  "display_name": "First Last",
  "all_permissions": [
        {
          "permission_level": "CAN_MANAGE",
          "inherited": true,
          "inherited_from_object": [
                        "/directories/2951435987702195"
                ]
        }
]
},
{
"group_name": "admins",
"all_permissions": [
        {
                "permission_level": "CAN_MANAGE",
                "inherited": true,
                "inherited_from_object": [
                        "/directories/"
                ]
        }
]
}
]
}

Çalışma alanı nesne izinlerini ayarlama

Panolarda izinleri, Çalışma alanı nesnesi izinlerini ayarla uç noktasını kullanarak ayarlayabilirsiniz. Bkz. PUT /api/workspace/workspace/setpermissions.

Aşağıdaki örnek, PUT isteğindeki için tüm çalışma alanı kullanıcılarına workspace_object_id CAN EDIT izni verir.

PUT /api/2.0/permissions/dashboards/01eec14769f616949d7a44244a53ed10

Request body:

{
"access_control_list": [
{
        "group_name": "users",
        "permission_level": "CAN_EDIT"
}
]
}

AI/BI panoları için grubu All account users kullanarak Azure Databricks hesabına kayıtlı tüm kullanıcılara görüntüleme izni atayabilirsiniz. Bkz. Yayımlanan panoyu paylaşma.

Çalışma alanı nesne izinlerini güncelleştirme

Update çalışma alanı nesne izinleri uç noktası, Çalışma alanı nesne izinleri ayarla uç noktası ile benzer şekilde çalışır. İzinleri istek yerine PATCH istek PUT kullanarak atar.

Bkz. PATCH /api/workspace/workspace/updatepermissions.


PATCH /api/2.0/permissions/dashboards/01eec14769f616949d7a44244a53ed10

Request body:

{
  "access_control_list": [
    {
      "group_name": "account userS",
      "permission_level": "CAN_VIEW"
    }
  ]
}
  • Last updated on