Condividi tramite


@azure/storage-blob package

Classi

Aborter

Un'istanza di interruzione implementa l'interfaccia AbortSignal, può interrompere le richieste HTTP.

  • Chiamare Aborter.none per creare una nuova istanza di Aborter senza timeout.
  • Chiamare Aborter.timeout() per creare una nuova istanza di Aborter con timeout.

Per un'istanza esistente interrotta:

  • Chiamare aborter.withTimeout() per creare e restituire un'istanza figlio di Aborter con timeout.
  • Chiamare aborter.withValue(key, value) per creare e restituire un'istanza figlio Aborter con coppia chiave/valore.
  • Chiamare aborter.abort() per interrompere l'istanza corrente e tutte le istanze figlio.
  • Chiamare aborter.getValue(key) per cercare e ottenere valore con la chiave corrispondente dall'interruzione corrente a tutti gli elementi padre.
AccountSASPermissions

DISPONIBILE SOLO IN NODE.JS RUNTIME. Si tratta di una classe helper per costruire una stringa che rappresenta le autorizzazioni concesse da un AccountSAS. L'impostazione di un valore su true indica che qualsiasi firma di accesso condiviso che usa queste autorizzazioni concederà le autorizzazioni per tale operazione. Una volta impostati tutti i valori, questo valore deve essere serializzato con toString e impostato come campo delle autorizzazioni in un oggetto <xref:IAccountSASSignatureValues>. È possibile costruire la stringa di autorizzazioni senza questa classe, ma l'ordine delle autorizzazioni è particolare e questa classe garantisce la correttezza.

AccountSASResourceTypes

DISPONIBILE SOLO IN NODE.JS RUNTIME. Si tratta di una classe helper per costruire una stringa che rappresenta le risorse accessibili da un AccountSAS. L'impostazione di un valore su true indica che qualsiasi firma di accesso condiviso che usa queste autorizzazioni consentirà l'accesso a tale tipo di risorsa. Dopo aver impostato tutti i valori, deve essere serializzato con toString e impostato come campo delle risorse in un oggetto <xref:IAccountSASSignatureValues>. È possibile costruire la stringa di risorse senza questa classe, ma l'ordine delle risorse è particolare e questa classe garantisce la correttezza.

AccountSASServices

DISPONIBILE SOLO IN NODE.JS RUNTIME. Si tratta di una classe helper per costruire una stringa che rappresenta i servizi accessibili da un AccountSAS. L'impostazione di un valore su true indica che qualsiasi firma di accesso condiviso che usa queste autorizzazioni consentirà l'accesso a tale servizio. Una volta impostati tutti i valori, deve essere serializzato con toString e impostato come campo dei servizi in un oggetto <xref:IAccountSASSignatureValues>. È possibile costruire la stringa dei servizi senza questa classe, ma l'ordine dei servizi è particolare e questa classe garantisce la correttezza.

AppendBlobURL

AppendBlobURL definisce un set di operazioni applicabili ai BLOB di accodamento.

BatchDeleteRequest

BatchDeleteRequest rappresenta una richiesta di eliminazione batch, costituita da una o più operazioni di eliminazione.

BatchRequest

BatchRequest rappresenta una classe basata per BatchDeleteRequest e BatchSetTierRequest.

BatchSetTierRequest

BatchSetTierRequest rappresenta una richiesta di livello set batch, costituita da una o più operazioni di livello set.

InnerBatchRequest

Classe di richiesta batch interna responsabile dell'assemblaggio e della serializzazione delle richieste secondarie. Per informazioni sulla modalità di assemblaggio della richiesta, vedere https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch#request-body.

BatchResponseParser

Classe Util per l'analisi della risposta batch.

BlobSASPermissions

DISPONIBILE SOLO IN NODE.JS RUNTIME. Si tratta di una classe helper per costruire una stringa che rappresenta le autorizzazioni concesse da un ServiceSAS a un BLOB. L'impostazione di un valore su true indica che qualsiasi firma di accesso condiviso che usa queste autorizzazioni concederà le autorizzazioni per tale operazione. Dopo aver impostato tutti i valori, deve essere serializzato con toString e impostato come campo delle autorizzazioni in un oggetto <xref:IBlobSASSignatureValues>. È possibile costruire la stringa di autorizzazioni senza questa classe, ma l'ordine delle autorizzazioni è particolare e questa classe garantisce la correttezza.

BlobURL

Un BLOBURL rappresenta un URL per un BLOB di archiviazione di Azure; il BLOB può essere un BLOB in blocchi, un BLOB di accodamento o un BLOB di pagine.

BlockBlobURL

BlockBlobURL definisce un set di operazioni applicabili ai BLOB in blocchi.

BrowserPolicyFactory

BrowserPolicyFactory è una classe factory che consente di generare oggetti BrowserPolicy.

ContainerSASPermissions

Si tratta di una classe helper per costruire una stringa che rappresenta le autorizzazioni concesse da un ServiceSAS a un contenitore. L'impostazione di un valore su true indica che qualsiasi firma di accesso condiviso che usa queste autorizzazioni concederà le autorizzazioni per tale operazione. Dopo aver impostato tutti i valori, deve essere serializzato con toString e impostato come campo delle autorizzazioni in un oggetto <xref:IBlobSASSignatureValues>. È possibile costruire la stringa di autorizzazioni senza questa classe, ma l'ordine delle autorizzazioni è particolare e questa classe garantisce la correttezza.

ContainerURL

Un containerURL rappresenta un URL del contenitore di Archiviazione di Azure che consente di modificare i BLOB.

KeepAlivePolicyFactory

KeepAlivePolicyFactory è una classe factory che consente di generare oggetti KeepAlivePolicy.

LoggingPolicyFactory

LoggingPolicyFactory è una classe factory che consente di generare oggetti LoggingPolicy.

PageBlobURL

PageBlobURL definisce un set di operazioni applicabili ai BLOB di pagine.

Pipeline

Classe Pipeline contenente i criteri di richiesta HTTP. È possibile creare una pipeline predefinita chiamando StorageURL.newPipeline(). In alternativa, è possibile creare una pipeline con criteri personalizzati dal costruttore di Pipeline. Vedere StorageURL.newPipeline() e i criteri forniti come riferimento prima di implementare la pipeline personalizzata.

RetryPolicyFactory

RetryPolicyFactory è una classe factory che consente di generare oggetti RetryPolicy.

SASQueryParameters

Rappresenta i componenti che costituiscono i parametri di query della firma di accesso condiviso di Archiviazione di Azure. Questo tipo non viene costruito direttamente dall'utente; viene generato solo dai tipi <xref:IAccountSASSignatureValues> e <xref:IBlobSASSignatureValues>. Una volta generato, può essere codificato in un {@code String} e accodato direttamente a un URL(anche se è necessario prestare attenzione nel caso in cui siano presenti parametri di query esistenti, che potrebbero influire sui mezzi appropriati per accodare questi parametri di query). NOTA: le istanze di questa classe non sono modificabili.

ServiceURL

ServiceURL rappresenta un URL del servizio BLOB di Archiviazione di Azure che consente di modificare i contenitori BLOB.

StorageURL

Un Oggetto ServiceURL rappresenta una classe URL basata per ServiceURL, ContainerURL e così via.

TelemetryPolicyFactory

TelemetryPolicyFactory è una classe factory che consente di generare oggetti TelemetryPolicy.

UniqueRequestIDPolicyFactory

UniqueRequestIDPolicyFactory è una classe factory che consente di generare oggetti UniqueRequestIDPolicy.

AnonymousCredential

AnonymousCredential fornisce un membro credentialPolicyCreator usato per creare oggetti AnonymousCredentialPolicy. AnonymousCredentialPolicy viene usato con richieste HTTP(S) che leggono risorse pubbliche o da usare con firme di accesso condiviso.

Credential

Credential è una classe astratta per la firma delle richieste HTTP di Archiviazione di Azure. Questa classe ospiterà una factory credentialPolicyCreator che genera CredentialPolicy.

SharedKeyCredential

DISPONIBILE SOLO IN NODE.JS RUNTIME. SharedKeyCredential per l'autorizzazione della chiave dell'account del servizio archiviazione di Azure.

TokenCredential

TokenCredential è una credenziale usata per generare un tokenCredentialPolicy. Rinnovare il token impostando un nuovo valore della stringa di token sulla proprietà del token.

UserDelegationKeyCredential

DISPONIBILE SOLO IN NODE.JS RUNTIME. UserDelegationKeyCredential viene usato solo per la generazione della firma di accesso condiviso della delega utente.

AppendBlob

Classe che rappresenta un oggetto AppendBlob.

Blob

Classe che rappresenta un BLOB.

BlockBlob

Classe che rappresenta un blockblob.

