Path - Update

  • 參考
Service:
Storage Services
API Version:
2023-08-03

附加數據 |排清數據 |設定屬性 |設定 存取控制
上傳要附加至檔案的數據、排清 (寫入) 先前上傳的數據至檔案、設定檔案或目錄的屬性，或設定檔案或目錄的訪問控制。 數據只能附加至檔案。 不支援使用多個用戶端對相同檔案的並行寫入。 此作業支援條件式 HTTP 要求。 如需詳細資訊，請參閱指定 Blob 服務作業的條件式標頭。

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}
With optional parameters: 
PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&timeout={timeout}

URI 參數

名稱 位於 必要 類型 Description
accountName
 path True

string

Azure 記憶體帳戶名稱。
dnsSuffix
 path True

string

Azure Data Lake Storage 端點的 DNS 後綴。
filesystem
 path True

string

文件系統標識碼。

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

檔案或目錄路徑。
action
 query True

PathUpdateAction

動作必須是 「append」，才能上傳要附加至檔案的數據、“flush” 以排清先前上傳的數據到檔案、“setProperties” 來設定檔案或目錄的屬性，或 “setAccessControl” 來設定檔案或目錄的擁有者、群組、許可權或訪問控制清單，或以遞歸方式設定目錄的訪問控制清單。 請注意，必須為帳戶啟用階層命名空間，才能使用訪問控制。 另請注意，存取控制 清單 (ACL) 包含擁有者、擁有群組和其他許可權的許可權，因此 x-ms-permissions 和 x-ms-acl 要求標頭互斥。
close
 query

boolean

Azure 記憶體事件可讓應用程式在檔案變更時接收通知。 啟用 Azure 記憶體事件時，會引發檔案變更事件。 此事件具有 屬性，指出這是最終變更，以區別中繼排清與檔案數據流之間的差異，以及文件數據流的最終關閉。 只有在動作為「排清」且啟用變更通知時，關閉查詢參數才有效。 如果 close 的值為 「true」，且排清作業順利完成，則服務會引發檔案變更通知，其屬性表示這是檔案數據流 (關閉) 的最終更新。 如果為 「false」，則會引發變更通知，指出檔案已變更。 預設值為 false。 Hadoop ABFS 驅動程式將此查詢參數設定為 true，表示檔案數據流已關閉。」
continuation
 query

string

選擇性且僅適用於 「setAccessControlRecursive」 作業。 每個調用處理的路徑數目有限。 如果要處理的路徑數目超過此限制，則會在響應標頭 x-ms-continuation 中傳回接續令牌。 在回應中傳回接續令牌時，它必須經過百分比編碼，並在後續的 setAccessControlRecursive 作業調用中指定。
flush
 query

boolean

僅適用於附加呼叫。 此參數可讓呼叫端在附加呼叫期間排清。 默認值為 「false」，如果為 「true」，則會使用附加呼叫排清數據。 請注意，使用 flush=true 時，不支援下列標頭 - “x-ms-cache-control”、“x-ms-content-encoding”、“x-ms-content-type”、“x-ms-content-language”、“x-ms-content-md5”、“x-ms-content-disposition”。 若要在排清期間設定這些標頭，請使用 action=flush
forceFlag
 query

boolean

選擇性且僅適用於 「setAccessControlRecursive」 作業。 如果這是 「false」 作業，會在遇到使用者錯誤時快速終止， (4XX) 。 如果為 「true」，API 將會忽略使用者錯誤，並在目錄的其他子實體上繼續進行作業。 使用者錯誤的詳細狀態將會在任一案例的回應中傳回。 只有在發生使用者錯誤時 forceFlag 為 「true」 時，才會傳回接續令牌。 forceFlag 的預設值為 false。
maxRecords
 query

integer

int32

選擇性且僅適用於 「setAccessControlRecursive」 作業。 它會指定將套用 acl 變更的檔案或目錄數目上限。 如果省略或大於 2,000，要求將處理最多 2,000 個專案
mode
 query

string

選擇性。 “setAccessControlRecursive” 作業的有效和必要專案。 模式 「set」 會設定檔案和目錄上的 POSIX 訪問控制許可權，“modify” 會修改檔案和目錄上既有的一或多個 POSIX 訪問控制許可權，“remove” 會移除檔案和目錄上先前存在的一或多個 POSIX 訪問控制許可權
position
 query

integer

int64

