Skip to content

Touchclient

TouchClient(rucio_host=None, auth_host=None, account=None, ca_cert=None, auth_type=None, creds=None, timeout=600, user_agent='rucio-clients', vo=None, logger=LOG)

Touch client class to send a trace that can be used to update accessed_at for file or dataset DIDs

touch(scope, name, rse=None)

Sends a touch trace for a given file or dataset.

Parameters:

Name Type Description Default
scope str

the scope of the file/dataset to update.

required
name str

the name of file/dataset to update.

required
rse Optional[str]

optional parameter if a specific replica should be touched.

None

Raises:

Type Description
DataIdentifierNotFound

if given dids does not exist.

RSENotFound

if rse is not None and given rse does not exist.

UnsupportedDIDType

if type of the given DID is not FILE or DATASET.

RucioException

if trace could not be sent successfully.