Container

Classe che rappresenta un contenitore.

Directory

Classe che rappresenta una directory.

PageBlob

Classe che rappresenta un oggetto PageBlob.

Service

Classe che rappresenta un servizio.

StorageClient
StorageClientContext
AnonymousCredentialPolicy

AnonymousCredentialPolicy viene usato con richieste HTTP(S) che leggono risorse pubbliche o da usare con firme di accesso condiviso.

BrowserPolicy

BrowserPolicy gestirà le differenze tra Node.js e il runtime del browser, tra cui:

  1. I browser memorizzano nella cache le richieste GET/HEAD aggiungendo intestazioni condizionali come "IF_MODIFIED_SINCE". BrowserPolicy è un criterio usato per aggiungere una query timestamp all'URL della richiesta GET/HEAD, evitando così la cache del browser.

  2. Rimuovere l'intestazione del cookie per la sicurezza

  3. Rimuovere l'intestazione content-length per evitare gli avvisi dei browser

CredentialPolicy

Criteri di credenziali usati per firmare le richieste HTTP(S) prima dell'invio. Si tratta di una classe astratta.

KeepAlivePolicy

KeepAlivePolicy è un criterio usato per controllare le impostazioni keep-alive per ogni richiesta.

LoggingPolicy

LoggingPolicy è un criterio usato per registrare le richieste.

RetryPolicy

Criteri di ripetizione dei tentativi con ripetizione esponenziale e ripetizione lineare implementati.

SharedKeyCredentialPolicy

SharedKeyCredentialPolicy è un criterio usato per firmare una richiesta HTTP con una chiave condivisa.

TelemetryPolicy

TelemetryPolicy è un criterio usato per contrassegnare l'intestazione dell'agente utente per ogni richiesta.

TokenCredentialPolicy

TokenCredentialPolicy è un criterio usato per firmare una richiesta HTTP con un token. Ad esempio un token di connessione OAuth.

UniqueRequestIDPolicy

UniqueRequestIDPolicy genera un UUID come valore di intestazione x-ms-request-id.

Batch

Batch offre un'esecuzione parallela di base con limiti di concorrenza. Arresterà le operazioni di sinistra quando una dell'operazione eseguita genera un errore. Ma Batch non può annullare le operazioni in corso, è necessario annullarle manualmente.

BufferScheduler

Questa classe accetta un flusso leggibile Node.js come input e continua a leggere i dati dal flusso nella struttura del buffer interno fino a raggiungere maxBuffers. Ogni buffer disponibile tenterà di attivare il gestore in uscita. La struttura del buffer interno include una matrice di buffer in ingresso e una matrice di buffer in uscita. La matrice di buffer in ingresso include i buffer "vuoti" che possono essere riempiti con nuovi dati in ingresso. La matrice in uscita include i buffer riempiti da gestire da outgoingHandler. Ogni dimensione del buffer precedente è definita dal parametro bufferSize.

NUM_OF_ALL_BUFFERS = BUFFERS_IN_INCOMING + BUFFERS_IN_OUTGOING + BUFFERS_UNDER_HANDLING

<NUM_OF_ALL_BUFFERS = maxBuffers

SUGGERIMENTI PER IL MIGLIORAMENTO DELLE PRESTAZIONI:

  1. L'highWaterMark del flusso di input è preferibile impostare lo stesso valore con il parametro bufferSize, che eviterà le operazioni Buffer.concat().
  2. Il parallelismo deve impostare un valore inferiore a maxBuffers, utile per ridurre la possibilità quando un gestore in uscita attende i dati del flusso. in questa situazione, i gestori in uscita vengono bloccati. La coda in uscita non deve essere vuota.
Mutex

Blocco mutex asincrono.

RetriableReadableStream

DISPONIBILE SOLO IN NODE.JS RUNTIME. Un Node.js ReadableStream ritenta internamente quando termina in modo imprevisto ReadableStream interno.

Interfacce

IAppendBlobAppendBlockFromURLOptions
IAppendBlobAppendBlockOptions
IAppendBlobCreateOptions
BatchSubRequest
BatchSubResponse
ParsedBatchResponse
IBlobAbortCopyFromURLOptions
IBlobAcquireLeaseOptions
IBlobBreakLeaseOptions
IBlobChangeLeaseOptions
IBlobCreateSnapshotOptions
IBlobDeleteOptions
IBlobDownloadOptions
IBlobGetPropertiesOptions
IBlobReleaseLeaseOptions
IBlobRenewLeaseOptions
IBlobSetHTTPHeadersOptions
IBlobSetMetadataOptions
IBlobSetTierOptions
IBlobStartCopyFromURLOptions
IBlobSyncCopyFromURLOptions
IBlockBlobCommitBlockListOptions
IBlockBlobGetBlockListOptions
IBlockBlobStageBlockFromURLOptions
IBlockBlobStageBlockOptions
IBlockBlobUploadOptions
IContainerAcquireLeaseOptions
IContainerBreakLeaseOptions
IContainerChangeLeaseOptions
IContainerCreateOptions
IContainerDeleteMethodOptions
IContainerGetAccessPolicyOptions
IContainerGetPropertiesOptions
IContainerListBlobsSegmentOptions
IContainerReleaseLeaseOptions
IContainerRenewLeaseOptions
IContainerSetAccessPolicyOptions
IContainerSetMetadataOptions
ISignedIdentifier
IAccountSASSignatureValues

DISPONIBILE SOLO IN NODE.JS RUNTIME. IAccountSASSignatureValues viene usato per generare una firma di accesso condiviso per un account di archiviazione di Azure. Dopo aver impostato tutti i valori qui in modo appropriato, chiamare generateSASQueryParameters() per ottenere una rappresentazione della firma di accesso condiviso che può essere effettivamente applicata agli URL DEL BLOB. Si noti che sia questa classe che <xref:SASQueryParameters> esistono perché la prima è modificabile e una rappresentazione logica mentre quest'ultima non è modificabile e usata per generare richieste REST effettive.

IBlobSASSignatureValues

DISPONIBILE SOLO IN NODE.JS RUNTIME. IBlobSASSignatureValues viene usato per generare token di firma di accesso condiviso del servizio BLOB per contenitori o BLOB.

IIPRange

Intervallo IP consentito per una firma di accesso condiviso.

IRange

Intervallo per le operazioni del servizio BLOB.

IKeepAliveOptions

Interfaccia delle opzioni KeepAlivePolicy.

IRequestLogOptions

RequestLogOptions configura il comportamento dei criteri di ripetizione dei tentativi.

IPageBlobClearPagesOptions
IPageBlobCreateOptions
IPageBlobGetPageRangesDiffOptions
IPageBlobGetPageRangesOptions
IPageBlobResizeOptions
IPageBlobStartCopyIncrementalOptions
IPageBlobUpdateSequenceNumberOptions
IPageBlobUploadPagesFromURLOptions
IPageBlobUploadPagesOptions
IPipelineOptions

Interfaccia di opzione per il costruttore Pipeline.

IRetryOptions

Interfaccia delle opzioni di ripetizione dei tentativi.

IServiceListContainersSegmentOptions
UserDelegationKey

Una chiave di delega utente

INewPipelineOptions

Interfaccia dell'opzione per il metodo Pipeline.newPipeline.

ITelemetryOptions

Interfaccia delle opzioni TelemetryPolicy.

AccessPolicy

Criteri di accesso

AppendBlobAppendBlockFromUrlHeaders

Definisce le intestazioni per l'operazione AppendBlockFromUrl.

AppendBlobAppendBlockFromUrlOptionalParams

Parametri facoltativi.

AppendBlobAppendBlockHeaders

Definisce le intestazioni per l'operazione AppendBlock.

AppendBlobAppendBlockOptionalParams

Parametri facoltativi.

AppendBlobCreateHeaders

Definisce le intestazioni per l'operazione di creazione.

AppendBlobCreateOptionalParams

Parametri facoltativi.

AppendPositionAccessConditions

Parametri aggiuntivi per un set di operazioni, ad esempio: AppendBlob_appendBlock, AppendBlob_appendBlockFromUrl.

BlobAbortCopyFromURLHeaders

Definisce le intestazioni per l'operazione AbortCopyFromURL.

BlobAbortCopyFromURLOptionalParams

Parametri facoltativi.

BlobAcquireLeaseHeaders

Definisce le intestazioni per l'operazione AcquireLease.

BlobAcquireLeaseOptionalParams

Parametri facoltativi.

BlobBreakLeaseHeaders

Definisce le intestazioni per l'operazione BreakLease.

BlobBreakLeaseOptionalParams

Parametri facoltativi.

BlobChangeLeaseHeaders

Definisce le intestazioni per l'operazione ChangeLease.

