ShareClient class
ShareClient 代表 Azure 儲存體共用的 URL，可讓您操作其目錄和檔案。
- Extends
-
StorageClient
建構函式
| Share |
建立 ShareClient 的實例。 |
| Share |
建立 ShareClient 的實例。 |
| Share |
屬性
| name | 共用的名稱 |
| root |
取得這個共用根目錄的目錄用戶端。 請注意，根目錄一律存在且無法刪除。 根目錄的新 ShareDirectoryClient 物件。 |
繼承的屬性
| account |
|
| url | URL 字串值。 |
方法
建構函式詳細資料
ShareClient(string, Credential_2 | TokenCredential, ShareClientOptions)
建立 ShareClient 的實例。
new ShareClient(url: string, credential?: Credential_2 | TokenCredential, options?: ShareClientOptions)參數
- url
-
string
指向 Azure 儲存體檔案共用的 URL 字串，例如 「 https://myaccount.file.core.windows.net/share" ;。 如果使用 AnonymousCredential，您可以附加 SAS，例如 「 https://myaccount.file.core.windows.net/share?sasString" ;。
- credential
例如 AnonymousCredential 或 StorageSharedKeyCredential。 如果未指定，則會使用 AnonymousCredential。
- options
- ShareClientOptions
選擇性。 設定 HTTP 管線的選項。
ShareClient(string, Pipeline, ShareClientConfig)
建立 ShareClient 的實例。
new ShareClient(url: string, pipeline: Pipeline, options?: ShareClientConfig)參數
- url
-
string
指向 Azure 儲存體檔案共用的 URL 字串，例如 「 https://myaccount.file.core.windows.net/share" ;。 如果使用 AnonymousCredential，您可以附加 SAS，例如 「 https://myaccount.file.core.windows.net/share?sasString" ;。
- pipeline
- Pipeline
呼叫 newPipeline () 以建立預設管線，或提供自訂管線。
- options
- ShareClientConfig
ShareClient(string, string, ShareClientOptions)
new ShareClient(connectionString: string, name: string, options?: ShareClientOptions)參數
- connectionString
-
string
帳戶連接字串或 Azure 儲存體帳戶的 SAS 連接字串。
[ 注意 - 帳戶連接字串只能用於NODE.JS執行時間。 ] 帳戶連接字串範例 -DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net SAS 連接字串範例 - BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString
- name
-
string
共用名稱稱。
- options
- ShareClientOptions
選擇性。 設定 HTTP 管線的選項。
屬性詳細資料
name
共用的名稱
string name屬性值
string
rootDirectoryClient
取得這個共用根目錄的目錄用戶端。 請注意，根目錄一律存在且無法刪除。
根目錄的新 ShareDirectoryClient 物件。
ShareDirectoryClient rootDirectoryClient屬性值
繼承的屬性詳細資料
accountName
accountName: string屬性值
string
繼承自 StorageClient.accountName
url
URL 字串值。
url: string屬性值
string
繼承自 StorageClient.url
方法詳細資料
create(ShareCreateOptions)
在指定的帳號下建立新的共用。 如果相同名稱的共用已經存在，作業會失敗。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/create-share
function create(options?: ShareCreateOptions): Promise<ShareCreateResponse>參數
- options
- ShareCreateOptions
共用建立作業的選項。
傳回
Promise<ShareCreateResponse>
共用建立作業的回應資料。
createDirectory(string, DirectoryCreateOptions)
在此共用下建立新的子目錄。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory
function createDirectory(directoryName: string, options?: DirectoryCreateOptions): Promise<{ directoryClient: ShareDirectoryClient, directoryCreateResponse: DirectoryCreateResponse }>參數
- directoryName
-
string
- options
- DirectoryCreateOptions
目錄建立作業的選項。
傳回
Promise<{ directoryClient: ShareDirectoryClient, directoryCreateResponse: DirectoryCreateResponse }>
目錄建立回應資料和對應的目錄用戶端。
createFile(string, number, FileCreateOptions)
建立新的檔案，或取代此共用根目錄下的檔案。 請注意，它只會初始化沒有內容的檔案。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/create-file
function createFile(fileName: string, size: number, options?: FileCreateOptions): Promise<{ fileClient: ShareFileClient, fileCreateResponse: FileCreateResponse }>參數
- fileName
-
string
- size
-
number
指定檔案的大小上限，最多 4 TB。
- options
- FileCreateOptions
檔案建立作業的選項。
傳回
Promise<{ fileClient: ShareFileClient, fileCreateResponse: FileCreateResponse }>
檔案建立回應資料和對應的檔案用戶端。
createIfNotExists(ShareCreateOptions)
在指定的帳號下建立新的共用。 如果具有相同名稱的共用已經存在，則不會變更。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/create-share
function createIfNotExists(options?: ShareCreateOptions): Promise<ShareCreateIfNotExistsResponse>參數
- options
- ShareCreateOptions
傳回
Promise<ShareCreateIfNotExistsResponse>
createPermission(string, ShareCreatePermissionOptions)
在共用層級 (安全性描述項) 建立檔案許可權。 建立的安全性描述元可用於共用中的檔案/目錄。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/create-permission
function createPermission(filePermission: string, options?: ShareCreatePermissionOptions): Promise<ShareCreatePermissionResponse>參數
- filePermission
-
string
SDDL 中所述的檔案許可權
- options
- ShareCreatePermissionOptions
共用建立許可權作業的選項。
傳回
Promise<ShareCreatePermissionResponse>
createSnapshot(ShareCreateSnapshotOptions)
建立共用的唯讀快照集。
function createSnapshot(options?: ShareCreateSnapshotOptions): Promise<ShareCreateSnapshotResponse>參數
- options
- ShareCreateSnapshotOptions
共用建立快照集作業的選項。
傳回
Promise<ShareCreateSnapshotResponse>
共用建立快照集作業的回應資料。
delete(ShareDeleteMethodOptions)
標記要刪除的指定共用。 共用及其內含的任何目錄或檔案稍後會在垃圾收集期間刪除。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share
function delete(options?: ShareDeleteMethodOptions): Promise<ShareDeleteResponse>參數
- options
- ShareDeleteMethodOptions
共用刪除作業的選項。
傳回
Promise<ShareDeleteResponse>
共用刪除作業的回應資料。
deleteDirectory(string, DirectoryDeleteOptions)
移除此共用下指定的空白子目錄。 請注意，必須先清空目錄才能將其刪除。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory
function deleteDirectory(directoryName: string, options?: DirectoryDeleteOptions): Promise<DirectoryDeleteResponse>參數
- directoryName
-
string
- options
- DirectoryDeleteOptions
目錄刪除作業的選項。
傳回
Promise<DirectoryDeleteResponse>
目錄刪除回應資料。
deleteFile(string, FileDeleteOptions)
從儲存體帳戶移除此共用根目錄下的檔案。 成功刪除檔案之後，會立即將其從儲存體帳戶的索引中移除，再也無法供用戶端存取。 稍後記憶體回收時，將會從服務中移除檔案的資料。
刪除檔案將會失敗，狀態碼為 409 (衝突) ，如果檔案是在 SMB 用戶端上開啟，則錯誤碼 SharingViolation 。
共用快照集不支援刪除檔案，這是共用的唯讀複本。 嘗試在共用快照集上執行這項作業將會失敗， (400 (InvalidQueryParameterValue)
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
function deleteFile(fileName: string, options?: FileDeleteOptions): Promise<FileDeleteResponse>參數
- fileName
-
string
- options
- FileDeleteOptions
檔案刪除作業的選項。
傳回
Promise<FileDeleteResponse>
Promise 檔案刪除回應資料。
deleteIfExists(ShareDeleteMethodOptions)
如果指定共用存在，請標示要刪除的共用。 共用及其內含的任何目錄或檔案稍後會在垃圾收集期間刪除。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share
function deleteIfExists(options?: ShareDeleteMethodOptions): Promise<ShareDeleteIfExistsResponse>參數
- options
- ShareDeleteMethodOptions
傳回
Promise<ShareDeleteIfExistsResponse>
exists(ShareExistsOptions)
如果此用戶端所代表的 Azrue 共用資源存在，則會傳回 true;否則為 false。
注意：請小心使用此函式，因為其他用戶端或應用程式可能會刪除現有的共用。 反之亦然，此函式完成後，其他用戶端或應用程式可能會新增新的共用。
function exists(options?: ShareExistsOptions): Promise<boolean>參數
- options
- ShareExistsOptions
存在作業的選項。
傳回
Promise<boolean>
generateSasUrl(ShareGenerateSasUrlOptions)
僅適用于以共用金鑰認證建構的 ShareClient。
根據傳入的用戶端屬性和參數，產生服務共用存取簽章 (SAS) URI。 SAS 是由用戶端的共用金鑰認證所簽署。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasUrl(options: ShareGenerateSasUrlOptions): string參數
- options
- ShareGenerateSasUrlOptions
選用參數。
傳回
string
SAS URI 是由此用戶端所代表之資源的 URI 所組成，後面接著產生的 SAS 權杖。
getAccessPolicy(ShareGetAccessPolicyOptions)
取得指定共用的許可權。 許可權會指出是否可以公開存取共用資料。
警告：剖析開始和到期字串時，JavaScript 日期可能會遺失有效位數。 例如，新的 Date (「2018-12-31T03：44：23.8827891Z」) .toISOString () 會取得 「2018-12-31T03：44：23.882Z」。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-acl
function getAccessPolicy(options?: ShareGetAccessPolicyOptions): Promise<ShareGetAccessPolicyResponse>參數
- options
- ShareGetAccessPolicyOptions
傳回
Promise<ShareGetAccessPolicyResponse>
共用取得存取原則作業的回應資料。
getDirectoryClient(string)
建立 ShareDirectoryClient 物件。
function getDirectoryClient(directoryName: string): ShareDirectoryClient參數
- directoryName
-
string
目錄名稱
傳回
指定目錄名稱的 ShareDirectoryClient 物件。
getPermission(string, ShareGetPermissionOptions)
取得指定檔案許可權金鑰的安全性描述元定義語言 (SDDL) ，表示安全性描述元。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-permission
function getPermission(filePermissionKey: string, options?: ShareGetPermissionOptions): Promise<ShareGetPermissionResponse>參數
- filePermissionKey
-
string
指出許可權之安全性描述元的檔案許可權金鑰。
- options
- ShareGetPermissionOptions
共用建立許可權作業的選項。
傳回
Promise<ShareGetPermissionResponse>
getProperties(ShareGetPropertiesOptions)
傳回指定共用的所有使用者定義中繼資料和系統屬性。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties
警告： metadata 回應中傳回的物件會以小寫顯示其索引鍵，即使其原本包含大寫字元也一樣。 這與ShareServiceClientincludeMetadata 方法所 listShares 傳回的中繼資料金鑰不同，此選項會保留其原始大小寫。
function getProperties(options?: ShareGetPropertiesOptions): Promise<ShareGetPropertiesResponse>參數
- options
- ShareGetPropertiesOptions
傳回
Promise<ShareGetPropertiesResponse>
共用取得屬性作業的回應資料。
getStatistics(ShareGetStatisticsOptions)
擷取與共享相關的統計資料。
function getStatistics(options?: ShareGetStatisticsOptions): Promise<ShareGetStatisticsResponse>參數
- options
- ShareGetStatisticsOptions
傳回
Promise<ShareGetStatisticsResponse>
共用取得統計資料作業的回應資料。
setAccessPolicy(SignedIdentifier[], ShareSetAccessPolicyOptions)
設定指定共用的許可權。 許可權會指出是否可以公開存取共用中的目錄或檔案。
當您設定共用的許可權時，會取代現有的許可權。 如果未提供 shareAcl，將會移除現有的共用 ACL。
當您在共用上建立預存存取原則時，最多可能需要 30 秒才會生效。 在此間隔期間，與儲存的存取原則相關聯的共用存取簽章會失敗，並顯示狀態碼 403 (禁止)，直到存取原則變成作用中為止。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-acl
function setAccessPolicy(shareAcl?: SignedIdentifier[], options?: ShareSetAccessPolicyOptions): Promise<ShareSetAccessPolicyResponse>參數
- shareAcl
已簽署識別碼的陣列，每個識別碼都有唯一的識別碼和存取原則的詳細資料。
- options
- ShareSetAccessPolicyOptions
傳回
Promise<ShareSetAccessPolicyResponse>
共用集存取原則作業的回應資料。
setMetadata(Metadata, ShareSetMetadataOptions)
設定指定共用的一或多個使用者定義名稱/值組。
如果未提供任何選項，或選項參數中未定義任何中繼資料，則會移除共用中繼資料。
請參閱https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-metadata
function setMetadata(metadata?: Metadata, options?: ShareSetMetadataOptions): Promise<ShareSetMetadataResponse>參數
- metadata
- Metadata
如果未提供任何中繼資料，則會移除所有現有的目錄中繼資料。
- options
- ShareSetMetadataOptions
傳回
Promise<ShareSetMetadataResponse>
共用集中繼資料作業的回應資料。
setProperties(ShareSetPropertiesOptions)
設定共用的屬性。
function setProperties(options?: ShareSetPropertiesOptions): Promise<ShareSetPropertiesResponse>參數
- options
- ShareSetPropertiesOptions
傳回
Promise<ShareSetPropertiesResponse>
共用集屬性作業的回應資料。
setQuota(number, ShareSetQuotaOptions)
設定指定共用的配額。
function setQuota(quotaInGB: number, options?: ShareSetQuotaOptions): Promise<ShareSetQuotaResponse>參數
- quotaInGB
-
number
以 GB 為單位指定共用的大小上限
- options
- ShareSetQuotaOptions
傳回
Promise<ShareSetQuotaResponse>
共用取得配額作業的回應資料。
withSnapshot(string)
建立與來源相同的新 ShareClient 物件，但具有指定的快照集時間戳記。 提供 「」 會移除快照集，並傳回基底共用的 URL。
function withSnapshot(snapshot: string): ShareClient參數
- snapshot
-
string
快照時間戳記。
傳回
新的 ShareClient 物件與來源相同，但具有指定的快照集時間戳記