View a markdown version of this page

Alexa for Business のアクション、リソース、および条件キー - サービス認可リファレンス

Alexa for Business のアクション、リソース、および条件キー

Alexa for Business (サービスプレフィックス: a4b) では、IAM アクセス許可ポリシーで使用できるように、以下のサービス固有のオペレーション、リソース、アクション、および条件キーが用意されています。

リファレンス:

Alexa for Business で定義されるアクション

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

アクション 説明 リソースタイプ (* 必須) 条件キー アクセスレベル

ApproveSkill

顧客の でスキルと組織を関連付けるアクセス許可を付与します AWS アカウント

書き込み

AssociateContactWithAddressBook

特定のアドレス帳に連絡先を関連付けるためのアクセス許可を付与

アドレス帳*

書き込み

連絡先*

AssociateDeviceWithNetworkProfile

指定されたネットワークプロファイルとデバイスを関連付けるためのアクセス許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

networkprofile*

AssociateDeviceWithRoom

特定のルームにデバイスを関連付けるためのアクセス許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

ルーム*

aws:ResourceTag/${TagKey}

AssociateSkillGroupWithRoom

特定のスキルグループにデバイスを関連付けるためのアクセス許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

スキルグループ*

AssociateSkillWithSkillGroup

スキルとスキルグループに関連付けるためのアクセス許可を付与

スキルグループ*

書き込み

AssociateSkillWithUsers

登録されたユーザーがデバイスで有効にするためにプライベートスキルを利用可能にする許可を付与

書き込み

CreateAddressBook

指定された詳細情報を持つアドレス帳を作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateBusinessReportSchedule

指定された S3 の場所に日次または週次の間隔で配信するために、使用状況レポートの定期的なスケジュールを作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateConferenceProvider

ユーザーの の下に新しい会議プロバイダーを追加するアクセス許可を付与します AWS アカウント

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateContact

指定された詳細情報を持つ連絡先を作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateGatewayGroup

指定された詳細でゲートウェイグループを作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateNetworkProfile

指定された詳細でネットワークプロファイルを作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateProfile

新しいプロファイルを作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateRoom

指定された詳細でルームを作成する許可を付与

プロファイル*

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateSkillGroup

指定した名前と説明でスキルグループを作成する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

CreateUser

ユーザーを作成する許可を付与

ユーザー*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

書き込み

DeleteAddressBook

アドレス帳 ARN によってアドレス帳を削除する許可を付与

アドレス帳*

書き込み

DeleteBusinessReportSchedule

指定されたスケジュール ARN を使用して定期的なレポート配信スケジュールを削除する許可を付与

スケジュール*

書き込み

DeleteConferenceProvider

会議プロバイダーを削除する許可を付与

カンファレンスプロバイダー*

書き込み

DeleteContact

連絡先 ARN によって連絡先を削除する許可を付与

連絡先*

書き込み

DeleteDevice

Alexa for Business からデバイスを削除する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

DeleteDeviceUsageData

デバイスの以前の音声入力データおよび関連する応答データの履歴全体を削除する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

DeleteGatewayGroup

ゲートウェイグループを削除する許可を付与

Gatewaygroup*

書き込み

DeleteNetworkProfile

ネットワークプロファイル ARN によってネットワークプロファイルを削除する許可を付与

networkprofile*

書き込み

DeleteProfile

プロファイル ARN によってプロファイルを削除する許可を付与

プロファイル*

書き込み

DeleteRoom

ルームを削除する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

DeleteRoomSkillParameter

スキルとルームからパラメータを削除する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

DeleteSkillAuthorization

スキルからサードパーティーアカウントのリンクを解除する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

DeleteSkillGroup

スキルグループ ARN を持つスキルグループを削除する許可を付与

スキルグループ*

書き込み

DeleteUser

ユーザーを削除する許可を付与

ユーザー*

aws:ResourceTag/${TagKey}

書き込み

DisassociateContactFromAddressBook

特定のアドレス帳から連絡先の関連付けを解除する許可を付与

アドレス帳*

書き込み

連絡先*

DisassociateDeviceFromRoom

現在のルームからデバイスの関連付けを解除する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

DisassociateSkillFromSkillGroup

スキルグループからスキルの関連付けを解除する許可を付与

スキルグループ*

書き込み

DisassociateSkillFromUsers

登録されたユーザー向けにプライベートスキルを利用不可にし、それらのユーザーによってデバイスでそのスキルが有効にされるのを防ぐためのアクセス許可を付与

ユーザー*

aws:ResourceTag/${TagKey}

書き込み

DisassociateSkillGroupFromRoom

特定のルームからスキルグループの関連付けを解除する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

スキルグループ*

ForgetSmartHomeAppliances

ルームに関連付けられたスマート家電を忘れるためのアクセス許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

GetAddressBook

アドレス帳 ARN によってアドレス帳の詳細を取得する許可を付与

アドレス帳*

読み取り

GetConferencePreference

