The ManagedFolder resource represents a
[managed folder](https://docs.cloud.google.com/storage/docs/managed-folders.md.txt) in
Cloud Storage. You can apply IAM policies on a managed folder to control
access to the resources within the managed folder.

To try out the methods for this resource, see [Methods](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder.md.txt#methods).

## Resource representations

<br />

```
{
  "kind": "storage#managedFolder&quot;
  "id": string,
  "selfLink": string,
  "name&quot;: string,
  "bucket": string,
  "createTime": datetime,
  "updateTime": datetime,
  "metageneration": long
}
```

| Property name | Value | Description | Notes |
|---|---|---|---|
| `kind` | `string` | The kind of item this is. For managed folders, this is always "`storage#managedFolder`". |   |
| `id` | `string` | The ID of the managed folder, which is composed of the bucket name and managed folder name, expressed as a path. For example, `example-bucket/example-dir/example-dir2/`. |   |
| `selfLink` | `string` | The canonical URL of the managed folder. For example, `https://www.googleapis.com/storage/v1/b/example-bucket/managedFolders/example-dir/example-dir2/`. |   |
| `name` | `string` | The name of the managed folder, expressed as a path. For example, `example_dir/example_dir2/`. |   |
| `bucket` | `string` | The name of the bucket that contains the managed folder. |   |
| `createTime` | `datetime` | The time at which the managed folder was created, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). |   |
| `updateTime` | `datetime` | The time at which the managed folder's metadata or IAM policy was last updated, in [RFC 3339 format](https://datatracker.ietf.org/doc/html/rfc3339). |   |
| `metageneration` | `long`^1^ | The metadata generation of the managed folder. |   |

## Methods

[insert](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/insert.md.txt)
:   Create a managed folder.

[delete](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/delete.md.txt)
:   Permanently delete a managed folder.

[get](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/get.md.txt)
:   View a managed folder.

[getIamPolicy](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/getIamPolicy.md.txt)
:   View the IAM policy for a managed folder.

[list](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/list.md.txt)
:   Retrieves a list of managed folders under a given bucket.

[setIamPolicy](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/setIamPolicy.md.txt)
:   Update the IAM policy for a managed folder.

[testIamPermissions](https://docs.cloud.google.com/storage/docs/json_api/v1/managedFolder/testIamPermissions.md.txt)
:   Tests a set of permissions on a managed folder to see which, if any, are held by the caller.