ManagedFolders

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/gcp-cloud-storage/json-schema/gcp-cloud-storage-managed-folders-schema.json",
  "title": "ManagedFolders",
  "description": "A list of managed folders.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/gcp-cloud-storage-managedfolders-api-openapi.yml#/components/schemas/ManagedFolders",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "The list of items.",
      "items": {
        "$ref": "#/$defs/ManagedFolder"
      }
    },
    "kind": {
      "type": "string",
      "description": "The kind of item this is. For lists of managed folders, this is always storage#managedFolders.",
      "default": "storage#managedFolders"
    },
    "nextPageToken": {
      "type": "string",
      "description": "The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results."
    }
  },
  "$defs": {
    "ManagedFolder": {
      "type": "object",
      "description": "A managed folder.",
      "properties": {
        "bucket": {
          "type": "string",
          "description": "The name of the bucket containing this managed folder."
        },
        "id": {
          "type": "string",
          "description": "The ID of the managed folder, including the bucket name and managed folder name."
        },
        "kind": {
          "type": "string",
          "description": "The kind of item this is. For managed folders, this is always storage#managedFolder.",
          "default": "storage#managedFolder"
        },
        "metageneration": {
          "type": "string",
          "description": "The version of the metadata for this managed folder. Used for preconditions and for detecting changes in metadata.",
          "format": "int64"
        },
        "name": {
          "type": "string",
          "description": "The name of the managed folder. Required if not specified by URL parameter."
        },
        "selfLink": {
          "type": "string",
          "description": "The link to this managed folder."
        },
        "createTime": {
          "type": "string",
          "description": "The creation time of the managed folder in RFC 3339 format.",
          "format": "date-time"
        },
        "updateTime": {
          "type": "string",
          "description": "The last update time of the managed folder metadata in RFC 3339 format.",
          "format": "date-time"
        },
        "rapidCacheConfig": {
          "$ref": "#/$defs/RapidCacheConfig"
        }
      }
    },
    "RapidCacheConfig": {
      "type": "object",
      "description": "Configuration options for the rapid cache of a managed folder.",
      "properties": {
        "policies": {
          "type": "object",
          "description": "A map of rapid cache IDs to the corresponding `RapidCachePolicy` configurations for a managed folder.",
          "additionalProperties": {
            "$ref": "#/$defs/RapidCachePolicy"
          }
        }
      }
    },
    "RapidCachePolicy": {
      "type": "object",
      "description": "The rapid cache policy configuration for a managed folder.",
      "properties": {
        "rapidCacheId": {
          "type": "string",
          "description": "The unique identifier of the rapid cache."
        },
        "ingestOnWrite": {
          "type": "string",
          "description": "The ingest-on-write policy for objects in the managed folder. When set to `enabled`, objects are automatically ingested into the cache when they are written to the managed folder.",
          "enum": [
            "enabled",
            "unspecified"
          ],
          "x-enumDescriptions": [
            "Ingestion on write is explicitly enabled for the managed folder.",
            "Ingestion on write isn't specified at the managed folder level and is inherited from the parent resource's configuration. This is the default value."
          ]
        }
      }
    }
  }
}