{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-pubsub/json-schema/google-cloud-pubsub-snapshot-schema.json",
  "title": "Snapshot",
  "description": "A snapshot resource. Snapshots are used in [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, which allow you to manage message acknowledgments in bulk. That is, you can set the acknowledgment state of messages in an existing subscription to the state captured by a snapshot.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-pubsub-pubsub-projects-api-openapi.yml#/components/schemas/Snapshot",
  "properties": {
    "labels": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Optional. See [Creating and managing labels]( https://cloud.google.com/pubsub/docs/labels).",
      "type": "object"
    },
    "topic": {
      "description": "Optional. The name of the topic from which this snapshot is retaining messages.",
      "type": "string"
    },
    "expireTime": {
      "description": "Optional. The snapshot is guaranteed to exist up until this time. A newly-created snapshot expires no later than 7 days from the time of its creation. Its exact lifetime is determined at creation by the existing backlog in the source subscription. Specifically, the lifetime of the snapshot is `7 days - (age of oldest unacked message in the subscription)`. For example, consider a subscription whose oldest unacked message is 3 days old. If a snapshot is created from this subscription, the snapshot -- which will always capture this 3-day-old backlog as long as the snapshot exists -- will expire in 4 days. The service will refuse to create a snapshot that would expire in less than 1 hour after creation.",
      "type": "string",
      "format": "google-datetime"
    },
    "name": {
      "type": "string",
      "description": "Optional. The name of the snapshot."
    }
  },
  "type": "object"
}