共用方式為

Path - Read

  • 參考
服務:
Storage Services
API 版本:
2023-08-03

讀取檔案
讀取檔案的內容。 針對讀取作業，支援範圍要求。 此作業支援條件式 HTTP 要求。 如需詳細資訊，請參閱 為 Blob 服務作業指定條件式標頭。

GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
含選擇性參數: 
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}

URI 參數

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

string

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

string

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

string

minLength: 3
maxLength: 63
pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

文件系統標識碼。
path
 path True

string

檔案或目錄路徑。
timeout
 query

integer (int32)

minimum: 1

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

要求標頭

名稱 必要 類型 Description
Range

string

HTTP Range 要求標頭會指定要擷取之資源的一或多個字節範圍。
x-ms-lease-id

string

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

選擇性。 如果指定此標頭，只有在符合下列兩個條件時，才會執行此作業：i） 路徑的租用目前為使用中，而ii要求中指定的租用標識元符合路徑的租用標識符。
x-ms-range-get-content-md5

boolean

選擇性。 當此標頭設定為 「true」 且與 Range 標頭一起指定時，服務會傳回該範圍的 MD5 哈希，只要範圍的大小小於或等於 4MB。 如果未指定此標頭，則服務會傳回狀態代碼 400 （不正確的要求）。 如果此標頭在大小超過 4 MB 時設定為 true，則服務會傳回狀態代碼 400 （不正確的要求）。
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-client-request-id

string

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

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

string

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

string

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

回應

名稱 類型 Description
200 OK

file

還行

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

標題

  • 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
  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-resource-type: string
  • x-ms-properties: string
  • x-ms-lease-duration: string
  • x-ms-lease-state: string
  • x-ms-lease-status: string
  • x-ms-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-context: string
  • x-ms-encryption-scope: string
Other Status Codes

file

部分內容

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

標題

  • 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-content-md5: string
  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-resource-type: string
  • x-ms-properties: string
  • x-ms-lease-duration: string
  • x-ms-lease-state: string
  • x-ms-lease-status: string
  • x-ms-server-encrypted: true/false: boolean
  • x-ms-encryption-key-sha256: string
  • x-ms-encryption-context: string
  • x-ms-encryption-scope: string
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 衝突，FilesystemBeingDeleted，「正在刪除指定的文件系統」。
  • 409 Conflict， InvalidDestinationPath， “指定的路徑或路徑的專案存在，而且其資源類型對這項作業無效。* 409 衝突，InvalidFlushOperation，「資源是由 Blob 服務 API 所建立或修改，無法由 Data Lake Storage Service API 寫入。
  • 409 Conflict， InvalidRenameSourcePath， “來源目錄不能與目的地目錄相同，目的地也不能是來源目錄的子目錄。
  • 409 Conflict，InvalidSourceOrDestinationResourceType，「來源和目的地資源類型必須相同」。
  • 409 衝突，LeaseAlreadyPresent，“已經有租用存在。
  • 409 Conflict，LeaseIdMismatchWithLeaseOperation：「指定的租用標識符與指定租用作業的資源租用標識符不符」。
  • 409 衝突，LeaseIsAlreadyBroken，“租用已經中斷，不能再中斷。
  • 409 Conflict， LeaseIsBreakingAndCannotBeAcquired， “租用標識符相符，但租用目前處於中斷狀態，而且在中斷之前無法取得。
  • 409 Conflict， LeaseIsBreakingAndCannotBeChanged：「租用標識符相符，但租用目前處於中斷狀態且無法變更」。
  • 409 衝突，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：「伺服器目前無法接收要求。 請重試您的要求。

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

標題

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

定義

名稱 Description
DataLakeStorageError
Error

服務錯誤回應物件。

DataLakeStorageError

Object
名稱 類型 Description
error

Error

服務錯誤回應物件。

Error

Object

服務錯誤回應物件。

名稱 類型 Description
code

string

服務錯誤碼。
message

string

服務錯誤訊息。