AWS Chatbot のアクション、リソース、および条件キー - サービス認可リファレンス
アクションリソースタイプ条件キー

AWS Chatbot のアクション、リソース、および条件キー

AWS Chatbot (サービスプレフィックス: chatbot) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のリソースやアクション、条件コンテキストキーが用意されています。

リファレンス:

AWS Chatbot で定義されるアクション

IAM ポリシーステートメントの Action エレメントでは、以下のアクションを指定できます。ポリシーを使用して、AWS でオペレーションを実行するアクセス許可を付与します。ポリシーでアクションを使用する場合は、通常、同じ名前の API オペレーションまたは CLI コマンドへのアクセスを許可または拒否します。ただし、場合によっては、1 つのアクションによって複数のオペレーションへのアクセスが制御されます。あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

アクションテーブルの [アクセスレベル] 列では、アクションの指定方法 (リスト、読み取り、アクセス許可管理、タグ付け) について説明します。このように分類することで、ポリシーで使用する際にアクションで付与するアクセスレベルを理解しやすくなります。アクセスレベルの詳細については、「ポリシー概要内のアクセスレベル」を参照してください。

[アクション] テーブルの [リソースタイプ] 列は、各アクションがリソースレベルの許可をサポートしているかどうかを示します。この列に値がない場合は、ポリシーステートメントの Resource 要素で、ポリシーが適用されるすべてのリソース (「*」) を指定する必要があります。列にリソースタイプが含まれる場合、そのアクションを含むステートメントでそのタイプの ARN を指定できます。アクションで 1 つ以上のリソースが必須となっている場合、呼び出し元には、それらのリソースを伴うアクションを使用するための許可が付与されている必要があります。必須リソースは、アスタリスク (*) でテーブルに示されています。IAM ポリシーの Resource 要素でリソースアクセスを制限する場合は、必要なリソースタイプごとに ARN またはパターンを含める必要があります。一部のアクションでは、複数のリソースタイプがサポートされています。リソースタイプがオプション (必須として示されていない) の場合、オプションのリソースタイプのいずれかを使用することを選択できます。

[アクション] テーブルの [条件キー] 列には、ポリシーステートメントの Condition 要素で指定できるキーが含まれます。サービスのリソースに関連付けられている条件キーの詳細については、[リソースタイプ] テーブルの [条件キー] 列を参照してください。

Actions テーブルの [依存アクション] 列には、アクションを正常に呼び出すために必要な追加のアクセス許可が表示されます。これらのアクセス許可は、アクション自体のアクセス許可に加えて必要になる場合があります。アクションが依存アクションを指定すると、それらの依存関係は、テーブルにリストされている最初のリソースだけでなく、そのアクションに定義された追加のリソースに適用される場合があります。

注記

リソース条件キーは、リソースタイプテーブルに一覧表示されています。アクションに適用されるリソースタイプへのリンクは、[アクション] テーブルの [リソースタイプ (* 必須)] 列にあります。[リソースタイプ] テーブルのリソースタイプには、[アクション] テーブルのアクションに適用されるリソース条件キーである、[条件キー] 列が含まれています。

以下の表の列の詳細については、「アクションテーブル」を参照してください。

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
AssociateToConfiguration リソースを設定に関連付けるアクセス許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

custom-action*

aws:ResourceTag/${TagKey}

CreateChimeWebhookConfiguration AWS Chatbot Chime Webhook Configuration を作成する許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

aws:TagKeys

aws:RequestTag/${TagKey}

CreateCustomAction カスタムアクションを作成する許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

aws:TagKeys

aws:RequestTag/${TagKey}

CreateMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams Channel Configuration を作成するための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

aws:TagKeys

aws:RequestTag/${TagKey}

CreateSlackChannelConfiguration AWS Chatbot Slack Channel Configuration を作成する許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

DeleteChimeWebhookConfiguration AWS Chatbot Chime Webhook Configuration を削除する許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteCustomAction カスタムアクションを削除する許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

custom-action*

aws:ResourceTag/${TagKey}

DeleteMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams Channel Configuration を削除するための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteMicrosoftTeamsConfiguredTeam AWS アカウント の AWS Chatbot で設定された Microsoft Teams を削除するための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
DeleteMicrosoftTeamsUserIdentity AWS Chatbot Microsoft Teams ユーザー ID を削除するための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
DeleteSlackChannelConfiguration AWS Chatbot Slack Channel Configuration を削除する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteSlackUserIdentity AWS Chatbot Slack ユーザー ID を削除するアクセス許可を付与します 書き込み
DeleteSlackWorkspaceAuthorization AWS アカウントに関連付けられた AWS Chatbot を用いて Slack ワークスペース認可を削除する許可を付与する 書き込み
DescribeChimeWebhookConfigurations AWS アカウントのすべての AWS Chatbot Chime Webhook Configurations を一覧表示する許可を付与 読み込み
DescribeSlackChannelConfigurations AWS アカウント で、すべての AWS Chatbot Slack Channel Configurations を一覧表示する許可を付与 読み込み
DescribeSlackChannels AWS Chatbot サービスでオンボーディングされている AWS アカウントに接続された Slack ワークスペースのすべてのパブリック Slack チャネルを一覧表示する許可を付与 読み込み
DescribeSlackUserIdentities AWS Chatbot Slack ユーザー ID を記述するアクセス許可を付与します 読み込み
DescribeSlackWorkspaces AWS Chatbot サービスでオンボーディングされている AWS アカウントに接続された Slack ワークスペースのすべての認証済み Slack ワークスペースを一覧表示する許可を付与 読み取り
DisassociateFromConfiguration リソースとの関連付けを解除するアクセス許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

