本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
AWS CodeStar Connections 的動作、資源和條件索引鍵
AWS CodeStar Connections （服務字首：codestar-connections) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
AWS CodeStar Connections 定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| CreateConnection | 授予建立 Connection 資源的許可 | 寫入 | |||
| CreateHost | 授予主機資源的建立許可 | 寫入 | |||
| CreateRepositoryLink | 准許建立儲存庫連結 | 寫入 |
codestar-connections:PassConnection codestar-connections:UseConnection |
||
| CreateSyncConfiguration | 准許建立範本同步組態 | 寫入 |
codestar-connections:PassRepository iam:PassRole |
||
| DeleteConnection | 授予刪除 Connection 資源的許可 | 寫入 | |||
| DeleteHost | 授予主機資源的刪除許可 | 寫入 | |||
| DeleteRepositoryLink | 准許刪除儲存庫連結 | 寫入 | |||
| DeleteSyncConfiguration | 准許刪除同步組態 | 寫入 | |||
| GetConnection | 授予取得 Connection 資源詳細資訊的許可 | 讀取 | |||
| GetConnectionToken [僅限許可] | 准許取得 Connection 權杖來呼叫提供者動作 | 讀取 | |||
| GetHost | 授予取得主機資源詳細資訊的許可 | 讀取 | |||
| GetIndividualAccessToken [僅限許可] | 准許為第三方 (例如 Bitbucket 應用程式安裝) 與 Connection 建立關聯 | 讀取 |
codestar-connections:StartOAuthHandshake |
||
| GetInstallationUrl [僅限許可] | 准許為第三方 (例如 Bitbucket 應用程式安裝) 與 Connection 建立關聯 | 讀取 | |||
| GetRepositoryLink | 准許描述儲存庫連結 | 讀取 | |||
| GetRepositorySyncStatus | 准許取得儲存庫最新同步狀態 | 讀取 | |||
| GetResourceSyncStatus | 准許取得資源 (cfn 堆疊或其他資源) 的最新同步狀態 | 讀取 | |||
| GetSyncBlockerSummary | 准許描述資源 (cfn 堆疊或其他資源) 上的服務同步封鎖程式 | 讀取 | |||
| GetSyncConfiguration | 准許描述同步組態 | 讀取 | |||
| ListConnections | 授予列出 Connection 資源的許可 | 列出 | |||
| ListHosts | 授予主機資源的列出許可 | 列出 | |||
| ListInstallationTargets [僅限許可] | 准許為第三方 (例如 Bitbucket 應用程式安裝) 與 Connection 建立關聯 | 清單 |
codestar-connections:GetIndividualAccessToken codestar-connections:StartOAuthHandshake |
||
| ListRepositoryLinks | 准許列出儲存庫連結 | 清單 | |||
| ListRepositorySyncDefinitions | 准許列出儲存庫同步定義 | 清單 | |||
| ListSyncConfigurations | 准許列出儲存庫連結的同步組態 | 清單 | |||
| ListTagsForResource | 准許用來管理資源的鍵值對組 | 清單 | |||
| PassConnection [僅限許可] | 准許將 Connection 資源傳遞至接受 Connection ARN 作為輸入的 AWS 服務，例如 Codepipeline：CreatePipeline | 讀取 | |||
| PassRepository [僅限許可] | 准許將儲存庫連結資源傳遞至接受 a RepositoryLinkId 作為輸入的 AWS 服務，例如 codestar-connections：CreateSyncConfiguration | 讀取 | |||
| RegisterAppCode [僅限許可] | 准許將第三方伺服器，例如 a GitHub Enterprise Server 執行個體與主機建立關聯 | 讀取 | |||
| StartAppRegistrationHandshake [僅限許可] | 准許將第三方伺服器，例如 a GitHub Enterprise Server 執行個體與主機建立關聯 | 讀取 | |||
| StartOAuthHandshake [僅限許可] | 准許為第三方 (例如 Bitbucket 應用程式安裝) 與 Connection 建立關聯 | 讀取 | |||
| TagResource | 准許新增或修改給定資源的標籤 | 標記 | |||
| UntagResource | 准許從 AWS 資源中移除標籤 | 標記 | |||
| UpdateConnectionInstallation | 准許使用安裝的 CodeStar Connections 應用程式更新 Connection 資源 | 寫入 |
codestar-connections:GetIndividualAccessToken codestar-connections:GetInstallationUrl codestar-connections:ListInstallationTargets codestar-connections:StartOAuthHandshake |
||
| UpdateHost | 准許更新主機資源 | 寫入 | |||
| UpdateRepositoryLink | 准許更新儲存庫連結 | 寫入 | |||
| UpdateSyncBlocker | 准許更新資源 (cfn 堆棧或其他資源) 的同步封鎖程式 | 寫入 | |||
| UpdateSyncConfiguration | 准許更新同步組態 | 寫入 | |||
| UseConnection [僅限許可] | 授予使用 Connection 資源呼叫提供者動作的許可 | 讀取 | |||
|
codestar-connections:BranchName codestar-connections:FullRepositoryId codestar-connections:ProviderAction |
AWS CodeStar Connections 定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| Connection |
arn:${Partition}:codestar-connections:${Region}:${Account}:connection/${ConnectionId}
|
|
| Host |
arn:${Partition}:codestar-connections:${Region}:${Account}:host/${HostId}
|
|
| RepositoryLink |
arn:${Partition}:codestar-connections:${Region}:${Account}:repository-link/${RepositoryLinkId}
|
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 （例如 Bitbucket App 安裝 ID for CodeStar Connections) 篩選存取權。可讓您限制哪些第三方應用程式安裝可以用來建立 Connection | 字串 |
| codestar-connections:OwnerId | 根據第三方儲存庫的擁有者來篩選存取 僅適用於存取特定使用者所擁有儲存庫的 UseConnection 請求 | 字串 |
| codestar-connections:PassedToService | 依允許主體傳遞 Connection 或 RepositoryLink 的服務篩選存取權 | 字串 |
| codestar-connections:ProviderAction | 依提供者動作在 a UseConnection 請求中篩選存取權，例如 ListRepositories。請參閱文件以了解所有有效值 | ArrayOfString |
| codestar-connections:ProviderPermissionsRequired | 依 a UseConnection 請求中提供者動作的寫入許可篩選存取權。有效類型包括 read_only 和 read_write | 字串 |
| codestar-connections:ProviderType | 根據請求中傳遞的第三方提供者類型來篩選存取 | 字串 |
| codestar-connections:ProviderTypeFilter | 根據用來篩選結果的第三方提供者類型來篩選存取 | 字串 |
| codestar-connections:RepositoryName | 根據請求中傳遞的儲存庫名稱來篩選存取。僅適用於存取特定使用者所擁有儲存庫的 UseConnection 請求 | 字串 |
