Condividi tramite


ShareFileClient Classe

Un client per interagire con un file specifico, anche se tale file potrebbe non esistere ancora.

Per altre configurazioni facoltative, fare clic qui.

Ereditarietà
azure.storage.fileshare._shared.base_client.StorageAccountHostsMixin
ShareFileClient

Costruttore

ShareFileClient(account_url: str, share_name: str, file_path: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, *, token_intent: Literal['backup'] | None = None, **kwargs: Any)

Parametri

account_url
str
Necessario

URI dell'account di archiviazione. Per creare un client dato l'URI completo al file, usare la from_file_url classemethod.

share_name
str
Necessario

Nome della condivisione per il file.

file_path
str
Necessario

Percorso del file con cui interagire. Se specificato, questo valore eseguirà l'override di un valore di file specificato nell'URL del file.

snapshot
str
valore predefinito: None

Snapshot di file facoltativo su cui funzionare. Questa può essere la stringa ID snapshot o la risposta restituita da create_snapshot.

credential
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL dell'account ha già un token di firma di accesso condiviso. Il valore può essere una stringa di token sas, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credential, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Se l'URI della risorsa contiene già un token di firma di accesso condiviso, questo verrà ignorato a favore di una credenziale esplicita

  • tranne nel caso di AzureSasCredential, in cui i token sas in conflitto genereranno un valoreError. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.
token_intent
Literal['backup']

Obbligatorio quando si usa TokenCredential per l'autenticazione e viene ignorato per altre forme di autenticazione. Specifica la finalità per tutte le richieste quando si usa l'autenticazione TokenCredential . I valori possibili sono:

backup: specifica che le richieste sono destinate alle operazioni di tipo di backup/amministratore, vale a dire che tutti gli ACL file/directory vengono ignorati e le autorizzazioni complete vengono concesse. L'utente deve avere anche l'autorizzazione RBAC necessaria.

allow_trailing_dot
bool

Se true, il punto finale non verrà tagliato dall'URI di destinazione.

allow_source_trailing_dot
bool

Se true, il punto finale non verrà tagliato dall'URI di origine.

api_version
str

Versione dell'API di archiviazione da usare per le richieste. Il valore predefinito è la versione del servizio più recente compatibile con l'SDK corrente. L'impostazione su una versione precedente può comportare una riduzione della compatibilità delle funzionalità.

Novità nella versione 12.1.0.

secondary_hostname
str

Nome host dell'endpoint secondario.

max_range_size
int

Dimensione massima dell'intervallo usata per un caricamento di file. Il valore predefinito è 41024 1024.

audience
str

Destinatari da usare quando si richiedono token per l'autenticazione di Azure Active Directory. Ha un effetto solo quando le credenziali sono di tipo TokenCredential. Il valore potrebbe essere https://storage.azure.com/ (impostazione predefinita) o https://.file.core.windows.net.

Metodi

abort_copy

Interrompere un'operazione di copia continua.

In questo modo verrà lasciato un file di destinazione con lunghezza zero e metadati completi. Verrà generato un errore se l'operazione di copia è già stata terminata.

acquire_lease

Richiede un nuovo lease.

Se il file non ha un lease attivo, il servizio file crea un lease nel BLOB e restituisce un nuovo lease.

clear_range

Cancella l'intervallo specificato e rilascia lo spazio usato nell'archiviazione per tale intervallo.

close

Questo metodo consiste nel chiudere i socket aperti dal client. Non è necessario usare quando si usa con un gestore di contesto.

close_all_handles

Chiudere tutti gli handle di file aperti.

Questa operazione verrà bloccata finché il servizio non ha chiuso tutti gli handle aperti.

close_handle

Chiudere un handle di file aperto.

create_file

Crea un nuovo file.

Si noti che inizializza solo il file senza contenuto.

delete_file

Contrassegna il file specificato per l'eliminazione. Il file viene eliminato successivamente durante la Garbage Collection.

download_file

Scarica un file in StorageStreamDownloader. Il metodo readall() deve essere usato per leggere tutto il contenuto o readinto() deve essere usato per scaricare il file in un flusso. L'uso di blocchi() restituisce un iteratore che consente all'utente di eseguire l'iterazione del contenuto in blocchi.

from_connection_string

Creare ShareFileClient da una stringa di connessione.

