Blobs auflisten

Der List Blobs Vorgang gibt eine Liste der Blobs unter dem angegebenen Container zurück.

Bitten

Sie können die List Blobs Anforderung wie folgt erstellen. HTTPS wird empfohlen. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos.

Emulierter Speicherdienst-URI

Wenn Sie eine Anforderung an den emulierten Speicherdienst senden, geben Sie den Hostnamen des Emulators und den Azure Blob Storage-Port als 127.0.0.1:10000an, gefolgt vom Namen des emulierten Speicherkontos.

Weitere Informationen finden Sie unter Verwenden des Azurite-Emulators für die lokale Azure Storage-Entwicklung.

URI-Parameter

Sie können die folgenden zusätzlichen Parameter für den URI angeben.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.

Anforderungstext

Nichts.

Beispielanforderung

Eine Beispielanforderung finden Sie unter Auflisten von Blobressourcen .

Antwort

Die Antwort enthält einen HTTP-Statuscode, eine Reihe von Antwortheadern und einen Antworttext im XML-Format.

Statuscode

Ein erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück. Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche, standardmäßige HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antworttext

Das Format der XML-Antwort lautet wie folgt.

Beachten Sie, dass die PrefixElemente , Marker, MaxResultsund Delimiter nur vorhanden sind, wenn sie im Anforderungs-URI angegeben wurden. Wenn NextMarker leer ist, sind die Listenergebnisse vollständig. Wenn das NextMarker Feld nicht leer ist, können die Listenergebnisse vollständig sein. Wenn Sie alle Blobs auflisten möchten, fahren Sie mit dem Aufruf List Blobs mit nachfolgenden Markierungswerten fort, bis NextMarker leer ist.

Momentaufnahmen, Blobmetadaten und Blobs ohne Commit sind nur dann in der Antwort enthalten, wenn sie mit dem include Parameter im Anforderungs-URI angegeben werden.

In Version 2009-09-19 und höher sind die Eigenschaften des Blobs in einem Properties Element gekapselt.

Gibt ab Version 2009-09-19 List Blobs die folgenden umbenannten Elemente im Antworttext zurück:

• Last-Modified (früher LastModified)

• Content-Length (früher Size)

• Content-Type (früher ContentType)

• Content-Encoding (früher ContentEncoding)

• Content-Language (früher ContentLanguage)

Das Content-MD5 Element wird für Blobs angezeigt, die mit Version 2009-09-19 und höher erstellt wurden. In Version 2012-02-12 und höher berechnet Blob Storage den Content-MD5 Wert, wenn Sie ein Blob mithilfe von Put Blob hochladen. Blob Storage berechnet dies nicht, wenn Sie ein Blob mithilfe von Put Block List erstellen. Sie können den Content-MD5 Wert explizit festlegen, wenn Sie das Blob erstellen, oder indem Sie die Vorgänge Put Block List oder Set Blob Properties aufrufen.

Für Versionen ab 2009-09-19, aber vor Version 2015-02-21, können Sie keinen Container aufrufen List Blobs , der Anfügeblobs enthält. Der Dienst gibt den Statuscode 409 (Conflict) zurück, wenn das Ergebnis der Auflistung ein Anfüge-BLOB enthält.

LeaseState und LeaseDuration erscheinen nur in Version 2012-02-12 und höher.

CopyId, CopyStatus, CopySource, , CopyProgressund CopyCompletionTimeCopyStatusDescription werden nur in Version 2012-02-12 und höher angezeigt, wenn dieser Vorgang den include={copy} Parameter enthält. Diese Elemente werden nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Copy Blob Vorgang war. Die Elemente werden nicht angezeigt, wenn dieses Blob nach einem abgeschlossenen Copy Blob Vorgang mit Set Blob Properties, Put Bloboder Put Block Listgeändert wurde. Diese Elemente werden auch nicht in einem Blob angezeigt, das vor Version 2012-02-12 von Copy Blob erstellt wurde.

In Version 2013-08-15 und höher enthält das EnumerationResults Element ein ServiceEndpoint Attribut, das den Blobendpunkt angibt. Dieses Element enthält auch ein ContainerName Feld, das den Namen des Containers angibt. In früheren Versionen wurden diese beiden Attribute vor ContainerName Ort miteinander kombiniert. Auch in Version 2013-08-15 und höher wurde das Url Element under Blob entfernt.