此參數可讓呼叫端平行上傳數據，並控制數據附加至檔案的順序。 上傳數據以附加至檔案，以及排清先前上傳的數據至檔案時，這是必要的。 此值必須是要附加數據的位置。 上傳的數據不會立即排清或寫入檔案。 若要排清，先前上傳的數據必須連續，必須指定 position 參數，且在寫入所有數據之後等於檔案的長度，而且要求中不得包含要求實體主體。
retainUncommittedData
 query

boolean

僅適用於排清作業。 如果為 「true」，則排清作業完成後會保留未認可的數據;否則，排清作業之後會刪除未認可的數據。 預設值為 false。 排清成功時，位移的數據會寫入檔案中小於指定位置的數據，但這個選擇性參數允許在排清位置之後保留數據，以供日後排清作業使用。
timeout
 query

integer

int32

選擇性的作業逾時值，以秒為單位。 此期間會從服務收到要求時開始。 如果逾時值在作業完成之前經過，作業就會失敗。

要求標頭

Media Types: "application/octet-stream", "text/plain"

名稱 必要 類型 Description
Content-Length

integer

int64

「附加數據」和「排清數據」的必要專案。 「排清數據」必須是0。 必須是「附加數據」的位元組要求內容的長度。
Content-MD5

string

選擇性。 要求內容的 MD5 雜湊。 此標頭在 「Append」 和 「Flush」 作業上有效。 在傳輸期間，此雜湊可用來驗證要求內容的完整性。 指定此標頭，儲存體服務會比較已到達的內容雜湊與此標頭值。 如果這兩個雜湊不相符，作業會失敗，並顯示錯誤碼 400 (不正確的要求)。 請注意，這個 MD5 哈希不會與檔案一起儲存。 此標頭與要求內容相關聯，而不是與檔案本身的預存內容相關聯。
x-ms-lease-id

string

如果有作用中的租用，則必須指定租用標識符。 “setAccessControlRecursive” 作業無效。

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control

string

選擇性且僅適用於排清和設定屬性作業。 服務會儲存此值，並將其包含在「讀取檔案」作業的「快取控制」回應標頭中。
x-ms-content-type

string

選擇性且僅適用於排清和設定屬性作業。 服務會儲存此值，並將其包含在「讀取檔案」作業的「內容類型」回應標頭中。
x-ms-content-disposition

string

選擇性且僅適用於排清和設定屬性作業。 服務會儲存此值，並將其包含在「讀取檔案」作業的「內容處置」響應標頭中。
x-ms-content-encoding

string

選擇性且僅適用於排清和設定屬性作業。 服務會儲存此值，並將其包含在「讀取檔案」作業的「內容編碼」回應標頭中。
x-ms-content-language

string

選擇性且僅適用於排清和設定屬性作業。 服務會儲存此值，並將其包含在「讀取檔案」作業的「內容語言」回應標頭中。
x-ms-content-md5

string

選擇性且僅適用於「排清和設定屬性」作業。 服務會儲存此值，並將其包含在「讀取和取得屬性」作業的「Content-Md5」回應標頭中。 如果要求中未指定此屬性，則會清除檔案的這個屬性。 除非再次明確在該檔案上設定此屬性，否則後續呼叫 「讀取和取得屬性」將不會傳回此屬性。
x-ms-properties

string

選擇性。 要以檔案或目錄儲存的使用者定義屬性，格式為逗號分隔的名稱和值組 「n1=v1， n2=v2， ...“，其中每個值都是base64編碼字串。 請注意，字串只能包含 ISO-8859-1 字元集中的 ASCII 字元。 僅適用於 setProperties 作業。 如果檔案或目錄存在，將會移除清單中未包含的任何屬性。 如果省略標頭，則會移除所有屬性。 若要合併新的和現有的屬性，請先取得所有現有的屬性和目前的 E-Tag，然後使用 E-Tag 提出條件式要求，並包含所有屬性的值。
x-ms-owner

string

選擇性且僅適用於 setAccessControl 作業。 設定檔案或目錄的擁有者。
x-ms-group

string

選擇性且僅適用於 setAccessControl 作業。 設定檔案或目錄的擁有群組。
x-ms-permissions

string

