SASQueryParameters class
代表組成 Azure 儲存體 SAS 查詢參數的元件。 使用者不會直接建構此類型;它只會由 <xref:AccountSASSignatureValues> 和 <xref:BlobSASSignatureValues> 型別產生。 產生之後,就可以將它編碼為 <xref:String> ,並直接附加至 URL (不過,如果有現有的查詢參數,這可能會影響附加這些查詢參數的適當方法) 。 注意:此類別的實例是不可變的。
建構函式
屬性
cache |
Blob/檔案服務 SAS 中快取控制標頭的值。 |
content |
Blob/檔案服務 SAS 中內容處置標頭的值。 |
content |
Blob/檔案服務 SAS 中內容編碼標頭的值。 |
content |
Blob/檔案服務 SAS 中內容長度標頭的值。 |
content |
Blob/檔案服務 SAS 中內容類型標頭的值。 |
correlation |
將記錄在儲存體診斷記錄中的 GUID 值,可用來將 SAS 產生與儲存體資源存取相互關聯。 這只適用于使用者委派 SAS。 |
expires |
只有在提供識別碼時,才為選擇性。 此 SAS 權杖的到期時間。 |
identifier | 選擇性。 簽署的識別碼 (僅適用于 <xref:BlobSASSignatureValues>) 。 |
ip |
選擇性。 此 SAS 允許的 IP 範圍。 |
permissions | 只有在提供識別碼時,才為選擇性。 如需詳細資訊,請參閱 <xref:AccountSASPermissions> 、 <xref:BlobSASPermissions> 或 <xref:ContainerSASPermissions> 。 |
preauthorized |
GUID 格式的授權 AAD 物件識別碼。 使用者委派金鑰擁有者授權的使用者 AAD 物件識別碼,以執行 SAS 授與的動作。 Azure 儲存體服務會確保使用者委派金鑰的擁有者具有必要的許可權,再授與存取權,但不會執行此值中所指定使用者的額外許可權檢查。 這只適用于使用者委派 SAS。 |
protocol | 選擇性。 允許的 HTTP 通訊協定 () 。 |
resource | 選擇性。 指定哪些資源只能透過 SAS (存取 <xref:BlobSASSignatureValues>) 。 |
resource |
選擇性。 只有帳戶 SAS) 才能存取儲存體資源類型 (。 如需詳細資訊, <xref:AccountSASResourceTypes> 請參閱 。 |
services | 選擇性。 只有帳戶 SAS) 才能存取儲存體服務 (。 如需詳細資訊, <xref:AccountSASServices> 請參閱 。 |
signature | SAS 權杖的簽章。 |
starts |
選擇性。 此 SAS 權杖的開始時間。 |
version | 儲存體 API 版本。 |
方法
to |
將所有 SAS 查詢參數編碼為可附加至 URL 的字串。 |
建構函式詳細資料
SASQueryParameters(string, string, SASQueryParametersOptions)
建立 SASQueryParameters 的實例。
new SASQueryParameters(version: string, signature: string, options?: SASQueryParametersOptions)
參數
- version
-
string
代表儲存體版本
- signature
-
string
表示 SAS 權杖的簽章
- options
- SASQueryParametersOptions
選擇性。 建構 SASQueryParameters 的選項。
SASQueryParameters(string, string, string, string, string, SASProtocol, Date, Date, SasIPRange, string, string, string, string, string, string, string, UserDelegationKey, string, string)
建立 SASQueryParameters 的實例。
new SASQueryParameters(version: string, signature: string, permissions?: string, services?: string, resourceTypes?: string, protocol?: SASProtocol, startsOn?: Date, expiresOn?: Date, ipRange?: SasIPRange, identifier?: string, resource?: string, cacheControl?: string, contentDisposition?: string, contentEncoding?: string, contentLanguage?: string, contentType?: string, userDelegationKey?: UserDelegationKey, preauthorizedAgentObjectId?: string, correlationId?: string)
參數
- version
-
string
代表儲存體版本
- signature
-
string
表示 SAS 權杖的簽章
- permissions
-
string
代表儲存體許可權
- services
-
string
只代表帳戶 SAS) 存取的儲存體服務 (
- resourceTypes
-
string
表示只有帳戶 SAS) 才能存取的儲存體資源類型 (
- protocol
- SASProtocol
表示允許的 HTTP 通訊協定 ()
- startsOn
-
Date
表示此 SAS 權杖的開始時間
- expiresOn
-
Date
表示此 SAS 權杖的到期時間
- ipRange
- SasIPRange
表示此 SAS 權杖的有效 IP 位址範圍
- identifier
-
string
僅代表服務 SAS) 的已簽署識別碼 (
- resource
-
string
僅代表服務 SAS) 的儲存體容器或 Blob (
- cacheControl
-
string
僅代表 Blob/檔案服務 SAS) 的快取控制標頭 (
- contentDisposition
-
string
僅代表 Blob/檔案服務 SAS) 的內容處置標頭 (
- contentEncoding
-
string
僅代表 Blob/檔案服務 SAS) 的內容編碼標頭 (
- contentLanguage
-
string
僅代表 Blob/檔案服務 SAS) 的內容語言標頭 (
- contentType
-
string
僅代表 Blob/檔案服務 SAS) 的內容類型標頭 (
- userDelegationKey
- UserDelegationKey
表示使用者委派金鑰屬性
- preauthorizedAgentObjectId
-
string
僅代表使用者委派 SAS) 的授權 AAD 物件識別碼 (
- correlationId
-
string
僅代表使用者委派 SAS) 的相互關聯識別碼 (
屬性詳細資料
cacheControl
Blob/檔案服務 SAS 中快取控制標頭的值。
cacheControl?: string
屬性值
string
contentDisposition
Blob/檔案服務 SAS 中內容處置標頭的值。
contentDisposition?: string
屬性值
string
contentEncoding
Blob/檔案服務 SAS 中內容編碼標頭的值。
contentEncoding?: string
屬性值
string
contentLanguage
Blob/檔案服務 SAS 中內容長度標頭的值。
contentLanguage?: string
屬性值
string
contentType
Blob/檔案服務 SAS 中內容類型標頭的值。
contentType?: string
屬性值
string
correlationId
將記錄在儲存體診斷記錄中的 GUID 值,可用來將 SAS 產生與儲存體資源存取相互關聯。 這只適用于使用者委派 SAS。
correlationId?: string
屬性值
string
expiresOn
只有在提供識別碼時,才為選擇性。 此 SAS 權杖的到期時間。
expiresOn?: Date
屬性值
Date
identifier
選擇性。 簽署的識別碼 (僅適用于 <xref:BlobSASSignatureValues>) 。
identifier?: string
屬性值
string
ipRange
permissions
只有在提供識別碼時,才為選擇性。 如需詳細資訊,請參閱 <xref:AccountSASPermissions> 、 <xref:BlobSASPermissions> 或 <xref:ContainerSASPermissions> 。
permissions?: string
屬性值
string
preauthorizedAgentObjectId
GUID 格式的授權 AAD 物件識別碼。 使用者委派金鑰擁有者授權的使用者 AAD 物件識別碼,以執行 SAS 授與的動作。 Azure 儲存體服務會確保使用者委派金鑰的擁有者具有必要的許可權,再授與存取權,但不會執行此值中所指定使用者的額外許可權檢查。 這只適用于使用者委派 SAS。
preauthorizedAgentObjectId?: string
屬性值
string
protocol
resource
選擇性。 指定哪些資源只能透過 SAS (存取 <xref:BlobSASSignatureValues>) 。
resource?: string
屬性值
string
resourceTypes
選擇性。 只有帳戶 SAS) 才能存取儲存體資源類型 (。 如需詳細資訊, <xref:AccountSASResourceTypes> 請參閱 。
resourceTypes?: string
屬性值
string
services
選擇性。 只有帳戶 SAS) 才能存取儲存體服務 (。 如需詳細資訊, <xref:AccountSASServices> 請參閱 。
services?: string
屬性值
string
signature
SAS 權杖的簽章。
signature: string
屬性值
string
startsOn
選擇性。 此 SAS 權杖的開始時間。
startsOn?: Date
屬性值
Date
version
儲存體 API 版本。
version: string
屬性值
string
方法詳細資料
toString()
將所有 SAS 查詢參數編碼為可附加至 URL 的字串。
function toString()
傳回
string