BlobChangeLeaseOptionalParams

Parametri facoltativi.

BlobCopyFromURLHeaders

Definisce le intestazioni per l'operazione CopyFromURL.

BlobCopyFromURLOptionalParams

Parametri facoltativi.

BlobCreateSnapshotHeaders

Definisce le intestazioni per l'operazione CreateSnapshot.

BlobCreateSnapshotOptionalParams

Parametri facoltativi.

BlobDeleteHeaders

Definisce le intestazioni per l'operazione Delete.

BlobDeleteMethodOptionalParams

Parametri facoltativi.

BlobDownloadHeaders

Definisce le intestazioni per l'operazione di download.

BlobDownloadOptionalParams

Parametri facoltativi.

BlobFlatListSegment

Interfaccia che rappresenta BlobFlatListSegment.

BlobGetAccessControlHeaders

Definisce le intestazioni per l'operazione GetAccessControl.

BlobGetAccessControlOptionalParams

Parametri facoltativi.

BlobGetAccountInfoHeaders

Definisce le intestazioni per l'operazione GetAccountInfo.

BlobGetPropertiesHeaders

Definisce le intestazioni per l'operazione GetProperties.

BlobGetPropertiesOptionalParams

Parametri facoltativi.

BlobHTTPHeaders

Parametri aggiuntivi per un set di operazioni.

BlobHierarchyListSegment

Interfaccia che rappresenta BlobHierarchyListSegment.

BlobItem

UN BLOB di Archiviazione di Azure

BlobMetadata

Interfaccia che rappresenta BlobMetadata.

BlobPrefix

Interfaccia che rappresenta BlobPrefix.

BlobProperties

Proprietà di un BLOB

BlobReleaseLeaseHeaders

Definisce le intestazioni per l'operazione ReleaseLease.

BlobReleaseLeaseOptionalParams

Parametri facoltativi.

BlobRenameHeaders

Definisce le intestazioni per l'operazione Rinomina.

BlobRenameOptionalParams

Parametri facoltativi.

BlobRenewLeaseHeaders

Definisce le intestazioni per l'operazione RenewLease.

BlobRenewLeaseOptionalParams

Parametri facoltativi.

BlobSetAccessControlHeaders

Definisce le intestazioni per l'operazione SetAccessControl.

BlobSetAccessControlOptionalParams

Parametri facoltativi.

BlobSetHTTPHeadersHeaders

Definisce le intestazioni per l'operazione SetHTTPHeaders.

BlobSetHTTPHeadersOptionalParams

Parametri facoltativi.

BlobSetMetadataHeaders

Definisce le intestazioni per l'operazione SetMetadata.

BlobSetMetadataOptionalParams

Parametri facoltativi.

BlobSetTierHeaders

Definisce le intestazioni per l'operazione SetTier.

BlobSetTierOptionalParams

Parametri facoltativi.

BlobStartCopyFromURLHeaders

Definisce le intestazioni per l'operazione StartCopyFromURL.

BlobStartCopyFromURLOptionalParams

Parametri facoltativi.

BlobUndeleteHeaders

Definisce le intestazioni per l'operazione Annulla eliminazione.

BlobUndeleteOptionalParams

Parametri facoltativi.

Block

Rappresenta un singolo blocco in un BLOB in blocchi. Descrive l'ID e le dimensioni del blocco.

BlockBlobCommitBlockListHeaders

Definisce le intestazioni per l'operazione CommitBlockList.

BlockBlobCommitBlockListOptionalParams

Parametri facoltativi.

BlockBlobGetBlockListHeaders

Definisce le intestazioni per l'operazione GetBlockList.

BlockBlobGetBlockListOptionalParams

Parametri facoltativi.

BlockBlobStageBlockFromURLHeaders

Definisce le intestazioni per l'operazione StageBlockFromURL.

BlockBlobStageBlockFromURLOptionalParams

Parametri facoltativi.

BlockBlobStageBlockHeaders

Definisce le intestazioni per l'operazione StageBlock.

BlockBlobStageBlockOptionalParams

Parametri facoltativi.

BlockBlobUploadHeaders

Definisce le intestazioni per l'operazione di caricamento.

BlockBlobUploadOptionalParams

Parametri facoltativi.

BlockList

Interfaccia che rappresenta BlockList.

BlockLookupList

Interfaccia che rappresenta BlockLookupList.

ClearRange

Interfaccia che rappresenta ClearRange.

ContainerAcquireLeaseHeaders

Definisce le intestazioni per l'operazione AcquireLease.

ContainerAcquireLeaseOptionalParams

Parametri facoltativi.

ContainerBreakLeaseHeaders

Definisce le intestazioni per l'operazione BreakLease.

ContainerBreakLeaseOptionalParams

Parametri facoltativi.

ContainerChangeLeaseHeaders

Definisce le intestazioni per l'operazione ChangeLease.

ContainerChangeLeaseOptionalParams

Parametri facoltativi.

ContainerCreateHeaders

Definisce le intestazioni per l'operazione di creazione.

ContainerCreateOptionalParams

Parametri facoltativi.

ContainerDeleteHeaders

Definisce le intestazioni per l'operazione Delete.

ContainerDeleteMethodOptionalParams

Parametri facoltativi.

ContainerGetAccessPolicyHeaders

Definisce le intestazioni per l'operazione GetAccessPolicy.

ContainerGetAccessPolicyOptionalParams

Parametri facoltativi.

ContainerGetAccountInfoHeaders

Definisce le intestazioni per l'operazione GetAccountInfo.

ContainerGetPropertiesHeaders

Definisce le intestazioni per l'operazione GetProperties.

ContainerGetPropertiesOptionalParams

Parametri facoltativi.

ContainerItem

Un contenitore di Archiviazione di Azure

ContainerListBlobFlatSegmentHeaders

Definisce le intestazioni per l'operazione ListBlobFlatSegment.

ContainerListBlobFlatSegmentOptionalParams

Parametri facoltativi.

ContainerListBlobHierarchySegmentHeaders

Definisce le intestazioni per l'operazione ListBlobHierarchySegment.

ContainerListBlobHierarchySegmentOptionalParams

Parametri facoltativi.

ContainerProperties

Proprietà di un contenitore

ContainerReleaseLeaseHeaders

Definisce le intestazioni per l'operazione ReleaseLease.

ContainerReleaseLeaseOptionalParams

Parametri facoltativi.

ContainerRenewLeaseHeaders

Definisce le intestazioni per l'operazione RenewLease.

ContainerRenewLeaseOptionalParams

Parametri facoltativi.

ContainerSetAccessPolicyHeaders

Definisce le intestazioni per l'operazione SetAccessPolicy.

ContainerSetAccessPolicyOptionalParams

Parametri facoltativi.

ContainerSetMetadataHeaders

Definisce le intestazioni per l'operazione SetMetadata.

ContainerSetMetadataOptionalParams

Parametri facoltativi.

CorsRule

CORS è una funzionalità HTTP che consente a un'applicazione Web in esecuzione in un dominio di accedere alle risorse in un altro dominio. I Web browser implementano una restrizione di sicurezza nota come criteri di stessa origine che impediscono a una pagina Web di chiamare le API in un dominio diverso; CORS offre un modo sicuro per consentire a un dominio (dominio di origine) di chiamare le API in un altro dominio

CpkInfo

Parametri aggiuntivi per un set di operazioni.

DataLakeStorageError

Interfaccia che rappresenta DataLakeStorageError.

DataLakeStorageErrorError

Oggetto risposta di errore del servizio.

DirectoryCreateHeaders

Definisce le intestazioni per l'operazione di creazione.

DirectoryCreateOptionalParams

Parametri facoltativi.

DirectoryDeleteHeaders

Definisce le intestazioni per l'operazione Delete.

DirectoryDeleteMethodOptionalParams

Parametri facoltativi.

DirectoryGetAccessControlHeaders

Definisce le intestazioni per l'operazione GetAccessControl.

DirectoryGetAccessControlOptionalParams

Parametri facoltativi.

DirectoryHttpHeaders

Parametri aggiuntivi per un set di operazioni, ad esempio: Directory_create, Directory_rename Blob_rename.

DirectoryRenameHeaders

Definisce le intestazioni per l'operazione Rinomina.

DirectoryRenameOptionalParams

Parametri facoltativi.

DirectorySetAccessControlHeaders

Definisce le intestazioni per l'operazione SetAccessControl.

DirectorySetAccessControlOptionalParams

Parametri facoltativi.

GeoReplication

Geo-Replication informazioni per il servizio di archiviazione secondario

KeyInfo

Informazioni chiave

LeaseAccessConditions

Parametri aggiuntivi per un set di operazioni.

ListBlobsFlatSegmentResponse

Enumerazione di BLOB

