Aracılığıyla paylaş


@azure/storage-file package

Sınıflar

Aborter

Aborter örneği AbortSignal arabirimini uygular, HTTP isteklerini durdurabilir.

  • Zaman aşımı olmadan yeni bir Aborter örneği oluşturmak için Aborter.none dosyasını çağır.
  • Zaman aşımı ile yeni bir Aborter örneği oluşturmak için Aborter.timeout() çağrısında bulunur.

Mevcut bir örnek durdurucu için:

  • Zaman aşımı olan bir alt Aborter örneği oluşturmak ve döndürmek için aborter.withTimeout() öğesini çağır.
  • Anahtar/değer çifti ile alt Aborter örneği oluşturmak ve döndürmek için aborter.withValue(anahtar, değer) öğesini çağır.
  • Geçerli örneği ve tüm alt örnekleri durdurmak için aborter.abort() öğesini çağır.
  • Geçerli aborter'dan tüm üst öğelerine karşılık gelen anahtarla arama yapmak ve değer almak için aborter.getValue(key) öğesini çağır.
AccountSASPermissions

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Bu, Bir AccountSAS tarafından verilen izinleri temsil eden bir dize oluşturmak için bir yardımcı sınıfıdır. Değeri true olarak ayarlamak, bu izinleri kullanan tüm SAS'lerin bu işlem için izinler vermesi anlamına gelir. Tüm değerler ayarlandıktan sonra, bu toString ile seri hale getirilmelidir ve bir <xref:IAccountSASSignatureValues> nesnesinde izinler alanı olarak ayarlanmalıdır. Bu sınıf olmadan izin dizesi oluşturmak mümkündür, ancak izinlerin sırası belirlidir ve bu sınıf doğruluğu garanti eder.

AccountSASResourceTypes

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Bu, AccountSAS tarafından erişilebilen kaynakları temsil eden bir dize oluşturmak için bir yardımcı sınıfıdır. Değeri true olarak ayarlamak, bu izinleri kullanan tüm SAS'lerin bu kaynak türüne erişim izni vermesi anlamına gelir. Tüm değerler ayarlandıktan sonra, bu toString ile seri hale getirilmeli ve bir <xref:IAccountSASSignatureValues> nesnesinde kaynaklar alanı olarak ayarlanmalıdır. Bu sınıf olmadan kaynak dizesini oluşturmak mümkündür, ancak kaynakların sırası belirlidir ve bu sınıf doğruluğu garanti eder.

AccountSASServices

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Bu, AccountSAS tarafından erişilebilen hizmetleri temsil eden bir dize oluşturmak için yardımcı bir sınıftır. Değeri true olarak ayarlamak, bu izinleri kullanan tüm SAS'lerin söz konusu hizmete erişim izni vermesi anlamına gelir. Tüm değerler ayarlandıktan sonra, bu toString ile seri hale getirilmeli ve <xref:IAccountSASSignatureValues> nesnesinde hizmetler alanı olarak ayarlanmalıdır. Bu sınıf olmadan hizmet dizesini oluşturmak mümkündür, ancak hizmetlerin sırası belirlidir ve bu sınıf doğruluğu garanti eder.

BrowserPolicyFactory

BrowserPolicyFactory, BrowserPolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

DirectoryURL

DirectoryURL, Azure Depolama dizininin bir URL'sini temsil eder ve bu url'nin dosyalarını ve dizinlerini işlemenizi sağlar.

FileSASPermissions

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Bu, serviceSAS tarafından bir dosyaya verilen izinleri temsil eden bir dize oluşturmak için yardımcı bir sınıftır. Değeri true olarak ayarlamak, bu izinleri kullanan tüm SAS'lerin bu işlem için izinler vermesi anlamına gelir. Tüm değerler ayarlandıktan sonra, bu toString ile seri hale getirilmeli ve <xref:IFileSASSignatureValues> nesnesinde izinler alanı olarak ayarlanmalıdır. Bu sınıf olmadan izin dizesi oluşturmak mümkündür, ancak izinlerin sırası belirlidir ve bu sınıf doğruluğu garanti eder.

FileSystemAttributes

Bu, bir dosya veya dizine NTFS özniteliklerini temsil eden bir dize oluşturmak için bir yardımcı sınıfıdır.

FileURL

FileURL, Azure Depolama dosyasının URL'sini temsil eder.

KeepAlivePolicyFactory

KeepAlivePolicyFactory, KeepAlivePolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

LoggingPolicyFactory

LoggingPolicyFactory, LoggingPolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

Pipeline

HTTP istek ilkelerini içeren bir İşlem Hattı sınıfı. StorageURL.newPipeline() öğesini çağırarak varsayılan bir İşlem Hattı oluşturabilirsiniz. Alternatif olarak, İşlem Hattı oluşturucusunun kendi ilkelerinizle bir İşlem Hattı oluşturabilirsiniz. Özelleştirilmiş İşlem Hattınızı uygulamadan önce StorageURL.newPipeline() ve sağlanan ilkelere başvuru olarak başvurun.

RetryPolicyFactory

RetryPolicyFactory, RetryPolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

SASQueryParameters

Azure Depolama SAS'sinin sorgu parametrelerini oluşturan bileşenleri temsil eder. Bu tür doğrudan kullanıcı tarafından yapılandırılmaz; yalnızca <xref:IAccountSASSignatureValues> ve <xref:IFileSASSignatureValues> türleri tarafından oluşturulur. Oluşturulduktan sonra bir {@code String} içine kodlanabilir ve doğrudan bir URL'ye eklenebilir (ancak mevcut sorgu parametreleri olması durumunda burada dikkatli olunmalıdır ve bu da bu sorgu parametrelerini eklemenin uygun araçlarını etkileyebilir). NOT: Bu sınıfın örnekleri sabittir.

ServiceURL

ServiceURL, Azure Depolama Dosya hizmeti URL'sini temsil eder ve dosya paylaşımlarını işlemenizi sağlar.

ShareSASPermissions

Bu, serviceSAS tarafından bir paylaşıma verilen izinleri temsil eden bir dize oluşturmak için bir yardımcı sınıfıdır. Değeri true olarak ayarlamak, bu izinleri kullanan tüm SAS'lerin bu işlem için izinler vermesi anlamına gelir. Tüm değerler ayarlandıktan sonra, bu toString ile seri hale getirilmeli ve <xref:IFileSASSignatureValues> nesnesinde izinler alanı olarak ayarlanmalıdır. Bu sınıf olmadan izin dizesi oluşturmak mümkündür, ancak izinlerin sırası belirlidir ve bu sınıf doğruluğu garanti eder.

