Struct taskcluster::PurgeCache

pub struct PurgeCache(_);

Purge Cache Service

The purge-cache service is responsible for tracking cache-purge requests.

User create purge requests for specific caches on specific workers, and these requests are timestamped. Workers consult the service before starting a new task, and purge any caches older than the timestamp.

Implementations

impl PurgeCache

pub fn new<CB: Into<ClientBuilder>>(client_builder: CB) -> Result<Self, Error>

Create a new undefined instance, based on the given client.

pub async fn ping(&self) -> Result<(), Error>

Ping Server

Respond without doing anything. This endpoint is used to check that the service is up.

pub fn ping_url(&self) -> Result<String, Error>

Generate an unsigned URL for the ping endpoint

pub fn ping_signed_url(&self, ttl: Duration) -> Result<String, Error>

Generate a signed URL for the ping endpoint

pub async fn purgeCache(
    &self,
    workerPoolId: &str,
    payload: &Value
) -> Result<(), Error>

Purge Worker Cache

Publish a request to purge caches named cacheName with on workerPoolId workers.

If such a request already exists, its before timestamp is updated to the current time.

pub async fn allPurgeRequests(
    &self,
    continuationToken: Option<&str>,
    limit: Option<&str>
) -> Result<Value, Error>

All Open Purge Requests

View all active purge requests.

This is useful mostly for administors to view the set of open purge requests. It should not be used by workers. They should use the purgeRequests endpoint that is specific to their workerType and provisionerId.

pub fn allPurgeRequests_url(
    &self,
    continuationToken: Option<&str>,
    limit: Option<&str>
) -> Result<String, Error>

Generate an unsigned URL for the allPurgeRequests endpoint

pub fn allPurgeRequests_signed_url(
    &self,
    continuationToken: Option<&str>,
    limit: Option<&str>,
    ttl: Duration
) -> Result<String, Error>

Generate a signed URL for the allPurgeRequests endpoint

pub async fn purgeRequests(
    &self,
    workerPoolId: &str,
    since: Option<&str>
) -> Result<Value, Error>

Open Purge Requests for a worker pool

List the caches for this workerPoolId that should to be purged if they are from before the time given in the response.

This is intended to be used by workers to determine which caches to purge.

pub fn purgeRequests_url(
    &self,
    workerPoolId: &str,
    since: Option<&str>
) -> Result<String, Error>

Generate an unsigned URL for the purgeRequests endpoint

pub fn purgeRequests_signed_url(
    &self,
    workerPoolId: &str,
    since: Option<&str>,
    ttl: Duration
) -> Result<String, Error>

Generate a signed URL for the purgeRequests endpoint