只有在帳戶啟用階層命名空間時，才有選擇性且有效。 設定檔案擁有者、檔案擁有者群組和其他專案的 POSIX 訪問許可權。 每個類別都可以被授與讀取 (4) 、寫入 (2) ，或執行 (1) 許可權。 支援符號 (rwxrw-rw-) 和 4 位數八進位表示法 (例如 0766) 。 黏性位也受到支援，而且在符號表示法中，其以字母 t 或 T 表示，取決於其他類別的執行位是分別設定或取消設定 (，例如，具有黏性位的 rwxrw-rw- 會以 rwxrw-rwT 表示。具有黏性位的 rwxrw-rwx 會以 rwxrw-rwt) 表示，沒有 t 或 T 表示未設定黏性位。 在 4 位數的八進位表示法中，其以第 1 個數位表示法 (例如 1766 代表具有黏性位的 rwxrw-rw-，而 0766 代表 rwxrw-rw- 而沒有黏性位) 。 與 x-ms-acl 搭配無效。
x-ms-acl

string

選擇性且僅適用於 setAccessControl 和 setAccessControlRecursive 作業。 setAccessControlRecursive 作業的必要專案。 設定檔案和目錄的 POSIX 訪問控制許可權。 此值是以逗號分隔的訪問控制專案清單，可完全取代在 setAccessControl 和 setAccessControlRecursive 的情況下， (ACL) 的現有訪問控制清單。 setAccessControlRecursive 的 “modify” 模式會更新既有的 ACLS。 每個訪問控制專案 (ACE) 都包含範圍、類型、使用者或群組標識碼，以及格式為 “[scope：][type]：[id]：[permissions]” 的許可權。 範圍必須是 「default」，表示 ACE 屬於目錄的預設 ACL;否則範圍為隱含，且 ACE 屬於存取 ACL。 有四種 ACE 類型：「使用者」會將許可權授與擁有者或具名使用者、「群組」將許可權授與擁有者群組或具名群組，「遮罩」會限制授與具名使用者和群組成員的許可權，而「其他」會將許可權授與任何其他專案中找不到的所有使用者。 使用者或群組標識碼會省略 「mask」 和 「other」 類型的專案。 也會省略擁有者和擁有群組的使用者或群組標識碼。 許可權欄位是3個字元序列，其中第一個字元是 『r』 來授與讀取許可權，第二個字元是 『w』 以授與寫入許可權，而第三個字元是 『x』 來授與執行許可權。 如果未授與存取權，則會使用 『-』 字元來表示許可權遭到拒絕。 例如，下列 ACL 會將讀取、寫入及執行許可權授與檔案擁有者及john.doe@contoso、擁有群組的讀取許可權，以及其他人沒有任何許可權：“user：：rwx，user：john.doe@contoso：rwx，group：：r--,other：：---,mask=rwx”。 與 x-ms-permissions 搭配無效。 setAccessControlRecursive 的 “remove” 模式會移除既有的 ACL，且不應在指定的訪問控制列表中包含許可權：“user：john.doe@contoso：， mask：”。 setAccessControlRecursive 的 “set” 模式會設定 ACL，以取代指定之範圍的預先存在的 ACL，而且必須包含這三個 - 擁有使用者、擁有群組和其他資訊，如果存取範圍已設定，或是在預設範圍內設定擁有使用者、擁有群組或其他專案。 setAccessControlRecursive 的 “set” 和 “modify” 模式必須包含訪問控制清單的許可權。
If-Match

string