ShareURL

ShareURL, Azure Depolama paylaşımının dizinlerini ve dosyalarını işlemenize olanak sağlayan bir URL'yi temsil eder.

StorageURL

ServiceURL, ServiceURL, ContainerURL vb. için temel bir URL sınıfını temsil eder.

TelemetryPolicyFactory

TelemetryPolicyFactory, TelemetryPolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

UniqueRequestIDPolicyFactory

UniqueRequestIDPolicyFactory, UniqueRequestIDPolicy nesnelerinin oluşturulmasına yardımcı olan bir fabrika sınıfıdır.

AnonymousCredential

AnonymousCredential, AnonymousCredentialPolicy nesneleri oluşturmak için kullanılan credentialPolicyCreator üyesini sağlar. AnonymousCredentialPolicy, ortak kaynakları okuyan HTTP(S) istekleriyle veya Paylaşılan Erişim İmzaları (SAS) ile kullanılmak üzere kullanılır.

Credential

Kimlik bilgileri, Azure Depolama HTTP isteklerini imzalamaya yönelik soyut bir sınıftır. Bu sınıf CredentialPolicy oluşturan bir credentialPolicyCreator fabrikasını barındıracaktır.

SharedKeyCredential

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Azure Depolama hizmetinin hesap anahtarı yetkilendirmesi için SharedKeyCredential.

Directory

Bir Dizini temsil eden sınıf.

File

Bir Dosyayı temsil eden sınıf.

Service

Bir Hizmeti temsil eden sınıf.

Share

Bir Paylaşımı temsil eden sınıf.

StorageClient
StorageClientContext
AnonymousCredentialPolicy

AnonymousCredentialPolicy, ortak kaynakları okuyan HTTP(S) istekleriyle veya Paylaşılan Erişim İmzaları (SAS) ile kullanılmak üzere kullanılır.

BrowserPolicy

BrowserPolicy, Node.js ve tarayıcı çalışma zamanı arasındaki farkları işler; örneğin:

  1. Tarayıcılar, 'IF_MODIFIED_SINCE' gibi koşullu üst bilgiler ekleyerek GET/HEAD isteklerini önbelleğe alır. BrowserPolicy, GET/HEAD istek URL'sine zaman damgası sorgusu eklemek için kullanılan bir ilkedir ve bu nedenle tarayıcı önbelleğinden kaçınır.

  2. Güvenlik için tanımlama bilgisi üst bilgisini kaldırma

  3. Tarayıcıların uyarısını önlemek için içerik uzunluğu üst bilgisini kaldırma

CredentialPolicy

Göndermeden önce HTTP(S) isteklerini imzalamak için kullanılan kimlik bilgisi ilkesi. Bu soyut bir sınıftır.

KeepAlivePolicy

KeepAlivePolicy, her istek için etkin tutma ayarlarını denetlemek için kullanılan bir ilkedir.

LoggingPolicy

LoggingPolicy, istekleri günlüğe kaydetmek için kullanılan bir ilkedir.

RetryPolicy

Üstel yeniden deneme ve doğrusal yeniden deneme uygulanarak yeniden deneme ilkesi.

SharedKeyCredentialPolicy

SharedKeyCredentialPolicy, HTTP isteğini paylaşılan anahtarla imzalamak için kullanılan bir ilkedir.

TelemetryPolicy

TelemetryPolicy, her istek için kullanıcı aracısı üst bilgisini etiketlemek için kullanılan bir ilkedir.

UniqueRequestIDPolicy

UniqueRequestIDPolicy, x-ms-request-id üst bilgi değeri olarak bir UUID oluşturur.

Batch

Batch, eşzamanlılık sınırlarıyla temel paralel yürütme sağlar. Yürütülen işlemlerden biri hataya neden olduğunda sol işlemleri yürütmeyi durdurur. Ancak Batch devam eden işlemleri iptal edemez, bunları kendiniz iptal etmeniz gerekir.

BufferScheduler

Bu sınıf Node.js Okunabilir bir akışı giriş olarak kabul eder ve maxBuffers'a ulaşana kadar akıştan iç arabellek yapısına veri okumaya devam eder. Kullanılabilir her arabellek, outgoingHandler'ı tetiklemeye çalışır. İç arabellek yapısı bir gelen arabellek dizisi ve giden arabellek dizisi içerir. Gelen arabellek dizisi "boş" arabellekleri yeni gelen verilerle doldurulabilir. Giden dizisi, outgoingHandler tarafından işlenecek doldurulmuş arabellekleri içerir. Yukarıdaki her arabellek boyutu bufferSize parametresi tarafından tanımlanır.

NUM_OF_ALL_BUFFERS = BUFFERS_IN_INCOMING + BUFFERS_IN_OUTGOING + BUFFERS_UNDER_HANDLING

<NUM_OF_ALL_BUFFERS = maxBuffers

PERFORMANS GELIŞTIRME IPUÇLARı:

  1. Giriş akışı highWaterMark, Buffer.concat() işlemlerinden kaçınacak bufferSize parametresiyle aynı değeri ayarlamak daha iyidir.
  2. Paralellik maxBuffers değerinden daha küçük bir değer ayarlamalıdır. Bu, giden işleyicinin akış verilerini bekleme olasılığını azaltmaya yardımcı olur. bu durumda giden işleyiciler engellenir. Giden kuyruğu boş olmamalıdır.
RetriableReadableStream

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Node.js ReadableStream, iç ReadableStream beklenmeyen sona erdiğinde dahili olarak yeniden dener.

Arabirimler

IDirectoryCreateOptions
IDirectoryForceCloseHandlesSegmentOptions
IDirectoryListFilesAndDirectoriesSegmentOptions
IDirectoryListHandlesSegmentOptions
IDirectoryProperties
IFileCreateOptions
IFileDownloadOptions
IFileGetRangeListOptions

seçeneği REST tanımına eşlik olarak tanımlanır. Şu anda kullanılmaya hazır olmasa da, kaynak içeriğin Crc64'ünün erişilebilir olmadığı göz önünde bulundurularak.

IFileListHandlesSegmentOptions
IFileProperties
IFileStartCopyOptions
IFileUploadRangeOptions
ISetPropertiesResponse
IAccountSASSignatureValues

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. IAccountSASSignatureValues, Bir Azure Depolama hesabı için Paylaşılan Erişim İmzası (SAS) oluşturmak için kullanılır. Buradaki tüm değerler uygun şekilde ayarlandıktan sonra generateSASQueryParameters() öğesini çağırarak DOSYA URL'lerine gerçekten uygulanabilen SAS'nin bir gösterimini elde edin. Not: hem bu sınıfın hem de <xref:SASQueryParameters> mevcut olduğunu çünkü ilkinin sabit ve mantıksal bir gösterimi olduğunu, ikincisinin sabit olduğunu ve gerçek REST istekleri oluşturmak için kullanıldığını unutmayın.

