filedatalake Pakket

Pakketten

aio

Klassen

AccessControlChangeCounters	AccessControlChangeCounters bevat aantallen bewerkingen die Access Control lijsten recursief wijzigen.
AccessControlChangeFailure	Vertegenwoordigt een vermelding die Access Control Lijst niet kan bijwerken.
AccessControlChangeResult	AccessControlChangeResult bevat het resultaat van bewerkingen die Access Control lijsten recursief wijzigen.
AccessControlChanges	AccessControlChanges bevat batch- en cumulatieve aantallen bewerkingen die Access Control lijsten recursief wijzigen. Daarnaast worden padvermeldingen weergegeven die niet zijn bijgewerkt terwijl deze bewerkingen worden uitgevoerd.
AccessPolicy	Toegangsbeleidsklasse die wordt gebruikt door de ingestelde en get-toegangsbeleidsmethoden in elke service. Een opgeslagen toegangsbeleid kan de begintijd, verlooptijd en machtigingen opgeven voor de Shared Access Signatures waaraan het is gekoppeld. Afhankelijk van hoe u de toegang tot uw resource wilt beheren, kunt u al deze parameters opgeven in het opgeslagen toegangsbeleid en deze weglaten uit de URL voor de Shared Access Signature. Als u dit doet, kunt u het gedrag van de bijbehorende handtekening op elk gewenst moment wijzigen en intrekken. U kunt ook een of meer van de parameters voor het toegangsbeleid opgeven in het opgeslagen toegangsbeleid en de andere parameters op de URL. Ten slotte kunt u alle parameters op de URL opgeven. In dit geval kunt u het opgeslagen toegangsbeleid gebruiken om de handtekening in te trekken, maar niet om het gedrag ervan te wijzigen. De Shared Access Signature en het opgeslagen toegangsbeleid moeten samen alle velden bevatten die nodig zijn om de handtekening te verifiëren. Als er vereiste velden ontbreken, mislukt de aanvraag. Op dezelfde manier mislukt de aanvraag met statuscode 400 (Ongeldige aanvraag) als er een veld is opgegeven in zowel de SHARED Access Signature-URL als in het opgeslagen toegangsbeleid.
AccountSasPermissions
AnalyticsLogging	Instellingen voor logboekregistratie van Azure Analytics.
ArrowDialect	veld van een pijlschema. Alle vereiste parameters moeten worden ingevuld om naar Azure te kunnen worden verzonden.
ContentSettings	De inhoudsinstellingen van een bestand of map.
CorsRule	CORS is een HTTP-functie waarmee een webtoepassing die wordt uitgevoerd onder één domein, toegang kan krijgen tot resources in een ander domein. Webbrowsers implementeren een beveiligingsbeperking die bekend staat als same orgine-beleid waarmee wordt voorkomen dat een webpagina API's in een ander domein aanroept. CORS biedt een veilige manier om het ene domein (het oorspronkelijke domein) toe te staan om API's in een ander domein aan te roepen.
CustomerProvidedEncryptionKey	Alle gegevens in Azure Storage worden in rust versleuteld met behulp van een versleutelingssleutel op accountniveau. In versies 2021-06-08 en hoger kunt u de sleutel beheren die wordt gebruikt voor het versleutelen van bestandsinhoud en metagegevens van toepassingen per bestand door een AES-256-versleutelingssleutel op te geven in aanvragen voor de opslagservice. Wanneer u een door de klant verstrekte sleutel gebruikt, beheert of bewaart Azure Storage uw sleutel niet. Wanneer u gegevens naar een bestand schrijft, wordt de opgegeven sleutel gebruikt om uw gegevens te versleutelen voordat deze naar de schijf worden geschreven. Een SHA-256-hash van de versleutelingssleutel wordt geschreven naast de bestandsinhoud en wordt gebruikt om te controleren of alle volgende bewerkingen voor het bestand dezelfde versleutelingssleutel gebruiken. Deze hash kan niet worden gebruikt om de versleutelingssleutel op te halen of de inhoud van het bestand te ontsleutelen. Bij het lezen van een bestand wordt de opgegeven sleutel gebruikt om uw gegevens te ontsleutelen nadat deze van schijf zijn gelezen. In beide gevallen wordt de opgegeven versleutelingssleutel veilig verwijderd zodra het versleutelings- of ontsleutelingsproces is voltooid.
DataLakeDirectoryClient	Een client voor interactie met de DataLake-map, zelfs als de map mogelijk nog niet bestaat. Voor bewerkingen die betrekking hebben op een specifieke submap of een specifiek bestand in de map, kan een mapclient of bestandsclient worden opgehaald met behulp van de get_sub_directory_client functies of get_file_client .
DataLakeFileClient	Een client voor interactie met het DataLake-bestand, zelfs als het bestand mogelijk nog niet bestaat.
DataLakeFileQueryError	De fout is opgetreden tijdens de snelle querybewerking.
DataLakeLeaseClient	Hiermee maakt u een nieuwe DataLakeLeaseClient. Deze client biedt leasebewerkingen op een FileSystemClient, DataLakeDirectoryClient of DataLakeFileClient.
DataLakeServiceClient	Een client voor interactie met de DataLake-service op accountniveau. Deze client biedt bewerkingen voor het ophalen en configureren van de accounteigenschappen, evenals het weergeven, maken en verwijderen van bestandssystemen binnen het account. Voor bewerkingen met betrekking tot een specifiek bestandssysteem, een specifieke map of een specifiek bestand kunnen clients voor die entiteiten ook worden opgehaald met behulp van de get_client-functies .
DeletedPathProperties	Eigenschappen ingevuld voor een verwijderd pad.
DelimitedJsonDialect	Definieert de in- of uitvoer-JSON-serialisatie voor een datalake-query. trefwoord str-scheidingsteken: het regelscheidingsteken, de standaardwaarde is ' '
DelimitedTextDialect	Definieert de door invoer of uitvoer gescheiden serialisatie (CSV) voor een datalake-queryaanvraag. trefwoord str scheidingsteken: kolomscheidingsteken, standaard ingesteld op ','. keyword str quotechar: Veldcitaat, standaard ingesteld op '''. keyword str lineterminator: recordscheidingsteken, standaard ingesteld op ' '. keyword str escapechar: Escape-teken, standaard ingesteld op leeg. trefwoord bool has_header: of de blobgegevens headers op de eerste regel bevatten. De standaardwaarde is Onwaar, wat betekent dat de gegevens worden geretourneerd, inclusief de eerste regel. Als deze optie is ingesteld op Waar, worden de gegevens exclusief de eerste regel geretourneerd.
DirectoryProperties
DirectorySasPermissions	De klasse DirectorySasPermissions die moet worden gebruikt met de generate_directory_sas functie .
EncryptionScopeOptions	De standaardconfiguratie van het versleutelingsbereik voor een bestandssysteem. Dit bereik wordt impliciet gebruikt voor alle toekomstige schrijfbewerkingen in het bestandssysteem, maar kan per blobbewerking worden overschreven. Nieuw in versie 12.9.0.
ExponentialRetry	Exponentieel opnieuw proberen. Maakt een exponentiële pogingsobject. De initial_backoff wordt gebruikt voor de eerste nieuwe poging. Volgende nieuwe pogingen worden opnieuw geprobeerd na initial_backoff + increment_power^retry_count seconden.
FileProperties
FileSasPermissions	FileSasPermissions-klasse die moet worden gebruikt met de generate_file_sas functie .
FileSystemClient	Een client om te communiceren met een specifiek bestandssysteem, zelfs als dat bestandssysteem mogelijk nog niet bestaat. Voor bewerkingen die betrekking hebben op een specifieke map of bestand in dit bestandssysteem, kan een mapclient of bestandsclient worden opgehaald met behulp van de get_directory_client functies of get_file_client .
FileSystemProperties	Bestandssysteemeigenschappenklasse. Geretourneerde FileSystemProperties exemplaren geven deze waarden weer via een woordenlijstinterface, bijvoorbeeld: file_system_props["last_modified"]. Daarnaast is de naam van het bestandssysteem beschikbaar als file_system_props["name"].
FileSystemPropertiesPaged	Een iterable van bestandssysteemeigenschappen.
FileSystemSasPermissions	FileSystemSasPermissions-klasse die moet worden gebruikt met de generate_file_system_sas functie .
LeaseProperties	Eigenschappen van DataLake-lease.
LinearRetry	Lineaire nieuwe poging. Maakt een lineair object voor opnieuw proberen.
LocationMode	Hiermee geeft u de locatie op waarnaar de aanvraag moet worden verzonden. Deze modus is alleen van toepassing op RA-GRS-accounts die secundaire leestoegang toestaan. Alle andere accounttypen moeten PRIMARY gebruiken.
Metrics	Een samenvatting van aanvraagstatistieken gegroepeerd per API in aggregaties van uren of minuten.
PathProperties	Padeigenschappen die door get_paths API worden vermeld.
ResourceTypes	Hiermee geeft u de resourcetypen op die toegankelijk zijn met de account-SAS.
RetentionPolicy	Het bewaarbeleid dat bepaalt hoe lang de gekoppelde gegevens moeten blijven bestaan.
StaticWebsite	De eigenschappen waarmee een account een statische website kan hosten.
StorageStreamDownloader	Een streaming-object om te downloaden van Azure Storage.
UserDelegationKey	Vertegenwoordigt een sleutel voor gebruikersdelegatie, die aan de gebruiker wordt verstrekt door Azure Storage op basis van het Azure Active Directory-toegangstoken. De velden worden opgeslagen als eenvoudige tekenreeksen, omdat de gebruiker niet met dit object hoeft te communiceren; om een identificerende SAS te genereren, kan de gebruiker deze eenvoudig doorgeven aan de juiste API.

Enums

ArrowType
PublicAccess	Hiermee geeft u op of gegevens in het bestandssysteem openbaar mogen worden geopend en het toegangsniveau.
QuickQueryDialect	Hiermee geeft u het invoer-/uitvoerdialect voor snelle query's op.
StorageErrorCode

Functies

generate_account_sas

Hiermee wordt een shared access signature gegenereerd voor de DataLake-service.

Gebruik de geretourneerde handtekening als referentieparameter van een DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient of DataLakeFileClient.

generate_account_sas(account_name: str, account_key: str, resource_types: ResourceTypes | str, permission: AccountSasPermissions | str, expiry: datetime | str | None, **kwargs: Any) -> str

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt om de shared access signature te genereren.

account_key

str

Vereist

De toegangssleutel voor het genereren van de shared access signature.

resource_types

str of ResourceTypes

Vereist

Hiermee geeft u de resourcetypen op die toegankelijk zijn met de account-SAS.

permission

str of AccountSasPermissions

Vereist

De machtigingen die zijn gekoppeld aan de handtekening voor gedeelde toegang. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Vereist, tenzij een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

Vereist

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist, tenzij een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

Het tijdstip waarop de handtekening voor gedeelde toegang geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

ip

str

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres van waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 op de SAS opgeeft, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_directory_sas

Hiermee wordt een shared access signature voor een map gegenereerd.

Gebruik de geretourneerde handtekening met de referentieparameter van een DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient of DataLakeFileClient.

generate_directory_sas(account_name: str, file_system_name: str, directory_name: str, credential: str | UserDelegationKey, permission: DirectorySasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

file_system_name

str

Vereist

De naam van het bestandssysteem.

directory_name

str

Vereist

De naam van de map.

credential

str of UserDelegationKey

Vereist

Referenties kunnen accountsleutels of gebruikersdelegatiesleutel zijn. Als accountsleutel wordt gebruikt als referentie, moet het referentietype een str zijn. In plaats van een accountsleutel kan de gebruiker ook een gebruikersdelegatiesleutel doorgeven. Een sleutel voor gebruikersdelegatie kan worden verkregen van de service door te verifiëren met een AAD-identiteit; Dit kan worden bereikt door aan te roepen get_user_delegation_key. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

permission

str of DirectorySasPermissions

standaardwaarde: None

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Machtigingen moeten racwdlmeop worden gerangschikt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

Het tijdstip waarop de Shared Access Signature geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

ip

str

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

cache_control

str

Antwoordheaderwaarde voor Cache-Control wanneer de resource wordt geopend met behulp van deze shared access signature.

content_disposition

str

De waarde van de antwoordheader voor Content-Disposition wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_encoding

str

Antwoordheaderwaarde voor inhoudscodering wanneer de resource wordt geopend met behulp van deze shared access signature.

content_language

str

Antwoordheaderwaarde voor Content-Language wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_type

str

Antwoordheaderwaarde voor Inhoudstype wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

preauthorized_agent_object_id

str

De AAD-object-id van een gebruiker wordt verondersteld te zijn geautoriseerd door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend, maar er wordt geen aanvullende machtigingscontrole voor de agentobject-id uitgevoerd.

agent_object_id

str

De AAD-object-id van een gebruiker waarvan wordt aangenomen dat deze niet gemachtigd is door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend. De service voert een extra POSIX ACL-controle uit om te bepalen of deze gebruiker gemachtigd is om de aangevraagde bewerking uit te voeren.

correlation_id

str

De correlatie-id om de auditlogboeken van de opslag te correleren met de auditlogboeken die worden gebruikt door de principal die de SAS genereert en distribueert.

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_file_sas

Hiermee genereert u een shared access signature voor een bestand.

Gebruik de geretourneerde handtekening met de referentieparameter van een BDataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient of DataLakeFileClient.

generate_file_sas(account_name: str, file_system_name: str, directory_name: str, file_name: str, credential: str | UserDelegationKey, permission: FileSasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

file_system_name

str

Vereist

De naam van het bestandssysteem.

directory_name

str

Vereist

De naam van de map.

file_name

str

Vereist

De naam van het bestand.

credential

str of UserDelegationKey

Vereist

Referenties kunnen accountsleutels of gebruikersdelegatiesleutel zijn. Als accountsleutel wordt gebruikt als referentie, moet het referentietype een str zijn. In plaats van een accountsleutel kan de gebruiker ook een gebruikersdelegatiesleutel doorgeven. Een sleutel voor gebruikersdelegatie kan worden verkregen van de service door te verifiëren met een AAD-identiteit; Dit kan worden bereikt door aan te roepen get_user_delegation_key. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

permission

str of FileSasPermissions

standaardwaarde: None

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Machtigingen moeten racwdlmeop worden gerangschikt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

Het tijdstip waarop de Shared Access Signature geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

ip

str

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

cache_control

str

Antwoordheaderwaarde voor Cache-Control wanneer de resource wordt geopend met behulp van deze shared access signature.

content_disposition

str

De waarde van de antwoordheader voor Content-Disposition wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_encoding

str

Antwoordheaderwaarde voor inhoudscodering wanneer de resource wordt geopend met behulp van deze shared access signature.

content_language

str

Antwoordheaderwaarde voor Content-Language wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_type

str

Antwoordheaderwaarde voor Inhoudstype wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

preauthorized_agent_object_id

str

De AAD-object-id van een gebruiker wordt verondersteld te zijn geautoriseerd door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend, maar er wordt geen aanvullende machtigingscontrole voor de agentobject-id uitgevoerd.

agent_object_id

str

De AAD-object-id van een gebruiker waarvan wordt aangenomen dat deze niet gemachtigd is door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend. De service voert een extra POSIX ACL-controle uit om te bepalen of deze gebruiker gemachtigd is om de aangevraagde bewerking uit te voeren.

correlation_id

str

De correlatie-id om de auditlogboeken van de opslag te correleren met de auditlogboeken die worden gebruikt door de principal die de SAS genereert en distribueert. Dit kan alleen worden gebruikt bij het genereren van een SAS met delegatiesleutel.

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str

generate_file_system_sas

Hiermee genereert u een shared access signature voor een bestandssysteem.

Gebruik de geretourneerde handtekening met de referentieparameter van een DataLakeServiceClient, FileSystemClient, DataLakeDirectoryClient of DataLakeFileClient.

generate_file_system_sas(account_name: str, file_system_name: str, credential: str | UserDelegationKey, permission: FileSystemSasPermissions | str | None = None, expiry: datetime | str | None = None, **kwargs: Any) -> str

Parameters

account_name

str

Vereist

De naam van het opslagaccount dat wordt gebruikt voor het genereren van de Shared Access Signature.

file_system_name

str

Vereist

De naam van het bestandssysteem.

credential

str of UserDelegationKey

Vereist

Referenties kunnen accountsleutels of gebruikersdelegatiesleutel zijn. Als accountsleutel wordt gebruikt als referentie, moet het referentietype een str zijn. In plaats van een accountsleutel kan de gebruiker ook een gebruikersdelegatiesleutel doorgeven. Een sleutel voor gebruikersdelegatie kan worden verkregen van de service door te verifiëren met een AAD-identiteit; Dit kan worden bereikt door aan te roepen get_user_delegation_key. Indien aanwezig, wordt de SAS in plaats daarvan ondertekend met de sleutel voor gebruikersdelegatie.

permission

str of FileSystemSasPermissions

standaardwaarde: None

De machtigingen die zijn gekoppeld aan de Shared Access Signature. De gebruiker is beperkt tot bewerkingen die zijn toegestaan door de machtigingen. Machtigingen moeten racwdlmeop worden gerangschikt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid.

expiry

datetime of str

standaardwaarde: None

Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt. Vereist tenzij er een id wordt opgegeven die verwijst naar een opgeslagen toegangsbeleid dat dit veld bevat. Dit veld moet worden weggelaten als het is opgegeven in een gekoppeld opgeslagen toegangsbeleid. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

start

datetime of str

Het tijdstip waarop de Shared Access Signature geldig wordt. Als u dit weglaat, wordt ervan uitgegaan dat de begintijd voor deze aanroep het tijdstip is waarop de opslagservice de aanvraag ontvangt. Azure converteert altijd waarden naar UTC. Als een datum wordt doorgegeven zonder tijdzone-informatie, wordt ervan uitgegaan dat deze UTC is.

ip

str

Hiermee geeft u een IP-adres of een bereik van IP-adressen van waaruit aanvragen te accepteren. Als het IP-adres waaruit de aanvraag afkomstig is, niet overeenkomt met het IP-adres of adresbereik dat is opgegeven in het SAS-token, wordt de aanvraag niet geverifieerd. Als u bijvoorbeeld ip=168.1.5.65 of ip=168.1.5.60-168.1.5.70 opgeeft op de SAS, wordt de aanvraag beperkt tot deze IP-adressen.

protocol

str

Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan. De standaardwaarde is https.

cache_control

str

Antwoordheaderwaarde voor Cache-Control wanneer de resource wordt geopend met behulp van deze shared access signature.

content_disposition

str

De waarde van de antwoordheader voor Content-Disposition wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_encoding

str

Antwoordheaderwaarde voor inhoudscodering wanneer de resource wordt geopend met behulp van deze shared access signature.

content_language

str

Antwoordheaderwaarde voor Content-Language wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

content_type

str

Antwoordheaderwaarde voor Inhoudstype wanneer de resource wordt geopend met behulp van deze Shared Access Signature.

preauthorized_agent_object_id

str

De AAD-object-id van een gebruiker wordt verondersteld te zijn geautoriseerd door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend, maar er wordt geen aanvullende machtigingscontrole voor de agentobject-id uitgevoerd.

agent_object_id

str

De AAD-object-id van een gebruiker waarvan wordt aangenomen dat deze niet gemachtigd is door de eigenaar van de gebruikersdelegatiesleutel om de actie uit te voeren die door het SAS-token is verleend. De service valideert het SAS-token en zorgt ervoor dat de eigenaar van de gebruikersdelegatiesleutel over de vereiste machtigingen beschikt voordat toegang wordt verleend. De service voert een extra POSIX ACL-controle uit om te bepalen of deze gebruiker gemachtigd is om de aangevraagde bewerking uit te voeren.

correlation_id

str

De correlatie-id om de auditlogboeken van de opslag te correleren met de auditlogboeken die worden gebruikt door de principal die de SAS genereert en distribueert.

encryption_scope

str

Hiermee geeft u het versleutelingsbereik voor een aanvraag op, zodat alle schrijfbewerkingen door de service worden versleuteld.

Retouren

Een Sas-token (Shared Access Signature).

Retourtype

str