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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

リファレンス:

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

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

Actions テーブルのアクセスレベル列は、アクションの分類方法 (List、Read、Permissions Management、Tagging) を示しています。このように分類することで、ポリシーで使用する際にアクションで付与するアクセスレベルを理解しやすくなります。アクセスレベルの詳細については、ポリシー概要の「アクセスレベル」を参照してください。

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

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

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

注記

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

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

アクション 説明 アクセスレベル リソースタイプ (* 必須) 条件キー 依存アクション
AssociateToConfiguration リソースを設定に関連付けるアクセス許可を付与します 書き込み

ChatbotConfiguration*

custom-action*

aws:ResourceTag/${TagKey}

CreateChimeWebhookConfiguration AWS Chatbot Chime ウェブフック設定を作成するアクセス許可を付与します 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateCustomAction カスタムアクションを作成するアクセス許可を付与します 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams チャネル設定を作成する許可を付与 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

CreateSlackChannelConfiguration AWS Chatbot Slack チャネル設定を作成するアクセス許可を付与します 書き込み

aws:TagKeys

aws:RequestTag/${TagKey}

DeleteChimeWebhookConfiguration AWS Chatbot Chime ウェブフック設定を削除する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteCustomAction カスタムアクションを削除する許可を付与 書き込み

custom-action*

aws:ResourceTag/${TagKey}

DeleteMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams チャネル設定を削除する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteMicrosoftTeamsConfiguredTeam で AWS Chatbot で設定された Microsoft Teams を削除する許可を付与 AWS アカウント 書き込み
DeleteMicrosoftTeamsUserIdentity AWS Chatbot Microsoft Teams ユーザー ID を削除するアクセス許可を付与します 書き込み
DeleteSlackChannelConfiguration AWS Chatbot Slack チャネル設定を削除する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

DeleteSlackUserIdentity AWS Chatbot Slack ユーザー ID を削除するアクセス許可を付与します 書き込み
DeleteSlackWorkspaceAuthorization AWS に関連付けられた AWS アカウント Chatbot を用いて Slack ワークスペース認可を削除する許可を付与 書き込み
DescribeChimeWebhookConfigurations AWS アカウント内のすべての AWS Chatbot Chime Webhook 設定を一覧表示するアクセス許可を付与します 読み取り
DescribeSlackChannelConfigurations 内のすべての AWS Chatbot Slack チャネル設定を一覧表示するアクセス許可を付与します AWS アカウント 読み取り
DescribeSlackChannels AWS Chatbot サービスでオンボーディングされた AWS アカウントに接続されている Slack ワークスペース内のすべてのパブリック Slack チャネルを一覧表示するアクセス許可を付与します 読み取り
DescribeSlackUserIdentities AWS Chatbot Slack ユーザー ID を記述する許可を付与 読み取り
DescribeSlackWorkspaces AWS Chatbot サービスでオンボーディングされた AWS アカウントに接続されているすべての承認された Slack ワークスペースを一覧表示するアクセス許可を付与します 読み取り
DisassociateFromConfiguration 設定からリソースの関連付けを解除するアクセス許可を付与します 書き込み

ChatbotConfiguration*

custom-action*

aws:ResourceTag/${TagKey}

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

custom-action*

aws:ResourceTag/${TagKey}

GetMicrosoftTeamsChannelConfiguration で単一の AWS Chatbot Microsoft Teams チャネル設定を取得する許可を付与 AWS アカウント 読み取り

aws:ResourceTag/${TagKey}

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

ChatbotConfiguration*

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

ChatbotConfiguration

custom-action

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource AWS Chatbot チャネル設定のタグを削除するアクセス許可を付与します Tagging

ChatbotConfiguration

custom-action

aws:TagKeys

UpdateAccountPreferences AWS Chatbot アカウント設定を更新する許可を付与 書き込み
UpdateChimeWebhookConfiguration AWS Chatbot Chime ウェブフック設定を更新する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

UpdateCustomAction カスタムアクションを更新するアクセス許可を付与します 書き込み

custom-action*

aws:ResourceTag/${TagKey}

UpdateMicrosoftTeamsChannelConfiguration AWS Chatbot Microsoft Teams チャネル設定を更新する許可を付与 書き込み

ChatbotConfiguration*

aws:ResourceTag/${TagKey}

UpdateSlackChannelConfiguration AWS Chatbot Slack チャネル設定を更新する許可を付与 書き込み

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