@azure/storage-blob package
類別
AccountSASPermissions |
僅適用於運行時間NODE.JS。 這是協助程序類別,用來建構代表 AccountSAS 授與之許可權的字串。 將值設定為 true 表示任何使用這些許可權的 SAS 都會授與該作業的許可權。 設定所有值之後,應該使用 toString 串行化,並設定為 AccountSASSignatureValues 對象的許可權欄位。 可以建構沒有這個類別的許可權字串,但許可權的順序是特定的,而且這個類別保證正確性。 |
AccountSASResourceTypes |
僅適用於運行時間NODE.JS。 這是協助程序類別,用來建構代表 AccountSAS 可存取之資源的字串。 將值設定為 true 表示任何使用這些許可權的 SAS 都會授與該資源類型的存取權。 設定所有值之後,這應該會以 toString 串行化,並設定為 AccountSASSignatureValues 物件上的資源欄位。 可以建構沒有這個類別的資源字串,但資源的順序是特定的,而且這個類別保證正確性。 |
AccountSASServices |
僅適用於運行時間NODE.JS。 這是協助程序類別,用來建構代表 AccountSAS 可存取之服務的字串。 將值設定為 true 表示任何使用這些許可權的 SAS 都會授與該服務的存取權。 設定所有值之後,應該使用 toString 串行化,並在 AccountSASSignatureValues 對象上設定為服務欄位。 可以建構沒有這個類別的服務字串,但服務的順序是特別的,而這個類別保證正確性。 |
AnonymousCredential |
AnonymousCredential 提供 credentialPolicyCreator 成員,用來建立 AnonymousCredentialPolicy 物件。 AnonymousCredentialPolicy 會與讀取公用資源的 HTTP(S) 要求搭配使用,或用於共用存取簽章(SAS)。 |
AnonymousCredentialPolicy |
AnonymousCredentialPolicy 會與讀取公用資源的 HTTP(S) 要求搭配使用,或用於共用存取簽章(SAS)。 |
AppendBlobClient |
AppendBlobClient 會定義一組適用於附加 Blob 的作業。 |
BaseRequestPolicy |
所有要求原則衍生自的基類。 |
BlobBatch |
BlobBatch 代表 Blob 上的一組匯總作業。
目前僅支援 |
BlobBatchClient |
BlobBatchClient 可讓您對 Azure 記憶體 Blob 服務提出批次要求。 請參閱 https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch |
BlobClient |
BlobClient 代表 Azure 記憶體 Blob 的 URL;Blob 可能是區塊 Blob、附加 Blob 或分頁 Blob。 |
BlobLeaseClient |
管理 ContainerClient 或 BlobClient租用的用戶端。 |
BlobSASPermissions |
僅適用於運行時間NODE.JS。 這是協助程序類別,用來建構字串,代表 ServiceSAS 授與給 Blob 的許可權。 將值設定為 true 表示任何使用這些許可權的 SAS 都會授與該作業的許可權。 設定所有值之後,這應該以 toString 串行化,並設定為 BlobSASSignatureValues 對象的許可權欄位。 可以建構沒有這個類別的許可權字串,但許可權的順序是特定的,而且這個類別保證正確性。 |
BlobServiceClient |
BlobServiceClient 代表 Azure 記憶體 Blob 服務的用戶端,可讓您操作 Blob 容器。 |
BlockBlobClient |
BlockBlobClient 會定義一組適用於區塊 Blob 的作業。 |
ContainerClient |
ContainerClient 代表 Azure 記憶體容器的 URL,可讓您操作其 Blob。 |
ContainerSASPermissions |
這是協助程序類別,用來建構字串,代表 ServiceSAS 授與給容器的許可權。 將值設定為 true 表示任何使用這些許可權的 SAS 都會授與該作業的許可權。 設定所有值之後,這應該以 toString 串行化,並設定為 BlobSASSignatureValues 對象的許可權欄位。 可以建構沒有這個類別的許可權字串,但許可權的順序是特定的,而且這個類別保證正確性。 |
Credential |
Credential 是 Azure 記憶體 HTTP 要求簽署的抽象類。 此類別會裝載一個 credentialPolicyCreator Factory,其會產生 CredentialPolicy。 |
CredentialPolicy |
在傳送之前,用來簽署 HTTP(S) 要求的認證原則。 這是抽象類。 |
PageBlobClient |
PageBlobClient 會定義一組適用於分頁 Blob 的作業。 |
Pipeline |
包含 HTTP 要求原則的 Pipeline 類別。 您可以呼叫 newPipeline 來建立預設管線。 或者,您可以透過管線的建構函式,使用您自己的原則建立管線。 請參閱 newPipeline,並在實作自定義管線之前提供原則。 |
RestError |
失敗管線要求的自定義錯誤類型。 |
SASQueryParameters |
表示組成 Azure 記憶體 SAS 查詢參數的元件。 使用者不會直接建構此類型;它只會由 AccountSASSignatureValues 和 BlobSASSignatureValues 類型產生。 產生之後,它可以編碼成 toString() 並直接附加至 URL(不過,如果現有的查詢參數存在,則應該在這裡小心,這可能會影響附加這些查詢參數的適當方法)。 注意:這個類別的實例是不可變的。 |
StorageBrowserPolicy |
StorageBrowserPolicy 會處理 Node.js 與瀏覽器運行時間之間的差異,包括:
|
StorageBrowserPolicyFactory |
StorageBrowserPolicyFactory 是一種處理站類別,可協助產生 StorageBrowserPolicy 物件。 |
StorageRetryPolicy |
重試原則,並實作指數重試和線性重試。 |
StorageRetryPolicyFactory |
StorageRetryPolicyFactory 是一種處理站類別,可協助產生 StorageRetryPolicy 物件。 |
StorageSharedKeyCredential |
僅適用於運行時間NODE.JS。 Azure 記憶體服務帳戶密鑰授權的 StorageSharedKeyCredential。 |
StorageSharedKeyCredentialPolicy |
StorageSharedKeyCredentialPolicy 是用來使用共用密鑰簽署 HTTP 要求的原則。 |
介面
類型別名
列舉
BlockBlobTier |
表示 Blob 上的存取層。 如需區塊 Blob 層級階層處理的詳細資訊,請參閱 經常性存取、非經常性存取和封存儲存層。 |
KnownEncryptionAlgorithmType |
EncryptionAlgorithmType 服務的已知值。 |
PremiumPageBlobTier |
指定要設定 Blob 的分頁 Blob 層。 這隻適用於進階記憶體帳戶上的分頁 Blob。 如需每個PageBlobTier對應IOPS和輸送量的詳細資訊,請參閱這裡 。 |
SASProtocol |
產生的 SAS 通訊協定。 |
StorageBlobAudience |
定義記憶體的已知雲端物件。 |
StorageRetryPolicyType |
RetryPolicy 類型。 |
函式
generate |
僅適用於運行時間NODE.JS。 產生 SASQueryParameters 物件,其中包含發出實際 REST 要求所需的所有 SAS 查詢參數。 請參閱 https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas |
generate |
僅適用於運行時間NODE.JS。 建立 SASQueryParameters 的實例。 只接受建立 SAS 所需的必要設定。 如需選擇性設定,請直接設定對應的屬性,例如許可權、startsOn 和標識符。 警告:未提供標識符時,需要許可權和 expiresOn。 如果您以這個建構函式初始,您必須將值指派給標識碼或 expiresOn & 許可權。 在執行下列代碼段之前,請先填入必要的詳細數據。 範例用法:
使用識別碼的範例:
使用 Blob 名稱的範例:
|
generate |
僅適用於運行時間NODE.JS。 建立 SASQueryParameters 的實例。 警告:產生使用者委派 SAS 時,需要有許可權和到期日時,將會忽略標識符。 範例用法:
|
get |
若要取得 Blob 服務的記憶體帳戶 OAuth 物件。 |
is |
判斷給定自變數是否符合管線合約的協助程式 |
new |
使用提供的認證建立新的 Pipeline 物件。 |
函式詳細資料
generateAccountSASQueryParameters(AccountSASSignatureValues, StorageSharedKeyCredential)
僅適用於運行時間NODE.JS。
產生 SASQueryParameters 物件,其中包含發出實際 REST 要求所需的所有 SAS 查詢參數。
請參閱 https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
function generateAccountSASQueryParameters(accountSASSignatureValues: AccountSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters
參數
- accountSASSignatureValues
- AccountSASSignatureValues
- sharedKeyCredential
- StorageSharedKeyCredential
傳回
generateBlobSASQueryParameters(BlobSASSignatureValues, StorageSharedKeyCredential)
僅適用於運行時間NODE.JS。
建立 SASQueryParameters 的實例。
只接受建立 SAS 所需的必要設定。 如需選擇性設定,請直接設定對應的屬性,例如許可權、startsOn 和標識符。
警告:未提供標識符時,需要許可權和 expiresOn。 如果您以這個建構函式初始,您必須將值指派給標識碼或 expiresOn & 許可權。
在執行下列代碼段之前,請先填入必要的詳細數據。
範例用法:
// Generate service level SAS for a container
const containerSAS = generateBlobSASQueryParameters({
containerName, // Required
permissions: ContainerSASPermissions.parse("racwdl"), // Required
startsOn: new Date(), // Optional
expiresOn: new Date(new Date().valueOf() + 86400 * 1000), // Required. Date type
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2016-05-31" // Optional
},
sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
使用識別碼的範例:
// Generate service level SAS for a container with identifier
// startsOn & permissions are optional when identifier is provided
const identifier = "unique-id";
await containerClient.setAccessPolicy(undefined, [
{
accessPolicy: {
expiresOn: new Date(new Date().valueOf() + 86400 * 1000), // Date type
permissions: ContainerSASPermissions.parse("racwdl").toString(),
startsOn: new Date() // Date type
},
id: identifier
}
]);
const containerSAS = generateBlobSASQueryParameters(
{
containerName, // Required
identifier // Required
},
sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
使用 Blob 名稱的範例:
// Generate service level SAS for a blob
const blobSAS = generateBlobSASQueryParameters({
containerName, // Required
blobName, // Required
permissions: BlobSASPermissions.parse("racwd"), // Required
startsOn: new Date(), // Optional
expiresOn: new Date(new Date().valueOf() + 86400 * 1000), // Required. Date type
cacheControl: "cache-control-override", // Optional
contentDisposition: "content-disposition-override", // Optional
contentEncoding: "content-encoding-override", // Optional
contentLanguage: "content-language-override", // Optional
contentType: "content-type-override", // Optional
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2016-05-31" // Optional
},
sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
function generateBlobSASQueryParameters(blobSASSignatureValues: BlobSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters
參數
- blobSASSignatureValues
- BlobSASSignatureValues
- sharedKeyCredential
- StorageSharedKeyCredential
傳回
generateBlobSASQueryParameters(BlobSASSignatureValues, UserDelegationKey, string)
僅適用於運行時間NODE.JS。
建立 SASQueryParameters 的實例。 警告:產生使用者委派 SAS 時,需要有許可權和到期日時,將會忽略標識符。
範例用法:
// Generate user delegation SAS for a container
const userDelegationKey = await blobServiceClient.getUserDelegationKey(startsOn, expiresOn);
const containerSAS = generateBlobSASQueryParameters({
containerName, // Required
permissions: ContainerSASPermissions.parse("racwdl"), // Required
startsOn, // Optional. Date type
expiresOn, // Required. Date type
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2018-11-09" // Must greater than or equal to 2018-11-09 to generate user delegation SAS
},
userDelegationKey, // UserDelegationKey
accountName
).toString();
function generateBlobSASQueryParameters(blobSASSignatureValues: BlobSASSignatureValues, userDelegationKey: UserDelegationKey, accountName: string): SASQueryParameters
參數
- blobSASSignatureValues
- BlobSASSignatureValues
- userDelegationKey
- UserDelegationKey
傳回值 blobServiceClient.getUserDelegationKey()
- accountName
-
string
傳回
getBlobServiceAccountAudience(string)
若要取得 Blob 服務的記憶體帳戶 OAuth 物件。
function getBlobServiceAccountAudience(storageAccountName: string): string
參數
- storageAccountName
-
string
傳回
string
isPipelineLike(unknown)
判斷給定自變數是否符合管線合約的協助程式
function isPipelineLike(pipeline: unknown): pipeline
參數
- pipeline
-
unknown
可能是管線的自變數
傳回
pipeline
當自變數滿足管線合約時,則為 true
newPipeline(StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
使用提供的認證建立新的 Pipeline 物件。
function newPipeline(credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, pipelineOptions?: StoragePipelineOptions): Pipeline
參數
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
例如 AnonymousCredential、StorageSharedKeyCredential 或任何來自 @azure/identity
套件的認證,以驗證對服務的要求。 您也可以提供實作 TokenCredential 介面的物件。 如果未指定,則會使用 AnonymousCredential。
- pipelineOptions
- StoragePipelineOptions
自選。 選項。
傳回
新的 Pipeline 物件。