Path - Get Properties

Referens

Tjänst:: Storage Services

API-version:: 2023-08-03

Hämta egenskaper | Hämta status | Hämta Access Control lista | Kontrollera åtkomst
Hämta egenskaper returnerar alla system- och användardefinierade egenskaper för en sökväg. Hämta status returnerar alla systemdefinierade egenskaper för en sökväg. Get Access Control List returnerar åtkomstkontrollistan för en sökväg. Den här åtgärden stöder villkorsstyrda HTTP-begäranden. Mer information finns i Ange villkorsstyrda rubriker för Blob Service-åtgärder.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}

Med valfria parametrar:

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Namnet på Azure Storage-kontot.
dnsSuffix	path	True	string	DNS-suffixet för Azure Data Lake Storage-slutpunkten.
filesystem	path	True	string	Filsystemidentifieraren. Reguljärt uttrycksmönster: `^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$`
path	path	True	string	Fil- eller katalogsökvägen.
action	query		PathGetPropertiesAction	Valfritt. Om värdet är "getStatus" returneras endast systemdefinierade egenskaper för sökvägen. Om värdet är "getAccessControl" returneras åtkomstkontrollistan i svarshuvudena (hierarkisk namnrymd måste vara aktiverat för kontot), annars returneras egenskaperna.
fsAction	query		string	Krävs endast för att kontrollera åtkomståtgärden. Gäller endast när hierarkisk namnrymd är aktiverat för kontot. Filsystemåtgärden read/write/execute in string form, matching regex pattern '[rwx-]{3}'
timeout	query		integer int32	Ett valfritt timeoutvärde för åtgärden i sekunder. Perioden börjar när begäran tas emot av tjänsten. Om tidsgränsvärdet förflutit innan åtgärden slutförs misslyckas åtgärden.
upn	query		boolean	Valfritt. Gäller endast när hierarkisk namnrymd är aktiverat för kontot. Om det är "sant" omvandlas användaridentitetsvärdena som returneras i svarshuvudena x-ms-owner, x-ms-group och x-ms-acl från Azure Active Directory-objekt-ID:t till användarens huvudnamn. Om värdet är "false" returneras de som Objekt-ID:t för Azure Active Directory. Standardvärdet är false. Observera att grupp- och programobjekt-ID:t inte översätts eftersom de inte har unika egna namn.

Begärandehuvud

Name	Typ	Description
x-ms-lease-id	string	Valfritt. Om det här huvudet anges utförs åtgärden endast om båda följande villkor är uppfyllda: i) sökvägens lån är för närvarande aktivt och ii) låne-ID:t som anges i begäran matchar sökvägens. Reguljärt uttrycksmönster: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
If-Match	string	Valfritt. Ett ETag-värde. Ange det här huvudet för att utföra åtgärden endast om resursens ETag matchar det angivna värdet. ETag måste anges inom citattecken.
If-None-Match	string	Valfritt. Ett ETag-värde eller ett särskilt jokerteckenvärde ("*"). Ange det här huvudet för att utföra åtgärden endast om resursens ETag inte matchar det angivna värdet. ETag måste anges inom citattecken.
If-Modified-Since	string	Valfritt. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen har ändrats sedan det angivna datumet och tiden.
If-Unmodified-Since	string	Valfritt. Ett datum- och tidsvärde. Ange det här huvudet för att utföra åtgärden endast om resursen inte har ändrats sedan det angivna datumet och tiden.
x-ms-encryption-key	string	Valfritt. Den Base64-kodade AES-256-krypteringsnyckeln.
x-ms-encryption-key-sha256	string	Valfritt. Den Base64-kodade SHA256-hashen för krypteringsnyckeln.
x-ms-encryption-algorithm: AES256	string	Valfritt. Anger vilken algoritm som ska användas för kryptering. Värdet för det här huvudet måste vara AES256.
x-ms-client-request-id	string	Ett UUID som registrerats i analysloggarna för felsökning och korrelation. Reguljärt uttrycksmönster: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
x-ms-date	string	Anger Coordinated Universal Time (UTC) för begäran. Detta krävs när du använder auktorisering av delad nyckel.
x-ms-version	string	Anger versionen av REST-protokollet som används för bearbetning av begäran. Detta krävs när du använder auktorisering av delad nyckel.

