[Документация Yandex Cloud](../../index.md) > [Terraform в Yandex Cloud](../index.md) > Справочник Terraform > Ресурсы (англ.) > Object Storage > Resources > storage_bucket_iam_binding

# yandex_storage_bucket_iam_binding (Resource)

Allows creation and management of a single binding within IAM policy for an existing `Bucket`.

{% note warning %}

**Warning:** This resource is authoritative for the given `role` on the target `Bucket` and manages the complete set of its members. When you change or delete `yandex_storage_bucket_iam_binding`, the `role` may be removed from other subjects on the `Bucket` as well — including subjects granted outside of this resource (via the corresponding `*_iam_member` resource, the management console, CLI or API). Those subjects are not tracked in the Terraform state, so a plain `terraform plan` does not list them. Be careful.

{% endnote %}


## Example usage

```terraform
//
// Create a new Object Storage (S3) Bucket IAM Binding.
//
resource "yandex_storage_bucket_iam_binding" "bucket-iam" {
  bucket = "your-bucket-name"
  role      = "storage.admin"

  members = [
    "system:allUsers",
  ]
}
```

## Arguments & Attributes Reference

- `bucket` (**Required**)(String). The name of the Object Storage (S3) bucket to attach the policy to. This resource should be used for managing [Service roles](../../storage/security/index.md#service-roles) only.
- `members` (**Required**)(Set Of String). An array of identities that will be granted the privilege in the `role`. 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.

{% note warning %}

for more information about system groups, see [Cloud Documentation](../../iam/concepts/access-control/system-group.md).

{% endnote %}



- `role` (**Required**)(String). The role that should be assigned. Only one yandex_storage_bucket_iam_binding can be used per role.

## Import

The resource can be imported by using their `resource ID`. For getting it you can use Yandex Cloud [Web Console](https://console.yandex.cloud) or Yandex Cloud [CLI](../../cli/quickstart.md).

```shell
# terraform import yandex_storage_bucket_iam_binding.<resource Name> "<resource Id> <resource Role>"
terraform import yandex_storage_bucket_iam_binding.bucket-iam "... storage.admin"
```