既存の会議の詳細設定を取得する許可を付与

読み取り

GetConferenceProvider

特定の会議プロバイダーの詳細を取得する許可を付与

カンファレンスプロバイダー*

読み取り

GetContact

連絡先 ARN によって連絡先の詳細を取得する許可を付与

連絡先*

読み取り

GetDevice

デバイスの詳細を取得する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

読み取り

GetGateway

ゲートウェイの詳細を取得する許可を付与

ゲートウェイ*

読み取り

GetGatewayGroup

ゲートウェイグループの詳細を取得する許可を付与

Gatewaygroup*

読み取り

GetInvitationConfiguration

ユーザー登録の招待メールのテンプレート用に設定された値を取得する許可を付与

読み取り

GetNetworkProfile

ネットワークプロファイル ARN によってネットワークプロファイルの詳細を取得する許可を付与

networkprofile*

読み取り

GetProfile

プロファイル ARN で提供されている場合、プロファイルを取得する許可を付与

プロファイル*

読み取り

GetRoom

ルームの詳細を取得する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

読み取り

GetRoomSkillParameter

スキルやルームに設定されている既存のパラメータを取得する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

読み取り

GetSkillGroup

スキルグループ ARN でスキルグループの詳細を取得する許可を付与

スキルグループ*

読み取り

ListBusinessReportSchedules

ユーザーが設定したスケジュールの詳細を一覧表示する許可を付与

リスト

ListConferenceProviders

特定の で会議プロバイダーを一覧表示する許可を付与 AWS アカウント

リスト

ListDeviceEvents

デバイス接続ステータスなどのイベント履歴を最大 30 日間一覧表示する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

リスト

ListGatewayGroups

ゲートウェイグループの概要を一覧表示する許可を付与

リスト

ListGateways

ゲートウェイの概要を一覧表示する許可を付与

Gatewaygroup*

リスト

ListSkills

スキルを一覧表示する許可を付与

リスト

ListSkillsStoreCategories

Alexa スキルストア内のすべてのカテゴリを一覧表示する許可を付与

リスト

ListSkillsStoreSkillsByCategory

Alexa スキルストア内のすべてのスキルをカテゴリ別に一覧表示する許可を付与

リスト

ListSmartHomeAppliances

ルームに関連付けられたすべてのスマート家電を一覧表示する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

リスト

ListTags

リソースのすべてのタグを一覧表示する許可を付与

デバイス

aws:ResourceTag/${TagKey}

読み取り

ルーム

aws:ResourceTag/${TagKey}

user

aws:ResourceTag/${TagKey}

PutConferencePreference

特定の会議プロバイダーの会議の設定をアカウントレベルで行うためのアクセス許可を付与

書き込み

PutInvitationConfiguration

ユーザー登録の招待メールのテンプレートを指定された属性で設定する許可を付与

書き込み

PutRoomSkillParameter

スキルにルーム固有のパラメータを配置する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

PutSkillAuthorization

ユーザーのアカウントをサードパーティーのスキルプロバイダーにリンクする許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

RegisterAVSDevice

Alexa Voice Service (AVS) を使用して、相手先ブランド製造会社 (OEM) によって構築された Alexa 対応デバイスを登録する許可を付与

aws:RequestTag/${TagKey}

aws:TagKeys

書き込み

スキルRejectSkill

ユーザーの の下にある組織からスキルの関連付けを解除するアクセス許可を付与します AWS アカウント

書き込み

ResolveRoom

ルーム情報を解決する許可を付与

読み取り

RevokeInvitation

招待を撤回する許可を付与

ユーザー*

aws:ResourceTag/${TagKey}

書き込み

SearchAddressBooks

アドレス帳を検索し、一連のフィルターと並べ替え条件に合致するアドレス帳を一覧表示する許可を付与

リスト

SearchContacts

連絡先を検索し、一連のフィルターと並べ替え条件に合致するアドレス帳を一覧表示する許可を付与

リスト

SearchDevices

デバイスを検索する許可を付与

リスト

SearchNetworkProfiles

ネットワークプロファイルを検索し、一連のフィルターと並べ替え条件に合致するアドレス帳を一覧表示する許可を付与

リスト

SearchProfiles

プロファイルを検索する許可を付与

リスト

SearchRooms

ルームを検索する許可を付与

リスト

SearchSkillGroups

スキルグループを検索する許可を付与

リスト

SearchUsers

ユーザーを検索する許可を付与

リスト

SendAnnouncement

検索またはフィルターによって識別されたルームにテキスト、SSML、または音声アナウンスを送信する非同期フローをトリガーする許可を付与

書き込み

SendInvitation

ユーザーに招待を送信する許可を付与

ユーザー*

aws:ResourceTag/${TagKey}

書き込み

StartDeviceSync

以前のユーザーが設定した情報や設定をすべて消去して、デバイスとそのアカウントを既知のデフォルト設定に復元する許可を付与

書き込み

StartSmartHomeApplianceDiscovery