ListBlobsHierarchySegmentResponse

Enumerazione di BLOB

ListContainersSegmentResponse

Enumerazione di contenitori

Logging

Impostazioni di registrazione di Analisi di Azure.

Metrics

riepilogo delle statistiche delle richieste raggruppate in base all'API in aggregazioni orarie o minuti per i BLOB

ModifiedAccessConditions

Parametri aggiuntivi per un set di operazioni.

PageBlobClearPagesHeaders

Definisce le intestazioni per l'operazione ClearPages.

PageBlobClearPagesOptionalParams

Parametri facoltativi.

PageBlobCopyIncrementalHeaders

Definisce le intestazioni per l'operazione CopyIncremental.

PageBlobCopyIncrementalOptionalParams

Parametri facoltativi.

PageBlobCreateHeaders

Definisce le intestazioni per l'operazione di creazione.

PageBlobCreateOptionalParams

Parametri facoltativi.

PageBlobGetPageRangesDiffHeaders

Definisce le intestazioni per l'operazione GetPageRangesDiff.

PageBlobGetPageRangesDiffOptionalParams

Parametri facoltativi.

PageBlobGetPageRangesHeaders

Definisce le intestazioni per l'operazione GetPageRanges.

PageBlobGetPageRangesOptionalParams

Parametri facoltativi.

PageBlobResizeHeaders

Definisce le intestazioni per l'operazione Di ridimensionamento.

PageBlobResizeOptionalParams

Parametri facoltativi.

PageBlobUpdateSequenceNumberHeaders

Definisce le intestazioni per l'operazione UpdateSequenceNumber.

PageBlobUpdateSequenceNumberOptionalParams

Parametri facoltativi.

PageBlobUploadPagesFromURLHeaders

Definisce le intestazioni per l'operazione UploadPagesFromURL.

PageBlobUploadPagesFromURLOptionalParams

Parametri facoltativi.

PageBlobUploadPagesHeaders

Definisce le intestazioni per l'operazione UploadPages.

PageBlobUploadPagesOptionalParams

Parametri facoltativi.

PageList

l'elenco di pagine

PageRange

Interfaccia che rappresenta PageRange.

RetentionPolicy

i criteri di conservazione che determinano per quanto tempo devono essere persistenti i dati associati

SequenceNumberAccessConditions

Parametri aggiuntivi per un set di operazioni, ad esempio: PageBlob_uploadPages, PageBlob_clearPages PageBlob_uploadPagesFromURL.

ServiceGetAccountInfoHeaders

Definisce le intestazioni per l'operazione GetAccountInfo.

ServiceGetPropertiesHeaders

Definisce le intestazioni per l'operazione GetProperties.

ServiceGetPropertiesOptionalParams

Parametri facoltativi.

ServiceGetStatisticsHeaders

Definisce le intestazioni per l'operazione GetStatistics.

ServiceGetStatisticsOptionalParams

Parametri facoltativi.

ServiceGetUserDelegationKeyHeaders

Definisce le intestazioni per l'operazione GetUserDelegationKey.

ServiceGetUserDelegationKeyOptionalParams

Parametri facoltativi.

ServiceListContainersSegmentHeaders

Definisce le intestazioni per l'operazione ListContainersSegment.

ServiceListContainersSegmentOptionalParams

Parametri facoltativi.

ServiceSetPropertiesHeaders

Definisce le intestazioni per l'operazione SetProperties.

ServiceSetPropertiesOptionalParams

Parametri facoltativi.

ServiceSubmitBatchHeaders

Definisce le intestazioni per l'operazione SubmitBatch.

ServiceSubmitBatchOptionalParams

Parametri facoltativi.

SignedIdentifier

identificatore firmato

SourceModifiedAccessConditions

Parametri aggiuntivi per un set di operazioni.

StaticWebsite

Proprietà che consentono a un account di ospitare un sito Web statico

StorageClientOptions

Interfaccia che rappresenta StorageClientOptions.

StorageError

Interfaccia che rappresenta StorageError.

StorageServiceProperties

Proprietà del servizio di archiviazione.

StorageServiceStats

Statistiche per il servizio di archiviazione.

IDownloadFromBlobOptions

Interfaccia dell'opzione per DownloadBlockBlobToBuffer.

IUploadToBlockBlobOptions

Interfaccia dell'opzione per uploadFileToBlockBlob e uploadSeekableStreamToBlockBlob.

IUploadStreamToBlockBlobOptions

Interfaccia dell'opzione per uploadStreamToBlockBlob.

IAppendBlobAccessConditions
IBlobAccessConditions
IContainerAccessConditions
IMetadata
IPageBlobAccessConditions
IRetriableReadableStreamOptions

Alias tipo

BlobDownloadResponse

Contiene i dati di risposta per l'operazione di download.

ContainerGetAccessPolicyResponse

Contiene i dati di risposta per l'operazione getAccessPolicy.

ServiceGetUserDelegationKeyResponse

Contiene i dati di risposta per l'operazione getUserDelegationKey.

ServiceSubmitBatchResponse

Contiene i dati di risposta per l'operazione submitBatch.

CredentialPolicyCreator

Funzione factory che crea un nuovo oggetto CredentialPolicy che usa nextPolicy fornito.

AccessTier

Definisce i valori per AccessTier. I valori possibili includono: 'P4', 'P6', 'P10', 'P15', 'P20', 'P30', 'P40', 'P50', 'P60', 'P70', 'P80', 'Hot', 'Cool', 'Archive'

AccountKind

Definisce i valori per AccountKind. I valori possibili includono: 'Storage', 'BlobStorage', 'StorageV2'

AppendBlobAppendBlockFromUrlResponse

Contiene i dati di risposta per l'operazione appendBlockFromUrl.

AppendBlobAppendBlockResponse

Contiene i dati di risposta per l'operazione appendBlock.

AppendBlobCreateResponse

Contiene i dati di risposta per l'operazione di creazione.

ArchiveStatus

Definisce i valori per ArchiveStatus. I valori possibili includono: 'rehydrate-pending-to-hot', 'rehydrate-pending-to-cool'

BlobAbortCopyFromURLResponse

Contiene i dati di risposta per l'operazione abortCopyFromURL.

BlobAcquireLeaseResponse

Contiene i dati di risposta per l'operazione acquireLease.

BlobBreakLeaseResponse

Contiene i dati di risposta per l'operazione breakLease.

BlobChangeLeaseResponse

Contiene i dati di risposta per l'operazione changeLease.

BlobCopyFromURLResponse

Contiene i dati di risposta per l'operazione copyFromURL.

BlobCreateSnapshotResponse

Contiene i dati di risposta per l'operazione createSnapshot.

BlobDeleteResponse

Contiene i dati di risposta per l'operazione deleteMethod.

BlobGetAccessControlResponse

Contiene i dati di risposta per l'operazione getAccessControl.

BlobGetAccountInfoResponse

Contiene i dati di risposta per l'operazione getAccountInfo.

BlobGetPropertiesResponse

Contiene i dati di risposta per l'operazione getProperties.

BlobReleaseLeaseResponse

Contiene i dati di risposta per l'operazione releaseLease.

BlobRenameResponse

Contiene i dati di risposta per l'operazione di ridenominazione.

BlobRenewLeaseResponse

Contiene i dati di risposta per l'operazione renewLease.

BlobSetAccessControlResponse

Contiene i dati di risposta per l'operazione setAccessControl.

BlobSetHTTPHeadersResponse

Contiene i dati di risposta per l'operazione setHTTPHeaders.

BlobSetMetadataResponse

Contiene i dati di risposta per l'operazione setMetadata.

BlobSetTierResponse

Contiene i dati di risposta per l'operazione setTier.

BlobStartCopyFromURLResponse

Contiene i dati di risposta per l'operazione startCopyFromURL.

BlobType

Definisce i valori per BlobType. I valori possibili includono: 'BlockBlob', 'PageBlob', 'AppendBlob'

BlobUndeleteResponse

Contiene i dati di risposta per l'operazione di annullamento dell'eliminazione.

BlockBlobCommitBlockListResponse

Contiene i dati di risposta per l'operazione commitBlockList.

BlockBlobGetBlockListResponse

Contiene i dati di risposta per l'operazione getBlockList.

BlockBlobStageBlockFromURLResponse

Contiene i dati di risposta per l'operazione stageBlockFromURL.

BlockBlobStageBlockResponse

Contiene i dati di risposta per l'operazione stageBlock.

BlockBlobUploadResponse

Contiene i dati di risposta per l'operazione di caricamento.

BlockListType

Definisce i valori per BlockListType. I valori possibili includono: 'committed', 'uncommitted', 'all'

ContainerAcquireLeaseResponse

Contiene i dati di risposta per l'operazione acquireLease.

