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

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

リファレンス:

このサービスを設定する方法について説明します。
このサービスで使用可能な API オペレーションのリストを表示します。
IAM アクセス許可ポリシーを使用して、このサービスとそのリソースを保護する方法を学びます。

トピック

AWS CodeStar Connections で定義されるアクション
AWS CodeStar Connections で定義されるリソースタイプ
AWS CodeStar Connections の条件キー

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

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

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

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

注記

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

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

アクション	説明	アクセスレベル	リソースタイプ (* 必須)	条件キー	依存アクション
CreateConnection	接続リソースを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys codestar-connections:ProviderType
CreateHost	ホストリソースを作成する許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys codestar-connections:ProviderType
CreateRepositoryLink	リポジトリリンクを作成するためのアクセス許可を付与	書き込み	Connection*		codestar-connections:PassConnection codestar-connections:UseConnection
CreateRepositoryLink	リポジトリリンクを作成するためのアクセス許可を付与	書き込み		aws:RequestTag/${TagKey} aws:TagKeys
CreateSyncConfiguration	テンプレート同期設定を作成する許可を付与。	書き込み	RepositoryLink*		codestar-connections:PassRepository iam:PassRole
CreateSyncConfiguration	テンプレート同期設定を作成する許可を付与。	書き込み		codestar-connections:Branch
DeleteConnection	接続リソースを削除する許可を付与	書き込み	Connection*
DeleteHost	ホストリソースを削除する許可を付与	書き込み	Host*
DeleteRepositoryLink	リポジトリリンクを削除するためのアクセス許可を付与	書き込み	RepositoryLink*
DeleteSyncConfiguration	同期設定を削除するためのアクセス許可を付与	書き込み
GetConnection	接続リソースに関する詳細を取得する許可を付与	読み込み	Connection*
GetHost	ホストリソースに関する詳細を取得する許可を付与	読み込み	Host*
GetIndividualAccessToken [許可のみ]	Bitbucket アプリのインストールなど、サードパーティーを接続に関連付けるアクセス許可を付与	読み込み		codestar-connections:ProviderType	codestar-connections:StartOAuthHandshake
GetInstallationUrl [許可のみ]	Bitbucket アプリのインストールなど、サードパーティーを接続に関連付けるアクセス許可を付与	読み取り		codestar-connections:ProviderType
GetRepositoryLink	リポジトリリンクを記述するためのアクセス許可を付与	読み取り	RepositoryLink*
GetRepositorySyncStatus	リポジトリの最新の同期ステータスを取得する許可を付与。	読み取り	RepositoryLink*
GetRepositorySyncStatus	リポジトリの最新の同期ステータスを取得する許可を付与。	読み取り		codestar-connections:Branch
GetResourceSyncStatus	リソース (cfn スタックまたはその他のリソース) の最新の同期ステータスを取得するためのアクセス許可を付与	読み取り
GetSyncBlockerSummary	リソース (cfn スタックまたはその他のリソース) のサービス同期ブロッカーを説明するためのアクセス許可を付与	読み取り
GetSyncConfiguration	同期設定を記述するためのアクセス許可を付与	読み取り
ListConnections	接続リソースを一覧表示する許可を付与	リスト	Connection*
ListConnections	接続リソースを一覧表示する許可を付与	リスト		codestar-connections:ProviderTypeFilter
ListHosts	ホストリソースを一覧表示する許可を付与	リスト		codestar-connections:ProviderTypeFilter
ListInstallationTargets [許可のみ]	Bitbucket アプリのインストールなど、サードパーティーを接続に関連付けるアクセス許可を付与	リスト			codestar-connections:GetIndividualAccessToken codestar-connections:StartOAuthHandshake
ListRepositoryLinks	リポジトリリンクを一覧表示するためのアクセス許可を付与	リスト
ListRepositorySyncDefinitions	リポジトリ同期定義を一覧表示する許可を付与。	リスト
ListSyncConfigurations	リポジトリリンクの同期設定を一覧表示するためのアクセス許可を付与	リスト
ListTagsForResource	リソースの管理に使用されるキーと値のペアのセットへの許可を付与	リスト	Connection
			Host
			RepositoryLink
PassConnection [アクセス許可のみ]	codepipeline などの接続 ARN を入力として受け入れる AWS サービスに接続リソースを渡すアクセス許可を付与します。CreatePipeline	読み取り	Connection*
PassConnection [アクセス許可のみ]		読み取り		codestar-connections:PassedToService
PassRepository [アクセス許可のみ]	codestar-connections などの入力 RepositoryLinkId としてを受け入れる AWS サービスにリポジトリリンクリソースを渡すアクセス許可を付与します。CreateSyncConfiguration	読み取り	RepositoryLink*
PassRepository [アクセス許可のみ]		読み取り		codestar-connections:PassedToService
RegisterAppCode [アクセス許可のみ]	GitHub Enterprise Server インスタンスなどのサードパーティーサーバーをホストに関連付けるアクセス許可を付与します	読み取り		codestar-connections:HostArn
StartAppRegistrationHandshake [アクセス許可のみ]	GitHub Enterprise Server インスタンスなどのサードパーティーサーバーをホストに関連付けるアクセス許可を付与します	読み取り		codestar-connections:HostArn
StartOAuthHandshake [許可のみ]	Bitbucket アプリのインストールなど、サードパーティーを接続に関連付けるアクセス許可を付与	読み取り		codestar-connections:ProviderType
TagResource	指定されたリソースのタグに追加または変更する許可を付与	タグ付け	Connection
			Host
			RepositoryLink
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	AWS リソースからタグを削除する許可を付与	タグ付け	Connection
			Host
			RepositoryLink
				aws:TagKeys