ルームに関連付けられたスマートホームアプライアンスの検出を開始する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

読み取り

TagResource

リソースにメタデータタグを追加する許可を付与

デバイス

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

タグ付け、書き込み

ルーム

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

user

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

UntagResource

リソースからメタデータタグを削除する許可を付与

デバイス

aws:ResourceTag/${TagKey}

タグ付け、書き込み

ルーム

aws:ResourceTag/${TagKey}

user

aws:ResourceTag/${TagKey}

UpdateAddressBook

アドレス帳 ARN によってアドレス帳の詳細を更新する許可を付与

アドレス帳*

書き込み

UpdateBusinessReportSchedule

指定されたスケジュール ARN を使用してレポート配信スケジュールの設定を更新する許可を付与

スケジュール*

書き込み

UpdateConferenceProvider

既存の会議プロバイダーの設定を更新する許可を付与

カンファレンスプロバイダー*

書き込み

UpdateContact

連絡先 ARN によって連絡先の詳細を更新する許可を付与

連絡先*

書き込み

UpdateDevice

デバイス名を更新する許可を付与

デバイス*

aws:ResourceTag/${TagKey}

書き込み

UpdateGateway

ゲートウェイの詳細を更新する許可を付与

ゲートウェイ*

書き込み

UpdateGatewayGroup

ゲートウェイグループの詳細を更新する許可を付与

Gatewaygroup*

書き込み

UpdateNetworkProfile

ネットワークプロファイル ARN によってネットワークプロファイルを更新する許可を付与

networkprofile*

書き込み

UpdateProfile

既存のプロファイルを更新する許可を付与

プロファイル*

書き込み

UpdateRoom

ルームの詳細を更新する許可を付与

ルーム*

aws:ResourceTag/${TagKey}

書き込み

UpdateSkillGroup

スキルグループ ARN を使用してスキルグループの詳細を更新する許可を付与

スキルグループ*

書き込み

Alexa for Business のアクセス許可のみのアクション

以下のアクションは Alexa for Business によって定義されますが、API オペレーションから直接呼び出すことはできません。アクセス許可を付与または拒否するには、IAM ポリシーステートメントでのみ使用できます。

アクション 説明 リソースタイプ (* 必須) 条件キー アクセスレベル

CompleteRegistration

Alexa デバイスの登録オペレーションを完了する許可を付与

書き込み

PutDeviceSetupEvents

Alexa デバイスセットアップイベントを発行する許可を付与

書き込み

RegisterDevice

Alexa デバイスを登録する許可を付与

書き込み

Alexa for Business で定義されるリソースタイプ

以下のリソースタイプは、このサービスによって定義され、IAM アクセス許可ポリシーステートメントの Resource エレメントで使用できます。

リソースタイプ: ARN 条件キー

アドレス帳

arn:${Partition}:a4b:${Region}:${Account}:address-book/${ResourceId}

カンファレンスプロバイダー

arn:${Partition}:a4b:${Region}:${Account}:conference-provider/${ResourceId}

連絡先

arn:${Partition}:a4b:${Region}:${Account}:contact/${ResourceId}

デバイス

arn:${Partition}:a4b:${Region}:${Account}:device/${ResourceId}

aws:ResourceTag/${TagKey}

ゲートウェイ

arn:${Partition}:a4b:${Region}:${Account}:gateway/${ResourceId}

ゲートウェイグループ

arn:${Partition}:a4b:${Region}:${Account}:gateway-group/${ResourceId}

ネットワークプロファイル

arn:${Partition}:a4b:${Region}:${Account}:network-profile/${ResourceId}

プロファイル

arn:${Partition}:a4b:${Region}:${Account}:profile/${ResourceId}

ルーム

arn:${Partition}:a4b:${Region}:${Account}:room/${ResourceId}

aws:ResourceTag/${TagKey}

スケジュール

arn:${Partition}:a4b:${Region}:${Account}:schedule/${ResourceId}

スキルグループ

arn:${Partition}:a4b:${Region}:${Account}:skill-group/${ResourceId}

ユーザー

arn:${Partition}:a4b:${Region}:${Account}:user/${ResourceId}

aws:ResourceTag/${TagKey}

Alexa for Business の条件キー

Alexa for Business では、IAM ポリシーの Condition 要素で使用できる以下の条件キーを定義します。

条件キー 説明 タイプ

a4b:amazonId

リクエスト内の Amazon ID に基づいてフィルタリングします。

String

a4b:filters_deviceType

リクエスト内のデバイスタイプに基づいてフィルタリングします。

ArrayOfString

aws:RequestTag/${TagKey}

各タグで許可されている値のセットに基づいてアクションをフィルタリングします

String

aws:ResourceTag/${TagKey}

リソースに関連付けられている tag-value に基づいてアクションをフィルタリングします

String

aws:TagKeys

リクエスト内の必須タグのプレゼンスに基づいてアクションをフィルタリングします

ArrayOfString