from_file_url

Un client per interagire con un file specifico, anche se tale file potrebbe non esistere ancora.

get_file_properties

Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il file.

get_ranges

Restituisce l'elenco di intervalli di pagine validi per un file o uno snapshot di un file.

get_ranges_diff

Restituisce l'elenco di intervalli di pagine validi per un file o uno snapshot di un file.

Novità nella versione 12.6.0.

list_handles

Elenca gli handle per il file.

rename_file

Rinominare il file di origine.

:p aramtype file_attributes:~azure.storage.fileshare.NTFSAttributes o str :keyword file_creation_time:

Ora di creazione per il file.

:p aramtype file_creation_time:~datetime.datetime o str :keyword file_last_write_time:

Ora dell'ultima scrittura per il file.

:p aramtype file_last_write_time:~datetime.datetime o str :keyword file_change_time:

Modifica dell'ora per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

resize_file

Imposta un file sulle dimensioni specificate.

set_file_metadata

Imposta i metadati definiti dall'utente per il file specificato come una o più coppie nome-valore.

Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al file. Per rimuovere tutti i metadati dal file, chiamare questa operazione senza dict di metadati.

set_http_headers

Imposta le intestazioni HTTP nel file.

start_copy_from_url

Avvia la copia dei dati da un URL di origine nel file a cui fa riferimento il client.

Lo stato di questa operazione di copia è disponibile usando il metodo get_properties .

upload_file

Carica un nuovo file.

dati param: contenuto del file.

param int length: lunghezza del file in byte. Specificare le dimensioni massime fino a 1 TiB.

param file_attributes: attributi del file system per file e directory. Se non è impostato, il valore predefinito sarà "Nessuno" e gli attributi verranno impostati su "Archivio". Ecco un esempio per quando il tipo var è str: 'Temporary|Archivio'. file_attributes valore non è distinzione tra maiuscole e minuscole.

tipo file_attributes: str o ~azure.storage.fileshare.NTFSAttributes

param file_creation_time: tempo di creazione per il valore predefinito del file: ora.

tipo file_creation_time: str o ~datetime.datetime

param file_last_write_time: ultima ora di scrittura per il valore predefinito del file: ora.

tipo file_last_write_time: str o ~datetime.datetime

param file_permission: se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory/file. Questa intestazione può essere usata se le dimensioni dell'autorizzazione sono <= 8 KB, è necessario usare l'intestazione x-ms-file-permission-key. Valore predefinito: Eredita. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

tipo file_permission: str

param permission_key: chiave dell'autorizzazione da impostare per la directory/file. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

tipo permission_key: str

upload_range

Caricare un intervallo di byte in un file.

upload_range_from_url

Scrive i byte da un endpoint file di Azure nell'intervallo specificato di un altro endpoint file di Azure.

abort_copy

Interrompere un'operazione di copia continua.

In questo modo verrà lasciato un file di destinazione con lunghezza zero e metadati completi. Verrà generato un errore se l'operazione di copia è già stata terminata.

abort_copy(copy_id: str | FileProperties, **kwargs: Any) -> None

Parametri

copy_id
str oppure FileProperties
Necessario

Operazione di copia da interrompere. Può essere un ID o un'istanza di FileProperties.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Tipo restituito

acquire_lease

Richiede un nuovo lease.

Se il file non ha un lease attivo, il servizio file crea un lease nel BLOB e restituisce un nuovo lease.

acquire_lease(lease_id: str | None = None, **kwargs: Any) -> ShareLeaseClient

Parametri

lease_id
str
Necessario

ID lease proposto, in un formato di stringa GUID. Il servizio file restituisce 400 (richiesta non valida) se l'ID lease proposto non è nel formato corretto.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Oggetto ShareLeaseClient.

Tipo restituito

Esempio

Acquisizione di un lease su un file.


   source_file.create_file(1024)
   lease = source_file.acquire_lease()
   source_file.upload_file(b'hello world', lease=lease)

   lease.release()

clear_range

Cancella l'intervallo specificato e rilascia lo spazio usato nell'archiviazione per tale intervallo.

clear_range(offset: int, length: int, **kwargs) -> Dict[str, Any]

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per cancellare una sezione del file. L'intervallo può essere fino a 4 MB di dimensioni.

length
int
Necessario

