GetLink Method
Creates a link that provides access to a container, blob, or snapshot.
Syntax
public String getLink(String blob, String permissions, String startTime, String expiryTime);
Remarks
This method creates and returns a shared access signature (SAS), which is a link that provides access to a specific container, blob, or snapshot. The following table indicates which inputs must be provided to produce a link of the desired type:
Link Type | Required Inputs |
Container | Non-empty Container, empty Blob, any Snapshot (ignored) |
Blob | Non-empty Container and Blob, empty Snapshot |
Snapshot | Non-empty Container, Blob, and Snapshot |
Permissions specifies what permissions the SAS grants, in the form of an abbreviated permissions list. Refer to this section of Azure's "Create a Service SAS" article for more information about how to format this value.
StartTime and ExpiryTime specify the UTC start and end times of the SAS's validity interval. Refer to this section of Azure's "Create a Service SAS" article for more information about how to format these values.
StartTime may be empty, in which case the server will assume that the link is valid immediately. Permissions and ExpiryTime must both be non-empty, unless an si query parameter that references a stored access policy (which has corresponding non-empty values) is present in the QueryParams collection.
If any of the query parameters listed below are present in the QueryParams collection when this method is called, they will be included when creating the SAS. All other application-specified query parameters are ignored.
- Response headers: rscc, rscd, rsce, rscl, rsct
- IP address (single or range): sip
- Allowed HTTP protocol(s): spr
- Stored access policy ("signed identifier"): si
For more information about SAS links, refer to Azure's Create a Service SAS article.