Storj IconSTORJ | DCS Docs
Import an Access to an Object

Import an Access to an Object #

Importing an access is done using the import command.

Import from the file #

./uplink.exe access import cheesecake cheesecake.access
uplink access import cheesecake ~/cheesecake.access
uplink access import cheesecake ~/cheesecake.access

This should give you the following output:

Import from the input #

./uplink.exe access import cheesecake 14dfgh....qr
uplink access import cheesecake 14dfgh....qr
uplink access import cheesecake 14dfgh....qr

Check list of Access grants #

You can list your available accesses using:

./uplink.exe access list
uplink access list
uplink access list
CURRENT    NAME           SATELLITE
*          cheesecake     us1.storj.io:7777
           pumpkin-pie    us1.storj.io:7777
           tarte          us1.storj.io:7777

To get more information on an access use the inspect command:

./uplink.exe access inspect cheesecake
uplink access inspect cheesecake
uplink access inspect cheesecake
{
  "satellite_addr": "12EayRS2V1kEsWESU9QMRseFhdxYxKicsiFmxrsLZHeLUtdps3S@us1.storj.io:7777",
  "encryption_access": {
    "default_path_cipher": "ENC_AESGCM"
  },
  "api_key": "...",
  "macaroon": {
    "head": "...",
    "caveats": [
      {
        "not_after": "2021-04-17T00:00:00Z",
        "not_before": "2021-04-18T00:00:00Z",
        "nonce": "..."
      }
    ],
    "tail": "..."
  }
}
There is no command to delete an access. You can delete an access directly in your configuration file.

How to use an Access grant with commands #

You can now use this access setting the --access flag. For example, to copy the shared object to your current directory you would use:

./uplink.exe cp --access cheesecake sj://cakes/cheesecake.jpg .
uplink cp --access cheesecake sj://cakes/cheesecake.jpg .
uplink cp --access cheesecake sj://cakes/cheesecake.jpg .