BlobClient class
Ein BlobClient stellt eine URL zu einem Azure Storage-Blob dar. das Blob kann ein Blockblob, ein Anfügeblob oder ein Seitenblob sein.
- Extends
Konstruktoren
Blob |
Erstellt eine Instanz von BlobClient. Diese Methode akzeptiert eine codierte URL oder nicht codierte URL, die auf ein Blob verweist. Die codierte URL-Zeichenfolge wird NICHT zweimal escaped, nur Sonderzeichen im URL-Pfad werden mit Escapezeichen versehen. Wenn ein Blobname enthält? oder %, blobname muss in der URL codiert werden. |
Blob |
Erstellt eine Instanz von BlobClient. Diese Methode akzeptiert eine codierte URL oder nicht codierte URL, die auf ein Blob verweist. Die codierte URL-Zeichenfolge wird NICHT zweimal escaped, nur Sonderzeichen im URL-Pfad werden mit Escapezeichen versehen. Wenn ein Blobname enthält? oder %, blobname muss in der URL codiert werden. |
Blob |
Erstellt eine Instanz von BlobClient aus der Verbindungszeichenfolge. |
Eigenschaften
account |
|
container |
Der Name des Speichercontainers, dem das Blob zugeordnet ist. |
credential | z. B. AnonymousCredential, StorageSharedKeyCredential oder alle Anmeldeinformationen aus dem |
name | Der Name des Blobs. |
url | Codierter URL-Zeichenfolgenwert. |
Methoden
abort |
Bricht einen ausstehenden asynchronen Kopierblobvorgang ab und belässt ein Zielblob mit der Länge null und vollständigen Metadaten. Version 2012-02-12 und höher. |
begin |
Kopiert ein Blob asynchron in ein Ziel innerhalb des Speicherkontos.
Diese Methode gibt einen Abfragevorgang mit langer Ausführungsdauer zurück, mit dem Sie unbegrenzt warten können, bis der Kopiervorgang abgeschlossen ist.
Sie können eine Kopie auch abbrechen, bevor sie abgeschlossen ist, indem Sie auf dem Poller aufrufen |
create |
Erstellt eine schreibgeschützte Momentaufnahme eines BLOB. |
delete(Blob |
Markiert das angegebene Blob oder die angegebene Momentaufnahme zum Löschen. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht. Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen. |
delete |
Markiert das angegebene Blob oder die angegebene Momentaufnahme zum Löschen, sofern vorhanden. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht. Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen. |
delete |
Löschen Sie die Unmutablilitätsrichtlinie für das Blob. |
download(number, number, Blob |
Liest oder lädt ein Blob aus dem System herunter, einschließlich seiner Metadaten und Eigenschaften. Sie können auch Get Blob aufrufen, um eine Momentaufnahme zu lesen.
|
download |
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob parallel in einen Puffer herunter. Offset und Count sind optional und lädt das gesamte Blob herunter, wenn sie nicht bereitgestellt werden. Warnung: Puffer können aufgrund von Einschränkungen der Node.js/V8 nur Dateien bis zu etwa einem Gigabyte auf 32-Bit-Systemen oder etwa zwei Gigabyte auf 64-Bit-Systemen unterstützen. Für Blobs, die größer als diese Größe sind, sollten Sie berücksichtigen <xref:downloadToFile>. |
download |
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob parallel in einen Puffer herunter. Offset und Count sind optional und lädt das gesamte Blob herunter, wenn sie nicht bereitgestellt werden. Warnung: Puffer können aufgrund von Einschränkungen der Node.js/V8 nur Dateien bis zu etwa einem Gigabyte auf 32-Bit-Systemen oder etwa zwei Gigabyte auf 64-Bit-Systemen unterstützen. Für Blobs, die größer als diese Größe sind, sollten Sie berücksichtigen <xref:downloadToFile>. |
download |
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob in eine lokale Datei herunter. Tritt ein Fehler auf, wenn der angegebene Dateipfad bereits beendet wird. Offset und Count sind optional, übergeben 0 bzw. undefiniert, um das gesamte Blob herunterzuladen. |
exists(Blob |
Gibt true zurück, wenn die von diesem Client dargestellte Azure-Blobressource vorhanden ist. Andernfalls false. HINWEIS: Verwenden Sie diese Funktion mit Bedacht, da ein vorhandenes Blob möglicherweise von anderen Clients oder Anwendungen gelöscht wird. Umgekehrt können neue Blobs von anderen Clients oder Anwendungen hinzugefügt werden, nachdem diese Funktion abgeschlossen ist. |
generate |
Nur für BlobClient verfügbar, der mit anmeldegeschützten Schlüsseln erstellt wurde. Generiert einen SAS-URI (Shared Access Signature) des Blobdiensts basierend auf den übergebenen Clienteigenschaften und Parametern. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert. |
get |
Erstellt ein AppendBlobClient-Objekt. |
get |
Rufen Sie eine ab <xref:BlobLeaseClient> , die Leases für das Blob verwaltet. |
get |
Erstellt ein BlockBlobClient-Objekt. |
get |
Erstellt ein PageBlobClient-Objekt. |
get |
Gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurück. Der Inhalt des BLOB wird nicht zurückgegeben. |
get |
Ruft die Tags ab, die dem zugrunde liegenden Blob zugeordnet sind. |
set |
Legt die Ebene für ein Blob fest. Der Vorgang ist für ein Seitenblob in einem Storage Premium-Konto und für ein Blockblob in einem Blobspeicherkonto (nur lokal redundanter Speicher) zulässig. Die Ebene eines Premium-Seitenblobs bestimmt die zulässige Größe, IOPS und Bandbreite des Blobs. Die Ebene eines Blockblobs bestimmt den Speichertyp Hot/Cool/Archive. Bei diesem Vorgang wird das ETag des Blobs nicht aktualisiert. |
set |
Legt Systemeigenschaften für den Blob fest. Wenn kein Wert oder kein Wert für die angegebenen Blob-HTTP-Header bereitgestellt wird, werden diese Blob-HTTP-Header ohne Wert gelöscht. |
set |
Legen Sie die Richtlinie für die Unmutablilität für das Blob fest. |
set |
Legen Sie den rechtlichen Halteraum für das Blob fest. |
set |
Legt benutzerdefinierte Metadaten für das angegebene Blob als mindestens ein Name-Wert-Paar fest. Wenn keine Option oder keine im Parameter definierten Metadaten angegeben sind, werden die Blobmetadaten entfernt. |
set |
Legt Tags für das zugrunde liegende Blob fest. Ein Blob kann bis zu 10 Tags aufweisen. Tagschlüssel müssen zwischen 1 und 128 Zeichen lang sein. Tagwerte müssen zwischen 0 und 256 Zeichen lang sein. Gültige Tagschlüssel- und Wertzeichen umfassen Klein- und Großbuchstaben, Ziffern (0-9), Leerzeichen (' '), plus ('+'), Minuszeichen ('-'), Punkt ('.'), Schrägstrich ('/'), Doppelpunkt (':'), gleich ('=') und Unterstrich ('_') . |
sync |
Der synchrone Vorgang "Aus URL kopieren" kopiert ein Blob oder eine Internetressource in ein neues Blob. Es wird erst dann eine Antwort zurückgegeben, wenn die Kopie abgeschlossen ist. |
undelete(Blob |
Stellt den Inhalt und die Metadaten des vorläufig gelöschten Blobs und aller zugeordneten vorläufig gelöschten Momentaufnahmen wieder her. Undelete Blob wird nur ab Version 2017-07-29 unterstützt. |
with |
Erstellt ein neues BlobClient-Objekt, das mit der Quelle identisch ist, aber mit dem angegebenen Momentaufnahmezeitstempel. Geben Sie "" an, um die Momentaufnahme zu entfernen und einen Client an das Basisblob zurückzugeben. |
with |
Erstellt ein neues BlobClient-Objekt, das auf eine Version dieses Blobs verweist. Geben Sie "" an, um die versionId zu entfernen und einen Client an das Basisblob zurückzugeben. |
Details zum Konstruktor
BlobClient(string, PipelineLike)
Erstellt eine Instanz von BlobClient. Diese Methode akzeptiert eine codierte URL oder nicht codierte URL, die auf ein Blob verweist. Die codierte URL-Zeichenfolge wird NICHT zweimal escaped, nur Sonderzeichen im URL-Pfad werden mit Escapezeichen versehen. Wenn ein Blobname enthält? oder %, blobname muss in der URL codiert werden.
new BlobClient(url: string, pipeline: PipelineLike)
Parameter
- url
-
string
Eine Clientzeichenfolge, die auf den Azure Storage-Blobdienst zeigt, z. B. "https://myaccount.blob.core.windows.net"". Sie können eine SAS anfügen, wenn Sie AnonymousCredential verwenden, z. B. "https://myaccount.blob.core.windows.net?sasString"".
- pipeline
- PipelineLike
Rufen Sie newPipeline() auf, um eine Standardpipeline zu erstellen oder eine angepasste Pipeline bereitzustellen.
BlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Erstellt eine Instanz von BlobClient. Diese Methode akzeptiert eine codierte URL oder nicht codierte URL, die auf ein Blob verweist. Die codierte URL-Zeichenfolge wird NICHT zweimal escaped, nur Sonderzeichen im URL-Pfad werden mit Escapezeichen versehen. Wenn ein Blobname enthält? oder %, blobname muss in der URL codiert werden.
new BlobClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Parameter
- url
-
string
Eine Clientzeichenfolge, die auf den Azure Storage-Blobdienst zeigt, z. B. "https://myaccount.blob.core.windows.net"". Sie können eine SAS anfügen, wenn Sie AnonymousCredential verwenden, z. B. "https://myaccount.blob.core.windows.net?sasString"".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
z. B. AnonymousCredential, StorageSharedKeyCredential oder alle Anmeldeinformationen aus dem @azure/identity
Paket, um Anforderungen an den Dienst zu authentifizieren. Sie können auch ein -Objekt bereitstellen, das die TokenCredential-Schnittstelle implementiert. Wenn nicht angegeben, wird AnonymousCredential verwendet.
- options
- StoragePipelineOptions
Optional. Optionen zum Konfigurieren der HTTP-Pipeline.
BlobClient(string, string, string, StoragePipelineOptions)
Erstellt eine Instanz von BlobClient aus der Verbindungszeichenfolge.
new BlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)
Parameter
- connectionString
-
string
Kontoverbindungszeichenfolge oder SAS-Verbindungszeichenfolge eines Azure-Speicherkontos.
[ Hinweis: Die Kontoverbindungszeichenfolge kann nur in NODE.JS Runtime verwendet werden. ] Beispiel für eine Kontoverbindungszeichenfolge :DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net
Beispiel für eine SAS-Verbindungszeichenfolge: BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString
- containerName
-
string
Der Containername.
- blobName
-
string
Blobname.
- options
- StoragePipelineOptions
Optional. Optionen zum Konfigurieren der HTTP-Pipeline.
Details zur Eigenschaft
accountName
accountName: string
Eigenschaftswert
string
containerName
Der Name des Speichercontainers, dem das Blob zugeordnet ist.
string containerName
Eigenschaftswert
string
credential
z. B. AnonymousCredential, StorageSharedKeyCredential oder alle Anmeldeinformationen aus dem @azure/identity
Paket, um Anforderungen an den Dienst zu authentifizieren. Sie können auch ein -Objekt bereitstellen, das die TokenCredential-Schnittstelle implementiert. Falls nicht angegeben, wird AnonymousCredential verwendet.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Eigenschaftswert
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
name
Der Name des Blobs.
string name
Eigenschaftswert
string
url
Codierter URL-Zeichenfolgenwert.
url: string
Eigenschaftswert
string
Details zur Methode
abortCopyFromURL(string, BlobAbortCopyFromURLOptions)
Bricht einen ausstehenden asynchronen Kopierblobvorgang ab und belässt ein Zielblob mit der Länge null und vollständigen Metadaten. Version 2012-02-12 und höher.
function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions)
Parameter
- copyId
-
string
ID des Vorgangs "Aus URL kopieren".
- options
- BlobAbortCopyFromURLOptions
Optionale Optionen für den Vorgang Blobabbruch kopieren von URL.
Gibt zurück
Promise<BlobAbortCopyFromURLResponse>
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)
Kopiert ein Blob asynchron in ein Ziel innerhalb des Speicherkontos.
Diese Methode gibt einen Abfragevorgang mit langer Ausführungsdauer zurück, mit dem Sie unbegrenzt warten können, bis der Kopiervorgang abgeschlossen ist.
Sie können eine Kopie auch abbrechen, bevor sie abgeschlossen ist, indem Sie auf dem Poller aufrufen cancelOperation
.
Beachten Sie, dass der onProgress-Rückruf nicht aufgerufen wird, wenn der Vorgang in der ersten Anforderung abgeschlossen ist und der Versuch, eine abgeschlossene Kopie abzubrechen, zu einem Fehler führt.
In Version 2012-02-12 und höher kann die Quelle für einen Kopierblobvorgang ein Commitblob in einem beliebigen Azure-Speicherkonto sein.
Ab Version 2015-02-21 kann die Quelle für einen Kopiervorgang blob eine Azure-Datei in einem beliebigen Azure-Speicherkonto sein.
Das Kopieren aus einem anderen Speicherkonto durch den Copy Blob-Vorgang wird jedoch nur für Speicherkonten unterstützt, die ab dem 7. Juni 2012 erstellt wurden.
function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions)
Parameter
- copySource
-
string
url zur Azure Blob/File-Quelle.
- options
- BlobBeginCopyFromURLOptions
Optionale Optionen für den Vorgang BlobStart Copy From URL( Blob Start Copy From URL).
Gibt zurück
Promise<PollerLike<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>
createSnapshot(BlobCreateSnapshotOptions)
Erstellt eine schreibgeschützte Momentaufnahme eines BLOB.
function createSnapshot(options?: BlobCreateSnapshotOptions)
Parameter
- options
- BlobCreateSnapshotOptions
Optionale Optionen für den Vorgang "Blobmomentaufnahme erstellen".
Gibt zurück
Promise<BlobCreateSnapshotResponse>
delete(BlobDeleteOptions)
Markiert das angegebene Blob oder die angegebene Momentaufnahme zum Löschen. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht. Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen.
function delete(options?: BlobDeleteOptions)
Parameter
- options
- BlobDeleteOptions
Optionale Optionen für blob delete-Vorgang.
Gibt zurück
Promise<BlobDeleteResponse>
deleteIfExists(BlobDeleteOptions)
Markiert das angegebene Blob oder die angegebene Momentaufnahme zum Löschen, sofern vorhanden. Das BLOB wird später während der automatischen Speicherbereinigung gelöscht. Beachten Sie, dass Sie zum Löschen eines BLOB alle zugehörigen Momentaufnahmen löschen müssen. Sie können beide gleichzeitig mit dem Vorgang Blob löschen löschen.
function deleteIfExists(options?: BlobDeleteOptions)
Parameter
- options
- BlobDeleteOptions
Optionale Optionen für blob delete-Vorgang.
Gibt zurück
Promise<BlobDeleteIfExistsResponse>
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)
Löschen Sie die Unmutablilitätsrichtlinie für das Blob.
function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions)
Parameter
Optionale Optionen zum Löschen der Unveränderlichkeitsrichtlinie für das Blob.
Gibt zurück
Promise<BlobDeleteImmutabilityPolicyResponse>
download(number, number, BlobDownloadOptions)
Liest oder lädt ein Blob aus dem System herunter, einschließlich seiner Metadaten und Eigenschaften. Sie können auch Get Blob aufrufen, um eine Momentaufnahme zu lesen.
- In Node.js werden Daten in einem lesbaren Stream zurückgegebenStreamBody
- In Browsern werden Daten in einer Zusage blobBody zurückgegeben.
function download(offset?: number, count?: number, options?: BlobDownloadOptions)
Parameter
- offset
-
number
Ab welcher Position des herunterzuladenden Blobs größer oder gleich 0
- count
-
number
Wie viele Daten heruntergeladen werden sollen, größer als 0. Wird bis zum Ende heruntergeladen, wenn nicht definiert
- options
- BlobDownloadOptions
Optionale Optionen für blobdownload-Vorgang.
Beispielverwendung (Node.js):
// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await streamToBuffer(downloadBlockBlobResponse.readableStreamBody);
console.log("Downloaded blob content:", downloaded.toString());
async function streamToBuffer(readableStream) {
return new Promise((resolve, reject) => {
const chunks = [];
readableStream.on("data", (data) => {
chunks.push(data instanceof Buffer ? data : Buffer.from(data));
});
readableStream.on("end", () => {
resolve(Buffer.concat(chunks));
});
readableStream.on("error", reject);
});
}
Beispielverwendung (Browser):
// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await blobToString(await downloadBlockBlobResponse.blobBody);
console.log(
"Downloaded blob content",
downloaded
);
async function blobToString(blob: Blob): Promise<string> {
const fileReader = new FileReader();
return new Promise<string>((resolve, reject) => {
fileReader.onloadend = (ev: any) => {
resolve(ev.target!.result);
};
fileReader.onerror = reject;
fileReader.readAsText(blob);
});
}
Gibt zurück
Promise<BlobDownloadResponseParsed>
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob parallel in einen Puffer herunter. Offset und Count sind optional und lädt das gesamte Blob herunter, wenn sie nicht bereitgestellt werden.
Warnung: Puffer können aufgrund von Einschränkungen der Node.js/V8 nur Dateien bis zu etwa einem Gigabyte auf 32-Bit-Systemen oder etwa zwei Gigabyte auf 64-Bit-Systemen unterstützen. Für Blobs, die größer als diese Größe sind, sollten Sie berücksichtigen <xref:downloadToFile>.
function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions)
Parameter
- buffer
-
Buffer
Puffer, der gefüllt werden soll, muss eine Länge haben, die größer als die Anzahl ist
- offset
-
number
Von welcher Position des Blockblobs heruntergeladen werden soll (in Bytes)
- count
-
number
Wie viele Daten (in Bytes) heruntergeladen werden sollen. Wird bis zum Ende heruntergeladen, wenn undefined übergeben wird
- options
- BlobDownloadToBufferOptions
BlobDownloadToBufferOptions
Gibt zurück
Promise<Buffer>
downloadToBuffer(number, number, BlobDownloadToBufferOptions)
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob parallel in einen Puffer herunter. Offset und Count sind optional und lädt das gesamte Blob herunter, wenn sie nicht bereitgestellt werden.
Warnung: Puffer können aufgrund von Einschränkungen der Node.js/V8 nur Dateien bis zu etwa einem Gigabyte auf 32-Bit-Systemen oder etwa zwei Gigabyte auf 64-Bit-Systemen unterstützen. Für Blobs, die größer als diese Größe sind, sollten Sie berücksichtigen <xref:downloadToFile>.
function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions)
Parameter
- offset
-
number
Von welcher Position des Blockblobs heruntergeladen werden soll (in Bytes)
- count
-
number
Wie viele Daten (in Bytes) heruntergeladen werden sollen. Wird bis zum Ende heruntergeladen, wenn undefined übergeben wird
- options
- BlobDownloadToBufferOptions
BlobDownloadToBufferOptions
Gibt zurück
Promise<Buffer>
downloadToFile(string, number, number, BlobDownloadOptions)
NUR IN NODE.JS RUNTIME VERFÜGBAR. Lädt ein Azure-Blob in eine lokale Datei herunter. Tritt ein Fehler auf, wenn der angegebene Dateipfad bereits beendet wird. Offset und Count sind optional, übergeben 0 bzw. undefiniert, um das gesamte Blob herunterzuladen.
function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions)
Parameter
- filePath
-
string
- offset
-
number
Von welcher Position des Blockblobs heruntergeladen werden soll.
- count
-
number
Wie viele Daten heruntergeladen werden sollen. Wird bis zum Ende heruntergeladen, wenn undefined übergeben wird.
- options
- BlobDownloadOptions
Optionen für Blobdownloadoptionen.
Gibt zurück
Promise<BlobDownloadResponseParsed>
Die Antwortdaten für den Blobdownloadvorgang, jedoch mit readableStreamBody, die auf undefiniert festgelegt sind, da der Inhalt bereits am angegebenen Pfad gelesen und in eine lokale Datei geschrieben wird.
exists(BlobExistsOptions)
Gibt true zurück, wenn die von diesem Client dargestellte Azure-Blobressource vorhanden ist. Andernfalls false. HINWEIS: Verwenden Sie diese Funktion mit Bedacht, da ein vorhandenes Blob möglicherweise von anderen Clients oder Anwendungen gelöscht wird. Umgekehrt können neue Blobs von anderen Clients oder Anwendungen hinzugefügt werden, nachdem diese Funktion abgeschlossen ist.
function exists(options?: BlobExistsOptions)
Parameter
- options
- BlobExistsOptions
Optionen zum Exists-Vorgang.
Gibt zurück
Promise<boolean>
generateSasUrl(BlobGenerateSasUrlOptions)
Nur für BlobClient verfügbar, der mit anmeldegeschützten Schlüsseln erstellt wurde. Generiert einen SAS-URI (Shared Access Signature) des Blobdiensts basierend auf den übergebenen Clienteigenschaften und Parametern. Die SAS wird von den Anmeldeinformationen für gemeinsam genutzte Schlüssel des Clients signiert.
function generateSasUrl(options: BlobGenerateSasUrlOptions)
Parameter
- options
- BlobGenerateSasUrlOptions
Optionale Parameter.
Gibt zurück
Promise<string>
Der SAS-URI, der aus dem URI für die von diesem Client dargestellte Ressource besteht, gefolgt vom generierten SAS-Token.
getAppendBlobClient()
getBlobLeaseClient(string)
Rufen Sie eine ab <xref:BlobLeaseClient> , die Leases für das Blob verwaltet.
function getBlobLeaseClient(proposeLeaseId?: string)
Parameter
- proposeLeaseId
-
string
Anfängliche vorgeschlagene Lease-ID.
Gibt zurück
Ein neues BlobLeaseClient-Objekt zum Verwalten von Leases für das Blob.
getBlockBlobClient()
getPageBlobClient()
getProperties(BlobGetPropertiesOptions)
Gibt alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurück. Der Inhalt des BLOB wird nicht zurückgegeben.
function getProperties(options?: BlobGetPropertiesOptions)
Parameter
- options
- BlobGetPropertiesOptions
Optionale Optionen zum Abrufen von Eigenschaften.
Gibt zurück
Promise<BlobGetPropertiesResponse>
getTags(BlobGetTagsOptions)
Ruft die Tags ab, die dem zugrunde liegenden Blob zugeordnet sind.
function getTags(options?: BlobGetTagsOptions)
Parameter
- options
- BlobGetTagsOptions
Gibt zurück
Promise<BlobGetTagsResponse>
setAccessTier(BlockBlobTier | PremiumPageBlobTier | string, BlobSetTierOptions)
Legt die Ebene für ein Blob fest. Der Vorgang ist für ein Seitenblob in einem Storage Premium-Konto und für ein Blockblob in einem Blobspeicherkonto (nur lokal redundanter Speicher) zulässig. Die Ebene eines Premium-Seitenblobs bestimmt die zulässige Größe, IOPS und Bandbreite des Blobs. Die Ebene eines Blockblobs bestimmt den Speichertyp Hot/Cool/Archive. Bei diesem Vorgang wird das ETag des Blobs nicht aktualisiert.
function setAccessTier(tier: BlockBlobTier | PremiumPageBlobTier | string, options?: BlobSetTierOptions)
Parameter
- tier
-
BlockBlobTier | PremiumPageBlobTier | string
Die Ebene, die für das Blob festgelegt werden soll. Gültige Werte sind Hot, Cool oder Archive.
- options
- BlobSetTierOptions
Optionale Optionen für den Vorgang Blobsatzebene.
Gibt zurück
Promise<BlobSetTierResponse>
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)
Legt Systemeigenschaften für den Blob fest. Wenn kein Wert oder kein Wert für die angegebenen Blob-HTTP-Header bereitgestellt wird, werden diese Blob-HTTP-Header ohne Wert gelöscht.
function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions)
Parameter
- blobHTTPHeaders
- BlobHTTPHeaders
Wenn kein Wert oder kein Wert für die angegebenen Blob-HTTP-Header bereitgestellt wird, werden diese Blob-HTTP-Header ohne Wert gelöscht.
Ein allgemeiner Header, der festgelegt werden soll, ist blobContentType
es dem Browser zu ermöglichen, Funktionen basierend auf dem Dateityp bereitzustellen.
- options
- BlobSetHTTPHeadersOptions
Optionale Optionen für den Vorgang Blobsatz-HTTP-Header.
Gibt zurück
Promise<BlobSetHTTPHeadersResponse>
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)
Legen Sie die Richtlinie für die Unmutablilität für das Blob fest.
function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions)
Parameter
- immutabilityPolicy
- BlobImmutabilityPolicy
- options
- BlobSetImmutabilityPolicyOptions
Optionale Optionen zum Festlegen einer Unveränderlichkeitsrichtlinie für das Blob.
Gibt zurück
Promise<BlobSetImmutabilityPolicyResponse>
setLegalHold(boolean, BlobSetLegalHoldOptions)
Legen Sie den rechtlichen Halteraum für das Blob fest.
function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions)
Parameter
- legalHoldEnabled
-
boolean
- options
- BlobSetLegalHoldOptions
Optionale Optionen zum Festlegen der rechtlichen Aufbewahrung für das Blob.
Gibt zurück
Promise<BlobSetLegalHoldResponse>
setMetadata(Metadata, BlobSetMetadataOptions)
Legt benutzerdefinierte Metadaten für das angegebene Blob als mindestens ein Name-Wert-Paar fest. Wenn keine Option oder keine im Parameter definierten Metadaten angegeben sind, werden die Blobmetadaten entfernt.
function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions)
Parameter
- metadata
- Metadata
Ersetzen Sie vorhandene Metadaten durch diesen Wert. Wenn kein Wert angegeben ist, werden die vorhandenen Metadaten entfernt.
- options
- BlobSetMetadataOptions
Optionale Optionen zum Festlegen des Metadatenvorgangs.
Gibt zurück
Promise<BlobSetMetadataResponse>
setTags(Tags, BlobSetTagsOptions)
Legt Tags für das zugrunde liegende Blob fest. Ein Blob kann bis zu 10 Tags aufweisen. Tagschlüssel müssen zwischen 1 und 128 Zeichen lang sein. Tagwerte müssen zwischen 0 und 256 Zeichen lang sein. Gültige Tagschlüssel- und Wertzeichen umfassen Klein- und Großbuchstaben, Ziffern (0-9), Leerzeichen (' '), plus ('+'), Minuszeichen ('-'), Punkt ('.'), Schrägstrich ('/'), Doppelpunkt (':'), gleich ('=') und Unterstrich ('_') .
function setTags(tags: Tags, options?: BlobSetTagsOptions)
Parameter
- tags
- Tags
- options
- BlobSetTagsOptions
Gibt zurück
Promise<BlobSetTagsResponse>
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)
Der synchrone Vorgang "Aus URL kopieren" kopiert ein Blob oder eine Internetressource in ein neues Blob. Es wird erst dann eine Antwort zurückgegeben, wenn die Kopie abgeschlossen ist.
function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions)
Parameter
- copySource
-
string
Die Quell-URL, aus der kopiert werden soll. Shared Access Signature(SAS) ist möglicherweise für die Authentifizierung erforderlich.
- options
- BlobSyncCopyFromURLOptions
Gibt zurück
Promise<BlobCopyFromURLResponse>
undelete(BlobUndeleteOptions)
Stellt den Inhalt und die Metadaten des vorläufig gelöschten Blobs und aller zugeordneten vorläufig gelöschten Momentaufnahmen wieder her. Undelete Blob wird nur ab Version 2017-07-29 unterstützt.
function undelete(options?: BlobUndeleteOptions)
Parameter
- options
- BlobUndeleteOptions
Optionale Optionen für blob-Undelete-Vorgang.
Gibt zurück
Promise<BlobUndeleteResponse>
withSnapshot(string)
Erstellt ein neues BlobClient-Objekt, das mit der Quelle identisch ist, aber mit dem angegebenen Momentaufnahmezeitstempel. Geben Sie "" an, um die Momentaufnahme zu entfernen und einen Client an das Basisblob zurückzugeben.
function withSnapshot(snapshot: string)
Parameter
- snapshot
-
string
Der Momentaufnahmezeitstempel.
Gibt zurück
Ein neues BlobClient-Objekt, das mit der Quelle identisch ist, aber mit dem angegebenen Momentaufnahmezeitstempel
withVersion(string)
Erstellt ein neues BlobClient-Objekt, das auf eine Version dieses Blobs verweist. Geben Sie "" an, um die versionId zu entfernen und einen Client an das Basisblob zurückzugeben.
function withVersion(versionId: string)
Parameter
- versionId
-
string
Die versionId.
Gibt zurück
Ein neues BlobClient-Objekt, das auf die Version dieses Blobs verweist.
Azure SDK for JavaScript
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für