# APIサンプルについて

**URL:** <https://community.amazonquick.com/t/api/51895>\
**Category:** 日本語で質問 | Q&A\
**Tags:** analysis, business-user\
**Created:** [March 19, 2026, 7:27am UTC](https://community.amazonquick.com/t/api/51895 "2026-03-19T07:27:55Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Kawaguchi](https://avatars.discourse-cdn.com/v4/letter/k/e19b73/32.png) [@Kawaguchi](https://community.amazonquick.com/u/Kawaguchi)\
**Post date:** [March 19, 2026, 7:27am UTC](https://community.amazonquick.com/t/api/51895/1 "2026-03-19T07:27:55Z")

</div>

APIサンプルが掲載されているサイトはございますでしょうか。

公式ドキュメントは確認済みです。

例えばPrincipalのStringがなにを書けばよいのかわかりません。

> **[DescribeFolderPermissions - Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeFolderPermissions.html)**
>
> Describes permissions for a folder.

---

<div class="post-metadata">

**Author:** ![ytakahr](https://d2orw1595917va.cloudfront.net/user_avatar/community.amazonquick.com/ytakahr/32/26209_2.png) [@ytakahr](https://community.amazonquick.com/u/ytakahr)\
**Post date:** [March 23, 2026, 12:31am UTC](https://community.amazonquick.com/t/api/51895/2 "2026-03-23T00:31:43Z")

</div>

@Kawaguchi さん、ご質問ありがとうございます。

APIの利用方法については参照いただいているAPIリファレンスか、各プログラミング言語向けのSDKのリファレンスをご覧いただければと思います。実例という形でのサンプルの記載はございませんが、構文の説明があるため基本的にそちらに従っていただければ問題無く利用いただけることを想定しています。

ご質問のDescribeFolderPermissionsのPrincipalについてはレスポンスの一部として返却されるものですので、リクエスト時に指定いただく必要はございません。ちなみに、Principalについては引用いただいたページのリンク先に説明されているように、ARNが返却されます。

 ![image](https://d1wl4jav5dp96l.cloudfront.net/original/3X/c/3/c33dd23cedfe1c269d183b06af876bce23bc5aa3.png)  
 ![image](https://d1wl4jav5dp96l.cloudfront.net/original/3X/0/8/08af3b650d7663229226091e2426505ca6452b73.png)

リクエストについては、「リクエストの構文」配下に説明があるように、AwsAccountIdおよびFolderIdを記載いただくこととなります。AwsAccountIdはお使いのAWSアカウントの12桁のIDを、FolderIdについては権限を確認する対象のフォルダのIDを指定します。フォルダのIDはコンソール上で対象のフォルダを開くとURLバーで確認できます。

 ![image](https://d1wl4jav5dp96l.cloudfront.net/original/3X/8/1/811f2de45cfe9602f093d8277285c0d1bba215dc.png)

AWS CLIの場合には以下のようになります。

> aws quicksight describe-folder-permissions --aws-account-id \<AWSアカウントID 12桁\> --folder-id \<フォルダID\>

---

<div class="post-metadata">

**Author:** ![Kawaguchi](https://avatars.discourse-cdn.com/v4/letter/k/e19b73/32.png) [@Kawaguchi](https://community.amazonquick.com/u/Kawaguchi)\
**Post date:** [March 23, 2026, 12:59am UTC](https://community.amazonquick.com/t/api/51895/3 "2026-03-23T00:59:15Z")

</div>

ご回答ありがとうございます。

もう1点確認させてください。

[UpdateFolderPermissions - Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateFolderPermissions.html) のRequestのActionになにを記述したらよいのでしょうか。解説は以下となっており、わかりません。

**Actions**

アクセス許可を付与または取り消す対象の IAM アクション。

---

<div class="post-metadata">

**Author:** ![ytakahr](https://d2orw1595917va.cloudfront.net/user_avatar/community.amazonquick.com/ytakahr/32/26209_2.png) [@ytakahr](https://community.amazonquick.com/u/ytakahr)\
**Post date:** [March 23, 2026, 1:34am UTC](https://community.amazonquick.com/t/api/51895/4 "2026-03-23T01:34:44Z")

</div>

@Kawaguchi ご確認ありがとうございます。

フォルダに付与する権限の種別（Owner / Contributor / Viewer）に応じて以下を指定ください。

**Owner**

```auto
"Actions": [
    "quicksight:CreateFolder",
    "quicksight:DescribeFolder",
    "quicksight:UpdateFolder",
    "quicksight:DeleteFolder",
    "quicksight:CreateFolderMembership",
    "quicksight:DeleteFolderMembership",
    "quicksight:DescribeFolderPermissions",
    "quicksight:UpdateFolderPermissions"
]

```

**Contributor**

```auto
"Actions": [
    "quicksight:CreateFolder",
    "quicksight:DescribeFolder",
    "quicksight:CreateFolderMembership",
    "quicksight:DeleteFolderMembership",
    "quicksight:DescribeFolderPermissions"
]

```

**Viewer**

```auto
"Actions": [
    "quicksight:DescribeFolder"
]

```

※上記のIAMアクションの組み合わせは、手元環境でコンソールからOwner / Contributor / Viewerの権限を付与した際に自動で設定されているものを参考としています。  
※各権限の違いについては以下の公式ドキュメントを参照ください。

> **[Quick Sight 共有フォルダのアクセス許可 - Amazon Quick](https://docs.aws.amazon.com/ja_jp/quick/latest/userguide/folders-security.html)**
>
> 共有フォルダには 3 つのアクセス許可レベルがあります。ユーザーまたはグループにフォルダレベルのアクセス許可を設定する方法については、「 」を参照してください。