yandex_kubernetes_cluster_iam_member (Resource)
Written by
Updated at September 18, 2025
Allows creation and management of a single binding within IAM policy for an existing cluster.
Example usage
//
// Create a new Managed Kubernetes cluster and a new IAM Member for it.
//
data "yandex_kubernetes_cluster" "my_cluster" {
name = "My Managed Kubernetes cluster"
}
resource "yandex_kubernetes_cluster_iam_member" "viewer" {
cluster_id = yandex_kubernetes_cluster.my_cluster.id
role = "viewer"
member = "userAccount:my_user_account_id"
}
Schema
Required
cluster_id(String) The ID of the computeclusterto attach the policy to.member(String) An array of identities that will be granted the privilege in therole. Each entry can have one of the following values:
- userAccount:{user_id}: A unique user ID that represents a specific Yandex account.
- serviceAccount:{service_account_id}: A unique service account ID.
- federatedUser:{federated_user_id}: A unique federated user ID.
- federatedUser:{federated_user_id}:: A unique SAML federation user account ID.
- group:{group_id}: A unique group ID.
- system:group:federation:{federation_id}:users: All users in federation.
- system:group:organization:{organization_id}:users: All users in organization.
- system:allAuthenticatedUsers: All authenticated users.
- system:allUsers: All users, including unauthenticated ones.
Warning
for more information about system groups, see Cloud Documentation.
role(String) The role that should be assigned. Only one yandex_kubernetes_cluster_iam_member can be used per role.
Optional
sleep_after(Number) For test purposes, to compensate IAM operations delay
Import
The resource can be imported by using their resource ID. For getting the resource ID you can use Yandex Cloud Web Console
# terraform import yandex_kubernetes_cluster_iam_member.<Resource Name> "<Cluster ID>,<Role>,<Subject>"
terraform import yandex_kubernetes_cluster_iam_member.viewer "cat7d**********46ehc,viewer,aje2z**********ddmec"