Versions Compared

Old Version 12

changes.mady.by.user Mohammed Iqbal

Saved on

compared with

New Version Current

changes.mady.by.user Lakshmi Manda

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page

Table of Contents
maxLevel3

Overview

This Snap generates a SAS (Shared Access Signature) URI that enable you to access Azure Storage containers or blobs for a specified period. You can use this URI with other Snaps, such as File Writer or File Reader, to interact with the files in the Azure Storage container or blob. See Using SAS for more information on SAS. 

Depending upon the Snap's configuration, you can either access all blobs in a container, or a specific blob in a container. See Snap Settings for more information.

SAS Type Compatibility Chart

Snap NameService SAS On ContainerService SAS On BlobAccount SAS
Directory BrowserYesNoNo
File DeleteYesYesNo
File OperationYesNoYes
File PollerYesNoNo
File ReaderYesYesYes
File WriterYesYesYes
Multi File ReaderYesNoNo
ZipFile ReadYesYesYes
ZipFile WriteYesYesYes

Input and Output

  • Expected input: A document containing the key/value pairs required for populating the expression properties in the Snap. 

  • Expected output: A document containing two fields, SasType and SasUri. The following is a sample output document:

    Paste code macro
    {
“SasType” : “Service SAS on container”,

“SasUri”  : “https://snapqa.blob.core.windows.net/testdata?sig=lnqwQPgOKtN1dm1

CHV5cPxUDBHuxOkYz0nWkq%2Fz9dBI%3D&st=2019-06-25T19%3A59

%3A03Z&se=2019-06-25T20%3A09%3A03Z&sv=2018-11-09&sp=rwdl

&sr=c"

}


  • Expected upstream Snaps: Any Snap with a document output view. For example, Mapper, Copy, etc.

  • Expected downstream Snaps: Compatible Snaps with a document input view. For example, File Reader, Directory Browser, and Multi File Reader.

Prerequisites

  • None.

Configuring Accounts

This Snap uses account references created on the Accounts page of the SnapLogic Manager to handle access to this endpoint. This Snap requires an Azure Storage account. See Configuring Binary Accounts for information on setting up accounts that work with this Snap.

Configuring Views

Input

This Snap has at most one optional document input view. It may contain values to evaluate expression properties in SAS Generator Snap.
OutputThis Snap has exactly one output view.
ErrorThis Snap has at most one document error view.

Troubleshooting

  • None.

Support

  • Works in Ultra Pipelines.

Known Issues

  • None.

Snap Settings

nameAnaplan Read

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Default Value: Execute only
Example: Validate & Execute

LabelRequired. The name for the Snap. Modify this to be more specific, especially if there are more than one of the same Snap in the Pipeline.
Container

The name of the Azure Storage container that you want to access. Enter the name or select one suggested by the Snap. This property is required for Service SAS on container and Service SAS on blob.
Examples: testcontainer
Default value: N/A

Note

The container's name must always be in lowercase. See Referencing Containers and Blobs for more information.


Blob

The name of the Azure Storage blob that you want to access. Enter the name or select one suggested by the Snap. Blob name should be a relative path in the container.
Examples:

  • testblob
  • abc.csv
  • testblob/abc.csv

Default value: N/A

Note

Leave this property blank to access all the blobs in the specified container.


Protocol

The protocol over which Azure Storage permits access to the client using the SAS URI. Available options are:

  • https: For WASBS
  • http: For WASB

Default value: https

SAS Permissions

Select the file-access permissions that you want to assign to users of the SAS URI. See Specifying Permissions for more information.

Available options are:

  • READ: permission to read a blob
  • WRITE: permission to create or overwrite a blob
  • LIST: permission to list a directory
  • CREATE: permission to create a blob (cannot overwrite an existing blob)
  • DELETE: permission to delete a blob

Default value: READ, WRITE, LIST, DELETE

Expire in (hours)

Specifies the validity of the SAS URI in hours. Configure this property and the Expire in (minutes) property to specify the total duration of the URI's validity.
Example: 3
Minimum value: 0
Default value: 0

Expire in (minutes)Specifies the expire time in minutes. 
Example: 10
Minimum value: 0
Default value: 1
Multiexcerpt include macro
Snap Execution
pageSOAP Execute
Multiexcerpt include macro
nameSnap_Execution_Introduced
page

Understanding the SAS URI Validity

The validity of the SAS URI is determined by the values in the Expire in (hours) and Expire in (minutes) properties. For example, if the SAS Generator Snap is configured as shown below, the validity of the SAS URI generated by the Snap is 3 hours and 43 minutes. 

See Also

Insert excerpt
Binary Snap Pack
Binary Snap Pack
nopaneltrue