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.exe access import cheesecake cheesecake.access

This should give you the following output:

Import from the input

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

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

Check list of Access grants

You can list your available accesses using:

./uplink.exe access list

./uplink.exe access list

CURRENT    NAME           SATELLITE
*          cheesecake     us1.storj.io:7777
           pumpkin-pie    us1.storj.io:7777
           tarte          us1.storj.io:7777

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.exe 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": "..."
  }
}

{
  "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.exe cp --access cheesecake sj://cakes/cheesecake.jpg .