ContainerBreakLeaseResponse

Contiene i dati di risposta per l'operazione breakLease.

ContainerChangeLeaseResponse

Contiene i dati di risposta per l'operazione changeLease.

ContainerCreateResponse

Contiene i dati di risposta per l'operazione di creazione.

ContainerDeleteResponse

Contiene i dati di risposta per l'operazione deleteMethod.

ContainerGetAccountInfoResponse

Contiene i dati di risposta per l'operazione getAccountInfo.

ContainerGetPropertiesResponse

Contiene i dati di risposta per l'operazione getProperties.

ContainerListBlobFlatSegmentResponse

Contiene i dati di risposta per l'operazione listBlobFlatSegment.

ContainerListBlobHierarchySegmentResponse

Contiene i dati di risposta per l'operazione listBlobHierarchySegment.

ContainerReleaseLeaseResponse

Contiene i dati di risposta per l'operazione releaseLease.

ContainerRenewLeaseResponse

Contiene i dati di risposta per l'operazione renewLease.

ContainerSetAccessPolicyResponse

Contiene i dati di risposta per l'operazione setAccessPolicy.

ContainerSetMetadataResponse

Contiene i dati di risposta per l'operazione setMetadata.

CopyStatusType

Definisce i valori per CopyStatusType. I valori possibili includono: 'in sospeso', 'success', 'aborted', 'failed'

DeleteSnapshotsOptionType

Definisce i valori per DeleteSnapshotsOptionType. I valori possibili includono: 'include', 'only'

DirectoryCreateResponse

Contiene i dati di risposta per l'operazione di creazione.

DirectoryDeleteResponse

Contiene i dati di risposta per l'operazione deleteMethod.

DirectoryGetAccessControlResponse

Contiene i dati di risposta per l'operazione getAccessControl.

DirectoryRenameResponse

Contiene i dati di risposta per l'operazione di ridenominazione.

DirectorySetAccessControlResponse

Contiene i dati di risposta per l'operazione setAccessControl.

EncryptionAlgorithmType

Definisce i valori per EncryptionAlgorithmType. I valori possibili includono: 'AES256'

GeoReplicationStatusType

Definisce i valori per GeoReplicationStatusType. I valori possibili includono: 'live', 'bootstrap', 'non disponibile'

LeaseDurationType

Definisce i valori per LeaseDurationType. I valori possibili includono: 'infinite', 'fixed'

LeaseStateType

Definisce i valori per LeaseStateType. I valori possibili includono: 'available', 'leased', 'expired', 'breaking', 'broken'

LeaseStatusType

Definisce i valori per LeaseStatusType. I valori possibili includono: 'locked', 'unlocked'

ListBlobsIncludeItem

Definisce i valori per ListBlobsIncludeItem. I valori possibili includono: 'copy', 'deleted', 'metadata', 'snapshots', 'uncommittedblobs'

ListContainersIncludeType

Definisce i valori per ListContainersIncludeType. I valori possibili includono: 'metadata'

PageBlobClearPagesResponse

Contiene i dati di risposta per l'operazione clearPages.

PageBlobCopyIncrementalResponse

Contiene i dati di risposta per l'operazione copyIncremental.

PageBlobCreateResponse

Contiene i dati di risposta per l'operazione di creazione.

PageBlobGetPageRangesDiffResponse

Contiene i dati di risposta per l'operazione getPageRangesDiff.

PageBlobGetPageRangesResponse

Contiene i dati di risposta per l'operazione getPageRanges.

PageBlobResizeResponse

Contiene i dati di risposta per l'operazione di ridimensionamento.

PageBlobUpdateSequenceNumberResponse

Contiene i dati di risposta per l'operazione updateSequenceNumber.

PageBlobUploadPagesFromURLResponse

Contiene i dati di risposta per l'operazione uploadPagesFromURL.

PageBlobUploadPagesResponse

Contiene i dati di risposta per l'operazione uploadPages.

PathRenameMode

Definisce i valori per PathRenameMode. I valori possibili includono: 'legacy', 'posix'

PublicAccessType

Definisce i valori per PublicAccessType. I valori possibili includono: 'container', 'blob'

RehydratePriority

Definisce i valori per RehydratePriority. I valori possibili includono: 'High', 'Standard'

SequenceNumberActionType

Definisce i valori per SequenceNumberActionType. I valori possibili includono: 'max', 'update', 'increment'

ServiceGetAccountInfoResponse

Contiene i dati di risposta per l'operazione getAccountInfo.

ServiceGetPropertiesResponse

Contiene i dati di risposta per l'operazione getProperties.

ServiceGetStatisticsResponse

Contiene i dati di risposta per l'operazione getStatistics.

ServiceListContainersSegmentResponse

Contiene i dati di risposta per l'operazione listContainersSegment.

ServiceSetPropertiesResponse

Contiene i dati di risposta per l'operazione setProperties.

SkuName

Definisce i valori per SkuName. I valori possibili includono: 'Standard_LRS', 'Standard_GRS', 'Standard_RAGRS', 'Standard_ZRS', 'Premium_LRS'

StorageErrorCode

Definisce i valori per StorageErrorCode. I valori possibili includono: 'AccountAlreadyExists', 'AccountBeingCreated', 'AccountIsDisabled', 'AuthenticationFailed', 'AuthorizationFailure', 'ConditionHeadersNotSupported', 'ConditionNotMet', 'EmptyMetadataKey', 'InsufficientAccountPermissions', 'InternalError', 'InvalidAuthenticationInfo', 'InvalidHeaderValue', 'InvalidHttpVerb', 'InvalidInput', 'InvalidMd5', 'InvalidMetadata', 'InvalidQueryParameterValue', 'InvalidRange', 'InvalidResourceName', 'InvalidUri', ' InvalidXmlDocument', 'InvalidXmlNodeValue', 'Md5Mismatch', 'MetadataTooLarge', 'MissingContentLengthHeader', 'MissingRequiredQueryParameter', 'MissingRequiredHeader', 'MissingRequiredXmlNode', 'MultipleConditionHeadersNotSupported', 'OperationTimedOut', 'OutOfRangeInput', 'OutOfRangeQueryParameterValue', 'RequestBodyTooLarge', 'ResourceTypeMismatch', 'RequestUrlFailedToParse', 'ResourceAlreadyExists', 'ResourceNotFound', 'ServerBusy', 'UnsupportedHeader', ' UnsupportedXmlNode', 'UnsupportedQueryParameter', 'UnsupportedHttpVerb', 'AppendPositionConditionNotMet', 'BlobAlreadyExists', 'BlobNotFound', 'BlobOverwritten', 'BlobTierInadequateForContentLength', 'BlockCountExceedsLimit', 'BlockListTooLong', 'CannotChangeToLowerTier', 'CannotVerifyCopySource', 'ContainerAlreadyExists', 'ContainerBeingDeleted', 'ContainerDisabled', 'ContainerNotFound', 'ContentLengthLargerThanTierLimit', 'CopyAcrossAccountsNotSupported', ' CopyIdMismatch', 'FeatureVersionMismatch', 'IncrementalCopyBlobMismatch', 'IncrementalCopyOfEralierVersionSnapshotNotAllowed', 'IncrementalCopySourceMustBeSnapshot', 'InfiniteLeaseDurationRequired', 'InvalidBlobOrBlock', 'InvalidBlobTier', 'InvalidBlobType', 'InvalidBlockId', 'InvalidBlockList', 'InvalidOperation', 'InvalidPageRange', 'InvalidSourceBlobType', 'InvalidSourceBlobUrl', 'InvalidVersionForPageBlobOperation', 'LeaseAlreadyPresent', 'LeaseAlreadyBroken', 'LeaseIdMismatchWithBlobOperation', 'LeaseIdMismatchWithContainerOperation', 'LeaseIdMismatchWithLeaseOperation', 'LeaseIdMissing', 'LeaseIsBreakingAndCannotBeAcquired', 'LeaseIsBreakingAndCannotBeChanged', 'LeaseIsBrokenAndCannotBeRenewed', 'LeaseLost', 'LeaseNotPresentWithBlobOperation', 'LeaseNotPresentWithContainerOperation', 'LeaseNotPresentWithLeaseOperation', 'MaxBlobSizeConditionNotMet', 'NoPendingCopyOperation', ' OperationNotAllowedOnIncrementalCopyBlob', 'PendingCopyOperation', 'PreviousSnapshotCannotBeNewer', 'PreviousSnapshotNotFound', 'PreviousSnapshotOperationNotSupported', 'SequenceNumberConditionNotMet', 'SequenceNumberIncrementTooLarge', 'SnapshotCountExceeded', 'SnaphotOperationRateExceeded', 'SnapshotsPresent', 'SourceConditionNotMet', 'SystemInUse', 'TargetConditionNotMet', 'UnauthorizedBlobOverwrite', 'BlobBeingRehydrated', 'BlobArchived', 'BlobNotArchived'

