Membuat folder QuickSight berskala dengan QuickSight APIs

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Anda dapat menggunakan Amazon QuickSight APIs untuk membuat folder berskala khusus yang dapat dibagikan dengan hingga 3000 ruang nama. Setiap namespace yang ditambahkan ke folder dapat berisi hingga 100 prinsipal. Prinsipal adalah pengguna atau sekelompok pengguna. Setelah Anda membuat folder berskala dan menambahkan prinsipal yang Anda inginkan, QuickSight aset apa pun dapat ditambahkan ke folder. Ini kemudian dapat dibagikan ke setiap prinsipal di ruang nama tempat prinsipal folder ditugaskan. Ini merampingkan proses untuk berbagi QuickSight aset dengan ribuan pengguna.

Folder berskala hanya dapat dibuat dengan file. QuickSight APIs Saat Anda membuat folder berskala, Anda dapat berbagi folder dengan hingga 100 prinsipal yang berada di namespace yang sama. Anda dapat menambahkan prinsipal milik namespace yang berbeda dengan panggilan API. UpdateFolderPermissions Setelah folder dibuat, Anda dapat menambah dan menghapus aset dari folder dengan QuickSight APIs atau QuickSight konsol.

Setiap QuickSight akun Amazon menampung 100 folder berskala. Anda dapat menambahkan hingga 100 aset ke folder yang diskalakan. Jika Anda ingin berbagi folder berskala dengan lebih dari 3000 ruang nama, hubungi dukungan.AWS

Contoh

Contoh berikut menunjukkan cara membuat folder berskala dengan file. QuickSight APIs

Prasyarat

Sebelum memulai, verifikasi bahwa Anda memiliki AWS Identity and Access Management peran yang memberikan akses pengguna API untuk memanggil operasi QuickSight API. Contoh berikut menunjukkan kebijakan IAM yang dapat Anda tambahkan ke peran IAM yang ada untuk membuat, menghapus, atau memodifikasi folder berskala. Dengan kebijakan sampel, pengguna dapat menambahkan dasbor, analisis, dan kumpulan data ke folder yang diskalakan.

{
    "Version": "2012-10-17",
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "quicksight:CreateFolder",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:DescribeFolderResolvedPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:UpdateDashboardPermissions",
            "quicksight:UpdateAnalysisPermissions",
            "quicksight:UpdateDataSetPermissions"
        ],
        "Resource": "*"
        }
    ]
}

Contoh berikut membuat folder skala.

aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "eastcoast-users" \
--sharing-model "NAMESPACE" \
--folder-id "eastcoast-users"

Setelah Anda membuat folder berskala, bagikan folder dengan prinsipal di akun Anda. Anda hanya dapat memberikan atau mencabut izin kepada pengguna dan grup yang berada dalam namespace yang sama di setiap panggilan API. Contoh berikut membagikan folder berskala dengan pengguna di akun yang sama dengan folder yang ada.

aws quicksight update-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--grant-permissions \
    '[
        {"Actions":
            ["quicksight:DescribeFolder",
            "quicksight:UpdateFolder",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:CreateFolder"
            ],
        "Principal":"arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/my-user"
        }
    ]'

Setelah Anda berbagi folder dengan prinsipal baru, validasi izin folder baru dengan panggilan describe-folder-permissions API.

aws quicksight describe-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--namespace "default"

Setelah Anda memvalidasi izin folder baru, buat subfolder dalam folder yang diskalakan. Subfolder mewarisi izin folder berskala tempat pembuatannya.

aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "new-york-users" \
--sharing-model "NAMESPACE" \
--folder-id "new-york-users" \
--parent-folder-arn "arn:aws:quicksight:us-east-1:AWSACCOUNTID:folder/eastcoast-users"

Contoh berikut memvalidasi izin yang diwariskan dari subfolder baru.

aws quicksight describe-folder-resolved-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "new-york-users" \
--namespace "default"

Setelah Anda memvalidasi izin subfolder, tambahkan aset yang ingin Anda bagikan ke folder. Setelah Anda menambahkan aset ke subfolder, aset akan dibagikan dengan setiap prinsipal yang dibagikan subfolder tersebut. Contoh berikut menambahkan dashboard ke subfolder.

aws quicksight create-folder-membership \
--aws-account-id "AWSACCOUNTID" \
--folder-id "new-york-users" \
--member-id "my-dashboard" \
--member-type "DASHBOARD" \
--region "us-east-1"