Gibt für Version 2015-02-21 und höher List Blobs Blobs aller Typen (Block-, Seiten- und Anfügeblobs) zurück.

Gibt für Version 2015-12-11 und höher List Blobs das ServerEncrypted Element zurück. Dieses Element wird auf true festgelegt, wenn das Blob und die Anwendungsmetadaten vollständig verschlüsselt sind, und false andernfalls .

Gibt für Version 2016-05-31 und höher List Blobs das IncrementalCopy Element für inkrementelle Kopierblobs und Momentaufnahmen zurück, wobei der Wert auf festgelegt ist true.

Gibt für Version 2017-04-17 und höher das AccessTier Element zurück, List Blobs wenn explizit eine Zugriffsebene festgelegt wurde. Eine Liste der zulässigen Premium-Seitenblobebenen finden Sie unter Hochleistungsspeicher Premium und verwaltete Datenträger für VMs. Für Blob Storage- oder universelle v2-Konten sind gültige Werte , HotCoolund Archive. Wenn sich das Blob im Status "Aktivierung ausstehend" befindet, ArchiveStatus wird das Element mit einem der gültigen Werte (rehydrate-pending-to-hot, rehydrate-pending-to-cool" oder rehydrate-pending-to-cold) zurückgegeben. Ausführliche Informationen zum Blockblobtiering finden Sie unter Speicherebenen "Heiß", "Kalt" und "Archiv".

Gibt für Version 2017-04-17 und höher List Blobs das AccessTierInferred Element für Blob Storage- oder universelle v2-Konten zurück. Wenn für das Blockblob die Zugriffsebene nicht festgelegt ist, werden die Ebeneninformationen aus den Eigenschaften des Speicherkontos abgeleitet, und dieser Wert wird auf truefestgelegt. Dieser Header ist nur vorhanden, wenn die Ebene von der Kontoeigenschaft abgeleitet wird.

Gibt für Version 2017-04-17 und höher List Blobs das AccessTierChangeTime Element für Blob Storage- oder universelle v2-Konten zurück. Dies wird nur zurückgegeben, wenn die Leiste für block-BLOB jemals festgelegt wurde. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Kopfzeilen.

Für Version 2017-07-29 und höher wird , DeletedTimeund RemainingRetentionDays angezeigt, Deletedwenn dieser Vorgang den include={deleted} Parameter enthält. Diese Elemente werden nicht angezeigt, wenn dieses Blob nicht gelöscht wurde. Diese Elemente werden für Blobs oder Momentaufnahmen angezeigt, die mit dem DELETE Vorgang gelöscht werden, wenn das Feature für vorläufiges Löschen aktiviert wurde. Das Deleted Element wird für Blobs und Momentaufnahmen, die vorläufig gelöscht werden, auf true festgelegt. Deleted-Time Entspricht dem Zeitpunkt, zu dem das Blob gelöscht wurde. RemainingRetentionDays Gibt die Anzahl der Tage an, nach denen ein vorläufig gelöschtes Blob endgültig gelöscht wird.

Gibt für Version 2017-11-09 und höher den Zeitpunkt zurück, Creation-Time zu dem dieses Blob erstellt wurde.

Gibt für Version 2019-02-02 und höher das CustomerProvidedKeySha256 Element zurück, List Blobs wenn das Blob mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt ist. Der Wert wird auf den SHA-256-Hash des Schlüssels festgelegt, der zum Verschlüsseln des Blobs verwendet wird. Wenn der Vorgang den include={metadata} Parameter enthält und Anwendungsmetadaten in einem Blob vorhanden sind, das mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt ist, verfügt das Metadata Element über ein Encrypted="true" Attribut. Dieses Attribut gibt an, dass das Blob Metadaten enthält, die im Rahmen des List Blobs Vorgangs nicht entschlüsselt werden können. Um auf die Metadaten für diese Blobs zuzugreifen, rufen Sie Get Blob Properties oder Get Blob Metadata mit dem vom Kunden bereitgestellten Schlüssel auf.

Gibt für Version 2019-02-02 und höher das EncryptionScope Element zurück, List Blobs wenn das Blob mit einem Verschlüsselungsbereich verschlüsselt ist. Der Wert wird auf den Namen des Verschlüsselungsbereichs festgelegt, der zum Verschlüsseln des Blobs verwendet wird. Wenn der Vorgang den include={metadata} Parameter enthält, werden die Anwendungsmetadaten für das Blob transparent entschlüsselt und sind im Metadata Element verfügbar.

Gibt für Version 2019-12-12 und höher List Blobs das RehydratePriority Element für Blob Storage- oder universelle v2-Konten zurück, wenn sich das Objekt im rehydrate pending Status befindet. Gültige Werte sind High und Standard.

Gibt für Version 2019-12-12 und höher List Blobs das VersionId Element für Blobs und generierte Blobversionen zurück, wenn die Versionsverwaltung für das Konto aktiviert ist.

Gibt für Version 2019-12-12 und höher List Blobs das IsCurrentVersion Element für die aktuelle Version des Blobs zurück. Der Wert wird auf truegesetzt. Mit diesem Element können Sie die aktuelle Version von der schreibgeschützten, automatisch generierten Version unterscheiden.

Gibt für Version 2019-12-12 und höher List Blobs das TagCount Element für Blobs mit beliebigen Tags zurück. Das Tags Element wird nur angezeigt, wenn dieser Vorgang den include={tags} Parameter enthält. Diese Elemente werden nicht angezeigt, wenn im Blob keine Tags vorhanden sind.

Gibt für Version 2019-12-12 und höher List Blobs das Sealed Element für Anfügeblobs zurück. Das Sealed Element wird nur angezeigt, wenn das Anfügeblob versiegelt wurde. Diese Elemente werden nicht angezeigt, wenn das Anfüge-Blob nicht versiegelt ist.

Gibt für Version 2020-02-10 und höher List Blobs das LastAccessTime Element zurück. Das Element zeigt an, wann auf die Daten des BLOB zuletzt zugegriffen wurde, entsprechend der Richtlinie für die Nachverfolgung der letzten Zugriffszeit des Speicherkontos. Das Element wird nicht zurückgegeben, wenn das Speicherkonto nicht über diese Richtlinie verfügt oder die Richtlinie deaktiviert ist. Informationen zum Festlegen der Richtlinie für die Nachverfolgungszeit des letzten Zugriffs des Kontos finden Sie unter der Blob-Dienst-API. Das LastAccessTime Element verfolgt nicht nach, wann das letzte Mal auf die Metadaten des Blobs zugegriffen wird.

Gibt für Version 2020-06-12 und höher das ImmutabilityPolicyUntilDate and-Element ImmutabilityPolicyModeList Blobs zurück, wenn dieser Vorgang den include={immutabilitypolicy} Parameter enthält.

Gibt für Version 2020-06-12 und höher List Blobs das LegalHold Element zurück, wenn dieser Vorgang den include={legalhold} Parameter enthält.

Für Version 2020-06-12 und höher gibt für Konten mit aktiviertem List Blobs hierarchischem Namespace die OwnerElemente , Group, Permissionsund Acl zurück. Die Anforderung muss den include={permissions} Parameter enthalten. Beachten Sie, dass es sich bei dem Acl Element um eine kombinierte Liste von Zugriffs- und Standardzugriffssteuerungslisten handelt, die für die Datei oder das Verzeichnis festgelegt wurden.

Für Version 2020-06-12 und höher gibt für Konten mit aktiviertem hierarchischem Namespace List Blobs ein Trennzeichen das Properties Element im BlobPrefix Element zurück. Dies entspricht den Eigenschaften im Verzeichnis.

Gibt für Version 2020-08-04 und höher für Konten mit aktiviertem hierarchischem Namespace List Blobs das DeletionId Element für gelöschte Blobs zurück. DeletionId ist ein 64-Bit-Bezeichner ohne Vorzeichen. Das Element identifiziert eindeutig einen vorläufig gelöschten Pfad, um ihn von anderen gelöschten Blobs mit demselben Pfad zu unterscheiden.

Gibt für Version 2020-10-02 und höher für Konten mit aktiviertem List Blobs hierarchischem Namespace das ResourceType Eigenschaftselement für den Pfad zurück. Dies kann entweder file oder sein directory.

Für Version 2021-02-12 und höher List Blobs werden alle BlobName oder BlobPrefixName Elementwerte prozentual codiert (gemäß RFC 2396). Dies gilt insbesondere für Werte, die Zeichen enthalten, die in XML (U+FFFE oder U+FFFF) nicht gültig sind. Wenn dies codiert ist, enthält das Name-Element ein Encoded=true-Attribut. Beachten Sie, dass dies nur für die Name Elementwerte gilt, die die in XML ungültigen Zeichen enthalten, nicht für die übrigen Name Elemente in der Antwort.

Gibt für Version 2021-06-08 und höher für Konten mit aktiviertem hierarchischem Namespace List Blobs das Placeholder properties-Element zurück. Dieses Element wird im BlobPrefix Element für Platzhalterverzeichnisse zurückgegeben, wenn gelöschte Blobs mit einem Trennzeichen aufgelistet werden. Diese Platzhalterverzeichnisse sind vorhanden, um die Navigation zu vorläufig gelöschten Blobs zu erleichtern.

Für Version 2021-06-08 und höher gibt für Konten mit aktiviertem List Blobs hierarchischem Namespace das EncryptionContext Element zurück. Wenn der Wert der Verschlüsselungskontexteigenschaft festgelegt wird, wird der festgelegte Wert zurückgegeben.

Gibt für Version 2020-02-10 und höher für Konten mit aktiviertem hierarchischem Namespace List Blobs das Expiry-Time Element für gelöschte Blobs zurück. Expiry-Time ist der Zeitpunkt, zu dem die Datei abläuft und für die Datei zurückgegeben wird, wenn das Ablaufdatum auf dieselbe festgelegt ist.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</Name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>
        <Owner>owner user id</Owner>
        <Group>owning group id</Group>
        <Permissions>permission string</Permissions>
        <Acl>access control list</Acl>
        <ResourceType>file | directory</ResourceType>
        <Placeholder>true</Placeholder>
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionContext>encryption-context</EncryptionContext>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
        <Expiry-Time>date-time-value</Expiry-Time>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>  

Beispielantwort

Eine Beispielantwort finden Sie unter Auflisten von Blobressourcen .

Ermächtigung

Die Autorisierung ist beim Aufrufen eines Datenzugriffsvorgangs in Azure Storage erforderlich. Sie können den List Blobs Vorgang wie unten beschrieben autorisieren.

Bemerkungen

Blob-Eigenschaften in der Antwort

Wenn Sie angefordert haben, dass nicht freigegebene Blobs in die Enumeration einbezogen werden, beachten Sie, dass einige Eigenschaften erst festgelegt werden, wenn das Blob zugesichert wurde. Einige Eigenschaften werden in der Antwort möglicherweise nicht zurückgegeben.

Das x-ms-blob-sequence-number Element wird nur für Seitenblobs zurückgegeben.

Das OrMetadata Element wird nur für Blockblobs zurückgegeben.

Bei Seitenblobs entspricht der im Element zurückgegebene Content-Length Wert dem Wert des Headers des Blobs x-ms-blob-content-length .

Das Content-MD5 Element wird nur dann im Antworttext angezeigt, wenn es mit Version 2009-09-19 oder höher für das Blob festgelegt wurde. Sie können die Content-MD5 Eigenschaft festlegen, wenn das Blob erstellt wird, oder indem Sie Set Blob Properties aufrufen. In Version 2012-02-12 und höher Put Blob wird der MD5-Wert eines Blockblobs festgelegt, auch wenn die Put Blob Anforderung keinen MD5-Header enthält.

Metadaten in der Antwort

Das Metadata Element ist nur vorhanden, wenn der include=metadata Parameter im URI angegeben wurde. Innerhalb des Metadata Elements wird der Wert jedes Name-Wert-Paares in einem Element aufgeführt, das dem Namen des Paares entspricht.

Beachten Sie, dass mit diesem Parameter angeforderte Metadaten gemäß den Benennungseinschränkungen gespeichert werden müssen, die von der 2009-09-19-Version von Blob Storage auferlegt werden. Ab dieser Version müssen alle Metadatennamen den Benennungskonventionen für C#-Bezeichner entsprechen.

Wenn ein Name-Wert-Paar aus Metadaten gegen diese Benennungseinschränkungen verstößt, gibt der Antworttext den problematischen Namen innerhalb eines x-ms-invalid-name Elements an. Das folgende XML-Fragment zeigt Folgendes:

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…  
  

Tags in der Antwort

Das Tags Element ist nur vorhanden, wenn der include=tags Parameter für den URI angegeben wurde und das Blob Tags enthält. Innerhalb des TagSet Elements werden bis zu 10 Tag Elemente zurückgegeben, die jeweils das key und value der benutzerdefinierten Blobindextags enthalten. Die Sortierung von Tags wird in der Antwort nicht garantiert.

Die Tags and-Elemente TagCount werden nicht zurückgegeben, wenn das Blob keine Tags enthält.

Der Speicherdienst behält eine starke Konsistenz zwischen einem Blob und seinen Tags bei, der sekundäre Index ist jedoch letztendlich konsistent. Tags können in einer Antwort auf sichtbar sein, List Blobs bevor sie für Find Blobs by Tags Vorgänge sichtbar sind.

Momentaufnahmen in der Antwort

Momentaufnahmen werden nur dann in der Antwort aufgeführt, wenn der include=snapshots Parameter im URI angegeben wurde. Momentaufnahmen, die in der Antwort aufgeführt sind, enthalten das LeaseStatus Element nicht, da Momentaufnahmen keine aktiven Leases haben können.

Mit der Dienstversion 2021-06-08 und höher können Sie mit einem Trennzeichen aufrufen List Blobs und Momentaufnahmen in die Enumeration einbeziehen. Für Dienstversionen vor 2021-06-08 gibt eine Anforderung, die beide enthält, einen InvalidQueryParameter-Fehler zurück (HTTP-Statuscode 400 – Ungültige Anforderung).

Nicht ausgelassene Blobs in der Antwort

Nicht ausgeführte Blobs werden nur dann in der Antwort aufgeführt, wenn der include=uncommittedblobs Parameter im URI angegeben wurde. Nicht ausgelassene Blobs, die in der Antwort aufgeführt sind, enthalten keines der folgenden Elemente:

• Last-Modified

• Etag

• Content-Type

• Content-Encoding

• Content-Language

• Content-MD5

• Cache-Control

• Metadata

Gelöschte Blobs in der Antwort

Gelöschte Blobs werden nur dann in der Antwort aufgeführt, wenn der include=deleted Parameter im URI angegeben wurde. Gelöschte Blobs, die in der Antwort aufgeführt sind, enthalten keine Lease-Elemente , da gelöschte Blobs keine aktiven Leases haben können.

Gelöschte Snapshots werden in die Listenantwort aufgenommen, wenn include=deleted,snapshot sie im URI angegeben wurde.

Objektreplikationsmetadaten in der Antwort

Das OrMetadata Element ist vorhanden, wenn eine Objektreplikationsrichtlinie für ein Blob ausgewertet wurde und der List Blobs Aufruf mit Version 2019-12-12 oder höher erfolgte. Innerhalb des OrMetadata Elements wird der Wert jedes Name-Wert-Paares in einem Element aufgeführt, das dem Namen des Paares entspricht. Das Format des Namens ist or-{policy-id}_{rule-id}, wobei {policy-id} eine GUID ist, die den Bezeichner der Objektreplikationsrichtlinie für das Speicherkonto darstellt. {rule-id} ist eine GUID, die den Regelbezeichner für den Speichercontainer darstellt. Gültige Werte sind complete und failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…  
  

Unveränderlichkeitsrichtlinie in der Antwort

Die ImmutabilityPolicyUntilDate and-Elemente ImmutabilityPolicyMode sind nur vorhanden, wenn der include=immutabilitypolicy Parameter im URI angegeben wurde.

<Properties> 
   <ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>   
   <ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>  
</Properties> 

Rechtliche Aufbewahrung in der Antwort

Das LegalHold Element ist nur vorhanden, wenn der include=legalhold Parameter im URI angegeben wurde.

<Properties> 
  <LegalHold>true | false </LegalHold>  
</Properties> 

Zurückgeben von Resultsets mithilfe eines Markerwerts

Wenn Sie einen Wert für den maxresults Parameter angeben und die Anzahl der zurückzugebenden Blobs diesen Wert oder den Standardwert für maxresultsüberschreitet, enthält der Antworttext ein NextMarker Element. Dieses Element gibt das nächste BLOB an, das für eine nachfolgende Anforderung zurückgegeben werden soll. In bestimmten Fällen gibt der Dienst das NextMarker Element zurück, obwohl die Anzahl der zurückgegebenen Ergebnisse kleiner als der Wert von maxresultsist.

Um die nächste Gruppe von Elementen zurückzugeben, geben Sie den Wert von NextMarker als Markierungsparameter im URI für die nachfolgende Anforderung an. Beachten Sie, dass der Wert von NextMarker als undurchsichtig behandelt werden sollte.

Verwenden eines Trennzeichens zum Durchlaufen des Blob-Namespace

Der delimiter Parameter ermöglicht es dem Aufrufer, den Blobnamespace mithilfe eines vom Benutzer konfigurierten Trennzeichens zu durchlaufen. Auf diese Weise können Sie eine virtuelle Hierarchie von Blobs durchlaufen, als wäre es ein Dateisystem. Das Trennzeichen kann ein einzelnes Zeichen oder eine Zeichenfolge sein.

Wenn die Anforderung diesen Parameter enthält, gibt der Vorgang ein BlobPrefix Element zurück. Das BlobPrefix Element wird anstelle aller Blobs mit Namen zurückgegeben, die mit derselben Teilzeichenfolge beginnen, bis zum Auftreten des Trennzeichens. Der Wert des BlobPrefix Elements ist substring+delimiter, wobei substring die gemeinsame Teilzeichenfolge ist, mit der ein oder mehrere Blobnamen beginnen, und delimiter der Wert des delimiter Parameters ist.

Sie können den Wert von BlobPrefix verwenden, um einen nachfolgenden Aufruf durchzuführen, um die Blobs aufzulisten, die mit diesem Präfix beginnen. Geben Sie dazu den Wert of BlobPrefix für den prefix Parameter im Anforderungs-URI an.

Beachten Sie, dass jedes zurückgegebene BlobPrefix-Element genauso wie jedes Blob-Element zu dem maximalen Ergebnis zählt.

Blobs werden im Antworttext in alphabetischer Reihenfolge mit großgeschriebenen Buchstaben aufgelistet. Beachten Sie, dass für Konten mit aktiviertem hierarchischem Namespace / die niedrigste Sortierreihenfolge verwendet wird. Dieser Unterschied im Verhalten gilt nur für das rekursive Auflisten.

Kopieren von Fehlern in der Beschreibung des Kopierstatus

CopyStatusDescription Enthält weitere Informationen zum Copy Blob Fehler.

• Wenn ein Kopierversuch fehlschlägt, ist auf pending festgelegt, CopyStatus wenn Blob Storage den Vorgang noch wiederholt. Der CopyStatusDescription Text beschreibt den Fehler, der beim letzten Kopierversuch aufgetreten sein könnte.

• Wenn CopyStatus auf failedfestgelegt ist, beschreibt der CopyStatusDescription Text den Fehler, der dazu geführt hat, dass der Kopiervorgang fehlgeschlagen ist.

In der folgenden Tabelle werden die Felder der einzelnen CopyStatusDescription Werte beschrieben.

In der folgenden Tabelle werden die CopyStatusCopyStatusDescription Werte gängiger Fehlerszenarien beschrieben.

Abrechnung

Preisanforderungen können von Clients stammen, die Blob Storage-APIs verwenden, entweder direkt über die BLOB Storage-REST-API oder aus einer Azure Storage-Clientbibliothek. Diese Anforderungen anfallen Gebühren pro Transaktion. Der Transaktionstyp wirkt sich auf die Belastung des Kontos aus. Lesen Sie z. B. Transaktionen, die einer anderen Abrechnungskategorie als dem Schreiben von Transaktionen zugerechnet werden. Die folgende Tabelle zeigt die Abrechnungskategorie für List Blobs Anforderungen basierend auf dem Speicherkontotyp:

Informationen zu den Preisen für die angegebene Abrechnungskategorie finden Sie unter Azure Blob Storage Pricing.

Siehe auch

Status- und Fehlercodes
Blob Storage-Fehlercodes