Numero di byte da usare per cancellare una sezione del file. L'intervallo può essere fino a 4 MB di dimensioni.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del file (Etag e ultima modifica).

Tipo restituito

close

Questo metodo consiste nel chiudere i socket aperti dal client. Non è necessario usare quando si usa con un gestore di contesto.

close()

close_all_handles

Chiudere tutti gli handle di file aperti.

Questa operazione verrà bloccata finché il servizio non ha chiuso tutti gli handle aperti.

close_all_handles(**kwargs: Any) -> Dict[str, int]

Parametri

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Il numero di handle chiusi (questo può essere 0 se l'handle specificato non è stato trovato) e il numero di handle non è riuscito a chiudere in un dict.

Tipo restituito

close_handle

Chiudere un handle di file aperto.

close_handle(handle: str | Handle, **kwargs: Any) -> Dict[str, int]

Parametri

handle
str oppure Handle
Necessario

Handle specifico da chiudere.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Il numero di handle chiusi (questo può essere 0 se l'handle specificato non è stato trovato) e il numero di handle non è riuscito a chiudere in un dict.

Tipo restituito

create_file

Crea un nuovo file.

Si noti che inizializza solo il file senza contenuto.

create_file(size: int, file_attributes: str | NTFSAttributes = 'none', file_creation_time: str | datetime | None = 'now', file_last_write_time: str | datetime | None = 'now', file_permission: str | None = None, permission_key: str | None = None, **kwargs: Any) -> Dict[str, Any]

Parametri

size
int
Necessario

Specifica le dimensioni massime per il file, fino a 1 TB.

file_attributes
NTFSAttributes
Necessario

Attributi del file system per file e directory. Se non è impostato, il valore predefinito sarà "Nessuno" e gli attributi verranno impostati su "Archivio". Ecco un esempio per quando il tipo var è str: 'Temporary|Archivio'. file_attributes valore non è distinzione tra maiuscole e minuscole.

file_creation_time
str oppure datetime
Necessario

Tempo di creazione per il valore predefinito del file: ora.

file_last_write_time
str oppure datetime
Necessario

Ultima ora di scrittura per il valore predefinito del file: ora.

file_permission
str
Necessario

Se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory/file. Questa intestazione può essere usata se le dimensioni dell'autorizzazione sono <= 8 KB, è necessario usare l'intestazione x-ms-file-permission-key. Valore predefinito: Eredita. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

permission_key
str
Necessario

Chiave dell'autorizzazione da impostare per la directory/file. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

file_change_time
str oppure datetime

Modificare il tempo per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nell'API versione '2021-06-08'.

content_settings
ContentSettings

Oggetto ContentSettings usato per impostare le proprietà dei file. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo cache.

metadata
dict(str,str)

Coppie nome-valore associate al file come metadati.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà aggiornata del file (Etag e ultima modifica).

Tipo restituito

Esempio

Creare un file.


   # Create and allocate bytes for the file (no content added yet)
   my_allocated_file.create_file(size=100)

delete_file

Contrassegna il file specificato per l'eliminazione. Il file viene eliminato successivamente durante la Garbage Collection.

delete_file(**kwargs: Any) -> None

Parametri

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Tipo restituito

Esempio

Consente di eliminare un file.


   my_file.delete_file()

download_file

Scarica un file in StorageStreamDownloader. Il metodo readall() deve essere usato per leggere tutto il contenuto o readinto() deve essere usato per scaricare il file in un flusso. L'uso di blocchi() restituisce un iteratore che consente all'utente di eseguire l'iterazione del contenuto in blocchi.

download_file(offset: int | None = None, length: int | None = None, **kwargs: Any) -> StorageStreamDownloader

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per il download di una sezione del file. Deve essere impostato se viene specificata la lunghezza.

length
int
Necessario

Numero di byte da leggere dal flusso. Questo è facoltativo, ma deve essere fornito per prestazioni ottimali.

max_concurrency
int

Numero massimo di connessioni parallele da usare.

validate_content
bool

Se true, calcola un hash MD5 per ogni blocco del file. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il file. Si noti anche che, se abilitato, l'algoritmo di caricamento efficiente per la memoria non verrà usato, perché l'elaborazione dell'hash MD5 richiede il buffering di tutti i blocchi e in questo modo lo scopo dell'algoritmo efficiente per la memoria.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

progress_hook
Callable[[int, int], None]

Callback per tenere traccia dello stato di avanzamento di un download a esecuzione prolungata. La firma è function(current: int, total: int) dove corrente è il numero di byte trasferiti finora e il totale è la dimensione totale del download.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Oggetto di streaming (StorageStreamDownloader)

Tipo restituito

<xref:azure.storage.fileshare.StorageStreamDownloader>

Esempio

Scaricare un file.


   with open(DEST_FILE, "wb") as data:
       stream = my_file.download_file()
       data.write(stream.readall())

from_connection_string

Creare ShareFileClient da una stringa di connessione.

from_connection_string(conn_str: str, share_name: str, file_path: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametri

conn_str
str
Necessario

Un stringa di connessione a un account di archiviazione di Azure.

share_name
str
Necessario

Nome della condivisione.

file_path
str
Necessario

Percorso del file.

snapshot
str
valore predefinito: None

Snapshot di file facoltativo su cui funzionare. Questa può essere la stringa ID snapshot o la risposta restituita da create_snapshot.

credential
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL dell'account ha già un token di firma di accesso condiviso. Il valore può essere una stringa di token sas, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credential, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Se l'URI della risorsa contiene già un token di firma di accesso condiviso, questo verrà ignorato a favore di una credenziale esplicita

  • tranne nel caso di AzureSasCredential, in cui i token sas in conflitto genereranno un valoreError. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.
audience
str

Destinatari da usare quando si richiedono token per l'autenticazione di Azure Active Directory. Ha un effetto solo quando le credenziali sono di tipo TokenCredential. Il valore potrebbe essere https://storage.azure.com/ (impostazione predefinita) o https://.file.core.windows.net.

Restituisce

Client file.

Tipo restituito

Esempio

Crea il client di file con stringa di connessione.


   from azure.storage.fileshare import ShareFileClient
   file = ShareFileClient.from_connection_string(
       self.connection_string,
       share_name="helloworld2",
       file_path="myfile")

from_file_url

Un client per interagire con un file specifico, anche se tale file potrebbe non esistere ancora.

from_file_url(file_url: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

Parametri

file_url
str
Necessario

URI completo del file.

snapshot
str
valore predefinito: None

Snapshot di file facoltativo su cui funzionare. Questa può essere la stringa ID snapshot o la risposta restituita da create_snapshot.

credential
valore predefinito: None

Credenziali con cui eseguire l'autenticazione. Questo è facoltativo se l'URL dell'account ha già un token di firma di accesso condiviso. Il valore può essere una stringa di token sas, un'istanza di AzureSasCredential o AzureNamedKeyCredential da azure.core.credential, una chiave di accesso condiviso dell'account o un'istanza di una classe TokenCredentials da azure.identity. Se l'URI della risorsa contiene già un token di firma di accesso condiviso, questo verrà ignorato a favore di una credenziale esplicita

  • tranne nel caso di AzureSasCredential, in cui i token sas in conflitto genereranno un valoreError. Se si usa un'istanza di AzureNamedKeyCredential, "name" deve essere il nome dell'account di archiviazione e "key" deve essere la chiave dell'account di archiviazione.
audience
str

Destinatari da usare quando si richiedono token per l'autenticazione di Azure Active Directory. Ha un effetto solo quando le credenziali sono di tipo TokenCredential. Il valore potrebbe essere https://storage.azure.com/ (impostazione predefinita) o https://.file.core.windows.net.

Restituisce

Client file.

Tipo restituito

get_file_properties

Restituisce tutti i metadati definiti dall'utente, le proprietà HTTP standard e le proprietà di sistema per il file.

get_file_properties(**kwargs: Any) -> FileProperties

Parametri

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Proprietà file

Tipo restituito

get_ranges

Restituisce l'elenco di intervalli di pagine validi per un file o uno snapshot di un file.

get_ranges(offset: int | None = None, length: int | None = None, **kwargs: Any) -> List[Dict[str, int]]

Parametri

offset
int
Necessario

Specifica l'offset iniziale dei byte su cui ottenere gli intervalli.

length
int
Necessario

Numero di byte da usare per ottenere intervalli.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Elenco di intervalli validi.

Tipo restituito

get_ranges_diff

Restituisce l'elenco di intervalli di pagine validi per un file o uno snapshot di un file.

Novità nella versione 12.6.0.

get_ranges_diff(previous_sharesnapshot: str | Dict[str, Any], offset: int | None = None, length: int | None = None, **kwargs: Any) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

Parametri

offset
int
Necessario

Specifica l'offset iniziale dei byte su cui ottenere gli intervalli.

length
int
Necessario

Numero di byte da usare per ottenere intervalli.

previous_sharesnapshot
str
Necessario

Parametro diff dello snapshot che contiene un valore DateTime opaco che specifica uno snapshot di file precedente da confrontare con uno snapshot più recente o il file corrente.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Tupla di due elenchi di intervalli di file come dizionari con chiavi "start" e "end". Il primo elemento è costituito da intervalli di file riempiti, il secondo elemento viene cancellato.

Tipo restituito

list_handles

Elenca gli handle per il file.

list_handles(**kwargs: Any) -> ItemPaged[Handle]

Parametri

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Iterabile di paging automatico di Handle

Tipo restituito

rename_file

Rinominare il file di origine.

:p aramtype file_attributes:~azure.storage.fileshare.NTFSAttributes o str :keyword file_creation_time:

Ora di creazione per il file.

:p aramtype file_creation_time:~datetime.datetime o str :keyword file_last_write_time:

Ora dell'ultima scrittura per il file.

:p aramtype file_last_write_time:~datetime.datetime o str :keyword file_change_time:

Modifica dell'ora per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

rename_file(new_name: str, **kwargs: Any) -> ShareFileClient

Parametri

content_type
str

Tipo di contenuto del nuovo file.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

metadata
Dict[str,str]

Coppia nome-valore da associare a un oggetto di archiviazione file.

source_lease
ShareLeaseClient oppure str

Obbligatorio se il file di origine ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

destination_lease
ShareLeaseClient oppure str

Obbligatorio se il file di destinazione ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Restituisce

Nuovo client file.

Tipo restituito

resize_file

Imposta un file sulle dimensioni specificate.

resize_file(size: int, **kwargs: Any) -> Dict[str, Any]

Parametri

size
int
Necessario

Dimensioni per ridimensionare il file in (in byte)

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dai file (Etag e ultima modifica).

Tipo restituito

set_file_metadata

Imposta i metadati definiti dall'utente per il file specificato come una o più coppie nome-valore.

Ogni chiamata a questa operazione sostituisce tutti i metadati esistenti collegati al file. Per rimuovere tutti i metadati dal file, chiamare questa operazione senza dict di metadati.

set_file_metadata(metadata: Dict[str, Any] | None = None, **kwargs: Any) -> Dict[str, Any]

Parametri

metadata
dict(str, str)
Necessario

Coppie nome-valore associate al file come metadati.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dai file (Etag e ultima modifica).

Tipo restituito

set_http_headers

Imposta le intestazioni HTTP nel file.

set_http_headers(content_settings: ContentSettings, file_attributes: str | NTFSAttributes = 'preserve', file_creation_time: str | datetime | None = 'preserve', file_last_write_time: str | datetime | None = 'preserve', file_permission: str | None = None, permission_key: str | None = None, **kwargs: Any) -> Dict[str, Any]

Parametri

content_settings
ContentSettings
Necessario

Oggetto ContentSettings utilizzato per impostare le proprietà del file. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo della cache.

file_attributes
NTFSAttributes
Necessario

Attributi del file system per file e directory. Se non impostato, indica la conservazione dei valori esistenti. Di seguito è riportato un esempio di quando il tipo var è str: 'Temporary|Archivio'

file_creation_time
str oppure datetime
Necessario

Ora di creazione per il valore predefinito del file: Mantieni.

file_last_write_time
str oppure datetime
Necessario

Ora dell'ultima scrittura per il valore predefinito del file: Mantieni.

file_permission
str
Necessario

Se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory o il file. Questa intestazione può essere usata se le dimensioni dell'autorizzazione sono <= 8 KB, altrimenti è necessario usare l'intestazione x-ms-file-permission-key. Valore predefinito: Eredita. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl. Nota: deve essere specificato solo uno dei valori x-ms-file-permission o x-ms-file-permission-key.

permission_key
str
Necessario

Chiave dell'autorizzazione da impostare per la directory o il file. Nota: deve essere specificato solo uno dei valori x-ms-file-permission o x-ms-file-permission-key.

file_change_time
str oppure datetime

Modifica dell'ora per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Restituisce

Dict della proprietà aggiornata dai file (Etag e ultima modifica).

Tipo restituito

start_copy_from_url

Avvia la copia dei dati da un URL di origine nel file a cui fa riferimento il client.

Lo stato di questa operazione di copia è disponibile usando il metodo get_properties .

start_copy_from_url(source_url: str, **kwargs: Any) -> Any

Parametri

source_url
str
Necessario

Specifica l'URL del file di origine.

file_permission
str

Se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory/file. Questo valore può essere impostato su "source" per copiare il descrittore di sicurezza dal file di origine. In caso contrario, questo valore verrà usato per eseguire l'override del valore di origine. Se non è impostato, il valore dell'autorizzazione viene ereditato dalla directory padre del file di destinazione. Questa impostazione può essere usata se la dimensione dell'autorizzazione è <= 8 KB, in caso contrario, permission_key deve essere usata. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl. Nota: deve essere specificato solo uno dei file_permission o permission_key.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

permission_key
str

Chiave dell'autorizzazione da impostare per la directory/file. Questo valore può essere impostato su "source" per copiare il descrittore di sicurezza dal file di origine. In caso contrario, questo valore verrà usato per eseguire l'override del valore di origine. Se non è impostato, il valore dell'autorizzazione viene ereditato dalla directory padre del file di destinazione. Nota: deve essere specificato solo uno dei file_permission o permission_key.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

file_attributes
NTFSAttributes

Questo valore può essere impostato su "source" per copiare gli attributi di file dal file di origine al file di destinazione oppure per cancellare tutti gli attributi, può essere impostato su "Nessuno". In caso contrario, può essere impostato su un elenco di attributi da impostare nel file di destinazione. Se non è impostato, il valore predefinito è "Archivio".

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

file_creation_time
str oppure datetime

Questo valore può essere impostato su "source" per copiare l'ora di creazione dal file di origine al file di destinazione oppure una datatime da impostare come ora di creazione nel file di destinazione. Potrebbe anche essere una stringa in formato ISO 8601. Se non è impostato, l'ora di creazione verrà impostata sul valore dell'ora di data della creazione (o quando è stato sovrascritto) del file di destinazione dal motore di copia.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

file_last_write_time
str oppure datetime

Questo valore può essere impostato su "source" per copiare l'ultima ora di scrittura dal file di origine al file di destinazione oppure una datatime da impostare come ultima ora di scrittura nel file di destinazione. Potrebbe anche essere una stringa in formato ISO 8601. Se non è impostato, il valore sarà l'ultima volta di scrittura nel file dal motore di copia.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

file_change_time
str oppure datetime

Modificare il tempo per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.9.0: questo parametro è stato introdotto nella versione API '2021-06-08'.

ignore_read_only
bool

Specifica l'opzione per sovrascrivere il file di destinazione se esiste già e ha un set di attributi di sola lettura.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

set_archive_attribute
bool

Specifica l'opzione per impostare l'attributo di archivio nel file di destinazione. True significa che l'attributo di archivio verrà impostato nel file di destinazione nonostante gli overridi degli attributi o lo stato del file di origine.

Novità nella versione 12.1.0: questo parametro è stato introdotto nella versione API '2019-07-07'.

metadata

Coppie nome-valore associate al file come metadati.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

Tipo restituito

Esempio

Copiare un file da un URL


   destination_file.start_copy_from_url(source_url=source_url)

upload_file

Carica un nuovo file.

dati param: contenuto del file.

param int length: lunghezza del file in byte. Specificare le dimensioni massime fino a 1 TiB.

param file_attributes: attributi del file system per file e directory. Se non è impostato, il valore predefinito sarà "Nessuno" e gli attributi verranno impostati su "Archivio". Ecco un esempio per quando il tipo var è str: 'Temporary|Archivio'. file_attributes valore non è distinzione tra maiuscole e minuscole.

tipo file_attributes: str o ~azure.storage.fileshare.NTFSAttributes

param file_creation_time: tempo di creazione per il valore predefinito del file: ora.

tipo file_creation_time: str o ~datetime.datetime

param file_last_write_time: ultima ora di scrittura per il valore predefinito del file: ora.

tipo file_last_write_time: str o ~datetime.datetime

param file_permission: se è stata specificata l'autorizzazione (descrittore di sicurezza) deve essere impostata per la directory/file. Questa intestazione può essere usata se le dimensioni dell'autorizzazione sono <= 8 KB, è necessario usare l'intestazione x-ms-file-permission-key. Valore predefinito: Eredita. Se SDDL viene specificato come input, deve avere proprietario, gruppo e dacl. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

tipo file_permission: str

param permission_key: chiave dell'autorizzazione da impostare per la directory/file. Nota: è necessario specificare una sola delle autorizzazioni x-ms-file-permission o x-ms-file-permission-key.

tipo permission_key: str

upload_file(data: bytes | str | Iterable | IO, length: int | None = None, file_attributes: str | NTFSAttributes = 'none', file_creation_time: str | datetime | None = 'now', file_last_write_time: str | datetime | None = 'now', file_permission: str | None = None, permission_key: str | None = None, **kwargs) -> Dict[str, Any]

Parametri

file_change_time

Modificare il tempo per il file. Se non specificato, l'ora di modifica verrà impostata sulla data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nell'API versione '2021-06-08'.

paramtype file_change_time: str o ~datetime.datetime

metadati della parola chiave dict(str,str): coppie nome-valore associate al file come metadati.

parola chiave ~azure.storage.fileshare.ContentSettings content_settings: oggetto ContentSettings usato per impostare le proprietà dei file. Usato per impostare il tipo di contenuto, la codifica, la lingua, l'eliminazione, md5 e il controllo cache.

parola chiave bool validate_content: se true, calcola un hash MD5 per ogni intervallo del file. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è principalmente utile per rilevare bitflips sul cavo se si usa http anziché https come https (impostazione predefinita) già convalida. Si noti che questo hash MD5 non viene archiviato con il file.

parola chiave int max_concurrency: numero massimo di connessioni parallele da usare.

lease delle parole chiave: obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità nella versione 12.1.0.

paramtype lease: ~azure.storage.fileshare.ShareLeaseClient o str

parola chiave progress_hook: callback per tenere traccia dello stato di avanzamento di un caricamento a esecuzione prolungata. La firma è function(current: int, total: Optional[int]) dove current è il numero di byte trasferiti finora e il totale è la dimensione del BLOB o Nessuno se la dimensione è sconosciuta.

paramtype progress_hook: Callable[[int, Optional[int]], None]

parola chiave int timeout: imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene monitorato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

codifica str della parola chiave: impostazione predefinita su UTF-8.

restituisce: proprietà aggiornata file dict (Etag e ultima modifica).

rtype: dict(str, Any)

Esempio:Caricare un file.


   with open(SOURCE_FILE, "rb") as source:
       my_file.upload_file(source)

upload_range

Caricare un intervallo di byte in un file.

upload_range(data: bytes, offset: int, length: int, **kwargs) -> Dict[str, Any]

Parametri

data
bytes
Necessario

Dati da caricare.

offset
int
Necessario

Inizio dell'intervallo di byte da usare per il caricamento di una sezione del file. L'intervallo può essere fino a 4 MB di dimensioni.

length
int
Necessario

Numero di byte da usare per il caricamento di una sezione del file. L'intervallo può avere dimensioni fino a 4 MB.

validate_content
bool

Se true, calcola un hash MD5 del contenuto della pagina. Il servizio di archiviazione controlla l'hash del contenuto che è arrivato con l'hash inviato. Questo è particolarmente utile per rilevare bitflips in transito se si usa http anziché https come https (impostazione predefinita) verrà già convalidata. Si noti che questo hash MD5 non viene archiviato con il file .

file_last_write_mode
Literal["preserve", "now"]

Se l'ora dell'ultima scrittura del file deve essere mantenuta o sovrascritta. I valori possibili sono "preserve" o "now". Se non specificato, l'ora dell'ultima scrittura del file verrà modificata in data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

encoding
str

Il valore predefinito è UTF-8.

Restituisce

Dict della proprietà aggiornata dai file (Etag e ultima modifica).

Tipo restituito

upload_range_from_url

Scrive i byte da un endpoint file di Azure nell'intervallo specificato di un altro endpoint file di Azure.

upload_range_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs: Any) -> Dict[str, Any]

Parametri

offset
int
Necessario

Inizio dell'intervallo di byte da usare per l'aggiornamento di una sezione del file. L'intervallo può avere dimensioni fino a 4 MB.

length
int
Necessario

Numero di byte da utilizzare per l'aggiornamento di una sezione del file. L'intervallo può avere dimensioni fino a 4 MB.

source_url
str
Necessario

URL di lunghezza massima di 2 KB che specifica un file o un BLOB di Azure. La codifica del valore deve essere di tipo URL in quanto viene visualizzato in un URI di richiesta. Se l'origine si trova in un altro account, l'origine deve essere pubblica o deve essere autenticata tramite una firma di accesso condiviso. Se l'origine è pubblica, non è necessaria alcuna autenticazione. Esempi: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken

source_offset
int
Necessario

Indica l'inizio dell'intervallo di byte (inclusi) che deve essere tratto dall'origine della copia. Il servizio leggerà lo stesso numero di byte dell'intervallo di destinazione (offset di lunghezza).

source_if_modified_since
datetime

Valore DateTime. Azure prevede che il valore della data passato sia UTC. Se il fuso orario è incluso, le datetime non UTC verranno convertite in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC. Specificare questa intestazione condizionale per copiare il Blob solo se il Blob di origine è stato modificato dopo la data e l'ora specificate.

source_if_unmodified_since
datetime

Valore DateTime. Azure prevede che il valore della data passato sia UTC. Se il fuso orario è incluso, le datetime non UTC verranno convertite in formato UTC. Se una data viene passata senza informazioni sul fuso orario, si presuppone che sia UTC. Specificare questa intestazione condizionale per copiare il Blob solo se il Blob di origine non è stato modificato dopo la data e l'ora specificate.

source_etag
str

Valore ETag di origine o carattere jolly (*). Usato per verificare se la risorsa è stata modificata e agire in base alla condizione specificata dal parametro match_condition .

source_match_condition
MatchConditions

Condizione di corrispondenza di origine da utilizzare sull'etag.

file_last_write_mode
Literal["preserve", "now"]

Se l'ora dell'ultima scrittura del file deve essere mantenuta o sovrascritta. I valori possibili sono "preserve" o "now". Se non specificato, l'ora dell'ultima scrittura del file verrà modificata in data/ora corrente.

Novità nella versione 12.8.0: questo parametro è stato introdotto nella versione DELL'API '2021-06-08'.

lease
ShareLeaseClient oppure str

Obbligatorio se il file ha un lease attivo. Il valore può essere un oggetto ShareLeaseClient o l'ID lease come stringa.

Novità della versione 12.1.0.

timeout
int

Imposta il timeout lato server per l'operazione in secondi. Per informazioni dettagliate, vedere https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-file-service-operations. Questo valore non viene rilevato o convalidato nel client. Per configurare i timeout di rete lato client, vedere qui.

source_authorization
str

Eseguire l'autenticazione come entità servizio usando un segreto client per accedere a un BLOB di origine. Assicurarsi che "bearer" sia il prefisso della stringa source_authorization.

Attributi

api_version

Versione dell'API di archiviazione usata per le richieste.

location_mode

Modalità percorso attualmente usata dal client.

Per impostazione predefinita, questo sarà "primario". Le opzioni includono "primary" e "secondary".

primary_endpoint

URL dell'endpoint primario completo.

primary_hostname

Nome host dell'endpoint primario.

secondary_endpoint

URL dell'endpoint secondario completo se configurato.

Se non è disponibile, verrà generato un valore ValueError. Per specificare in modo esplicito un nome host secondario, usare l'argomento della parola chiave facoltativo secondary_hostname nell'istanza.

Eccezioni

secondary_hostname

Nome host dell'endpoint secondario.

Se non è disponibile, questo sarà Nessuno. Per specificare in modo esplicito un nome host secondario, usare l'argomento della parola chiave facoltativo secondary_hostname nell'istanza.

url

URL completo dell'endpoint per questa entità, incluso il token di firma di accesso condiviso se usato.

Questo potrebbe essere l'endpoint primario o l'endpoint secondario a seconda dell'oggetto corrente location_mode. :restituisce: URL completo dell'endpoint per questa entità, incluso il token di firma di accesso condiviso se usato. :rtype: str