SyncCopyStatusType

Definisce i valori per SyncCopyStatusType. I valori possibili includono: 'success'

BlobUploadCommonResponse

Digitare uploadFileToBlockBlob, uploadStreamToBlockBlob e uploadBrowserDateToBlockBlob.

Operation

L'operazione è una funzione asincrona da eseguire e gestire da Batch.

OutgoingHandler

OutgoingHandler è una funzione asincrona attivata da BufferScheduler.

ReadableStreamGetter

Enumerazioni

SASProtocol

Protocolli per la firma di accesso condiviso generato.

BlockBlobTier
PremiumPageBlobTier
RetryPolicyType

Tipi RetryPolicy.

Funzioni

getBodyAsText(Models.ServiceSubmitBatchResponse)
utf8ByteLength(string)
generateAccountSASQueryParameters(IAccountSASSignatureValues, SharedKeyCredential)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Genera un oggetto <xref:SASQueryParameters> che contiene tutti i parametri di query sas necessari per effettuare una richiesta REST effettiva.

generateBlobSASQueryParameters(IBlobSASSignatureValues, SharedKeyCredential)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Crea un'istanza di SASQueryParameters.

Accetta solo le impostazioni necessarie per creare una firma di accesso condiviso. Per le impostazioni facoltative, impostare direttamente le proprietà corrispondenti, ad esempio autorizzazioni, startTime e identificatore.

AVVISO: quando l'identificatore non viene fornito, sono necessarie autorizzazioni e expiryTime. È NECESSARIO assegnare un valore alle autorizzazioni di identificatore o expiryTime & manualmente se si esegue l'inizializzazione con questo costruttore.

generateBlobSASQueryParameters(IBlobSASSignatureValues, UserDelegationKey, string)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Crea un'istanza di SASQueryParameters. AVVISO: l'identificatore verrà ignorato durante la generazione della firma di accesso condiviso della delega utente, sono necessarie autorizzazioni e expiryTime.

ipRangeToString(IIPRange)

Generare la stringa di formato IPRange. Ad esempio: "8.8.8.8" o "1.1.1.1-255.255.255.255"

rangeToString(IRange)

Generare una stringa di intervallo. Ad esempio: "bytes=255-" o "bytes=0-511"

uploadBrowserDataToBlockBlob(Aborter, Blob | ArrayBuffer | ArrayBufferView, BlockBlobURL, IUploadToBlockBlobOptions)

DISPONIBILE SOLO NEI BROWSER. Carica un oggetto BLOB/File/ArrayBuffer/ArrayBufferView del browser nel BLOB in blocchi.

Quando la lunghezza del buffer <= 256 MB, questo metodo userà 1 chiamata di caricamento per completare il caricamento. In caso contrario, questo metodo chiamerà stageBlock per caricare i blocchi e infine chiamerà commitBlockList per eseguire il commit dell'elenco di blocchi.