UpdateConnectionInstallation	Connections アプリのインストールで CodeStar Connection リソースを更新する許可を付与	書き込み	Connection*		codestar-connections:GetIndividualAccessToken codestar-connections:GetInstallationUrl codestar-connections:ListInstallationTargets codestar-connections:StartOAuthHandshake
UpdateConnectionInstallation	Connections アプリのインストールで CodeStar Connection リソースを更新する許可を付与	書き込み		codestar-connections:InstallationId
UpdateHost	ホストリソースを更新するアクセス許可を付与	書き込み	Host*
UpdateRepositoryLink	リポジトリリンクを更新するためのアクセス許可を付与	書き込み	RepositoryLink*
UpdateSyncBlocker	リソース (cfn スタックまたはその他のリソース) の同期ブロッカーを更新するためのアクセス許可を付与	書き込み
UpdateSyncConfiguration	同期設定を更新するためのアクセス許可を付与	書き込み		codestar-connections:Branch
UseConnection [許可のみ]	接続リソースを使用してプロバイダーのアクションを呼び出すアクセス許可を付与	読み取り	Connection*
UseConnection [許可のみ]	接続リソースを使用してプロバイダーのアクションを呼び出すアクセス許可を付与	読み取り		codestar-connections:BranchName codestar-connections:FullRepositoryId codestar-connections:OwnerId codestar-connections:ProviderAction codestar-connections:ProviderPermissionsRequired codestar-connections:RepositoryName

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

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

リソースタイプ	ARN	条件キー
Connection	`arn:${Partition}:codestar-connections:${Region}:${Account}:connection/${ConnectionId}`	aws:ResourceTag/${TagKey}
Host	`arn:${Partition}:codestar-connections:${Region}:${Account}:host/${HostId}`	aws:ResourceTag/${TagKey}
RepositoryLink	`arn:${Partition}:codestar-connections:${Region}:${Account}:repository-link/${RepositoryLinkId}`	aws:ResourceTag/${TagKey}

AWS CodeStar Connections の条件キー

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

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

条件キー	説明	タイプ
aws:RequestTag/${TagKey}	リクエストで渡されたタグでアクセスをフィルタリングします	文字列
aws:ResourceTag/${TagKey}	リソースに関連付けられたタグでアクセスをフィルタリングします	文字列
aws:TagKeys	リクエストで渡されたタグキーでアクセスをフィルタリングします	ArrayOfString
codestar-connections:Branch	リクエストで渡されたブランチ名でアクセスをフィルタリングします	文字列
codestar-connections:BranchName	リクエストで渡されたブランチ名でアクセスをフィルタリングします特定のリポジトリブランチへのアクセス UseConnection リクエストにのみ適用されます	文字列
codestar-connections:FullRepositoryId	リクエストで渡されたリポジトリによるアクセスをフィルタリングします。特定のリポジトリへのアクセス UseConnection リクエストにのみ適用されます	文字列
codestar-connections:HostArn	リクエストで使用された接続に関連付けられたホストリソースによってアクセスをフィルタリングします	ARN
codestar-connections:InstallationId	接続の更新に使用されるサードパーティー ID ( CodeStar Connections の Bitbucket アプリのインストール ID など) でアクセスをフィルタリングします。Connection を作成するために使用できるサードパーティー製アプリのインストールを制限できます。	文字列
codestar-connections:OwnerId	サードパーティーのリポジトリの所有者によるアクセスをフィルタリングします。特定のユーザーが所有するリポジトリへのアクセス UseConnection リクエストにのみ適用されます	文字列
codestar-connections:PassedToService	プリンシパルが接続またはを渡すことが許可されているサービスによってアクセスをフィルタリングします RepositoryLink	文字列
codestar-connections:ProviderAction	などの UseConnection リクエストでプロバイダーアクションによってアクセスをフィルタリングします ListRepositories。すべての有効な値については、ドキュメントを参照してください。	ArrayOfString
codestar-connections:ProviderPermissionsRequired	UseConnection リクエスト内のプロバイダーアクションの書き込みアクセス許可でアクセスをフィルタリングします。有効なタイプには、読み取り専用と読み取り書き込みがあります。	文字列
codestar-connections:ProviderType	リクエストで渡されたサードパーティープロバイダーのタイプによってアクセスをフィルタリングします。	文字列
codestar-connections:ProviderTypeFilter	結果をフィルタリングするために使用されるサードパーティープロバイダーのタイプによってアクセスをフィルタリングします。	文字列
codestar-connections:RepositoryName	リクエストで渡されたリポジトリ名でアクセスをフィルタリングします。特定のユーザーが所有するリポジトリへのアクセス UseConnection リクエストにのみ適用されます	文字列

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS CodeStar

AWS CodeStar 通知