Svar

Name	Typ	Description
200 OK		Returnerar alla egenskaper för filen eller katalogen. Sidhuvuden 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-owner: string x-ms-group: string x-ms-permissions: string x-ms-acl: 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 x-ms-creation-time: string x-ms-expiry-time: string x-ms-client-transaction-id: string
Other Status Codes	DataLakeStorageError	Ett fel inträffade. De möjliga HTTP-status-, kod- och meddelandesträngarna visas nedan: 400 Felaktig begäran, ContentLengthMustBeZero, "Rubriken för innehållslängdsbegäran måste vara noll". 400 Felaktig begäran, InvalidAuthenticationInfo, "Autentiseringsinformation ges inte i rätt format. Kontrollera värdet för auktoriseringshuvud." 400 Felaktig begäran, InvalidFlushPosition, "De uppladdade data är inte sammanhängande eller värdet för parametervärdet för positionsfrågan är inte lika med filens längd efter att de uppladdade data har lagts till." 400 Felaktig begäran, InvalidHeaderValue, "Värdet för en av HTTP-huvudena är inte i rätt format." 400 Felaktig begäran, InvalidHttpVerb, "Det angivna HTTP-verbet är ogiltigt – det känns inte igen av servern." 400 Felaktig begäran, InvalidInput, "En av begärandeindata är inte giltig." 400 Felaktig begäran, InvalidPropertyName, "Ett egenskapsnamn får inte vara tomt". 400 Felaktig begäran, InvalidPropertyName, "Egenskapsnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidQueryParameterValue, "Värdet för en av frågeparametrarna som anges i begärans URI är ogiltigt.". 400 Felaktig begäran, InvalidResourceName, "Det angivna resursnamnet innehåller ogiltiga tecken". 400 Felaktig begäran, InvalidSourceUri, "Käll-URI:n är ogiltig". 400 Felaktig begäran, InvalidUri, "Begärans URI är ogiltig". 400 Felaktig begäran, MissingRequiredHeader, "Ett HTTP-huvud som är obligatoriskt för den här begäran har inte angetts." 400 Felaktig begäran, MissingRequiredQueryParameter, "En frågeparameter som är obligatorisk för den här begäran har inte angetts.". 400 Felaktig begäran, MultipleConditionHeadersNotSupported, "Flera villkorsrubriker stöds inte.". 400 Bad Request, OutOfRangeInput, "One of the request inputs is out of range". 400 Bad Request, OutOfRangeQueryParameterValue, "En av frågeparametrarna som anges i begärande-URI:n ligger utanför det tillåtna intervallet." 400 Felaktig begäran, UnsupportedHeader, "En av de rubriker som anges i begäran stöds inte." 400 Bad Request, UnsupportedQueryParameter, "En av frågeparametrarna som anges i begärande-URI:n stöds inte." 400 Felaktig begäran,RestVersion stöds inte, "Den angivna restversionen stöds inte.". 403 Förbjuden, AccountIsDisabled, "Det angivna kontot är inaktiverat". 403 Förbjuden, AuthorizationFailure, "Denna begäran har inte behörighet att utföra den här åtgärden." 403 Förbjuden, InsufficientAccountPermissions: "Kontot som används har inte tillräcklig behörighet för att köra den här åtgärden." 404 Hittades inte, FilesystemNotFound, "Det angivna filsystemet finns inte." 404 Hittades inte, PathNotFound, "Den angivna sökvägen finns inte". 404 Hittades inte, RenameDestinationParentPathNotFound, "Målsökvägens överordnade katalog finns inte.". 404 Hittades inte, ResourceNotFound, "Den angivna resursen finns inte.". 404 Hittades inte, SourcePathNotFound, "Källsökvägen för en namnbytesåtgärd finns inte." 405-metoden är inte tillåten, stöds inteHttpVerb, "Resursen stöder inte det angivna HTTP-verbet." 409 Conflict, DestinationPathIsBeingDeleted, "Den angivna målsökvägen är markerad som att tas bort". 409 Conflict, DirectoryNotEmpty, "Det rekursiva frågeparametervärdet måste vara sant för att ta bort en icke-tom katalog." 409 Konflikt, FilesystemAlreadyExists, "Det angivna filsystemet finns redan." 409 Conflict, FilesystemBeingDeleted, "Det angivna filsystemet tas bort". 409 Konflikt, InvalidDestinationPath, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." * 409 Conflict, InvalidFlushOperation, "Resursen skapades eller ändrades av Blob Service API och kan inte skrivas till av Data Lake Storage Service API." 409 Konflikt, InvalidRenameSourcePath, "Källkatalogen får inte vara samma som målkatalogen och inte heller kan målet vara en underkatalog till källkatalogen." 409 Konflikt, InvalidSourceOrDestinationResourceType, "Käll- och målresurstypen måste vara identisk." 409 Konflikt, LeaseAlreadyPresent, "Det finns redan ett lån närvarande." 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen med den angivna låneåtgärden." 409 Konflikt, LeaseIsAlreadyBroken, "Lånet har redan brutits och kan inte brytas igen." 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte förvärvas förrän det har brutits." 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte ändras." 409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Låne-ID matchade, men lånet har brutits uttryckligen och kan inte förnyas." 409 Konflikt, LeaseNameMismatch, "Det angivna lånenamnet matchade inte det befintliga lånenamnet." 409 Konflikt, LeaseNotPresentWithLeaseOperation, "Låne-ID:t finns inte med den angivna låneåtgärden." 409 Konflikt, PathAlreadyExists, "Den angivna sökvägen finns redan.". 409 Konflikt, PathConflict, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." 409 Conflict, SourcePathIsBeingDeleted, "Den angivna källsökvägen är markerad som att tas bort". 409 Konflikt, ResourceTypeMismatch, "Resurstypen som anges i begäran matchar inte resurstypen." 412 Villkoret misslyckades, ConditionNotMet, "Villkoret som anges med http-villkorliga huvuden är inte uppfyllt." 412 Förutsättningen misslyckades, LeaseIdMismatch, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen." 412 Förutsättningen misslyckades, LeaseIdMissing, "Det finns för närvarande ett lån på resursen och inget låne-ID angavs i begäran." 412 Förutsättningen misslyckades, LeaseNotPresent, "Det finns för närvarande inget lån på resursen." 412 Förutsättningen misslyckades, LeaseLost, "Ett låne-ID angavs, men lånet för resursen har upphört att gälla." 412 Villkoret misslyckades, SourceConditionNotMet, "Källvillkoret som anges med http-villkorsrubriker är inte uppfyllt." 413 Begärandeentiteten är för stor, RequestBodyTooLarge, "Begärandetexten är för stor och överskrider den maximala tillåtna gränsen." 416 Det begärda intervallet är inte uppfyllt, InvalidRange, "Det angivna intervallet är ogiltigt för resursens aktuella storlek." 500 Internt serverfel, InternalError, "Servern påträffade ett internt fel. Försök igen." 500 Internt serverfel, OperationTimedOut, "Åtgärden kunde inte slutföras inom den tillåtna tiden." 503 Tjänsten är inte tillgänglig, ServerBusy, "Utgående trafik överskrider kontogränsen." 503 Tjänsten är inte tillgänglig, ServerBusy, "Ingress is over the account limit". 503 Tjänsten är inte tillgänglig, ServerBusy, "Åtgärder per sekund överskrider kontogränsen". 503 Tjänsten är inte tillgänglig, ServerBusy, "Servern kan för närvarande inte ta emot begäranden. Försök igen." Sidhuvuden x-ms-request-id: string x-ms-version: string

