Lijst met blobs
De List Blobs
-bewerking retourneert een lijst met de blobs onder de opgegeven container.
U kunt de List Blobs
aanvraag als volgt samenstellen. HTTPS wordt aanbevolen. Vervang myaccount- door de naam van uw opslagaccount.
Methode | Aanvraag-URI | HTTP-versie |
---|---|---|
GET |
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list |
HTTP/1.1 |
Wanneer u een aanvraag indient op basis van de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Azure Blob Storage-poort op als 127.0.0.1:10000
, gevolgd door de geëmuleerde naam van het opslagaccount.
Methode | Aanvraag-URI | HTTP-versie |
---|---|---|
GET |
http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list |
HTTP/1.1 |
Zie Azure Storage-emulator gebruiken voor lokale Azure Storage-ontwikkelingvoor meer informatie.
U kunt de volgende aanvullende parameters voor de URI opgeven.
Parameter | Beschrijving |
---|---|
prefix |
Facultatief. Hiermee filtert u de resultaten zodat alleen blobs worden geretourneerd met namen die beginnen met het opgegeven voorvoegsel. In accounts met een hiërarchische naamruimte treedt er een fout op in gevallen waarin de naam van een bestand wordt weergegeven in het midden van het pad naar het voorvoegsel. U kunt bijvoorbeeld proberen om blobs te vinden met de naam readmefile.txt met behulp van het voorvoegselpad folder1/folder2/readme/readmefile.txt . Er wordt een fout weergegeven als een submap een bestand met de naam readme bevat. |
delimiter |
Facultatief. Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix element in de hoofdtekst van het antwoord. Dit element fungeert als tijdelijke aanduiding voor alle blobs met namen die beginnen met dezelfde subtekenreeks, tot het uiterlijk van het scheidingsteken. Het scheidingsteken kan één teken of een tekenreeks zijn. |
marker |
Facultatief. Een tekenreekswaarde die het deel van de lijst aangeeft dat moet worden geretourneerd met de volgende lijstbewerking. De bewerking retourneert een markeringswaarde in de hoofdtekst van het antwoord als de geretourneerde lijst niet is voltooid. Vervolgens kunt u de markeringswaarde in een volgende aanroep gebruiken om de volgende set lijstitems aan te vragen. De markeringswaarde is ondoorzichtig voor de client. |
maxresults |
Facultatief. Hiermee geeft u het maximum aantal blobs dat moet worden geretourneerd, inclusief alle BlobPrefix elementen. Als de aanvraag geen maxresults opgeeft of een waarde groter dan 5.000 opgeeft, retourneert de server maximaal 5000 items. Als er extra resultaten moeten worden geretourneerd, retourneert de service een vervolgtoken in het NextMarker antwoordelement. In bepaalde gevallen retourneert de service mogelijk minder resultaten dan is opgegeven door maxresults en wordt ook een vervolgtoken geretourneerd.Als u maxresults instelt op een waarde die kleiner is dan of gelijk is aan nul, resulteert dit in foutcode 400 (Ongeldige aanvraag). |
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions, deletedwithversions,immutabilitypolicy,legalhold,permissions} |
Facultatief. Hiermee geeft u een of meer gegevenssets op die moeten worden opgenomen in het antwoord: - snapshots : Hiermee geeft u op dat momentopnamen moeten worden opgenomen in de opsomming. Momentopnamen worden weergegeven van oud naar nieuw in het antwoord.- metadata : hiermee geeft u op dat blobmetagegevens worden geretourneerd in het antwoord.- uncommittedblobs : hiermee geeft u op dat blobs waarvoor blokken zijn geüpload, maar die niet zijn doorgevoerd met behulp van Put Block List, worden opgenomen in het antwoord.- copy : versie 2012-02-12 en hoger. Hiermee geeft u op dat metagegevens met betrekking tot een huidige of vorige Copy Blob bewerking moeten worden opgenomen in het antwoord.- deleted : versie 2017-07-29 en hoger. Hiermee geeft u op dat voorlopig verwijderde blobs moeten worden opgenomen in het antwoord. - tags : versie 2019-12-12 en hoger. Hiermee geeft u op dat door de gebruiker gedefinieerde blob-indextags moeten worden opgenomen in het antwoord. - versions : versie 2019-12-12 en hoger. Hiermee geeft u op dat versies van blobs moeten worden opgenomen in de opsomming.- deletedwithversions : versie 2020-10-02 en hoger. Hiermee geeft u op dat verwijderde blobs met alle versies (actief of verwijderd) moeten worden opgenomen in het antwoord. Items die u definitief hebt verwijderd, worden in het antwoord weergegeven totdat ze worden verwerkt door garbagecollection. Gebruik de tag \<HasVersionsOnly\> en de waarde true . - immutabilitypolicy : versie 2020-06-12 en hoger. Hiermee geeft u op dat de opsomming het beleid voor onveranderbaarheid moet bevatten tot datum en de onveranderbaarheidsbeleidsmodus van de blobs.- legalhold : versie 2020-06-12 en hoger. Hiermee geeft u op dat de opsomming de juridische bewaring van blobs moet bevatten.- permissions : versie 2020-06-12 en hoger. Alleen ondersteund voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld. Als een aanvraag deze parameter bevat, worden de eigenaar, groep, machtigingen en toegangsbeheerlijst voor de vermelde blobs of mappen opgenomen in de opsomming. Als u meer dan een van deze opties op de URI wilt opgeven, moet u elke optie scheiden met een door URL gecodeerde komma ("%82"). |
showonly={deleted,files,directories} |
Facultatief. Hiermee geeft u een van deze gegevenssets die moeten worden geretourneerd in het antwoord: - deleted : optioneel. Versie 2020-08-04 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen voorlopig verwijderde blobs. Houd er rekening mee dat het terugval van POSIX ACL-autorisatie niet wordt ondersteund voor het weergeven van voorlopig verwijderde blobs. Als include=deleted ook is opgegeven, mislukt de aanvraag met Ongeldige aanvraag (400).- files : optioneel. Versie 2020-12-06 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen bestanden. - directories : optioneel. Versie 2020-12-06 en hoger. Alleen voor accounts die zijn ingeschakeld met hiërarchische naamruimte. Wanneer een aanvraag deze parameter bevat, bevat de lijst alleen mappen. |
timeout |
Facultatief. De parameter timeout wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Storage-bewerkingenvoor meer informatie. |
In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.
Aanvraagheader | Beschrijving |
---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen en optioneel voor anonieme aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-servicesvoor meer informatie. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Blob Storage-bewaken voor meer informatie. |
x-ms-upn |
Facultatief. Alleen geldig wanneer een hiërarchische naamruimte is ingeschakeld voor het account en include=permissions is opgegeven in de aanvraag. Als true , worden de waarden van de gebruikersidentiteit die worden geretourneerd in de <Owner>, <Group>en <Acl> velden omgezet van Microsoft Entra-object-id's naar principal-namen van gebruikers. Als false , worden de waarden geretourneerd als Object-id's van Microsoft Entra. De standaardwaarde is false . Houd er rekening mee dat groeps- en toepassingsobject-id's niet worden vertaald omdat ze geen unieke beschrijvende namen hebben. |
Geen.
Zie Blob-resources opsommen voor een voorbeeldaanvraag.
Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst in XML-indeling.
Een geslaagde bewerking retourneert statuscode 200 (OK). Zie Status en foutcodesvoor meer informatie over statuscodes.
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende, standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
Antwoordheader | Beschrijving |
---|---|
Content-Type |
Hiermee geeft u de indeling op waarin de resultaten worden geretourneerd. Deze waarde is momenteel application/xml . |
x-ms-request-id |
Deze header identificeert de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossenvoor meer informatie. |
x-ms-version |
Geeft de versie van Blob Storage aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan met versie 2009-09-19 en hoger. Deze header wordt ook geretourneerd voor anonieme aanvragen, zonder een versie die is opgegeven, als de container is gemarkeerd voor openbare toegang met behulp van de 2009-09-19-versie van Blob Storage. |
Date |
Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. De service genereert deze waarde. |
x-ms-client-request-id |
U kunt deze header gebruiken om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id -header als deze aanwezig is in de aanvraag. De waarde is maximaal 1024 zichtbare ASCII-tekens. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord. |
De indeling van het XML-antwoord is als volgt.
Houd er rekening mee dat de Prefix
, Marker
, MaxResults
en Delimiter
elementen alleen aanwezig zijn als ze zijn opgegeven op de aanvraag-URI. Het element NextMarker
heeft alleen een waarde als de lijstresultaten niet zijn voltooid.
Momentopnamen, blobmetagegevens en niet-verzonden blobs worden alleen opgenomen in het antwoord als ze zijn opgegeven met de parameter include
op de aanvraag-URI.
In versie 2009-09-19 en hoger worden de eigenschappen van de blob ingekapseld binnen een Properties
element.
Vanaf versie 2009-09-19 retourneert List Blobs
de volgende hernoemde elementen in de hoofdtekst van het antwoord:
Last-Modified
(eerderLastModified
)Content-Length
(eerderSize
)Content-Type
(eerderContentType
)Content-Encoding
(eerderContentEncoding
)Content-Language
(eerderContentLanguage
)
Het element Content-MD5
wordt weergegeven voor blobs die zijn gemaakt met versie 2009-09-19 en hoger. In versie 2012-02-12 en hoger berekent Blob Storage de Content-MD5
waarde wanneer u een blob uploadt met behulp van Put Blob. Blob Storage berekent dit niet wanneer u een blob maakt met behulp van Put Block List. U kunt de Content-MD5
waarde expliciet instellen wanneer u de blob maakt of door de put block list of blobeigenschappen instellen bewerkingen aan te roepen.
Voor versies van 2009-09-19 en hoger, maar vóór versie 2015-02-21 kunt u geen List Blobs
aanroepen voor een container met toevoeg-blobs. De service retourneert statuscode 409 (Conflict) als het resultaat van de vermelding een toevoeg-blob bevat.
LeaseState
en LeaseDuration
alleen in versie 2012-02-12 en hoger worden weergegeven.
CopyId
, CopyStatus
, CopySource
, CopyProgress
, CopyCompletionTime
en CopyStatusDescription
alleen weergegeven in versie 2012-02-12 en hoger, wanneer deze bewerking de parameter include={copy}
bevat. Deze elementen worden niet weergegeven als deze blob nooit de bestemming is geweest in een Copy Blob
bewerking. De elementen worden niet weergegeven als deze blob is gewijzigd na een voltooide Copy Blob
bewerking, met behulp van Set Blob Properties
, Put Blob
of Put Block List
. Deze elementen worden ook niet weergegeven met een blob die is gemaakt door Blob kopiërenvóór versie 2012-02-12.
In versie 2013-08-15 en hoger bevat het EnumerationResults
element een ServiceEndpoint
kenmerk waarmee het blob-eindpunt wordt opgegeven. Dit element bevat ook een ContainerName
veld dat de naam van de container aangeeft. In eerdere versies werden deze twee kenmerken gecombineerd in het ContainerName
veld. Ook in versie 2013-08-15 en hoger is het Url
element onder Blob
verwijderd.
Voor versie 2015-02-21 en hoger retourneert List Blobs
blobs van alle typen (blok-, pagina- en toevoeg-blobs).
Voor versie 2015-12-11 en hoger retourneert List Blobs
het ServerEncrypted
element. Dit element is ingesteld op true
als de metagegevens van de blob en toepassing volledig zijn versleuteld en anders false
.
Voor versie 2016-05-31 en hoger retourneert List Blobs
het IncrementalCopy
-element voor incrementele kopieer-blobs en momentopnamen, waarbij de waarde is ingesteld op true
.
Voor versie 2017-04-17 en hoger retourneert List Blobs
het AccessTier
element als een toegangslaag expliciet is ingesteld. Zie Premium-opslag en beheerde schijven voor VM'svoor een lijst met toegestane premium-pagina-bloblagen. Voor Blob Storage- of v2-accounts voor algemeen gebruik zijn geldige waarden Hot
, Cool
en Archive
. Als de blob de status Rehydrate in behandeling heeft, wordt ArchiveStatus
element geretourneerd met een van de geldige waarden (rehydrate-pending-to-hot
, rehydrate-pending-to-cool
of rehydrate-pending-to-cold
). Zie dynamische, statische en archiefopslaglagenvoor gedetailleerde informatie over blok-bloblagen.
Voor versie 2017-04-17 en hoger retourneert List Blobs
het element AccessTierInferred
in Blob Storage- of v2-accounts voor algemeen gebruik. Als de blok-blob niet over de toegangslaag beschikt, wordt de laaggegevens afgeleid van de eigenschappen van het opslagaccount en wordt deze waarde ingesteld op true
. Deze header is alleen aanwezig als de laag wordt afgeleid van de accounteigenschap.
Voor versie 2017-04-17 en hoger retourneert List Blobs
het element AccessTierChangeTime
in Blob Storage- of v2-accounts voor algemeen gebruik. Dit wordt alleen geretourneerd als de laag op blok-blob ooit is ingesteld. Zie Weergave van datum/tijd-waarden in koptekstenvoor meer informatie.
Voor versie 2017-07-29 en hoger worden Deleted
, DeletedTime
en RemainingRetentionDays
weergegeven wanneer deze bewerking de parameter include={deleted}
bevat. Deze elementen worden niet weergegeven als deze blob niet is verwijderd. Deze elementen worden weergegeven voor blobs of momentopnamen die zijn verwijderd met de DELETE
bewerking, wanneer de functie voor voorlopig verwijderen is ingeschakeld. Het element Deleted
is ingesteld op true
voor blobs en momentopnamen die voorlopig worden verwijderd.
Deleted-Time
komt overeen met het tijdstip waarop de blob is verwijderd.
RemainingRetentionDays
geeft het aantal dagen aan waarna een voorlopig verwijderde blob definitief wordt verwijderd.
Voor versie 2017-11-09 en hoger retourneert Creation-Time
het tijdstip waarop deze blob is gemaakt.
Voor versie 2019-02-02 en hoger retourneert List Blobs
het CustomerProvidedKeySha256
element als de blob is versleuteld met een door de klant geleverde sleutel. De waarde wordt ingesteld op de SHA-256-hash van de sleutel die wordt gebruikt om de blob te versleutelen. Als de bewerking de parameter include={metadata}
bevat en er toepassingsmetagegevens aanwezig zijn op een blob die is versleuteld met een door de klant geleverde sleutel, heeft het Metadata
element een Encrypted="true"
kenmerk. Dit kenmerk geeft aan dat de blob metagegevens bevat die niet kunnen worden ontsleuteld als onderdeel van de List Blobs
-bewerking. Als u toegang wilt krijgen tot de metagegevens voor deze blobs, roept u Blob-eigenschappen ophalen aan of blobmetagegevens ophalen met de door de klant geleverde sleutel.
Voor versie 2019-02-02 en hoger retourneert List Blobs
het EncryptionScope
element als de blob is versleuteld met een versleutelingsbereik. De waarde wordt ingesteld op de naam van het versleutelingsbereik dat wordt gebruikt om de blob te versleutelen. Als de bewerking de parameter include={metadata}
bevat, worden toepassingsmetagegevens op de blob transparant ontsleuteld en beschikbaar in het Metadata
-element.
Voor versie 2019-12-12 en hoger retourneert List Blobs
het RehydratePriority
element in Blob Storage- of v2-accounts voor algemeen gebruik, als het object de status rehydrate pending
heeft. Geldige waarden zijn High
en Standard
.
Voor versie 2019-12-12 en hoger retourneert List Blobs
het VersionId
-element voor blobs en gegenereerde blobversies wanneer versiebeheer is ingeschakeld voor het account.
Voor versie 2019-12-12 en hoger retourneert List Blobs
het IsCurrentVersion
element voor de huidige versie van de blob. De waarde is ingesteld op true
. Met dit element kunt u de huidige versie onderscheiden van de alleen-lezen, automatisch gegenereerde versies.
Voor versie 2019-12-12 en hoger retourneert List Blobs
het TagCount
-element voor blobs met tags. Het element Tags
wordt alleen weergegeven wanneer deze bewerking de parameter include={tags}
bevat. Deze elementen worden niet weergegeven als er geen tags op de blob staan.
Voor versie 2019-12-12 en hoger retourneert List Blobs
het Sealed
element voor toevoeg-blobs. Het element Sealed
wordt alleen weergegeven wanneer de toevoeg-blob is verzegeld. Deze elementen worden niet weergegeven als de toevoeg-blob niet is verzegeld.
Voor versie 2020-02-10 en hoger retourneert List Blobs
het LastAccessTime
element. Het element laat zien wanneer de gegevens van de blob voor het laatst zijn geopend, volgens het laatste beleid voor het bijhouden van toegangstijd van het opslagaccount. Het element wordt niet geretourneerd als het opslagaccount dit beleid niet heeft of als het beleid is uitgeschakeld. Zie de Blob Service-APIvoor meer informatie over het instellen van het beleid voor het bijhouden van de laatste toegangstijd van het account. Het element LastAccessTime
houdt niet de laatste keer bij wanneer de metagegevens van de blob worden geopend.
Voor versie 2020-06-12 en hoger retourneert List Blobs
de ImmutabilityPolicyUntilDate
en ImmutabilityPolicyMode
elementen, wanneer deze bewerking de parameter include={immutabilitypolicy}
bevat.
Voor versie 2020-06-12 en hoger retourneert List Blobs
het LegalHold
-element wanneer deze bewerking de parameter include={legalhold}
bevat.
Voor versie 2020-06-12 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
de elementen Owner
, Group
, Permissions
en Acl
. De aanvraag moet de parameter include={permissions}
bevatten. Het element Acl
is een gecombineerde lijst met toegangs- en standaardtoegangsbeheerlijsten die zijn ingesteld in het bestand of de map.
Voor versie 2020-06-12 en hoger, voor accounts met een hiërarchische naamruimte ingeschakeld, retourneert List Blobs
met een scheidingsteken het Properties
element in het BlobPrefix
-element. Dit komt overeen met de eigenschappen in de map.
Voor versie 2020-08-04 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
het DeletionId
-element voor verwijderde blobs.
DeletionId
is een niet-ondertekende, 64-bits id. Het element identificeert een voorlopig verwijderd pad om het te onderscheiden van andere verwijderde blobs met hetzelfde pad.
Voor versie 2020-10-02 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
het ResourceType
eigenschapselement voor het pad. Dit kan file
of directory
zijn.
Voor versie 2021-02-12 en hoger worden alle Blob
Name
of BlobPrefix
Name
elementwaarden door List Blobs
procentcode (per RFC 2396). Dit doet u met name voor waarden die tekens bevatten die niet geldig zijn in XML (U+FFFE of U+FFFF). Als dit is gecodeerd, bevat het Name
-element een Encoded=true
kenmerk. Houd er rekening mee dat dit alleen gebeurt voor de Name
elementwaarden die de tekens bevatten die ongeldig zijn in XML, niet de resterende Name
elementen in het antwoord.
Voor versie 2021-06-08 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
het element Placeholder
eigenschappen. Het retourneert dit element in het BlobPrefix
-element voor tijdelijke aanduidingen, bij het weergeven van verwijderde blobs met een scheidingsteken. Deze tijdelijke aanduidingen bestaan om navigatie naar voorlopig verwijderde blobs te vergemakkelijken.
Voor versie 2021-06-08 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
het EncryptionContext
element. Als de eigenschapswaarde van de versleutelingscontext is ingesteld, wordt de ingestelde waarde geretourneerd.
Voor versie 2020-02-10 en hoger, voor accounts waarvoor een hiërarchische naamruimte is ingeschakeld, retourneert List Blobs
het Expiry-Time
element voor verwijderde blobs.
Expiry-Time
is het tijdstip waarop het bestand verloopt en wordt geretourneerd voor het bestand als de vervaldatum is ingesteld op hetzelfde.
<?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>
Zie blob-resources opsommen voor een voorbeeldantwoord.
Autorisatie is vereist bij het aanroepen van een bewerking voor gegevenstoegang in Azure Storage. U kunt de List Blobs
bewerking autoriseren zoals hieronder wordt beschreven.
Belangrijk
Microsoft raadt aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen voor Azure Storage te autoriseren. Microsoft Entra ID biedt superieure beveiliging en gebruiksgemak in vergelijking met autorisatie van gedeelde sleutels.
- Microsoft Entra ID (aanbevolen)
-
Sas- (Shared Access Signatures)
- gedeelde sleutel
Azure Storage ondersteunt het gebruik van Microsoft Entra ID om aanvragen voor blobgegevens te autoriseren. Met Microsoft Entra ID kunt u op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) gebruiken om machtigingen te verlenen aan een beveiligingsprincipaal. De beveiligingsprincipaal kan een door een gebruiker, groep, toepassingsservice-principal of door Azure beheerde identiteit zijn. De beveiligingsprincipaal wordt geverifieerd door de Microsoft Entra-id om een OAuth 2.0-token te retourneren. Het token kan vervolgens worden gebruikt om een aanvraag te autoriseren voor de Blob-service.
Zie Toegang tot blobs autoriseren met behulp van Microsoft Entra IDvoor meer informatie over autorisatie met Behulp van Microsoft Entra ID.
Hieronder vindt u de RBAC-actie die nodig is voor een Microsoft Entra-gebruiker, groep, beheerde identiteit of service-principal om de List Blobs
-bewerking aan te roepen, en de minst bevoorrechte ingebouwde Azure RBAC-rol die deze actie omvat:
- Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
- Ingebouwde rol met minimale bevoegdheden:Storage Blob Data Reader
Als u include=tags
opgeeft:
- Azure RBAC-actie:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read
- ingebouwde rol met minimale bevoegdheden:eigenaar van opslagblobgegevens
Zie Een Azure-rol toewijzen voor toegang tot blobgegevensvoor meer informatie over het toewijzen van rollen met behulp van Azure RBAC.
Als u hebt gevraagd dat niet-doorgevoerde blobs worden opgenomen in de opsomming, moet u er rekening mee houden dat sommige eigenschappen pas zijn ingesteld als de blob is doorgevoerd. Sommige eigenschappen worden mogelijk niet geretourneerd in het antwoord.
Het x-ms-blob-sequence-number
-element wordt alleen geretourneerd voor pagina-blobs.
Het OrMetadata
-element wordt alleen geretourneerd voor blok-blobs.
Voor pagina-blobs komt de waarde die wordt geretourneerd in het Content-Length
-element overeen met de waarde van de x-ms-blob-content-length
header van de blob.
Het element Content-MD5
wordt weergegeven in de hoofdtekst van het antwoord, alleen als het is ingesteld op de blob met versie 2009-09-19 of hoger. U kunt de eigenschap Content-MD5
instellen wanneer de blob wordt gemaakt of door Blobeigenschappen instellen aan te roepen. In versie 2012-02-12 en hoger stelt Put Blob
de MD5-waarde van een blok-blob in, zelfs wanneer de Put Blob
aanvraag geen MD5-header bevat.
Het Metadata
element is alleen aanwezig als de parameter include=metadata
is opgegeven op de URI. Binnen het Metadata
element wordt de waarde van elk paar naam-waarde weergegeven in een element dat overeenkomt met de naam van het paar.
Houd er rekening mee dat metagegevens die met deze parameter zijn aangevraagd, moeten worden opgeslagen in overeenstemming met de naamgevingsbeperkingen die zijn opgelegd door de 2009-09-19-versie van Blob Storage. Vanaf deze versie moeten alle namen van metagegevens voldoen aan de naamconventies voor C#-id's.
Als een paar metagegevensnaam-waarde deze naamgevingsbeperkingen schendt, geeft de hoofdtekst van het antwoord de problematische naam aan binnen een x-ms-invalid-name
element. In het volgende XML-fragment ziet u dit:
…
<Metadata>
<MyMetadata1>first value</MyMetadata1>
<MyMetadata2>second value</MyMetadata2>
<x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>
</Metadata>
…
Het Tags
element is alleen aanwezig als de parameter include=tags
is opgegeven op de URI en als er tags in de blob zijn. Binnen het TagSet
-element worden maximaal 10 Tag
elementen geretourneerd, die elk de key
en value
van de door de gebruiker gedefinieerde blobindextags bevatten. De volgorde van tags wordt niet gegarandeerd in het antwoord.
De Tags
- en TagCount
-elementen worden niet geretourneerd als de blob geen tags bevat.
De opslagservice behoudt sterke consistentie tussen een blob en de bijbehorende tags, maar de secundaire index is uiteindelijk consistent. Tags kunnen zichtbaar zijn in een antwoord op List Blobs
voordat ze zichtbaar zijn voor Find Blobs by Tags
bewerkingen.
Momentopnamen worden alleen weergegeven in het antwoord als de parameter include=snapshots
is opgegeven op de URI. Momentopnamen die in het antwoord worden vermeld, bevatten het LeaseStatus
element niet, omdat momentopnamen geen actieve leases kunnen hebben.
Met serviceversie 2021-06-08 en hoger kunt u List Blobs
aanroepen met een scheidingsteken en momentopnamen opnemen in de opsomming. Voor serviceversies vóór 2021-06-08 retourneert een aanvraag met beide een InvalidQueryParameter-fout (HTTP-statuscode 400 – Ongeldige aanvraag).
Niet-doorgevoerde blobs worden alleen in het antwoord vermeld als de parameter include=uncommittedblobs
is opgegeven op de URI. Niet-doorgevoerde blobs die in het antwoord worden vermeld, bevatten geen van de volgende elementen:
Last-Modified
Etag
Content-Type
Content-Encoding
Content-Language
Content-MD5
Cache-Control
Metadata
Verwijderde blobs worden alleen in het antwoord vermeld als de parameter include=deleted
is opgegeven op de URI. Verwijderde blobs die in het antwoord worden vermeld, bevatten niet de Lease elementen, omdat verwijderde blobs geen actieve leases kunnen hebben.
Verwijderde momentopnamen worden opgenomen in een lijstantwoord als include=deleted,snapshot
is opgegeven op de URI.
Het element OrMetadata
aanwezig is wanneer een objectreplicatiebeleid is geëvalueerd op een blob en de List Blobs
aanroep is uitgevoerd met versie 2019-12-12 of hoger. Binnen het OrMetadata
element wordt de waarde van elk paar naam-waarde weergegeven in een element dat overeenkomt met de naam van het paar. De indeling van de naam is or-{policy-id}_{rule-id}
, waarbij {policy-id}
een GUID is die de id van het objectreplicatiebeleid voor het opslagaccount vertegenwoordigt.
{rule-id}
is een GUID die de regel-id in de opslagcontainer vertegenwoordigt. Geldige waarden zijn complete
of 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>
…
De ImmutabilityPolicyUntilDate
- en ImmutabilityPolicyMode
-elementen zijn alleen aanwezig als de parameter include=immutabilitypolicy
is opgegeven op de URI.
<Properties>
<ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>
<ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>
</Properties>
Het LegalHold
element is alleen aanwezig als de parameter include=legalhold
is opgegeven op de URI.
<Properties>
<LegalHold>true | false </LegalHold>
</Properties>
Als u een waarde opgeeft voor de parameter maxresults
en het aantal blobs dat moet worden geretourneerd deze waarde overschrijdt of de standaardwaarde voor maxresults
overschrijdt, bevat de hoofdtekst van het antwoord een NextMarker
element. Dit element geeft de volgende blob aan die moet worden geretourneerd op een volgende aanvraag. In bepaalde gevallen kan de service het NextMarker
element retourneren, ook al is het aantal geretourneerde resultaten kleiner dan de waarde van maxresults
.
Als u de volgende set items wilt retourneren, geeft u de waarde van NextMarker
op als de markeringsparameter op de URI voor de volgende aanvraag. Houd er rekening mee dat de waarde van NextMarker
moet worden behandeld als ondoorzichtig.
Met de parameter delimiter
kan de aanroeper de blobnaamruimte doorlopen met behulp van een door de gebruiker geconfigureerd scheidingsteken. Op deze manier kunt u een virtuele hiërarchie van blobs doorlopen alsof het een bestandssysteem was. Het scheidingsteken kan één teken of een tekenreeks zijn.
Wanneer de aanvraag deze parameter bevat, retourneert de bewerking een BlobPrefix
-element. Het BlobPrefix
element wordt geretourneerd in plaats van alle blobs met namen die beginnen met dezelfde subtekenreeks, tot het uiterlijk van het scheidingsteken. De waarde van het BlobPrefix
-element is subtekenreeks+scheidingsteken, waarbij subtekenreeks de algemene subtekenreeks is waarmee een of meer blobnamen worden gestart en scheidingsteken de waarde van de parameter delimiter
is.
U kunt de waarde van BlobPrefix
gebruiken om een volgende aanroep uit te voeren om de blobs weer te geven die beginnen met dit voorvoegsel. U doet dit door de waarde van BlobPrefix
op te geven voor de parameter prefix
van de aanvraag-URI.
Houd er rekening mee dat elk BlobPrefix
element dat wordt geretourneerd, telt mee naar het maximumresultaat, net zoals elk Blob
element doet.
Blobs worden in alfabetische volgorde weergegeven in de hoofdtekst van het antwoord, met hoofdletters die als eerste worden vermeld.
CopyStatusDescription
bevat meer informatie over de Copy Blob
fout.
Wanneer een kopieerpoging mislukt, wordt
CopyStatus
ingesteld oppending
als Blob Storage de bewerking nog steeds opnieuw probeert uit te voeren. In deCopyStatusDescription
tekst wordt de fout beschreven die mogelijk is opgetreden tijdens de laatste kopieerpoging.Wanneer
CopyStatus
is ingesteld opfailed
, beschrijft deCopyStatusDescription
tekst de fout waardoor de kopieerbewerking is mislukt.
In de volgende tabel worden de velden van elke CopyStatusDescription
waarde beschreven.
Bestanddeel | Beschrijving |
---|---|
HTTP-statuscode | Standaard driecijferig geheel getal dat de fout aangeeft. |
Foutcode | Trefwoord dat de fout beschrijft. Het wordt geleverd door Azure in het element <ErrorCode>. Als er geen <ErrorCode> element wordt weergegeven, retourneert de service een trefwoord dat standaardfouttekst bevat die is gekoppeld aan de HTTP-statuscode van drie cijfers in de HTTP-specificatie. Zie Algemene REST API-foutcodesvoor meer informatie. |
Informatie | Gedetailleerde beschrijving van de fout, tussen aanhalingstekens. |
In de volgende tabel worden de CopyStatus
- en CopyStatusDescription
waarden van veelvoorkomende foutscenario's beschreven.
Belangrijk
Beschrijvingstekst die hier wordt weergegeven, kan zonder waarschuwing worden gewijzigd, zelfs zonder een versiewijziging. Vertrouw niet op het vergelijken van deze exacte tekst.
Scenario | Waarde status kopiëren | Waarde statusbeschrijving kopiëren |
---|---|---|
De kopieerbewerking is voltooid. | succes | leeg |
Gebruiker heeft de kopieerbewerking afgebroken voordat deze is voltooid. | rudimentair | leeg |
Er is een fout opgetreden bij het lezen van de bron-blob tijdens een kopieerbewerking. De bewerking wordt opnieuw geprobeerd. | aanhangig | 502 BadGateway 'Er is een fout opgetreden die opnieuw kan worden geprobeerd bij het lezen van de bron. Zal het opnieuw proberen. Tijd van fout: <tijd>" |
Er is een fout opgetreden bij het schrijven naar de doel-blob van een kopieerbewerking. De bewerking wordt opnieuw geprobeerd. | aanhangig | 500 InternalServerError 'Er is een fout opgetreden die opnieuw kan worden geprobeerd. Zal het opnieuw proberen. Tijd van fout: <tijd>" |
Er is een onherstelbare fout opgetreden bij het lezen van de bron-blob van een kopieerbewerking. | mislukt | 404 ResourceNotFound 'Kopiëren is mislukt bij het lezen van de bron'. Wanneer de service deze onderliggende fout rapporteert, wordt ResourceNotFound geretourneerd in het <ErrorCode> element. Als er geen <ErrorCode> element in het antwoord wordt weergegeven, wordt een standaardtekenreeksweergave van de HTTP-status, zoals NotFound , weergegeven. |
De time-outperiode voor het beperken van alle kopieerbewerkingen die zijn verstreken. (De time-outperiode is momenteel twee weken.) | mislukt | 500 OperationCancelled "De kopie heeft de maximale toegestane tijd overschreden." |
De kopieerbewerking is te vaak mislukt bij het lezen van de bron en voldoet niet aan een minimale verhouding van pogingen tot geslaagde pogingen. (Deze time-out voorkomt dat een zeer slechte bron meer dan twee weken opnieuw wordt geprobeerd voordat deze mislukt). | mislukt | 500 OperationCancelled "De kopie is mislukt bij het lezen van de bron." |
Prijsaanvragen kunnen afkomstig zijn van clients die Blob Storage-API's gebruiken, rechtstreeks via de Blob Storage REST API of vanuit een Azure Storage-clientbibliotheek. Deze aanvragen maken kosten per transactie. Het type transactie is van invloed op de manier waarop het account in rekening wordt gebracht. Leestransacties worden bijvoorbeeld opgebouwd tot een andere factureringscategorie dan schrijftransacties. In de volgende tabel ziet u de factureringscategorie voor List Blobs
aanvragen op basis van het type opslagaccount:
Operatie | Type opslagaccount | Factureringscategorie |
---|---|---|
Lijst met blobs | Premium blok-blob Standaard algemeen gebruik v2 Standaard algemeen gebruik v1 |
Containerbewerkingen weergeven en maken |
Zie Prijzen voor Azure Blob Storagevoor meer informatie over prijzen voor de opgegeven factureringscategorie.