IFileSASSignatureValues

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. IFileSASSignatureValues, paylaşımlar veya dosyalar için Dosya hizmeti SAS belirteçleri oluşturmaya yardımcı olmak için kullanılır.

IIPRange

SAS için izin verilen IP aralığı.

IRange

Hizmet İşlemleri aralığı.

IKeepAliveOptions

KeepAlivePolicy seçeneklerinin arabirimi.

IRequestLogOptions

RequestLogOptions, yeniden deneme ilkesinin davranışını yapılandırıyor.

IPipelineOptions

İşlem hattı oluşturucu için seçenek arabirimi.

IRetryOptions

Yeniden deneme seçenekleri arabirimi.

IServiceListSharesSegmentOptions
IShareCreateOptions
IShareCreateSnapshotOptions
IShareDeleteMethodOptions
ISignedIdentifier
INewPipelineOptions

Pipeline.newPipeline yöntemi için seçenek arabirimi.

ITelemetryOptions

TelemetryPolicy seçeneklerinin arabirimi.

AccessPolicy

Erişim ilkesi.

CorsRule

CORS, bir etki alanı altında çalışan bir web uygulamasının başka bir etki alanındaki kaynaklara erişmesini sağlayan bir HTTP özelliğidir. Web tarayıcıları, web sayfasının farklı bir etki alanındaki API'leri çağırmasını engelleyen, aynı kaynak ilkesi olarak bilinen bir güvenlik kısıtlaması uygular; CORS, bir etki alanının (kaynak etki alanı) başka bir etki alanındaki API'leri çağırmasına izin vermek için güvenli bir yol sağlar.

DirectoryCreateHeaders

Oluşturma işlemi için üst bilgileri tanımlar.

DirectoryCreateOptionalParams

İsteğe Bağlı Parametreler.

DirectoryDeleteHeaders

Silme işlemi için üst bilgileri tanımlar.

DirectoryDeleteMethodOptionalParams

İsteğe Bağlı Parametreler.

DirectoryForceCloseHandlesHeaders

ForceCloseHandles işlemi için üst bilgileri tanımlar.

DirectoryForceCloseHandlesOptionalParams

İsteğe Bağlı Parametreler.

DirectoryGetPropertiesHeaders

GetProperties işlemi için üst bilgileri tanımlar.

DirectoryGetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

DirectoryItem

Listelenen bir dizin öğesi.

DirectoryListFilesAndDirectoriesSegmentHeaders

ListFilesAndDirectoriesSegment işlemi için üst bilgileri tanımlar.

DirectoryListFilesAndDirectoriesSegmentOptionalParams

İsteğe Bağlı Parametreler.

DirectoryListHandlesHeaders

ListHandles işlemi için üst bilgileri tanımlar.

DirectoryListHandlesOptionalParams

İsteğe Bağlı Parametreler.

DirectorySetMetadataHeaders

SetMetadata işlemi için üst bilgileri tanımlar.

DirectorySetMetadataOptionalParams

İsteğe Bağlı Parametreler.

DirectorySetPropertiesHeaders

SetProperties işlemi için üst bilgileri tanımlar.

DirectorySetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

FileAbortCopyHeaders

AbortCopy işlemi için üst bilgileri tanımlar.

FileAbortCopyOptionalParams

İsteğe Bağlı Parametreler.

FileCreateHeaders

Oluşturma işlemi için üst bilgileri tanımlar.

FileCreateOptionalParams

İsteğe Bağlı Parametreler.

FileDeleteHeaders

Silme işlemi için üst bilgileri tanımlar.

FileDeleteMethodOptionalParams

İsteğe Bağlı Parametreler.

FileDownloadHeaders

İndirme işlemi için üst bilgileri tanımlar.

FileDownloadOptionalParams

İsteğe Bağlı Parametreler.

FileForceCloseHandlesHeaders

ForceCloseHandles işlemi için üst bilgileri tanımlar.

FileForceCloseHandlesOptionalParams

İsteğe Bağlı Parametreler.

FileGetPropertiesHeaders

GetProperties işlemi için üst bilgileri tanımlar.

FileGetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

FileGetRangeListHeaders

GetRangeList işlemi için üst bilgileri tanımlar.

FileGetRangeListOptionalParams

İsteğe Bağlı Parametreler.

FileHTTPHeaders

bir dizi işlem için ek parametreler, örneğin: File_create, File_setHTTPHeaders.

FileItem

Listelenen bir dosya öğesi.

FileListHandlesHeaders

ListHandles işlemi için üst bilgileri tanımlar.

FileListHandlesOptionalParams

İsteğe Bağlı Parametreler.

FileProperty

Dosya özellikleri.

FileSetHTTPHeadersHeaders

SetHTTPHeaders işlemi için üst bilgileri tanımlar.

FileSetHTTPHeadersOptionalParams

İsteğe Bağlı Parametreler.

FileSetMetadataHeaders

SetMetadata işlemi için üst bilgileri tanımlar.

FileSetMetadataOptionalParams

İsteğe Bağlı Parametreler.

FileStartCopyHeaders

StartCopy işlemi için üst bilgileri tanımlar.

FileStartCopyOptionalParams

İsteğe Bağlı Parametreler.

FileUploadRangeFromURLHeaders

UploadRangeFromURL işlemi için üst bilgileri tanımlar.

FileUploadRangeFromURLOptionalParams

İsteğe Bağlı Parametreler.

FileUploadRangeHeaders

UploadRange işlemi için üst bilgileri tanımlar.

FileUploadRangeOptionalParams

İsteğe Bağlı Parametreler.

FilesAndDirectoriesListSegment

Dizin'den listelenebilen girdiler için özet.

HandleItem

Listelenen bir Azure Depolama tanıtıcı öğesi.

ListFilesAndDirectoriesSegmentResponse

Dizinlerin ve dosyaların sabit listesi.

ListHandlesResponse

Tanıtıcıların numaralandırması.

ListSharesResponse

Paylaşımların sabit listesi.

Metrics

Dosya hizmeti için Depolama Analizi ölçümleri.

Permission

Güvenlik Tanımlayıcısı Tanım Dili'nde (SDDL) açıklanan izin (bir güvenlik tanımlayıcısı).

Range

Azure Depolama dosya aralığı.

RetentionPolicy

Bekletme ilkesi.