[排清數據]、[設定 存取控制] 和 [設定屬性] 選擇性，但 [附加數據] 和 [設定 存取控制 遞歸無效。 ETag 值。 只有資源的 ETag 與指定的值相符，才能指定此標頭執行作業。 ETag 必須以引號指定。
If-None-Match

string

[排清數據]、[設定 存取控制] 和 [設定屬性] 選擇性，但 [附加數據] 和 [設定 存取控制 遞歸無效。 ETag 值或特殊通配符 (“*”) 值。 只有資源的 ETag 與指定的值不相符，才能指定此標頭執行作業。 ETag 必須以引號指定。
If-Modified-Since

string

排清數據和集合屬性的選擇性，但附加數據和集合 存取控制 遞歸無效。 日期和時間值。 指定此標頭，只有在資源自指定的日期和時間以來已修改時，才執行作業。
If-Unmodified-Since

string

排清數據和集合屬性的選擇性，但附加數據和集合 存取控制 遞歸無效。 日期和時間值。 只有當資源自指定的日期和時間以來尚未修改時，才指定此標頭來執行作業。
x-ms-encryption-key

string

選擇性。 Base64 編碼的 AES-256 加密金鑰。
x-ms-encryption-key-sha256

string

選擇性。 加密金鑰的Base64編碼SHA256哈希。
x-ms-encryption-algorithm: AES256

string

選擇性。 指定要用於加密的演算法。 這個標頭的值必須是 AES256。
x-ms-lease-action True

PathLeaseAction

從附加和排清作業的 2020-08-04 版開始。 Append 支援 'acquire'、'auto-renew' 和 'acquire-release' 動作。 如果 「取得」，則會取得租用。 如果「自動更新」，則會更新租用。 如果 「acquire-release」，它會取得 & 完成作業，& 完成作業之後釋放租用。 只有在排清作業中才支援 『Release』 動作。 如果為 'true'，則會使用 x-ms-lease-id 標頭中的租用標識符資訊，在檔案上釋放租用。
x-ms-lease-duration

integer

int32

需要租用期間才能取得租用，並以秒為單位指定租用的持續時間。 租用持續時間必須介於 15 到 60 秒或 -1 之間，才能無限租用。
x-ms-proposed-lease-id

string

當 「x-ms-lease-action」 為 “acquire” 或 “change” 時，為必要專案。 如果作業成功，則會使用此租用標識符取得租用。

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-client-request-id

string

分析記錄中記錄的 UUID，用於疑難解答和相互關聯。

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

指定要求的「國際標準時間」(UTC)。 使用共用密鑰授權時，這是必要的。
x-ms-version

string

指定用於處理要求的 REST 通訊協定版本。 使用共用密鑰授權時，這是必要的。

要求本文

Media Types: "application/octet-stream", "text/plain"

名稱 類型 Description
requestBody

object

僅適用於附加作業。 要上傳並附加至檔案的數據。

回應

名稱 類型 Description
200 OK

SetAccessControlRecursiveResponse

數據已排清 (寫入檔案) ，或已成功設定屬性。 回應本文是選擇性的，且僅適用於 “SetAccessControlRecursive”

Headers

  • Date: string
  • ETag: string
  • Last-Modified: string
  • Accept-Ranges: string
  • Cache-Control: string
  • Content-Disposition: string
  • Content-Encoding: string
  • Content-Language: string
  • Content-Length: integer
  • Content-Range: string
  • Content-Type: string
  • Content-MD5: string
  • x-ms-properties: string
  • x-ms-continuation: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-request-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-scope: string
  • x-ms-lease-renewed: boolean
202 Accepted

已接受上傳的數據。

Headers

  • Content-MD5: string
  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-lease-renewed: boolean
Other Status Codes

DataLakeStorageError

發生錯誤。 可能的 HTTP 狀態、程式代碼和訊息字串如下所列：

  • 400 不正確的要求、ContentLengthMustBeZero：「Content-Length 要求標頭必須是零」。
  • 400 不正確的要求，InvalidAuthenticationInfo：「驗證資訊的格式不正確。 檢查 Authorization 標頭的值。」
  • 400 不正確的要求，InvalidFlushPosition：「上傳的數據不是連續的，或是位置查詢參數值不等於附加上傳的數據之後檔案的長度。」
  • 400 不正確的要求，InvalidHeaderValue：「其中一個 HTTP 標頭的值不是正確的格式。」
  • 400 不正確的要求，Invalid HttpVerb：「指定的 HTTP 動詞命令無效 - 伺服器無法辨識它。」
  • 400 不正確的要求，InvalidInput，「其中一個要求輸入無效」。
  • 400 不正確的要求、InvalidPropertyName、“屬性名稱不能空白。
  • 400 不正確的要求，InvalidPropertyName，“屬性名稱包含無效的字元。
  • 400 不正確的要求，InvalidQueryParameterValue，「要求 URI 中指定的其中一個查詢參數的值無效」。
  • 400 不正確的要求，InvalidResourceName，「指定的資源名稱包含無效的字元」。
  • 400 不正確的要求，InvalidSourceUri，「來源 URI 無效」。
  • 400 不正確的要求，InvalidUri，「要求 URI 無效」。
  • 400 不正確的要求，MissingRequiredHeader：「未指定此要求的必要 HTTP 標頭。」
  • 400 不正確的要求、MissingRequiredQueryParameter、「未指定此要求的必要查詢參數」。
  • 400 不正確的要求、MultipleConditionHeadersNotSupported、「不支援多個條件標頭」。
  • 400 不正確的要求，OutOfRangeInput，「其中一個要求輸入超出範圍」。
  • 400 不正確的要求，OutOfRangeQueryParameterValue：「要求 URI 中指定的其中一個查詢參數超出允許的範圍」。
  • 400 不正確的要求，UnsupportedHeader，「不支援要求中指定的其中一個標頭」。
  • 400 不正確的要求，UnsupportedQueryParameter，「不支援要求 URI 中指定的其中一個查詢參數。」
  • 400 不正確的要求，UnsupportedRestVersion，「指定的 Rest 版本不受支援」。
  • 403 禁止，AccountIsDisabled，「指定的帳戶已停用」。
  • 403 禁止，AuthorizationFailure：「此要求未獲授權執行這項作業」。
  • 403 禁止，InsufficientAccountPermissions：「正在存取的帳戶沒有足夠的許可權可執行這項作業。」
  • 404 找不到，FilesystemNotFound，「指定的文件系統不存在」。
  • 404 找不到，PathNotFound，「指定的路徑不存在」。
  • 404 找不到，RenameDestinationParentPathNotFound，「目的地路徑的父目錄不存在」。
  • 404 找不到，ResourceNotFound，「指定的資源不存在」。
  • 404 找不到 SourcePathNotFound：「重新命名作業的來源路徑不存在」。
  • 405 方法不允許，不支援 HttpVerb：「資源不支援指定的 HTTP 動詞命令」。
  • 409 Conflict， DestinationPathIsBeingDeleted：「指定的目的地路徑標示為要刪除」。
  • 409 Conflict， DirectoryNotEmpty：「遞歸查詢參數值必須為 true，才能刪除非空白目錄。」
  • 409 Conflict， FilesystemAlreadyExists，「指定的文件系統已經存在」。
  • 409 Conflict， FilesystemBeingDeleted，「正在刪除指定的文件系統」。
  • 409 Conflict、InvalidDestinationPath、「指定的路徑或路徑的專案存在，而且其資源類型對此作業無效」。* 409 Conflict， InvalidFlushOperation，「資源是由 Blob 服務 API 所建立或修改，而且無法由 Data Lake Storage 服務 API 寫入。」
  • 409 Conflict， InvalidRenameSourcePath：「來源目錄不能與目的地目錄相同，也無法目的地是來源目錄的子目錄。」
  • 409 Conflict，InvalidSourceOrDestinationResourceType：「來源和目的地資源類型必須相同」。
  • 409 Conflict， LeaseAlreadyPresent，「已經有租用存在」。
  • 409 Conflict， LeaseIdMismatchWithLeaseOperation：「指定的租用標識符不符合具有指定租用作業之資源的租用標識符」。
  • 409 Conflict， LeaseIsAlreadyBroken：「租用已中斷，無法再中斷」。
  • 409 Conflict， LeaseIsBreakingAndCannotBeAcquired：「租用標識符相符，但租用目前處於中斷狀態，且在中斷之前無法取得」。
  • 409 Conflict， LeaseIsBreakingAndCannotBeChanged：「租用標識符相符，但租用目前處於中斷狀態且無法變更」。
  • 409 Conflict， LeaseIsBrokenAndCannotBeRenewed：「租用標識符相符，但租用已明確中斷且無法更新。」
  • 409 Conflict， LeaseNameMismatch，「指定的租用名稱不符合現有的租用名稱」。
  • 409 Conflict， LeaseNotPresentWithLeaseOperation：「租用標識符不存在於指定的租用作業中」。
  • 409 Conflict，PathAlreadyExists，「指定的路徑已經存在」。
  • 409 Conflict、PathConflict、「指定的路徑或路徑的專案存在，且其資源類型對此作業無效」。
  • 409 Conflict， SourcePathIsBeingDeleted：「指定的來源路徑標示為要刪除」。
  • 409 Conflict， ResourceTypeMismatch，「要求中指定的資源類型不符合資源的類型」。
  • 412 前置條件失敗，ConditionNotMet：「不符合使用 HTTP 條件式標頭指定的條件 () 。」
  • 412 前置條件失敗，LeaseIdMismatch：「指定的租用標識碼不符合資源的租用標識符」。
  • 412 前置條件失敗，LeaseIdMissing：「資源目前有租用，且要求中未指定租用標識符」。
  • 412 前置條件失敗，LeaseNotPresent：「資源目前沒有租用。」
  • 412 前置條件失敗，LeaseLost，「已指定租用標識碼，但資源的租用已過期。」
  • 412 前置條件失敗，SourceConditionNotMet：「不符合使用 HTTP 條件式標頭指定的來源條件 () 。」
  • 413 要求實體太大，RequestBodyTooLarge：「要求本文太大，超過允許的最大限制」。
  • 416 要求的範圍無法滿足，InvalidRange：「指定的範圍對目前資源的大小無效」。
  • 500 內部伺服器錯誤，InternalError：「伺服器發生內部錯誤。 請重試要求。」
  • 500 內部伺服器錯誤 OperationTimedOut：「作業無法在允許的時間內完成。」
  • 503 服務無法使用，ServerBusy，「輸出超過帳戶限制」。
  • 503 服務無法使用，ServerBusy，「輸入超過帳戶限制」。
  • 503 服務無法使用，ServerBusy，「每秒的作業超過帳戶限制」。
  • 503 服務無法使用，ServerBusy：「伺服器目前無法接收要求。 請重試您的要求。」

Headers

  • x-ms-request-id: string
  • x-ms-version: string

定義

名稱 Description
AclFailedEntryList
DataLakeStorageError
Error

服務錯誤回應物件。
PathLeaseAction

從附加和排清作業的 2020-08-04 版開始。 Append 支援 'acquire'、'auto-renew' 和 'acquire-release' 動作。 如果 'acquire' 會取得租用。 如果 「自動更新」，則會更新租用。 如果 'acquire-release' 會取得 & 完成作業，& 作業完成後釋放租用。 只有在排清作業中才支援 「發行」動作。 如果為 'true'，則會使用 x-ms-lease-id 標頭中的租用標識符信息，釋放檔案上的租用。
PathUpdateAction

動作必須是 「附加」，才能將數據附加至檔案、「flush」以排清先前上傳的數據至檔案、“setProperties” 設定檔案或目錄的屬性，或 “setAccessControl” 來設定檔案或目錄的擁有者、群組、許可權或訪問控制清單，或以遞歸方式設定目錄的訪問控制清單。 請注意，必須啟用帳戶的階層命名空間，才能使用訪問控制。 另請注意，存取控制 清單 (ACL) 包含擁有者、擁有群組和其他許可權的許可權，因此 x-ms-permissions 和 x-ms-acl 要求標頭互斥。
SetAccessControlRecursiveResponse

AclFailedEntryList

名稱 類型 Description
errorMessage

string

name

string

type

string

DataLakeStorageError

名稱 類型 Description
error

Error

服務錯誤回應物件。

Error

服務錯誤回應物件。

名稱 類型 Description
code

string

服務錯誤碼。
message

string

服務錯誤訊息。

PathLeaseAction

從附加和排清作業的 2020-08-04 版開始。 Append 支援 'acquire'、'auto-renew' 和 'acquire-release' 動作。 如果 'acquire' 會取得租用。 如果 「自動更新」，則會更新租用。 如果 'acquire-release' 會取得 & 完成作業，& 作業完成後釋放租用。 只有在排清作業中才支援 「發行」動作。 如果為 'true'，則會使用 x-ms-lease-id 標頭中的租用標識符信息，釋放檔案上的租用。

名稱 類型 Description
acquire

string

acquire-release

string

auto-renew

string

release

string

PathUpdateAction

動作必須是 「附加」，才能將數據附加至檔案、「flush」以排清先前上傳的數據至檔案、“setProperties” 設定檔案或目錄的屬性，或 “setAccessControl” 來設定檔案或目錄的擁有者、群組、許可權或訪問控制清單，或以遞歸方式設定目錄的訪問控制清單。 請注意，必須啟用帳戶的階層命名空間，才能使用訪問控制。 另請注意，存取控制 清單 (ACL) 包含擁有者、擁有群組和其他許可權的許可權，因此 x-ms-permissions 和 x-ms-acl 要求標頭互斥。

名稱 類型 Description
append

string

flush

string

setAccessControl

string

setAccessControlRecursive

string

setProperties

string

SetAccessControlRecursiveResponse

名稱 類型 Description
directoriesSuccessful

integer

failedEntries

AclFailedEntryList[]

failureCount

integer

filesSuccessful

integer