Help > Azure > blob >
getsas
PreviousNext

  • Overview
  • Syntax
  • Arguments
  • Notes
  • Examples
  • Overview

    get shared access signature(s) for specified blob(s) or container

    Download ZappyShell

    Syntax

    getsas <BLOB_OR_CONTAINER> [<PERMISSION1>  <PERMISSION2>  <PERMISSION3>  <PER]
              MISSION4>  <PERMISSION5> ] [--start DATE_TIME] [--end DATE_TIME]
               [-o|--out SAVE_FILE_PATH] [--cont] [--region NAME] [--urlonly]
               [--exclude-olderthan INPUT] [--exclude-newerthan INPUT]
               [-r|--recursive] [-c|--continue-onerror] [--auth NAME]
               [--accesskey YOUR_ACCESS_KEY] [--secretkey YOUR_SECRET_KEY]
               [--serviceurl URL] [--threads COUNT] [--consoleout FILEPATH]
               [-v|--verbose] [-w|--wait] [-i|--interactive] 
    

    Arguments

    Parameter Description
    <BLOB_OR_CONTAINER>
    Container name or pattern of blob names for which you want to generate SAS
    <PERMISSION>
    Permission(s) for Shared Access Signature. It can be READ, WRITE, LIST or DELETE. Possible values are [READ|WRITE|LIST|DELETE]
    --start DATE_TIME
    Start datetime or just date when link should become available to access. Date format must be YYYY-MM-DD HH:MI:SS or YYYY-MM-DD. If you include Time part then enclose date and time in double quotes (e.g. "2014-12-31 23:59:59"). If you skip this parameter then current datetime is used
    --end DATE_TIME
    End datetime or just date when link should expire. Date format must be YYYY-MM-DD HH:MI:SS or YYYY-MM-DD. If you include Time part then enclose date and time in double quotes (e.g. "2014-12-31 23:59:59"). If you skip this parameter then link will not expire
    -o | --out SAVE_FILE_PATH
    Path where you want to save generated SAS list
    --cont
    Generate shared url for container. Treat Source path as container name
    --region NAME
    Region where requests should be redirected. If you don't specify region then all requests are first directed to US Standard Region (us-east-1) for name resolution. If you want to create new bucket in a specific region or you want to reduce latency in name resolution then specify this parameter.. Possible values are [us-west-1 | us-west-2 | eu-west-1 | eu-central-1 | ap-southeast-1 | ap-southeast-2 | ap-northeast-1 | sa-east-1]
    --urlonly
    generate only shared URL in output
    --exclude-olderthan
    Exclude files if they are older than specified period. You may use format specifier or exact date/datetime. Period format specifiers are d,h,m or s (days, hours, minutes or seconds). Example: 5d = (5 days), 5h=(5 hours), 5m=(5 hours), 5s=5s=(5 second), "2015-12-31 11:59:59"=(exact date+time), "2015-12-31"=(exact date)
    --exclude-newerthan
    Exclude files if they are newer than specified period. You may use format specifier or exact date/datetime. Period format specifiers are d,h,m or s (days, hours, minutes or seconds). Example: 5d = (5 days), 5h=(5 hours), 5m=(5 hours), 5s=5s=(5 second), "2015-12-31 11:59:59"=(exact date+time), "2015-12-31"=(exact date)
    -r | --recursive
    Scan recursive
    -c | --continue-onerror
    Continue on error such as specified file is missing at source
    --auth NAME
    Credential entry name. This entry name must exist (previously saved using setauth command)
    --accesskey YOUR_ACCESS_KEY
    Cloud account access key
    --secretkey YOUR_SECRET_KEY
    Cloud account secret key
    --serviceurl URL
    Service url for cloud service e.g. --serviceurl https://s3-us-west-2.amazonaws.com
    --threads COUNT
    Number of concurrent operations. If you don't specify then system will use default settings to optimize transfer.
    --consoleout FILEPATH
    Captures console output and saves to file
    -v | --verbose
    Log verbosity level. -v means detailed, If you don't specify this option then minimum logging will be done.
    -w | --wait
    Wait for user input before exit
    -i | --interactive
    Continue in interactive mode after this command is completed. This switch is not applicable if you already in interactive mode

    Notes

    Examples

    Examples
    Get shared access signatures for files starting with prefix vhd/win2008 in mycontainer with read and write permission and validity for Jan-1-2015 to Jan-31-2015.

    getsas /mycontainer/vhd/win2008*.vhd --full --start 2015-01-01 --end 2016-01-01 
    reset permission to default for specified container

    getsas mycontainer -r


    www.zappysys.com | Products | All copyrights reserved. ZappySys LLC.