ServiceGetPropertiesHeaders

GetProperties işlemi için üst bilgileri tanımlar.

ServiceGetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

ServiceListSharesSegmentHeaders

ListSharesSegment işlemi için üst bilgileri tanımlar.

ServiceListSharesSegmentOptionalParams

İsteğe Bağlı Parametreler.

ServiceSetPropertiesHeaders

SetProperties işlemi için üst bilgileri tanımlar.

ServiceSetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

ShareCreateHeaders

Oluşturma işlemi için üst bilgileri tanımlar.

ShareCreateOptionalParams

İsteğe Bağlı Parametreler.

ShareCreatePermissionHeaders

CreatePermission işlemi için üst bilgileri tanımlar.

ShareCreatePermissionOptionalParams

İsteğe Bağlı Parametreler.

ShareCreateSnapshotHeaders

CreateSnapshot işlemi için üst bilgileri tanımlar.

ShareCreateSnapshotOptionalParams

İsteğe Bağlı Parametreler.

ShareDeleteHeaders

Silme işlemi için üst bilgileri tanımlar.

ShareDeleteMethodOptionalParams

İsteğe Bağlı Parametreler.

ShareGetAccessPolicyHeaders

GetAccessPolicy işlemi için üst bilgileri tanımlar.

ShareGetAccessPolicyOptionalParams

İsteğe Bağlı Parametreler.

ShareGetPermissionHeaders

GetPermission işlemi için üst bilgileri tanımlar.

ShareGetPermissionOptionalParams

İsteğe Bağlı Parametreler.

ShareGetPropertiesHeaders

GetProperties işlemi için üst bilgileri tanımlar.

ShareGetPropertiesOptionalParams

İsteğe Bağlı Parametreler.

ShareGetStatisticsHeaders

GetStatistics işlemi için üst bilgileri tanımlar.

ShareGetStatisticsOptionalParams

İsteğe Bağlı Parametreler.

ShareItem

Listelenen bir Azure Depolama paylaşım öğesi.

ShareProperties

Paylaşımın özellikleri.

ShareSetAccessPolicyHeaders

SetAccessPolicy işlemi için üst bilgileri tanımlar.

ShareSetAccessPolicyOptionalParams

İsteğe Bağlı Parametreler.

ShareSetMetadataHeaders

SetMetadata işlemi için üst bilgileri tanımlar.

ShareSetMetadataOptionalParams

İsteğe Bağlı Parametreler.

ShareSetQuotaHeaders

SetQuota işlemi için üst bilgileri tanımlar.

ShareSetQuotaOptionalParams

İsteğe Bağlı Parametreler.

ShareStats

Paylaşım için istatistikler.

SignedIdentifier

İmzalı tanımlayıcı.

SourceModifiedAccessConditions

uploadRangeFromURL işlemi için ek parametreler.

StorageError

StorageError'ı temsil eden bir arabirim.

StorageServiceProperties

Depolama hizmeti özellikleri.

IDownloadFromAzureFileOptions

DownloadAzurefileToBuffer için seçenek arabirimi.

IUploadToAzureFileOptions

uploadFileToAzureFile ve uploadSeekableStreamToAzureFile için seçenek arabirimi.

IUploadStreamToAzureFileOptions

uploadStreamToAzureFile için seçenek arabirimi.

IFileAndDirectoryCreateCommonOptions
IFileAndDirectorySetPropertiesCommonOptions
IFileHTTPHeaders
IMetadata
IRetriableReadableStreamOptions

Tür Diğer Adları

FileDownloadResponse

İndirme işlemi için yanıt verilerini içerir.

FileGetRangeListResponse

getRangeList işleminin yanıt verilerini içerir.

ShareGetAccessPolicyResponse

getAccessPolicy işleminin yanıt verilerini içerir.

ShareGetStatisticsResponse

getStatistics işlemi için yanıt verilerini içerir.

CredentialPolicyCreator

Sağlanan nextPolicy kullanan yeni bir CredentialPolicy oluşturan fabrika işlevi.

CopyStatusType

CopyStatusType değerlerini tanımlar. Olası değerler şunlardır: 'pending', 'success', 'aborted', 'failed'

DeleteSnapshotsOptionType

DeleteSnapshotsOptionType değerlerini tanımlar. Olası değerler şunlardır: 'include'

DirectoryCreateResponse

Oluşturma işlemi için yanıt verilerini içerir.

DirectoryDeleteResponse

deleteMethod işlemi için yanıt verilerini içerir.

DirectoryForceCloseHandlesResponse

forceCloseHandles işleminin yanıt verilerini içerir.

DirectoryGetPropertiesResponse

getProperties işlemi için yanıt verilerini içerir.

DirectoryListFilesAndDirectoriesSegmentResponse

listFilesAndDirectoriesSegment işlemi için yanıt verilerini içerir.

DirectoryListHandlesResponse

listHandles işleminin yanıt verilerini içerir.

DirectorySetMetadataResponse

setMetadata işlemi için yanıt verilerini içerir.

DirectorySetPropertiesResponse

setProperties işleminin yanıt verilerini içerir.

FileAbortCopyResponse

abortCopy işleminin yanıt verilerini içerir.

FileCreateResponse

Oluşturma işlemi için yanıt verilerini içerir.

FileDeleteResponse

deleteMethod işlemi için yanıt verilerini içerir.

FileForceCloseHandlesResponse

forceCloseHandles işleminin yanıt verilerini içerir.

FileGetPropertiesResponse

getProperties işlemi için yanıt verilerini içerir.

FileListHandlesResponse

listHandles işleminin yanıt verilerini içerir.

FileRangeWriteType

FileRangeWriteType değerlerini tanımlar. Olası değerler şunlardır: 'update', 'clear'

FileSetHTTPHeadersResponse

KümeHTTPHeaders işlemi için yanıt verilerini içerir.

FileSetMetadataResponse

setMetadata işlemi için yanıt verilerini içerir.

FileStartCopyResponse

startCopy işleminin yanıt verilerini içerir.

FileType

FileType değerlerini tanımlar. Olası değerler şunlardır: 'Dosya'

FileUploadRangeFromURLResponse

uploadRangeFromURL işlemi için yanıt verilerini içerir.

FileUploadRangeResponse

uploadRange işleminin yanıt verilerini içerir.

ListSharesIncludeType

ListSharesIncludeType değerlerini tanımlar. Olası değerler şunlardır: 'anlık görüntüler', 'meta veriler'

ServiceGetPropertiesResponse

getProperties işlemi için yanıt verilerini içerir.

ServiceListSharesSegmentResponse

