← Cloudflare Workers / workers / runtime-apis / bindings

Metadata verze

Vazbu na metadata verze lze použít k přístupu k metadatům přiřazeným k verze zevnitř runtime prostředí Workers.

ID verze, tag verze a časové razítko vytvoření verze jsou dostupné prostřednictvím version metadata bindingu. Lze je použít v událostech odesílaných do Workers Analytics Engine nebo do libovolné služby pro analytiku/metriky třetích stran za účelem agregace podle verze Workeru.

Chcete-li použít binding metadat verze, upravte soubor Wrangler pro daný Worker:

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

[version_metadata]
binding = "CF_VERSION_METADATA"

Rozhraní

Příklad, jak zevnitř Workeru přistupovat k ID verze a tagu verze a odesílat události do 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>;