downloadBlobToBuffer(Aborter, Buffer, BlobURL, number, undefined | number, IDownloadFromBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Scarica un BLOB di Azure in parallelo in un buffer. Offset e conteggio sono facoltativi, passare 0 per entrambi per scaricare l'intero BLOB.

uploadFileToBlockBlob(Aborter, string, BlockBlobURL, IUploadToBlockBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Carica un file locale in blocchi in un BLOB in blocchi.

Quando le dimensioni del file <= 256 MB, questo metodo userà 1 chiamata di caricamento per completare il caricamento. In caso contrario, questo metodo chiamerà stageBlock per caricare i blocchi e infine chiamerà commitBlockList per eseguire il commit dell'elenco di blocchi.

uploadStreamToBlockBlob(Aborter, Readable, BlockBlobURL, number, number, IUploadStreamToBlockBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Carica un flusso leggibile Node.js nel BLOB in blocchi.

SUGGERIMENTI PER IL MIGLIORAMENTO DELLE PRESTAZIONI:

  • L'highWaterMark del flusso di input è preferibile impostare lo stesso valore con il parametro bufferSize, che eviterà le operazioni Buffer.concat().
ensureCpkIfSpecified(CpkInfo | undefined, boolean)
toAccessTier(BlockBlobTier | PremiumPageBlobTier | string | undefined)
NewRetryPolicyFactory(IRetryOptions)

Metodo factory usato per generare una factory RetryPolicy.

blobToArrayBuffer(Blob)

Convertire un oggetto BLOB del browser in ArrayBuffer.

blobToString(Blob)

Convertire un oggetto BLOB del browser in stringa.

appendToURLPath(string, string)

Aggiungere una stringa al percorso URL. Rimuoverà "/" duplicato davanti alla stringa quando il percorso URL termina con "/".

base64decode(string)

Decodifica Base64.

base64encode(string)

Codifica Base64.

delay(number, AbortSignalLike, Error)

Intervallo di tempo specificato in ritardo.

escapeURLPath(string)

I caratteri URL riservati devono essere preceduti correttamente da escape per i servizi di archiviazione, ad esempio BLOB o file.

Strategia di codifica e escape degli URL per gli SDK JSv10

Quando i clienti passano una stringa URL in classi XXXURL constrcutor, la stringa URL potrebbe essere già codificata o meno. Ma prima di inviare al server di Archiviazione di Azure, l'URL deve essere codificato. Tuttavia, è difficile per un SDK indovinare se la stringa URL è stata codificata o meno. Abbiamo due strategie potenziali e abbiamo scelto la strategia due per i costruttori XXXURL.

Strategia 1: si supponga che la stringa URL del cliente non sia codificata e codifica sempre la stringa URL in SDK.

Questo è ciò che l'SDK V2 legacy fa, semplice e funziona per la maggior parte dei casi.

  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b:", l'SDK lo codifica in "http://account.blob.core.windows.net/con/b%3A" e inviare al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%3A", l'SDK lo codifica in "http://account.blob.core.windows.net/con/b%253A" e inviare al server. Verrà creato un BLOB denominato "b%3A".

Ma questa strategia non consentirà di creare un BLOB con "?" nel nome. Poiché quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/blob?name", il "?name" verrà considerato come parametro URL anziché come nome BLOB. Se la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/blob%3Fname", verrà creato un BLOB denominato "BLOB%3Fname". V2 SDK non ha questo problema perché non consente al cliente di passare un URL completo, accetta un nome BLOB separato e encodeURIComponent. Non è possibile accettare un SDK per creare un nome BLOB con "?". Implementiamo quindi la strategia due:

Strategia 2: SDK non presuppone che l'URL sia stato codificato o meno. I caratteri speciali verranno semplicemente preceduti da escape.

Questo è il funzionamento di BLOB Go SDK V10.This is what what V10 Blob Go SDK does. Accetta un tipo di URL in Go e l'URL di chiamata. EscapedPath() per eseguire l'escape dei caratteri speciali senza caratteri.

  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b:", l'SDK eseguirà l'escape ":" come "http://account.blob.core.windows.net/con/b%3A" e inviare al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%3A", non sono presenti caratteri speciali, quindi inviare "http://account.blob.core.windows.net/con/b%3A" al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%253A", non sono presenti caratteri speciali, quindi inviare "http://account.blob.core.windows.net/con/b%253A" al server. Verrà creato un BLOB denominato "b%3A".

Questa strategia offre flessibilità per creare con qualsiasi carattere speciale. Ma "%" verrà considerato come un carattere speciale, se la stringa URL non è codificata, non dovrebbe essere presente un "%" nella stringa URL; in caso contrario, l'URL non è un URL valido. Se il cliente deve creare un BLOB con "%" nel nome del BLOB, usare "%25" insead di "%". Proprio come sopra il terzo campione. E le stringhe URL seguenti non sono valide:

  • "http://account.blob.core.windows.net/con/b%""
  • "http://account.blob.core.windows.net/con/b%2""
  • "http://account.blob.core.windows.net/con/b%G""

Un altro carattere speciale è "?", usare "%2F" per rappresentare un nome BLOB con "?" in una stringa URL.

Strategia per containerName, blobName o altri parametri XXXName specifici in metodi come BlobURL.fromContainerURL(containerURL, blobName)

Verrà applicata la strategia 1 e si chiamerà encodeURIComponent per questi parametri, ad esempio blobName. Poiché i clienti passano è un nome normale anziché un URL.

generateBlockID(string, number)

Generare una stringa ID blocco di 64 byte base64.

getURLParameter(string, string)

Ottenere il parametro URL in base al nome.

getURLPath(string)

Ottenere il percorso URL da una stringa URL.

getURLPathAndQuery(string)

Ottenere il percorso URL ed eseguire query da una stringa URL.

getURLQueries(string)

Ottenere coppie chiave di query URL da una stringa URL.

getURLScheme(string)

Ottenere lo schema URL da una stringa URL.

iEqual(string, string)

Se due stringhe sono uguali quando confrontate senza distinzione tra maiuscole e minuscole.

padStart(string, number, undefined | string)

String.prototype.padStart()

setURLHost(string, string)

Impostare l'host URL.

setURLParameter(string, string, undefined | string)

Impostare il nome e il valore del parametro URL. Se il nome esiste nei parametri URL, il valore precedente verrà sostituito dalla chiave del nome. Se non si specifica un valore, il parametro verrà eliminato.

truncatedISO8061Date(Date, undefined | false | true)

Arrotonda una data disattivata in secondi.

streamToBuffer(ReadableStream, Buffer, number, number, undefined | string)

Legge un flusso leggibile nel buffer. Riempire il buffer dall'offset alla fine.

streamToBuffer2(ReadableStream, Buffer, undefined | string)

Legge interamente un flusso leggibile nel buffer.

Dettagli funzione

getBodyAsText(Models.ServiceSubmitBatchResponse)

function getBodyAsText(batchResponse: Models.ServiceSubmitBatchResponse)

Parametri

batchResponse
Models.ServiceSubmitBatchResponse

Restituisce

Promise<string>

utf8ByteLength(string)

function utf8ByteLength(str: string)

Parametri

str

string

Restituisce

number

generateAccountSASQueryParameters(IAccountSASSignatureValues, SharedKeyCredential)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Genera un oggetto <xref:SASQueryParameters> che contiene tutti i parametri di query sas necessari per effettuare una richiesta REST effettiva.

function generateAccountSASQueryParameters(accountSASSignatureValues: IAccountSASSignatureValues, sharedKeyCredential: SharedKeyCredential)

Parametri

accountSASSignatureValues
IAccountSASSignatureValues
sharedKeyCredential
SharedKeyCredential

Restituisce

generateBlobSASQueryParameters(IBlobSASSignatureValues, SharedKeyCredential)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Crea un'istanza di SASQueryParameters.

Accetta solo le impostazioni necessarie per creare una firma di accesso condiviso. Per le impostazioni facoltative, impostare direttamente le proprietà corrispondenti, ad esempio autorizzazioni, startTime e identificatore.

AVVISO: quando l'identificatore non viene fornito, sono necessarie autorizzazioni e expiryTime. È NECESSARIO assegnare un valore alle autorizzazioni di identificatore o expiryTime & manualmente se si esegue l'inizializzazione con questo costruttore.

function generateBlobSASQueryParameters(blobSASSignatureValues: IBlobSASSignatureValues, sharedKeyCredential: SharedKeyCredential)

Parametri

blobSASSignatureValues
IBlobSASSignatureValues
sharedKeyCredential
SharedKeyCredential

Restituisce

generateBlobSASQueryParameters(IBlobSASSignatureValues, UserDelegationKey, string)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Crea un'istanza di SASQueryParameters. AVVISO: l'identificatore verrà ignorato durante la generazione della firma di accesso condiviso della delega utente, sono necessarie autorizzazioni e expiryTime.

function generateBlobSASQueryParameters(blobSASSignatureValues: IBlobSASSignatureValues, userDelegationKey: UserDelegationKey, accountName: string)

Parametri

blobSASSignatureValues
IBlobSASSignatureValues
userDelegationKey
UserDelegationKey

Valore restituito di ServiceURL.getUserDelegationKey()

accountName

string

Restituisce

ipRangeToString(IIPRange)

Generare la stringa di formato IPRange. Ad esempio: "8.8.8.8" o "1.1.1.1-255.255.255.255"

function ipRangeToString(ipRange: IIPRange)

Parametri

ipRange
IIPRange

Restituisce

string

rangeToString(IRange)

Generare una stringa di intervallo. Ad esempio: "bytes=255-" o "bytes=0-511"

function rangeToString(iRange: IRange)

Parametri

iRange
IRange

Restituisce

string

uploadBrowserDataToBlockBlob(Aborter, Blob | ArrayBuffer | ArrayBufferView, BlockBlobURL, IUploadToBlockBlobOptions)

DISPONIBILE SOLO NEI BROWSER. Carica un oggetto BLOB/File/ArrayBuffer/ArrayBufferView del browser nel BLOB in blocchi.

Quando la lunghezza del buffer <= 256 MB, questo metodo userà 1 chiamata di caricamento per completare il caricamento. In caso contrario, questo metodo chiamerà stageBlock per caricare i blocchi e infine chiamerà commitBlockList per eseguire il commit dell'elenco di blocchi.

function uploadBrowserDataToBlockBlob(aborter: Aborter, browserData: Blob | ArrayBuffer | ArrayBufferView, blockBlobURL: BlockBlobURL, options?: IUploadToBlockBlobOptions)

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta

browserData

Blob | ArrayBuffer | ArrayBufferView

BLOB, File, ArrayBuffer o ArrayBufferView

blockBlobURL
BlockBlobURL

Restituisce

downloadBlobToBuffer(Aborter, Buffer, BlobURL, number, undefined | number, IDownloadFromBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Scarica un BLOB di Azure in parallelo in un buffer. Offset e conteggio sono facoltativi, passare 0 per entrambi per scaricare l'intero BLOB.

function downloadBlobToBuffer(aborter: Aborter, buffer: Buffer, blobURL: BlobURL, offset: number, count?: undefined | number, options?: IDownloadFromBlobOptions)

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta

buffer

Buffer

Il buffer da riempire deve avere una lunghezza maggiore del conteggio

blobURL
BlobURL

Oggetto BlobURL

offset

number

Da quale posizione del BLOB in blocchi scaricare, in byte

count

undefined | number

Restituisce

Promise<void>

uploadFileToBlockBlob(Aborter, string, BlockBlobURL, IUploadToBlockBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Carica un file locale in blocchi in un BLOB in blocchi.

Quando le dimensioni del file <= 256 MB, questo metodo userà 1 chiamata di caricamento per completare il caricamento. In caso contrario, questo metodo chiamerà stageBlock per caricare i blocchi e infine chiamerà commitBlockList per eseguire il commit dell'elenco di blocchi.

function uploadFileToBlockBlob(aborter: Aborter, filePath: string, blockBlobURL: BlockBlobURL, options?: IUploadToBlockBlobOptions)

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta

filePath

string

Percorso completo del file locale

blockBlobURL
BlockBlobURL

BlockBlobURL

Restituisce

ICommonResponse

uploadStreamToBlockBlob(Aborter, Readable, BlockBlobURL, number, number, IUploadStreamToBlockBlobOptions)

DISPONIBILE SOLO IN NODE.JS RUNTIME. Carica un flusso leggibile Node.js nel BLOB in blocchi.

SUGGERIMENTI PER IL MIGLIORAMENTO DELLE PRESTAZIONI:

  • L'highWaterMark del flusso di input è preferibile impostare lo stesso valore con il parametro bufferSize, che eviterà le operazioni Buffer.concat().
function uploadStreamToBlockBlob(aborter: Aborter, stream: Readable, blockBlobURL: BlockBlobURL, bufferSize: number, maxBuffers: number, options?: IUploadStreamToBlockBlobOptions)

Parametri

aborter
Aborter

Creare una nuova istanza di Aborter con Aborter.none o Aborter.timeout(), documenti goto di Aborter per altri esempi sull'annullamento della richiesta

stream

Readable

Node.js flusso leggibile

blockBlobURL
BlockBlobURL

Istanza BlockBlobURL

bufferSize

number

Dimensioni di ogni buffer allocato, anche le dimensioni del blocco nel BLOB in blocchi caricato

maxBuffers

number

Il numero massimo di buffer verrà allocato durante il caricamento, correlazione positiva con la concorrenza massima di caricamento

Restituisce

ensureCpkIfSpecified(CpkInfo | undefined, boolean)

function ensureCpkIfSpecified(cpk: CpkInfo | undefined, isHttps: boolean)

Parametri

cpk

CpkInfo | undefined

isHttps

boolean

toAccessTier(BlockBlobTier | PremiumPageBlobTier | string | undefined)

function toAccessTier(tier: BlockBlobTier | PremiumPageBlobTier | string | undefined)

Parametri

tier

BlockBlobTier | PremiumPageBlobTier | string | undefined

Restituisce

Models

NewRetryPolicyFactory(IRetryOptions)

Metodo factory usato per generare una factory RetryPolicy.

function NewRetryPolicyFactory(retryOptions?: IRetryOptions)

Parametri

retryOptions
IRetryOptions

Restituisce

RequestPolicyFactory

blobToArrayBuffer(Blob)

Convertire un oggetto BLOB del browser in ArrayBuffer.

function blobToArrayBuffer(blob: Blob)

Parametri

blob

Blob

Restituisce

Promise<ArrayBuffer>

blobToString(Blob)

Convertire un oggetto BLOB del browser in stringa.

function blobToString(blob: Blob)

Parametri

blob

Blob

Restituisce

Promise<string>

appendToURLPath(string, string)

Aggiungere una stringa al percorso URL. Rimuoverà "/" duplicato davanti alla stringa quando il percorso URL termina con "/".

function appendToURLPath(url: string, name: string)

Parametri

url

string

Stringa URL di origine

name

string

Stringa da aggiungere all'URL

Restituisce

string

Stringa url aggiornata

base64decode(string)

Decodifica Base64.

function base64decode(encodedString: string)

Parametri

encodedString

string

Restituisce

string

base64encode(string)

Codifica Base64.

function base64encode(content: string)

Parametri

content

string

Restituisce

string

delay(number, AbortSignalLike, Error)

Intervallo di tempo specificato in ritardo.

function delay(timeInMs: number, aborter?: AbortSignalLike, abortError?: Error)

Parametri

timeInMs

number

aborter

AbortSignalLike

abortError

Error

Restituisce

Promise<unknown>

escapeURLPath(string)

I caratteri URL riservati devono essere preceduti correttamente da escape per i servizi di archiviazione, ad esempio BLOB o file.

Strategia di codifica e escape degli URL per gli SDK JSv10

Quando i clienti passano una stringa URL in classi XXXURL constrcutor, la stringa URL potrebbe essere già codificata o meno. Ma prima di inviare al server di Archiviazione di Azure, l'URL deve essere codificato. Tuttavia, è difficile per un SDK indovinare se la stringa URL è stata codificata o meno. Abbiamo due strategie potenziali e abbiamo scelto la strategia due per i costruttori XXXURL.

Strategia 1: si supponga che la stringa URL del cliente non sia codificata e codifica sempre la stringa URL in SDK.

Questo è ciò che l'SDK V2 legacy fa, semplice e funziona per la maggior parte dei casi.

  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b:", l'SDK lo codifica in "http://account.blob.core.windows.net/con/b%3A" e inviare al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%3A", l'SDK lo codifica in "http://account.blob.core.windows.net/con/b%253A" e inviare al server. Verrà creato un BLOB denominato "b%3A".

Ma questa strategia non consentirà di creare un BLOB con "?" nel nome. Poiché quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/blob?name", il "?name" verrà considerato come parametro URL anziché come nome BLOB. Se la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/blob%3Fname", verrà creato un BLOB denominato "BLOB%3Fname". V2 SDK non ha questo problema perché non consente al cliente di passare un URL completo, accetta un nome BLOB separato e encodeURIComponent. Non è possibile accettare un SDK per creare un nome BLOB con "?". Implementiamo quindi la strategia due:

Strategia 2: SDK non presuppone che l'URL sia stato codificato o meno. I caratteri speciali verranno semplicemente preceduti da escape.

Questo è il funzionamento di BLOB Go SDK V10.This is what what V10 Blob Go SDK does. Accetta un tipo di URL in Go e l'URL di chiamata. EscapedPath() per eseguire l'escape dei caratteri speciali senza caratteri.

  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b:", l'SDK eseguirà l'escape ":" come "http://account.blob.core.windows.net/con/b%3A" e inviare al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%3A", non sono presenti caratteri speciali, quindi inviare "http://account.blob.core.windows.net/con/b%3A" al server. Verrà creato un BLOB denominato "b:".
  • Quando la stringa dell'URL del cliente è "http://account.blob.core.windows.net/con/b%253A", non sono presenti caratteri speciali, quindi inviare "http://account.blob.core.windows.net/con/b%253A" al server. Verrà creato un BLOB denominato "b%3A".

Questa strategia offre flessibilità per creare con qualsiasi carattere speciale. Ma "%" verrà considerato come un carattere speciale, se la stringa URL non è codificata, non dovrebbe essere presente un "%" nella stringa URL; in caso contrario, l'URL non è un URL valido. Se il cliente deve creare un BLOB con "%" nel nome del BLOB, usare "%25" insead di "%". Proprio come sopra il terzo campione. E le stringhe URL seguenti non sono valide:

  • "http://account.blob.core.windows.net/con/b%""
  • "http://account.blob.core.windows.net/con/b%2""
  • "http://account.blob.core.windows.net/con/b%G""

Un altro carattere speciale è "?", usare "%2F" per rappresentare un nome BLOB con "?" in una stringa URL.

Strategia per containerName, blobName o altri parametri XXXName specifici in metodi come BlobURL.fromContainerURL(containerURL, blobName)

Verrà applicata la strategia 1 e si chiamerà encodeURIComponent per questi parametri, ad esempio blobName. Poiché i clienti passano è un nome normale anziché un URL.

function escapeURLPath(url: string)

Parametri

url

string

Restituisce

string

generateBlockID(string, number)

Generare una stringa ID blocco di 64 byte base64.

function generateBlockID(blockIDPrefix: string, blockIndex: number)

Parametri

blockIDPrefix

string

blockIndex

number

Restituisce

string

getURLParameter(string, string)

Ottenere il parametro URL in base al nome.

function getURLParameter(url: string, name: string)

Parametri

url

string

name

string

Restituisce

string | string[] | undefined

getURLPath(string)

Ottenere il percorso URL da una stringa URL.

function getURLPath(url: string)

Parametri

url

string

Stringa URL di origine

Restituisce

string | undefined

getURLPathAndQuery(string)

Ottenere il percorso URL ed eseguire query da una stringa URL.

function getURLPathAndQuery(url: string)

Parametri

url

string

Stringa URL di origine

Restituisce

string | undefined

getURLQueries(string)

Ottenere coppie chiave di query URL da una stringa URL.

function getURLQueries(url: string)

Parametri

url

string

Restituisce

[key: string]: string

getURLScheme(string)

Ottenere lo schema URL da una stringa URL.

function getURLScheme(url: string)

Parametri

url

string

Stringa URL di origine

Restituisce

string | undefined

iEqual(string, string)

Se due stringhe sono uguali quando confrontate senza distinzione tra maiuscole e minuscole.

function iEqual(str1: string, str2: string)

Parametri

str1

string

str2

string

Restituisce

boolean

padStart(string, number, undefined | string)

String.prototype.padStart()

function padStart(currentString: string, targetLength: number, padString?: undefined | string)

Parametri

currentString

string

targetLength

number

padString

undefined | string

Restituisce

string

setURLHost(string, string)

Impostare l'host URL.

function setURLHost(url: string, host: string)

Parametri

url

string

Stringa URL di origine

host

string

Nuova stringa host

Restituisce

string

Stringa url aggiornata

setURLParameter(string, string, undefined | string)

Impostare il nome e il valore del parametro URL. Se il nome esiste nei parametri URL, il valore precedente verrà sostituito dalla chiave del nome. Se non si specifica un valore, il parametro verrà eliminato.

function setURLParameter(url: string, name: string, value?: undefined | string)

Parametri

url

string

Stringa URL di origine

name

string

Nome parametro

value

undefined | string

Restituisce

string

Stringa url aggiornata

truncatedISO8061Date(Date, undefined | false | true)

Arrotonda una data disattivata in secondi.

function truncatedISO8061Date(date: Date, withMilliseconds?: undefined | false | true)

Parametri

date

Date

withMilliseconds

undefined | false | true

Restituisce

string

Stringa di data in formato ISO8061, con o senza componente di 7 millisecondi

streamToBuffer(ReadableStream, Buffer, number, number, undefined | string)

Legge un flusso leggibile nel buffer. Riempire il buffer dall'offset alla fine.

function streamToBuffer(stream: ReadableStream, buffer: Buffer, offset: number, end: number, encoding?: undefined | string)

Parametri

stream

ReadableStream

Flusso leggibile Node.js

buffer

Buffer

Buffer da riempire, la lunghezza deve >= offset

offset

number

Da quale posizione nel buffer da riempire, inclusiva

end

number

In cui posizionare il buffer da riempire, esclusivo

encoding

undefined | string

Restituisce

Promise<void>

streamToBuffer2(ReadableStream, Buffer, undefined | string)

Legge interamente un flusso leggibile nel buffer.

function streamToBuffer2(stream: ReadableStream, buffer: Buffer, encoding?: undefined | string)

Parametri

stream

ReadableStream

Flusso leggibile Node.js

buffer

Buffer

Buffer da riempire, la lunghezza deve >= offset

encoding

undefined | string

Restituisce

Promise<number>

con il numero di byte letti.