listSharesSegment işlemi için yanıt verilerini içerir.

ServiceSetPropertiesResponse

setProperties işleminin yanıt verilerini içerir.

ShareCreatePermissionResponse

createPermission işlemi için yanıt verilerini içerir.

ShareCreateResponse

Oluşturma işlemi için yanıt verilerini içerir.

ShareCreateSnapshotResponse

createSnapshot işlemi için yanıt verilerini içerir.

ShareDeleteResponse

deleteMethod işlemi için yanıt verilerini içerir.

ShareGetPermissionResponse

getPermission işleminin yanıt verilerini içerir.

ShareGetPropertiesResponse

getProperties işlemi için yanıt verilerini içerir.

ShareSetAccessPolicyResponse

setAccessPolicy işleminin yanıt verilerini içerir.

ShareSetMetadataResponse

setMetadata işlemi için yanıt verilerini içerir.

ShareSetQuotaResponse

setQuota işlemi için yanıt verilerini içerir.

StorageErrorCode

StorageErrorCode değerlerini tanımlar. Olası değerler şunlardır: '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', 'CannotDeleteFileOrDirectory', 'ClientCacheFlushDelay', 'DeletePending', 'DirectoryNotEmpty', 'FileLockConflict', 'InvalidFileOrDirectoryPathName', 'ParentNotFound', 'ReadOnlyAttribute', 'ShareAlreadyExists', 'ShareBeingDeleted', 'ShareDisabled', 'ShareNotFound', 'SharingViolation', 'ShareSnapshotInProgress', 'ShareSnapshotCountExceeded', 'ShareSnapshotOperationNotSupported', ' ShareHasSnapshots', 'ContainerQuotaDowngradeNotAllowed'

FileAttributesPreserveType

Mevcut dosya özniteliklerinin değişmediğini gösterir.

FilePermissionInheritType

Üst dizinden dosya devralma iznini gösterir.

FilePermissionPreserveType

Mevcut dosya izin değerinin değişmediğini gösterir.

TimeNowType

ayarı isteğin zamanı olarak gösterir.

TimePreserveType

Mevcut zaman değerinin değişmediğini gösterir.

Operation

İşlem, Batch tarafından yürütülecek ve yönetilecek zaman uyumsuz bir işlevdir.

OutgoingHandler

OutgoingHandler, BufferScheduler tarafından tetiklenen zaman uyumsuz bir işlevdir.

ReadableStreamGetter

Numaralandırmalar

SASProtocol

Oluşturulan SAS için protokoller.

RetryPolicyType

RetryPolicy türleri.

İşlevler

generateAccountSASQueryParameters(IAccountSASSignatureValues, SharedKeyCredential)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Gerçek bir REST isteği yapmak için gereken tüm SAS sorgu parametrelerini içeren bir <xref:SASQueryParameters> nesnesi oluşturur.

generateFileSASQueryParameters(IFileSASSignatureValues, SharedKeyCredential)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. SASQueryParameters örneğini oluşturur.

Yalnızca SAS oluşturmak için gereken ayarları kabul eder. İsteğe bağlı ayarlar için lütfen izinler, startTime ve tanımlayıcı gibi ilgili özellikleri doğrudan ayarlayın.

UYARI: Tanımlayıcı sağlanmadığında izinler ve expiryTime gereklidir. Bu oluşturucuyla başlangıç yaparsanız identifier veya expiryTime & izinlerine el ile değer atamanız GEREKIR.

ipRangeToString(IIPRange)

IPRange biçim dizesi oluşturun. Örneğin: "8.8.8.8" veya "1.1.1.1-255.255.255.255"

rangeToString(IRange)

Bir aralık dizesi oluşturun. Örneğin: "bytes=255-" veya "bytes=0-511"

uploadBrowserDataToAzureFile(Aborter, Blob | ArrayBuffer | ArrayBufferView, FileURL, IUploadToAzureFileOptions)

YALNıZCA TARAYıCıLARDA KULLANıLABILIR. Tarayıcı Blobu/Dosyası/ArrayBuffer/ArrayBufferView nesnesini bir Azure Dosyasına yükler.