custom-action*

aws:ResourceTag/${TagKey}

GetAccountPreferences AWS Chatbot アカウント設定を取得するアクセス許可を付与します 読み取り
GetCustomAction カスタムアクションを取得する許可を付与 読み取り

custom-action*

aws:ResourceTag/${TagKey}

GetMicrosoftTeamsChannelConfiguration AWS アカウント における単一の AWS Chatbot Microsoft Teams Channel Configurations を取得するための許可を付与します 読み取り

aws:ResourceTag/${TagKey}

GetMicrosoftTeamsOauthParameters AWS Chatbot サービスで使用する Microsoft Teams OAuth コードをリクエストする OAuth パラメータを生成するための許可を付与します 読み取り
GetSlackOauthParameters AWS Chatbot サービスで使用する Slack OAuth コードをリクエストする OAuth パラメータを生成する許可を付与 読み取り
ListAssociations リソースに関連付けられているリソースを一覧表示する許可を付与 読み取り

ChatbotConfiguration*

ListCustomActions カスタムアクションを一覧表示する許可を付与 リスト
ListMicrosoftTeamsChannelConfigurations AWS アカウント で、すべての AWS Chatbot Microsoft Teams Channel Configurations を一覧表示するための許可を付与します 読み取り
ListMicrosoftTeamsConfiguredTeams AWS Chatbot サービスでオンボーディングされた AWS アカウントに接続されているすべての Microsoft Teams を一覧表示するための許可を付与します 読み取り
ListMicrosoftTeamsUserIdentities AWS Chatbot Microsoft Teams ユーザー ID を記述するための許可を付与します 読み取り
ListTagsForResource AWS Chatbot チャネル設定に関連付けられたすべてのタグを一覧表示する許可を付与する 読み取り
RedeemMicrosoftTeamsOauthCode AWS Chatbot サービスで使用する OAuth トークンを取得するために、以前に生成されたパラメータを Microsoft API で引き換えるための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
RedeemSlackOauthCode AWS Chatbot サービスで使用する OAuth トークンを取得するために、以前に生成されたパラメータを Slack API で引き換える許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。
TagResource AWS Chatbot チャネル設定でタグを作成する許可を付与する タグ付け

ChatbotConfiguration

custom-action

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource AWS Chatbot チャネル設定のタグを削除する許可を付与する タグ付け

ChatbotConfiguration

custom-action

aws:TagKeys

UpdateAccountPreferences AWS Chatbot アカウント設定を更新するアクセス許可を付与します 書き込み
UpdateChimeWebhookConfiguration AWS Chatbot Chime Webhook Configuration を更新する許可を付与します。 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

UpdateCustomAction カスタムアクションを更新する許可を付与 あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

custom-action*

aws:ResourceTag/${TagKey}

UpdateMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams Channel Configuration を更新するための許可を付与します あるいは、いくつかのオペレーションはいくつかの異なるアクションを必要とします。

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

UpdateSlackChannelConfiguration AWS Chatbot Slack Channel Configuration を更新する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

AWS Chatbot で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。アクションテーブルの各アクションは、そのアクションで指定できるリソースタイプを示しています。リソースタイプは、ポリシーに含めることができる条件キーを定義することもできます。これらのキーは、[リソースタイプ] テーブルの最後の列に表示されます。以下の表の列の詳細については、「リソースタイプテーブル」を参照してください。

リソースタイプ ARN 条件キー
ChatbotConfiguration arn:${Partition}:chatbot::${Account}:chat-configuration/${ConfigurationType}/${ChatbotConfigurationName}

aws:ResourceTag/${TagKey}

custom-action arn:${Partition}:chatbot::${Account}:custom-action/${ActionName}

aws:ResourceTag/${TagKey}

AWS Chatbot の条件キー

AWS Chatbot では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。これらのキーを使用して、ポリシーステートメントが適用される条件をさらに絞り込むことができます。以下の表の列の詳細については、「条件キーテーブル」を参照してください。

すべてのサービスで使用できるグローバル条件キーを確認するには、「AWSグローバル条件コンテキストキー」を参照してください。

条件キー 説明 タイプ
aws:RequestTag/${TagKey} リクエストで渡されたタグでアクセスをフィルタリングします 文字列
aws:ResourceTag/${TagKey} リソースに関連付けられたタグでアクセスをフィルタリングします 文字列
aws:TagKeys リクエストで渡されたタグキーでアクセスをフィルタリングします ArrayOfString