← Cloudflare Workers / workers / runtime-apis / bindings

Метаданные версии

Привязка метаданных версии позволяет получить доступ к метаданным, связанным с версия изнутри среды выполнения Workers.

ID версии, тег версии и время создания версии доступны через привязку метаданных версии. Их можно использовать в событиях, отправляемых в Workers Analytics Engine или в любую стороннюю систему аналитики/метрик для агрегации по версии Worker.

Чтобы использовать привязку метаданных версии, обновите файл Wrangler вашего Worker:

{
	"version_metadata": {
		"binding": "CF_VERSION_METADATA"
	}
}

[version_metadata]
binding = "CF_VERSION_METADATA"

Интерфейс

Пример того, как получить доступ к ID версии и тегу версии внутри Worker для отправки событий в Workers Analytics Engine:

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag, timestamp: versionTimestamp } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag, versionTimestamp],
      //...
    });
    //...
  },
};

interface Environment {
  CF_VERSION_METADATA: WorkerVersionMetadata;
  WAE: AnalyticsEngineDataset;
}

export default {
  async fetch(request, env, ctx) {
    const { id: versionId, tag: versionTag } = env.CF_VERSION_METADATA;
    env.WAE.writeDataPoint({
      indexes: [versionId],
      blobs: [versionTag],
      //...
    });
    //...
  },
} satisfies ExportedHandler<Env>;