SASQueryParameters class
代表組成 Azure 記憶體 SAS 查詢參數的元件。 使用者不會直接建構此類型;它只會由 AccountSASSignatureValues 和 <xref:BlobSASSignatureValues> 類型產生。 產生之後,就可以將它編碼為 toString() ,並直接附加至 URL (不過,如果有現有的查詢參數,這可能會影響附加這些查詢參數的適當方法) 。
注意:此類別的實例是不可變的。
建構函式
屬性
agent |
未授權的 AAD 物件識別碼,格式為 GUID。 假設使用者被使用者委派密鑰擁有者未經授權之使用者的 AAD 物件識別碼。 Azure 記憶體服務會執行額外的 POSIX ACL 檢查,以判斷使用者是否有權執行要求的作業。 這不能與 搭配 <xref:signedAuthorizedUserObjectId>使用。 這隻適用於使用者委派SAS。 |
cache |
Blob/檔案服務 SAS 中快取控制標頭的值。 |
content |
Blob/檔案服務 SAS 中內容處置標頭的值。 |
content |
Blob/檔案服務 SAS 中內容編碼標頭的值。 |
content |
Blob/檔案服務 SAS 中內容長度標頭的值。 |
content |
Blob/檔案服務 SAS 中內容類型標頭的值。 |
correlation |
將記錄在記憶體診斷記錄中的 GUID 值,可用來將 SAS 產生與記憶體資源存取相互關聯。 這隻適用於使用者委派SAS。 |
directory |
指出字串對符號之標準化resource 欄位中所指定的目錄深度。 目錄的深度是根資料夾底下的目錄數目。 |
encryption |
選擇性。 傳送具有此SAS URI授權的要求時要使用的加密範圍。 |
expires |
只有在提供標識符時,才為選擇性。 此 SAS 令牌的到期時間。 |
identifier | 選擇性。 簽署的標識碼 (僅適用於 <xref:BlobSASSignatureValues>) 。 請參閱 https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy |
ip |
選擇性。 此 SAS 允許的IP範圍。 |
permissions | 只有在提供標識符時,才為選擇性。 如需詳細資訊,請參閱 AccountSASPermissions、 <xref:BlobSASPermissions>或 <xref:ContainerSASPermissions> 。 |
preauthorized |
GUID 格式的授權 AAD 物件識別碼。 使用者委派密鑰擁有者授權的使用者 AAD 物件識別碼,以執行 SAS 授與的動作。 Azure 記憶體服務會確保使用者委派密鑰的擁有者具有必要的許可權,再授與存取權,但不會執行此值中所指定使用者的額外許可權檢查。 這不能與 搭配 <xref:signedUnauthorizedUserObjectId>使用。 這隻適用於使用者委派SAS。 |
protocol | 選擇性。 允許的 HTTP 通訊協定 () 。 |
resource | 選擇性。 指定哪些資源只能透過 SAS (存取 <xref:BlobSASSignatureValues>) 。 |
resource |
選擇性。 只有帳戶 SAS) 才能存取記憶體資源類型 (。 如需詳細資訊,請參閱 AccountSASResourceTypes 。 |
services | 選擇性。 只有帳戶 SAS) 才能存取記憶體服務 (。 如需詳細資訊,請參閱 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, number, string, string, 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, directoryDepth?: number, preauthorizedAgentObjectId?: string, agentObjectId?: string, correlationId?: string, encryptionScope?: string)
參數
- version
-
string
表示記憶體版本
- signature
-
string
表示 SAS 令牌的簽章
- permissions
-
string
表示記憶體許可權
- services
-
string
僅代表帳戶 SAS () 存取的記憶體服務
- resourceTypes
-
string
只代表帳戶 SAS) 存取的記憶體資源類型 (
- protocol
- SASProtocol
表示允許的 HTTP 通訊協定 (s)
- 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
表示使用者委派金鑰屬性
- directoryDepth
-
number
- preauthorizedAgentObjectId
-
string
僅代表使用者委派 SAS) 的授權 AAD 物件識別碼 (
- agentObjectId
-
string
僅針對使用者委派 SAS) ,代表未經授權的 AAD 物件標識碼 (
- correlationId
-
string
僅代表使用者委派 SAS) 的相互關聯標識碼 (
- encryptionScope
-
string
屬性詳細資料
agentObjectId
未授權的 AAD 物件識別碼,格式為 GUID。 假設使用者被使用者委派密鑰擁有者未經授權之使用者的 AAD 物件識別碼。 Azure 記憶體服務會執行額外的 POSIX ACL 檢查,以判斷使用者是否有權執行要求的作業。 這不能與 搭配 <xref:signedAuthorizedUserObjectId>使用。 這隻適用於使用者委派SAS。
agentObjectId?: string
屬性值
string
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
directoryDepth
指出字串對符號之標準化resource 欄位中所指定的目錄深度。 目錄的深度是根資料夾底下的目錄數目。
directoryDepth?: number
屬性值
number
encryptionScope
選擇性。 傳送具有此SAS URI授權的要求時要使用的加密範圍。
encryptionScope?: string
屬性值
string
expiresOn
只有在提供標識符時,才為選擇性。 此 SAS 令牌的到期時間。
expiresOn?: Date
屬性值
Date
identifier
選擇性。 簽署的標識碼 (僅適用於 <xref:BlobSASSignatureValues>) 。
請參閱 https://docs.microsoft.com/en-us/rest/api/storageservices/establishing-a-stored-access-policy
identifier?: string
屬性值
string
ipRange
permissions
只有在提供標識符時,才為選擇性。 如需詳細資訊,請參閱 AccountSASPermissions、 <xref:BlobSASPermissions>或 <xref:ContainerSASPermissions> 。
permissions?: string
屬性值
string
preauthorizedAgentObjectId
GUID 格式的授權 AAD 物件識別碼。 使用者委派密鑰擁有者授權的使用者 AAD 物件識別碼,以執行 SAS 授與的動作。 Azure 記憶體服務會確保使用者委派密鑰的擁有者具有必要的許可權,再授與存取權,但不會執行此值中所指定使用者的額外許可權檢查。 這不能與 搭配 <xref:signedUnauthorizedUserObjectId>使用。 這隻適用於使用者委派SAS。
preauthorizedAgentObjectId?: string
屬性值
string
protocol
resource
選擇性。 指定哪些資源只能透過 SAS (存取 <xref:BlobSASSignatureValues>) 。
resource?: string
屬性值
string
resourceTypes
選擇性。 只有帳戶 SAS) 才能存取記憶體資源類型 (。 如需詳細資訊,請參閱 AccountSASResourceTypes 。
resourceTypes?: string
屬性值
string
services
signature
SAS 令牌的簽章。
signature: string
屬性值
string
startsOn
選擇性。 此 SAS 令牌的開始時間。
startsOn?: Date
屬性值
Date
version
記憶體 API 版本。
version: string
屬性值
string
方法詳細資料
toString()
將所有 SAS 查詢參數編碼為可附加至 URL 的字串。
function toString(): string
傳回
string