Name

Typ

Description

200 OK

Returnerar alla egenskaper för filen eller katalogen.

Sidhuvuden

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-owner: string
x-ms-group: string
x-ms-permissions: string
x-ms-acl: 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
x-ms-creation-time: string
x-ms-expiry-time: string
x-ms-client-transaction-id: string

Other Status Codes

DataLakeStorageError

Ett fel inträffade. De möjliga HTTP-status-, kod- och meddelandesträngarna visas nedan:

400 Felaktig begäran, ContentLengthMustBeZero, "Rubriken för innehållslängdsbegäran måste vara noll".
400 Felaktig begäran, InvalidAuthenticationInfo, "Autentiseringsinformation ges inte i rätt format. Kontrollera värdet för auktoriseringshuvud."
400 Felaktig begäran, InvalidFlushPosition, "De uppladdade data är inte sammanhängande eller värdet för parametervärdet för positionsfrågan är inte lika med filens längd efter att de uppladdade data har lagts till."
400 Felaktig begäran, InvalidHeaderValue, "Värdet för en av HTTP-huvudena är inte i rätt format."
400 Felaktig begäran, InvalidHttpVerb, "Det angivna HTTP-verbet är ogiltigt – det känns inte igen av servern."
400 Felaktig begäran, InvalidInput, "En av begärandeindata är inte giltig."
400 Felaktig begäran, InvalidPropertyName, "Ett egenskapsnamn får inte vara tomt".
400 Felaktig begäran, InvalidPropertyName, "Egenskapsnamnet innehåller ogiltiga tecken".
400 Felaktig begäran, InvalidQueryParameterValue, "Värdet för en av frågeparametrarna som anges i begärans URI är ogiltigt.".
400 Felaktig begäran, InvalidResourceName, "Det angivna resursnamnet innehåller ogiltiga tecken".
400 Felaktig begäran, InvalidSourceUri, "Käll-URI:n är ogiltig".
400 Felaktig begäran, InvalidUri, "Begärans URI är ogiltig".
400 Felaktig begäran, MissingRequiredHeader, "Ett HTTP-huvud som är obligatoriskt för den här begäran har inte angetts."
400 Felaktig begäran, MissingRequiredQueryParameter, "En frågeparameter som är obligatorisk för den här begäran har inte angetts.".
400 Felaktig begäran, MultipleConditionHeadersNotSupported, "Flera villkorsrubriker stöds inte.".
400 Bad Request, OutOfRangeInput, "One of the request inputs is out of range".
400 Bad Request, OutOfRangeQueryParameterValue, "En av frågeparametrarna som anges i begärande-URI:n ligger utanför det tillåtna intervallet."
400 Felaktig begäran, UnsupportedHeader, "En av de rubriker som anges i begäran stöds inte."
400 Bad Request, UnsupportedQueryParameter, "En av frågeparametrarna som anges i begärande-URI:n stöds inte."
400 Felaktig begäran,RestVersion stöds inte, "Den angivna restversionen stöds inte.".
403 Förbjuden, AccountIsDisabled, "Det angivna kontot är inaktiverat".
403 Förbjuden, AuthorizationFailure, "Denna begäran har inte behörighet att utföra den här åtgärden."
403 Förbjuden, InsufficientAccountPermissions: "Kontot som används har inte tillräcklig behörighet för att köra den här åtgärden."
404 Hittades inte, FilesystemNotFound, "Det angivna filsystemet finns inte."
404 Hittades inte, PathNotFound, "Den angivna sökvägen finns inte".
404 Hittades inte, RenameDestinationParentPathNotFound, "Målsökvägens överordnade katalog finns inte.".
404 Hittades inte, ResourceNotFound, "Den angivna resursen finns inte.".
404 Hittades inte, SourcePathNotFound, "Källsökvägen för en namnbytesåtgärd finns inte."
405-metoden är inte tillåten, stöds inteHttpVerb, "Resursen stöder inte det angivna HTTP-verbet."
409 Conflict, DestinationPathIsBeingDeleted, "Den angivna målsökvägen är markerad som att tas bort".
409 Conflict, DirectoryNotEmpty, "Det rekursiva frågeparametervärdet måste vara sant för att ta bort en icke-tom katalog."
409 Konflikt, FilesystemAlreadyExists, "Det angivna filsystemet finns redan."
409 Conflict, FilesystemBeingDeleted, "Det angivna filsystemet tas bort".
409 Konflikt, InvalidDestinationPath, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden." * 409 Conflict, InvalidFlushOperation, "Resursen skapades eller ändrades av Blob Service API och kan inte skrivas till av Data Lake Storage Service API."
409 Konflikt, InvalidRenameSourcePath, "Källkatalogen får inte vara samma som målkatalogen och inte heller kan målet vara en underkatalog till källkatalogen."
409 Konflikt, InvalidSourceOrDestinationResourceType, "Käll- och målresurstypen måste vara identisk."
409 Konflikt, LeaseAlreadyPresent, "Det finns redan ett lån närvarande."
409 Conflict, LeaseIdMismatchWithLeaseOperation, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen med den angivna låneåtgärden."
409 Konflikt, LeaseIsAlreadyBroken, "Lånet har redan brutits och kan inte brytas igen."
409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte förvärvas förrän det har brutits."
409 Conflict, LeaseIsBreakingAndCannotBeChanged, "Låne-ID:t matchade, men lånet är för närvarande i ett icke-bakåtkompatibelt tillstånd och kan inte ändras."
409 Konflikt, LeaseIsBrokenAndCannotBeRenewed, "Låne-ID matchade, men lånet har brutits uttryckligen och kan inte förnyas."
409 Konflikt, LeaseNameMismatch, "Det angivna lånenamnet matchade inte det befintliga lånenamnet."
409 Konflikt, LeaseNotPresentWithLeaseOperation, "Låne-ID:t finns inte med den angivna låneåtgärden."
409 Konflikt, PathAlreadyExists, "Den angivna sökvägen finns redan.".
409 Konflikt, PathConflict, "Den angivna sökvägen eller ett element i sökvägen finns och dess resurstyp är ogiltig för den här åtgärden."
409 Conflict, SourcePathIsBeingDeleted, "Den angivna källsökvägen är markerad som att tas bort".
409 Konflikt, ResourceTypeMismatch, "Resurstypen som anges i begäran matchar inte resurstypen."
412 Villkoret misslyckades, ConditionNotMet, "Villkoret som anges med http-villkorliga huvuden är inte uppfyllt."
412 Förutsättningen misslyckades, LeaseIdMismatch, "Det angivna låne-ID:t matchade inte låne-ID:t för resursen."
412 Förutsättningen misslyckades, LeaseIdMissing, "Det finns för närvarande ett lån på resursen och inget låne-ID angavs i begäran."
412 Förutsättningen misslyckades, LeaseNotPresent, "Det finns för närvarande inget lån på resursen."
412 Förutsättningen misslyckades, LeaseLost, "Ett låne-ID angavs, men lånet för resursen har upphört att gälla."
412 Villkoret misslyckades, SourceConditionNotMet, "Källvillkoret som anges med http-villkorsrubriker är inte uppfyllt."
413 Begärandeentiteten är för stor, RequestBodyTooLarge, "Begärandetexten är för stor och överskrider den maximala tillåtna gränsen."
416 Det begärda intervallet är inte uppfyllt, InvalidRange, "Det angivna intervallet är ogiltigt för resursens aktuella storlek."
500 Internt serverfel, InternalError, "Servern påträffade ett internt fel. Försök igen."
500 Internt serverfel, OperationTimedOut, "Åtgärden kunde inte slutföras inom den tillåtna tiden."
503 Tjänsten är inte tillgänglig, ServerBusy, "Utgående trafik överskrider kontogränsen."
503 Tjänsten är inte tillgänglig, ServerBusy, "Ingress is over the account limit".
503 Tjänsten är inte tillgänglig, ServerBusy, "Åtgärder per sekund överskrider kontogränsen".
503 Tjänsten är inte tillgänglig, ServerBusy, "Servern kan för närvarande inte ta emot begäranden. Försök igen."

Sidhuvuden

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

Definitioner

Name	Description
DataLakeStorageError
Error	Svarsobjektet för tjänstfel.
PathGetPropertiesAction	Valfritt. Om värdet är "getStatus" returneras endast systemdefinierade egenskaper för sökvägen. Om värdet är "getAccessControl" returneras åtkomstkontrollistan i svarshuvudena (hierarkisk namnrymd måste aktiveras för kontot), annars returneras egenskaperna.

DataLakeStorageError

Name	Typ	Description
error	Error	Svarsobjektet för tjänstfel.

Error

Svarsobjektet för tjänstfel.

Name	Typ	Description
code	string	Felkoden för tjänsten.
message	string	Tjänstens felmeddelande.