downloadAzureFileToBuffer(Aborter, Buffer, FileURL, number, undefined | number, IDownloadFromAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure dosyası indirir. Uzaklık ve sayı isteğe bağlıdır, her ikisi için de 0 geçirerek dosyanın tamamını indirin.

uploadFileToAzureFile(Aborter, string, FileURL, IUploadToAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Yerel bir dosyayı Bir Azure dosyasına yükler.

uploadStreamToAzureFile(Aborter, Readable, number, FileURL, number, number, IUploadStreamToAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Node.js Okunabilir bir akışı Azure dosyasına yükler. Bu yöntem bir Azure oluşturmaya çalışır ve öbekleri öbek olarak karşıya yüklemeye başlar. Öbek boyutu bufferSize parametresiyle tanımlanır. Lütfen olası akış boyutunun dosya boyutunu aşmadığından emin olun.

PERFORMANS GELIŞTIRME IPUÇLARı:

  • Giriş akışı highWaterMark, Buffer.concat() işlemlerinden kaçınacak bufferSize parametresiyle aynı değeri ayarlamak daha iyidir.
fileAttributesToString(FileSystemAttributes | FileAttributesPreserveType)
fileCreationTimeToString(Date | TimeNowType | TimePreserveType)
fileLastWriteTimeToString(Date | TimeNowType | TimePreserveType)
validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(IFileAndDirectoryCreateCommonOptions)
validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(IFileAndDirectorySetPropertiesCommonOptions)
validateFilePermissionOptions(undefined | string, undefined | string)
NewRetryPolicyFactory(IRetryOptions)

RetryPolicy fabrikası oluşturmak için kullanılan fabrika yöntemi.

blobToArrayBuffer(Blob)

Tarayıcı Blobu nesnesini ArrayBuffer'a dönüştürün.

appendToURLPath(string, string)

URL yoluna bir dize ekleyin. URL yolu "/" ile sona erdiğinde dizenin önündeki yinelenen "/" öğesini kaldırır.

base64decode(string)

Base64 kodunu çözme.

base64encode(string)

Base64 kodlaması.

delay(number, AbortSignalLike, Error)

Belirtilen zaman aralığını geciktir.

escapeURLPath(string)

Blob veya Dosya gibi Depolama hizmetleri için ayrılmış URL karakterlerinden düzgün bir şekilde çıkılmalıdır.

JSv10 SDK'ları için URL kodlama ve kaçış stratejisi

Müşteriler XXXURL sınıf oluşturucusuna bir URL dizesi ilettiğinde, URL dizesi zaten URL kodlanmış veya kodlanmış olmayabilir. Ancak Azure Depolama sunucusuna göndermeden önce URL kodlanmalıdır. Ancak, BIR SDK'nın URL dizesinin kodlanıp kodlanmadığını tahmin etmek zordur. 2 olası stratejimiz var ve XXXURL oluşturucuları için iki strateji seçtik.

Strateji Bir: Müşteri URL dizesinin kodlanmadığını ve her zaman SDK'da URL dizesini kodladığını varsayalım.

Eski V2 SDK'sı bu şekilde basit bir şekilde çalışır ve çoğu durumda çalışır.

  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b:" olduğunda SDK bunu "http://account.blob.core.windows.net/con/b%3A" ve sunucuya gönderin. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%3A" olduğunda SDK bunu "http://account.blob.core.windows.net/con/b%253A" ve sunucuya gönderin. "b%3A" adlı bir blob oluşturulur.

Ancak bu strateji, adında "?" olan bir blob oluşturulmasını mümkün olmayacaktır. Müşteri URL dizesi "http://account.blob.core.windows.net/con/blob?name" olduğunda, "?name" blob adı yerine URL parametresi olarak kabul edilir. Müşteri URL dizesi "http://account.blob.core.windows.net/con/blob%3Fname" ise, "blob%3Fname" adlı bir blob oluşturulur. Müşterinin tam URL'yi geçirmesine izin vermediğinden V2 SDK'sında bu sorun yoktur; bunun için ayrı bir blob adı ve encodeURIComponent kabul eder. SDK'nın "?" ile blob adı oluşturamadığını kabul edemiyoruz. Bu nedenle iki strateji uygularız:

Strateji İki: SDK, URL'nin kodlandığını veya kodlanmadığını varsaymıyor. Özel karakterlerden kaçacaktır.

V10 Blob Go SDK'sı bunu yapar. Git'te bir URL türü kabul eder ve URL'yi çağırır. EscapedPath(), özel karakterlerden kaçış yapmak için.

  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b:" olduğunda SDK , "http://account.blob.core.windows.net/con/b%3A"gibi ":" kaçışı oluşturur; ve sunucuya gönderin. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%3A" olduğunda, özel karakter yoktur, bu nedenle "http://account.blob.core.windows.net/con/b%3A"gönderin ; sunucuya. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%253A" olduğunda, özel karakter yoktur, bu nedenle "http://account.blob.core.windows.net/con/b%253A"gönderin ; sunucuya. "b%3A" adlı bir blob oluşturulur.

Bu strateji, herhangi bir özel karakterle oluşturma esnekliği sağlar. Ancak "%" özel karakterler olarak değerlendirilir; URL dizesi kodlanmazsa, URL dizesinde "%" olmamalıdır, aksi takdirde URL geçerli bir URL değildir. Müşterinin blob adında "%" olan bir blob oluşturması gerekiyorsa, " "%25" insead of "%" kullanın. Tıpkı yukarıdaki 3. örnek gibi. Ve aşağıdaki URL dizeleri geçersiz:

  • "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"

Bir diğer özel karakter de "?", URL dizesinde "?" ile bir blob adını temsil etmek için "%2F" kullanın.

BlobURL.fromContainerURL(containerURL, blobName) gibi yöntemlerdeki containerName, blobName veya diğer belirli XXXName parametreleri için strateji

Bir numaralı stratejiyi uygulayacak ve blobName gibi bu parametreler için encodeURIComponent çağrısı yapacağız. Müşterilerin geçişleri URL yerine düz bir ad olduğundan.

getURLParameter(string, string)

URL parametresini ada göre alın.

getURLPath(string)

URL dizesinden URL yolunu alma.

getURLQueries(string)

URL dizesinden URL sorgu anahtarı değer çiftlerini alma.

padStart(string, number, undefined | string)

String.prototype.padStart()

setURLHost(string, string)

URL ana bilgisayarını ayarlayın.

setURLParameter(string, string, undefined | string)

URL parametre adını ve değerini ayarlayın. URL parametrelerinde ad varsa, eski değer ad anahtarıyla değiştirilir. Değer sağlanmazsa parametresi silinir.

truncatedISO8061Date(Date, undefined | false | true)

Bir tarihi saniyeye yuvarlar.

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

Okunabilir bir akışı arabelleğe okur. Arabelleği uzaklıktan uçtan uca doldurun.

İşlev Ayrıntıları

generateAccountSASQueryParameters(IAccountSASSignatureValues, SharedKeyCredential)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Gerçek bir REST isteği yapmak için gereken tüm SAS sorgu parametrelerini içeren bir <xref:SASQueryParameters> nesnesi oluşturur.

function generateAccountSASQueryParameters(accountSASSignatureValues: IAccountSASSignatureValues, sharedKeyCredential: SharedKeyCredential)

Parametreler

accountSASSignatureValues
IAccountSASSignatureValues
sharedKeyCredential
SharedKeyCredential

Döndürülenler

generateFileSASQueryParameters(IFileSASSignatureValues, SharedKeyCredential)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. SASQueryParameters örneğini oluşturur.

Yalnızca SAS oluşturmak için gereken ayarları kabul eder. İsteğe bağlı ayarlar için lütfen izinler, startTime ve tanımlayıcı gibi ilgili özellikleri doğrudan ayarlayın.

UYARI: Tanımlayıcı sağlanmadığında izinler ve expiryTime gereklidir. Bu oluşturucuyla başlangıç yaparsanız identifier veya expiryTime & izinlerine el ile değer atamanız GEREKIR.

function generateFileSASQueryParameters(fileSASSignatureValues: IFileSASSignatureValues, sharedKeyCredential: SharedKeyCredential)

Parametreler

fileSASSignatureValues
IFileSASSignatureValues
sharedKeyCredential
SharedKeyCredential

Döndürülenler

ipRangeToString(IIPRange)

IPRange biçim dizesi oluşturun. Örneğin: "8.8.8.8" veya "1.1.1.1-255.255.255.255"

function ipRangeToString(ipRange: IIPRange)

Parametreler

ipRange
IIPRange

Döndürülenler

string

rangeToString(IRange)

Bir aralık dizesi oluşturun. Örneğin: "bytes=255-" veya "bytes=0-511"

function rangeToString(iRange: IRange)

Parametreler

iRange
IRange

Döndürülenler

string

uploadBrowserDataToAzureFile(Aborter, Blob | ArrayBuffer | ArrayBufferView, FileURL, IUploadToAzureFileOptions)

YALNıZCA TARAYıCıLARDA KULLANıLABILIR. Tarayıcı Blobu/Dosyası/ArrayBuffer/ArrayBufferView nesnesini bir Azure Dosyasına yükler.

function uploadBrowserDataToAzureFile(aborter: Aborter, browserData: Blob | ArrayBuffer | ArrayBufferView, fileURL: FileURL, options?: IUploadToAzureFileOptions)

Parametreler

aborter
Aborter

aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun, istek iptali hakkında daha fazla örnek için Aborter belgelerine gidin

browserData

Blob | ArrayBuffer | ArrayBufferView

Blob, Dosya, ArrayBuffer veya ArrayBufferView

fileURL
FileURL

Döndürülenler

Promise<void>

downloadAzureFileToBuffer(Aborter, Buffer, FileURL, number, undefined | number, IDownloadFromAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Arabelleğe paralel olarak bir Azure dosyası indirir. Uzaklık ve sayı isteğe bağlıdır, her ikisi için de 0 geçirerek dosyanın tamamını indirin.

function downloadAzureFileToBuffer(aborter: Aborter, buffer: Buffer, fileURL: FileURL, offset: number, count?: undefined | number, options?: IDownloadFromAzureFileOptions)

Parametreler

aborter
Aborter

aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun, istek iptali hakkında daha fazla örnek için Aborter belgelerine gidin

buffer

Buffer

Arabellek doldurulacak, uzunluğu sayıdan büyük olmalıdır

fileURL
FileURL

FileURL nesnesi

offset

number

Azure Dosyasının indirilmesi gereken konumdan

count

undefined | number

Döndürülenler

Promise<void>

uploadFileToAzureFile(Aborter, string, FileURL, IUploadToAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Yerel bir dosyayı Bir Azure dosyasına yükler.

function uploadFileToAzureFile(aborter: Aborter, filePath: string, fileURL: FileURL, options?: IUploadToAzureFileOptions)

Parametreler

aborter
Aborter

aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun, istek iptali hakkında daha fazla örnek için Aborter belgelerine gidin

filePath

string

Yerel dosyanın tam yolu

fileURL
FileURL

FileURL

Döndürülenler

Promise<void>

uploadStreamToAzureFile(Aborter, Readable, number, FileURL, number, number, IUploadStreamToAzureFileOptions)

YALNıZCA NODE.JS ÇALıŞMA ZAMANıNDA KULLANıLABILIR. Node.js Okunabilir bir akışı Azure dosyasına yükler. Bu yöntem bir Azure oluşturmaya çalışır ve öbekleri öbek olarak karşıya yüklemeye başlar. Öbek boyutu bufferSize parametresiyle tanımlanır. Lütfen olası akış boyutunun dosya boyutunu aşmadığından emin olun.

PERFORMANS GELIŞTIRME IPUÇLARı:

  • Giriş akışı highWaterMark, Buffer.concat() işlemlerinden kaçınacak bufferSize parametresiyle aynı değeri ayarlamak daha iyidir.
function uploadStreamToAzureFile(aborter: Aborter, stream: Readable, size: number, fileURL: FileURL, bufferSize: number, maxBuffers: number, options?: IUploadStreamToAzureFileOptions)

Parametreler

aborter
Aborter

aborter.none veya Aborter.timeout() ile yeni bir Aborter örneği oluşturun, istek iptali hakkında daha fazla örnek için Aborter belgelerine gidin

stream

Readable

Okunabilir akışı Node.js. Dosya boyutundan küçük veya eşit olmalıdır.

size

number

Oluşturulacak dosyanın boyutu. İzin verilen maksimum boyut 1 TB'tır. Bu değer akış boyutundan büyükse, dosya kuyruğunda boş baytlar olacaktır.

fileURL
FileURL

FileURL örneği

bufferSize

number

Bayt cinsinden ayrılan her arabelleğin boyutu, ayrıca karşıya yüklenen dosya sırasındaki öbek/aralık boyutu. Boyut > 0 ve <= 4 * 1024 * 1024 (4 MB) olmalıdır

maxBuffers

number

Maksimum arabellekler karşıya yükleme sırasında ayrılacak, maksimum karşıya yükleme eşzamanlılığı ile pozitif bağıntı

Döndürülenler

Promise<void>

fileAttributesToString(FileSystemAttributes | FileAttributesPreserveType)

function fileAttributesToString(fileAttributes: FileSystemAttributes | FileAttributesPreserveType)

Parametreler

Döndürülenler

string

fileCreationTimeToString(Date | TimeNowType | TimePreserveType)

function fileCreationTimeToString(time: Date | TimeNowType | TimePreserveType)

Parametreler

Döndürülenler

string

fileLastWriteTimeToString(Date | TimeNowType | TimePreserveType)

function fileLastWriteTimeToString(time: Date | TimeNowType | TimePreserveType)

Parametreler

Döndürülenler

string

validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(IFileAndDirectoryCreateCommonOptions)

function validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(options: IFileAndDirectoryCreateCommonOptions)

Parametreler

Döndürülenler

validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(IFileAndDirectorySetPropertiesCommonOptions)

function validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(options: IFileAndDirectorySetPropertiesCommonOptions)

Parametreler

Döndürülenler

validateFilePermissionOptions(undefined | string, undefined | string)

function validateFilePermissionOptions(filePermission?: undefined | string, filePermissionKey?: undefined | string)

Parametreler

filePermission

undefined | string

filePermissionKey

undefined | string

NewRetryPolicyFactory(IRetryOptions)

RetryPolicy fabrikası oluşturmak için kullanılan fabrika yöntemi.

function NewRetryPolicyFactory(retryOptions?: IRetryOptions)

Parametreler

retryOptions
IRetryOptions

Döndürülenler

RequestPolicyFactory

blobToArrayBuffer(Blob)

Tarayıcı Blobu nesnesini ArrayBuffer'a dönüştürün.

function blobToArrayBuffer(blob: Blob)

Parametreler

blob

Blob

Döndürülenler

Promise<ArrayBuffer>

appendToURLPath(string, string)

URL yoluna bir dize ekleyin. URL yolu "/" ile sona erdiğinde dizenin önündeki yinelenen "/" öğesini kaldırır.

function appendToURLPath(url: string, name: string)

Parametreler

url

string

Kaynak URL dizesi

name

string

URL'ye eklenecek dize

Döndürülenler

string

Güncelleştirilmiş BIR URL dizesi

base64decode(string)

Base64 kodunu çözme.

function base64decode(encodedString: string)

Parametreler

encodedString

string

Döndürülenler

string

base64encode(string)

Base64 kodlaması.

function base64encode(content: string)

Parametreler

content

string

Döndürülenler

string

delay(number, AbortSignalLike, Error)

Belirtilen zaman aralığını geciktir.

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

Parametreler

timeInMs

number

aborter

AbortSignalLike

abortError

Error

Döndürülenler

Promise<unknown>

escapeURLPath(string)

Blob veya Dosya gibi Depolama hizmetleri için ayrılmış URL karakterlerinden düzgün bir şekilde çıkılmalıdır.

JSv10 SDK'ları için URL kodlama ve kaçış stratejisi

Müşteriler XXXURL sınıf oluşturucusuna bir URL dizesi ilettiğinde, URL dizesi zaten URL kodlanmış veya kodlanmış olmayabilir. Ancak Azure Depolama sunucusuna göndermeden önce URL kodlanmalıdır. Ancak, BIR SDK'nın URL dizesinin kodlanıp kodlanmadığını tahmin etmek zordur. 2 olası stratejimiz var ve XXXURL oluşturucuları için iki strateji seçtik.

Strateji Bir: Müşteri URL dizesinin kodlanmadığını ve her zaman SDK'da URL dizesini kodladığını varsayalım.

Eski V2 SDK'sı bu şekilde basit bir şekilde çalışır ve çoğu durumda çalışır.

  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b:" olduğunda SDK bunu "http://account.blob.core.windows.net/con/b%3A" ve sunucuya gönderin. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%3A" olduğunda SDK bunu "http://account.blob.core.windows.net/con/b%253A" ve sunucuya gönderin. "b%3A" adlı bir blob oluşturulur.

Ancak bu strateji, adında "?" olan bir blob oluşturulmasını mümkün olmayacaktır. Müşteri URL dizesi "http://account.blob.core.windows.net/con/blob?name" olduğunda, "?name" blob adı yerine URL parametresi olarak kabul edilir. Müşteri URL dizesi "http://account.blob.core.windows.net/con/blob%3Fname" ise, "blob%3Fname" adlı bir blob oluşturulur. Müşterinin tam URL'yi geçirmesine izin vermediğinden V2 SDK'sında bu sorun yoktur; bunun için ayrı bir blob adı ve encodeURIComponent kabul eder. SDK'nın "?" ile blob adı oluşturamadığını kabul edemiyoruz. Bu nedenle iki strateji uygularız:

Strateji İki: SDK, URL'nin kodlandığını veya kodlanmadığını varsaymıyor. Özel karakterlerden kaçacaktır.

V10 Blob Go SDK'sı bunu yapar. Git'te bir URL türü kabul eder ve URL'yi çağırır. EscapedPath(), özel karakterlerden kaçış yapmak için.

  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b:" olduğunda SDK , "http://account.blob.core.windows.net/con/b%3A"gibi ":" kaçışı oluşturur; ve sunucuya gönderin. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%3A" olduğunda, özel karakter yoktur, bu nedenle "http://account.blob.core.windows.net/con/b%3A"gönderin ; sunucuya. "b:" adlı bir blob oluşturulur.
  • Müşteri URL dizesi "http://account.blob.core.windows.net/con/b%253A" olduğunda, özel karakter yoktur, bu nedenle "http://account.blob.core.windows.net/con/b%253A"gönderin ; sunucuya. "b%3A" adlı bir blob oluşturulur.

Bu strateji, herhangi bir özel karakterle oluşturma esnekliği sağlar. Ancak "%" özel karakterler olarak değerlendirilir; URL dizesi kodlanmazsa, URL dizesinde "%" olmamalıdır, aksi takdirde URL geçerli bir URL değildir. Müşterinin blob adında "%" olan bir blob oluşturması gerekiyorsa, " "%25" insead of "%" kullanın. Tıpkı yukarıdaki 3. örnek gibi. Ve aşağıdaki URL dizeleri geçersiz:

  • "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"

Bir diğer özel karakter de "?", URL dizesinde "?" ile bir blob adını temsil etmek için "%2F" kullanın.

BlobURL.fromContainerURL(containerURL, blobName) gibi yöntemlerdeki containerName, blobName veya diğer belirli XXXName parametreleri için strateji

Bir numaralı stratejiyi uygulayacak ve blobName gibi bu parametreler için encodeURIComponent çağrısı yapacağız. Müşterilerin geçişleri URL yerine düz bir ad olduğundan.

function escapeURLPath(url: string)

Parametreler

url

string

Döndürülenler

string

getURLParameter(string, string)

URL parametresini ada göre alın.

function getURLParameter(url: string, name: string)

Parametreler

url

string

name

string

Döndürülenler

string | string[] | undefined

getURLPath(string)

URL dizesinden URL yolunu alma.

function getURLPath(url: string)

Parametreler

url

string

Kaynak URL dizesi

Döndürülenler

string | undefined

getURLQueries(string)

URL dizesinden URL sorgu anahtarı değer çiftlerini alma.

function getURLQueries(url: string)

Parametreler

url

string

Döndürülenler

[key: string]: string

padStart(string, number, undefined | string)

String.prototype.padStart()

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

Parametreler

currentString

string

targetLength

number

padString

undefined | string

Döndürülenler

string

setURLHost(string, string)

URL ana bilgisayarını ayarlayın.

function setURLHost(url: string, host: string)

Parametreler

url

string

Kaynak URL dizesi

host

string

Yeni konak dizesi

Döndürülenler

string

Güncelleştirilmiş BIR URL dizesi

setURLParameter(string, string, undefined | string)

URL parametre adını ve değerini ayarlayın. URL parametrelerinde ad varsa, eski değer ad anahtarıyla değiştirilir. Değer sağlanmazsa parametresi silinir.

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

Parametreler

url

string

Kaynak URL dizesi

name

string

Parametre adı

value

undefined | string

Döndürülenler

string

Güncelleştirilmiş BIR URL dizesi

truncatedISO8061Date(Date, undefined | false | true)

Bir tarihi saniyeye yuvarlar.

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

Parametreler

date

Date

withMilliseconds

undefined | false | true

Döndürülenler

string

7 milisaniye bileşenli veya 7 milisaniye olmayan ISO8061 biçimde tarih dizesi

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

Okunabilir bir akışı arabelleğe okur. Arabelleği uzaklıktan uçtan uca doldurun.

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

Parametreler

stream

ReadableStream

Node.js Okunabilir akış

buffer

Buffer

Doldurulacak arabellek, uzunluk >= uzaklık olmalıdır

offset

number

Arabellekte doldurulacak konumdan (dahil)

end

number

Arabellekte hangi konuma doldurulacak, özel

encoding

undefined | string

Döndürülenler

Promise<void>