dcache icon indicating copy to clipboard operation
dcache copied to clipboard

Request: show pins through API

Open onnozweers opened this issue 1 month ago • 2 comments

Dear dCache devs,

I would like to kindly request an option to show pin info of a file through the API. We have users (specifically from the LOFAR project) who would like to get an overview of all pins for a file and specifically their expiration timestamps. I could not find such info in the API on our fairly up-to-date dCache test instance.

I could think of two suitable API locations to expose this info:

  • /namespace - since almost all file info is there anyway;
  • /tape/archiveinfo - since it is tape oriented, and the Gfal software already uses the /tape call collection for tape operations, and I can imagine that one day some Gfal developer might like to add this capability to Gfal.

Not sure which location would be better.

Kind regards, Onno

onnozweers avatar Nov 17 '25 16:11 onnozweers

I think namespace would be proper, May be part of what is returned by:

/api/v1/namespace/<file name>?optional=true

DmitryLitvintsev avatar Nov 17 '25 20:11 DmitryLitvintsev

I have a question that is probably related (representing the Use case mentioned above): Apart from checking a pins status, we'd also like to be able to release a single pin, either by aborting the request, or directly. I could imagine this is essentially the same end point but with a DELETE rather than a GET.

ygrange avatar Dec 02 '25 22:12 ygrange