Daftar Blob

Operasi List Blobs mengembalikan daftar blob di bawah kontainer yang ditentukan.

Minta

Permintaan List Blobs dapat dibuat sebagai berikut. HTTPS disarankan. Ganti myaccount dengan nama akun penyimpanan Anda:

Metode URI Permintaan Versi HTTP
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1

URI layanan penyimpanan yang ditimulasikan

Saat membuat permintaan terhadap layanan penyimpanan yang ditimulasi, tentukan nama host emulator dan port layanan Blob sebagai 127.0.0.1:10000, diikuti dengan nama akun penyimpanan yang ditimulasikan:

Metode URI Permintaan Versi HTTP
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1

Untuk informasi selengkapnya, lihat Menggunakan Emulator Azure Storage untuk Pengembangan dan Pengujian.

Parameter URI

Parameter tambahan berikut dapat ditentukan pada URI.

Parameter Deskripsi
prefix Opsional. Memfilter hasil untuk mengembalikan hanya blob yang namanya dimulai dengan awalan yang ditentukan.
delimiter Opsional. Ketika permintaan menyertakan parameter ini, operasi mengembalikan BlobPrefix elemen dalam isi respons yang bertindak sebagai tempat penampung untuk semua blob yang namanya dimulai dengan substring yang sama hingga tampilan karakter pemisah. Pemisah mungkin satu karakter atau string.
marker Opsional. Nilai string yang mengidentifikasi bagian daftar yang akan dikembalikan dengan operasi daftar berikutnya. Operasi mengembalikan nilai penanda dalam isi respons jika daftar yang dikembalikan tidak selesai. Nilai penanda kemudian dapat digunakan dalam panggilan berikutnya untuk meminta kumpulan item daftar berikutnya.

Nilai penanda buram untuk klien.
maxresults Opsional. Menentukan jumlah maksimum blob yang akan dikembalikan, termasuk semua BlobPrefix elemen. Jika permintaan tidak menentukan maxresults atau menentukan nilai yang lebih besar dari 5.000, server akan mengembalikan hingga 5.000 item. Jika ada hasil tambahan untuk dikembalikan, layanan mengembalikan token kelanjutan dalam NextMarker elemen respons. Dalam kasus tertentu, layanan dapat mengembalikan hasil yang lebih sedikit dari yang ditentukan oleh maxresults dan juga mengembalikan token kelanjutan.

Pengaturan maxresults ke nilai yang kurang dari atau sama dengan nol menghasilkan kode respons kesalahan 400 (Permintaan Buruk).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,
deletedwithversions,immutabilitypolicy,legalhold,permissions}
Opsional. Menentukan satu atau beberapa himpunan data untuk disertakan dalam respons:

- snapshots: Menentukan bahwa rekam jepret harus disertakan dalam enumerasi. Rekam jepret dicantumkan dari yang terlama hingga terbaru dalam respons.
- metadata: Menentukan bahwa metadata blob dikembalikan dalam respons.
- uncommittedblobs: Menentukan bahwa blob yang bloknya telah diunggah, tetapi yang belum diterapkan menggunakan Put Block List, disertakan dalam respons.
- copy: Versi 2012-02-12 dan yang lebih baru. Menentukan bahwa metadata yang terkait dengan operasi saat ini atau sebelumnya Copy Blob harus disertakan dalam respons.
-deleted: Versi 2017-07-29 dan yang lebih baru. Menentukan bahwa blob yang dihapus sementara harus disertakan dalam respons.
-tags: Versi 2019-12-12 dan yang lebih baru. Menentukan bahwa tag Indeks Blob yang ditentukan pengguna harus disertakan dalam respons.
-versions: Versi 2019-12-12 dan yang lebih baru. Menentukan bahwa Versi blob harus disertakan dalam enumerasi.
-deletedwithversions: Versi 2020-10-02 dan yang lebih baru. Menentukan bahwa blob yang dihapus dengan versi apa pun (aktif atau dihapus) harus disertakan dalam respons dengan tag <HasVersionsOnly> dan nilai true.
-immutabilitypolicy: Versi 2020-06-12 dan yang lebih baru. Menentukan bahwa kebijakan imutabilitas hingga mode kebijakan tanggal dan kekekalan blob harus disertakan dalam enumerasi.
-legalhold: Versi 2020-06-12 dan yang lebih baru. Menentukan bahwa penahanan legal blob harus disertakan dalam enumerasi.
-permissions: Versi 2020-06-12 dan yang lebih baru. Hanya didukung untuk akun dengan namespace hierarki diaktifkan. Jika permintaan menyertakan parameter ini, maka Pemilik, Grup, Izin, dan Daftar Access Control untuk blob atau direktori yang tercantum akan disertakan dalam enumerasi.

Untuk menentukan lebih dari salah satu opsi ini pada URI, Anda harus memisahkan setiap opsi dengan koma yang dikodekan URL ("%82").
showonly={deleted,files,directories} Opsional. Menentukan salah satu himpunan data ini yang akan dikembalikan dalam respons:

-deleted: Opsional. Versi 2020-08-04 dan yang lebih baru. Hanya untuk akun dengan Namespace Hierarki diaktifkan. Ketika permintaan menyertakan parameter ini, daftar hanya berisi blob yang dihapus sementara. Jika include=deleted juga ditentukan, permintaan akan gagal dengan Permintaan Buruk (400).
-files: Opsional. Versi 2020-12-06 dan yang lebih baru. Hanya untuk akun dengan Namespace Hierarki diaktifkan. Ketika permintaan menyertakan parameter ini, daftar hanya berisi file.
-directories: Opsional. Versi 2020-12-06 dan yang lebih baru. Hanya untuk akun dengan Namespace Hierarki diaktifkan. Ketika permintaan menyertakan parameter ini, daftar hanya berisi direktori.
timeout Opsional. Parameter timeout dinyatakan dalam hitung detik. Untuk informasi selengkapnya, lihat Mengatur Batas Waktu untuk Operasi Blob Service.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan yang diperlukan dan opsional.

Header Permintaan Deskripsi
Authorization Wajib diisi. Menentukan skema otorisasi, nama akun, dan tanda tangan. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
Date atau x-ms-date Wajib diisi. Menentukan Waktu Universal Terkoordinasi (UTC) untuk permintaan tersebut. Untuk informasi selengkapnya, lihat Mengotorisasi permintaan ke Azure Storage.
x-ms-version Diperlukan untuk semua permintaan resmi, opsional untuk permintaan anonim. Menentukan versi operasi yang akan digunakan untuk permintaan ini. Untuk informasi selengkapnya, lihat Penerapan versi untuk layanan Azure Storage.
x-ms-client-request-id Opsional. Menyediakan nilai buram yang dihasilkan klien dengan batas karakter 1 KiB yang dicatat dalam log analitik saat pengelogan analitik penyimpanan diaktifkan. Menggunakan header ini sangat direkomendasikan untuk mengkorelasi aktivitas sisi klien dengan permintaan yang diterima oleh server. Untuk informasi selengkapnya, lihat Tentang Storage Analytics Logging dan Azure Logging: Menggunakan Log untuk Melacak Permintaan Storage.
x-ms-upn Opsional. Hanya berlaku ketika namespace hierarki diaktifkan untuk akun dan include=permissions disediakan dalam permintaan. Jika true, nilai identitas pengguna yang dikembalikan di <Owner>bidang , <Group>, dan <Acl> akan diubah dari ID objek Azure Active Directory menjadi nama utama pengguna. Jika false, nilai akan dikembalikan sebagai ID objek Azure Active Directory. Nilai defaultnya adalah salah. Perhatikan bahwa ID objek grup dan aplikasi tidak diterjemahkan karena tidak memiliki nama ramah yang unik.

Isi Permintaan

Tidak ada.

Permintaan Sampel

Lihat Menghitung Sumber Daya Blob untuk permintaan sampel.

Respon

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons dalam format XML.

Kode Status

Operasi yang berhasil mengembalikan kode status 200 (OK).

Untuk informasi tentang kode status, lihat Status dan Kode Kesalahan.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header respons Deskripsi
Content-Type Menentukan format di mana hasil dikembalikan. Saat ini nilai ini adalah application/xml.
x-ms-request-id Header ini secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan. Untuk informasi selengkapnya, lihat Pemecahan Masalah Operasi API.
x-ms-version Menunjukkan versi layanan Blob yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat menggunakan versi 2009-09-19 dan yang lebih baru.

Header ini juga dikembalikan untuk permintaan anonim tanpa versi yang ditentukan jika kontainer ditandai untuk akses publik menggunakan blob service versi 2009-09-19.
Date Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai.
x-ms-client-request-id Header ini dapat digunakan untuk memecahkan masalah permintaan dan respons yang sesuai. Nilai header ini sama dengan nilai x-ms-client-request-id header jika ada dalam permintaan dan nilainya paling banyak 1024 karakter ASCII yang terlihat. x-ms-client-request-id Jika header tidak ada dalam permintaan, header ini tidak akan ada dalam respons.

Isi Respons

Format respons XML adalah sebagai berikut.

Perhatikan bahwa Prefixelemen , Marker, MaxResults, dan Delimiter hanya ada jika ditentukan pada URI permintaan. Elemen NextMarker memiliki nilai hanya jika hasil daftar tidak selesai.

Rekam jepret, metadata blob, dan blob yang tidak dikomit disertakan dalam respons hanya jika ditentukan dengan include parameter pada URI permintaan.

Dalam versi 2009-09-19 dan yang lebih baru, properti blob dienkapsulasi dalam Properties elemen .

Dimulai dengan versi 2009-09-19, List Blobs mengembalikan elemen yang diganti namanya berikut dalam isi respons:

  • Last-Modified (sebelumnya LastModified)

  • Content-Length (sebelumnya Size)

  • Content-Type (sebelumnya ContentType)

  • Content-Encoding (sebelumnya ContentEncoding)

  • Content-Language (sebelumnya ContentLanguage)

Elemen muncul Content-MD5 untuk blob yang dibuat dengan versi 2009-09-19 dan yang lebih baru. Dalam versi 2012-02-12 dan yang lebih baru, blob service menghitung Content-MD5 nilai saat Anda mengunggah blob menggunakan Put Blob, tetapi tidak menghitung ini saat Anda membuat blob menggunakan Put Block List. Anda dapat secara eksplisit mengatur Content-MD5 nilai saat membuat blob, atau dengan memanggil operasi Put Block List atau Set Blob Properties .

Untuk versi dari 2009-09-19 dan yang lebih baru tetapi sebelum versi 2015-02-21, panggilan List Blobs pada kontainer yang menyertakan blob tambahan akan gagal dengan kode status 409 (FeatureVersionMismatch) jika hasil daftar berisi blob tambahan.

LeaseState dan LeaseDuration hanya muncul di versi 2012-02-12 dan yang lebih baru.

CopyId, , CopyStatus, CopyProgress``CopySource, CopyCompletionTime, dan CopyStatusDescription hanya muncul dalam versi 2012-02-12 dan yang lebih baru, ketika operasi ini menyertakan include={copy} parameter . Elemen-elemen ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam Copy Blob operasi, atau jika blob ini telah dimodifikasi setelah operasi yang disimpulkan Copy Blob menggunakan Set Blob Properties, , Put Blobatau Put Block List. Elemen-elemen ini juga tidak muncul dengan blob yang dibuat oleh Copy Blob sebelum versi 2012-02-12.

Dalam versi 2013-08-15 dan yang lebih baru, EnumerationResults elemen berisi atribut yang ServiceEndpoint menentukan titik akhir blob, dan bidang yang ContainerName menentukan nama kontainer. Dalam versi sebelumnya kedua atribut ini digabungkan bersama-sama ContainerName di bidang . Juga dalam versi 2013-08-15 dan yang lebih baru, Url elemen di bawah Blob telah dihapus.

Untuk versi 2015-02-21 ke atas, List Blobs mengembalikan blob dari semua jenis (blok, halaman, dan blob penambahan).

Untuk versi 2015-12-11 ke atas, List Blobs mengembalikan ServerEncrypted elemen . Elemen ini diatur ke true jika metadata blob dan aplikasi benar-benar dienkripsi, dan false sebaliknya.

Untuk versi 2016-05-31 ke atas, List Blobs mengembalikan IncrementalCopy elemen untuk blob salinan bertahap dan rekam jepret dengan nilai diatur ke true.

Untuk versi 2017-04-17 ke atas, List Blobs mengembalikan AccessTier elemen jika tingkat akses telah ditetapkan secara eksplisit. Untuk daftar tingkat blob halaman premium yang diizinkan, lihat Premium Storage berkinerja tinggi dan disk terkelola untuk VM. Untuk akun Blob Storage atau Tujuan Umum v2, nilai yang valid adalah Hot``Archive/Cool/. Jika blob dalam status tertunda rehidrasi, ArchiveStatus maka elemen dikembalikan dengan salah satu nilai rehydrate-pending-to-hot/rehydrate-pending-to-coolyang valid . Untuk informasi terperinci tentang tingkatan blob blok, lihat Tingkat penyimpanan panas, dingin, dan arsip.

Untuk versi 2017-04-17 ke atas, List Blobs mengembalikan AccessTierInferred elemen pada akun Blob Storage atau General Purpose v2. Jika blob blok tidak memiliki tingkat akses yang ditetapkan maka kami menyimpulkan tingkat dari properti akun penyimpanan dan nilai ini diatur ke true. Header ini hanya ada jika tingkat disimpulkan dari properti akun. Untuk informasi terperinci tentang tingkatan blob blok, lihat Tingkat penyimpanan panas, dingin, dan arsip.

Untuk versi 2017-04-17 ke atas, List Blobs mengembalikan AccessTierChangeTime elemen pada akun Blob Storage atau General Purpose v2. Ini dikembalikan hanya jika tingkat pada blob blok pernah ditetapkan. Format tanggal mengikuti RFC 1123. Untuk informasi selengkapnya, lihat Representasi Nilai Date-Time di Header. Untuk informasi terperinci tentang tingkatan blob blok, lihat Tingkat penyimpanan panas, dingin, dan arsip.

Untuk versi 2017-07-29 ke atas, , Deleted``DeletedTime dan RemainingRetentionDays muncul ketika operasi ini menyertakan include={deleted} parameter . Elemen-elemen ini tidak muncul jika blob ini tidak dihapus. Elemen-elemen ini muncul untuk blob atau rekam jepret yang dihapus dengan DELETE operasi saat fitur penghapusan sementara diaktifkan. Deleted elemen diatur ke true untuk blob dan rekam jepret yang dihapus sementara. Deleted-Time sesuai dengan waktu ketika blob dihapus. RemainingRetentionDays menunjukkan jumlah hari setelah blob yang dihapus sementara akan dihapus secara permanen oleh layanan blob.

Untuk versi 2017-11-09 ke atas, Creation-Time mengembalikan waktu pembuatan blob ini.

Untuk versi 2019-02-02 ke atas, List Blobs mengembalikan CustomerProvidedKeySha256 elemen jika blob dienkripsi dengan kunci yang disediakan pelanggan. Nilai akan diatur ke hash SHA-256 dari kunci yang digunakan untuk mengenkripsi blob. Selain itu, jika operasi menyertakan include={metadata} parameter dan ada metadata aplikasi yang ada pada blob yang dienkripsi dengan kunci yang disediakan pelanggan, Metadata elemen akan memiliki Encrypted="true" atribut untuk menunjukkan bahwa blob memiliki metadata yang tidak dapat didekripsi sebagai bagian List Blobs dari operasi. Panggil Dapatkan Properti Blob atau Dapatkan Metadata Blob dengan kunci yang disediakan pelanggan untuk mengakses metadata untuk blob ini.

Untuk versi 2019-02-02 ke atas, List Blobs mengembalikan EncryptionScope elemen jika blob dienkripsi dengan cakupan enkripsi. Nilai akan diatur ke nama cakupan enkripsi yang digunakan untuk mengenkripsi blob. Jika operasi menyertakan include={metadata} parameter , metadata aplikasi pada blob akan didekripsi secara transparan dan tersedia dalam Metadata elemen .

Untuk versi 2019-12-12 ke atas, List Blobs mengembalikan RehydratePriority elemen pada akun Blob Storage atau General Purpose v2 jika objek dalam status tertunda rehidrasi. Nilai yang valid adalah High/Standard. Untuk informasi terperinci tentang tingkatan blob blok, lihat Tingkat penyimpanan panas, dingin, dan arsip.

Untuk versi 2019-12-12 ke atas, List Blobs mengembalikan VersionId elemen untuk blob dan versi blob yang dihasilkan saat Penerapan Versi diaktifkan pada akun.

Untuk versi 2019-12-12 ke atas, List Blobs mengembalikan IsCurrentVersion elemen untuk versi blob saat ini dengan nilai yang diatur ke true, untuk membedakannya dari versi yang dibuat secara otomatis baca-saja.

Untuk versi 2019-12-12 ke atas, List Blobs mengembalikan TagCount elemen untuk blob dengan tag apa pun. Elemen Tags hanya muncul ketika operasi ini menyertakan include={tags} parameter . Elemen-elemen ini tidak muncul jika tidak ada tag pada blob.

Untuk versi 2019-12-12 ke atas, List Blobs mengembalikan Sealed elemen untuk Tambahkan Blob. Elemen Sealed hanya muncul ketika blob Tambahkan telah disegel. Elemen-elemen ini tidak muncul jika Append Blob tidak disegel.

Untuk versi 2020-02-10 ke atas, List Blobs mengembalikan LastAccessTime elemen . Elemen menunjukkan kapan data blob terakhir diakses sesuai dengan kebijakan pelacakan waktu akses terakhir akun penyimpanan. Elemen tidak akan dikembalikan jika akun penyimpanan tidak memiliki kebijakan pelacakan waktu akses terakhir, atau kebijakan dinonaktifkan. Untuk informasi tentang pengaturan kebijakan pelacakan waktu akses terakhir akun, lihat BLob Service API. Elemen LastAccessTime tidak melacak terakhir kali ketika metadata blob diakses.

Untuk versi 2020-06-12 ke atas, List Blobs mengembalikan elemen dan ImmutabilityPolicyMode saat operasi ini menyertakan include={immutabilitypolicy} ImmutabilityPolicyUntilDate parameter .

Untuk versi 2020-06-12 ke atas, List Blobs mengembalikan LegalHold elemen saat operasi ini menyertakan include={legalhold} parameter .

Untuk versi 2020-06-12 ke atas, untuk akun dengan namespace hierarki diaktifkan, List Blobs mengembalikan elemen , Group, dan Acl Permissions saat permintaan berisi include={permissions} Ownerparameter. Perhatikan bahwa Acl elemen akan menjadi daftar gabungan Access dan Default Acl yang diatur pada file/direktori.

Untuk versi 2020-06-12 ke atas, untuk akun dengan namespace hierarki diaktifkan, List Blobs dengan pemisah mengembalikan Properties elemen dalam BlobPrefix elemen , yang sesuai dengan Properti pada direktori.

Untuk versi 2020-08-04 ke atas, untuk akun yang diaktifkan Namespace HierarkisDeletionId, List Blobs mengembalikan elemen untuk blob yang dihapus. DeletionId adalah pengidentifikasi 64 bit yang tidak ditandatangani yang secara unik mengidentifikasi jalur yang dihapus sementara untuk membedakannya dari blob lain yang dihapus dengan jalur yang sama.

Untuk versi 2020-10-02 ke atas, untuk akun yang diaktifkan Namespace Hierarkis, List Blobs mengembalikan elemen properti untuk jalur , yang dapat berupadirectory``file/ .ResourceType

Untuk versi 2021-02-12 ke atas, List Blobs akan mengodekan persen (per RFC 2396) semua Blob Name atau BlobPrefix Name nilai elemen yang berisi karakter tidak valid dalam XML (khususnya, U+FFFE atau U+FFFF). Jika dikodekan, Name elemen akan menyertakan Encoded=true atribut . Perhatikan bahwa ini hanya akan terjadi untuk Name nilai elemen yang berisi karakter yang tidak valid di XML, bukan elemen yang tersisa Name dalam respons.

Untuk versi 2021-06-08 ke atas, untuk akun yang diaktifkan Namespace HierarkisPlaceholder, List Blobs mengembalikan elemen properti dalam BlobPrefix elemen untuk direktori tempat penampung saat mencantumkan blob yang dihapus dengan pemisah. Direktori tempat penampung ini hanya ada untuk membantu menavigasi ke blob yang dihapus sementara.

Untuk versi 2020-02-10 ke atas, untuk akun yang diaktifkan Namespace HierarkisExpiry-Time, List Blobs mengembalikan elemen untuk blob yang dihapus. Expiry-Time adalah waktu ketika file akan kedaluwarsa dan akan dikembalikan untuk file jika kedaluwarsa diatur pada yang sama.

<?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>
        <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>  

Respons Sampel

Lihat Menghitung Sumber Daya Blob untuk respons sampel.

Otorisasi

Jika daftar kontrol akses kontainer (ACL) diatur untuk mengizinkan akses anonim ke kontainer, klien apa pun dapat memanggil operasi ini. Jika tidak, operasi ini dapat dipanggil oleh pemilik akun dan oleh siapa pun dengan Tanda Tangan Akses Bersama yang memiliki izin untuk mencantumkan blob dalam kontainer.

Keterangan

Properti Blob dalam Respons

Jika Anda telah meminta agar blob yang tidak dikomit disertakan dalam enumerasi, perhatikan bahwa beberapa properti tidak diatur hingga blob diterapkan, sehingga beberapa properti mungkin tidak dikembalikan dalam respons.

Elemen x-ms-blob-sequence-number hanya dikembalikan untuk blob halaman.

Elemen OrMetadata hanya dikembalikan untuk blob blok.

Untuk blob halaman, nilai yang dikembalikan dalam Content-Length elemen sesuai dengan nilai header blob x-ms-blob-content-length .

Elemen Content-MD5 muncul di isi respons hanya jika telah diatur pada blob menggunakan versi 2009-09-19 atau yang lebih baru. Anda dapat mengatur Content-MD5 properti saat blob dibuat atau dengan memanggil Atur Properti Blob. Dalam versi 2012-02-12 dan yang lebih baru, Put Blob menetapkan nilai MD5 blob blok bahkan ketika Put Blob permintaan tidak menyertakan header MD5.

Metadata dalam Respons

Elemen Metadata hanya ada jika include=metadata parameter ditentukan pada URI. Metadata Dalam elemen , nilai setiap pasangan nama-nilai tercantum dalam elemen yang sesuai dengan nama pasangan.

Perhatikan bahwa metadata yang diminta dengan parameter ini harus disimpan sesuai dengan pembatasan penamaan yang diberlakukan oleh blob service versi 2009-09-19. Dimulai dengan versi ini, semua nama metadata harus mematuhi konvensi penamaan untuk pengidentifikasi C#.

Jika pasangan nama-nilai metadata melanggar pembatasan penamaan yang diberlakukan oleh versi 2009-09-19, isi respons menunjukkan nama yang bermasalah dalam elemen, seperti yang x-ms-invalid-name ditunjukkan dalam fragmen XML berikut:

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

Tag dalam Respons

Elemen Tags hanya ada jika include=tags parameter ditentukan pada URI dan jika ada tag pada blob. TagSet Dalam elemen , hingga 10 Tag elemen dikembalikan, masing-masing berisi key dan value dari tag Indeks Blob yang ditentukan pengguna. Urutan tag tidak dijamin dalam respons.

Elemen Tags dan TagCount tidak dikembalikan jika tidak ada tag pada blob.

Layanan penyimpanan mempertahankan konsistensi yang kuat antara blob dan tag-nya, tetapi indeks sekunder pada akhirnya konsisten. Tag mungkin terlihat dalam respons terhadap Blob Daftar sebelum terlihat oleh operasi Temukan Blob menurut Tag.

Rekam jepret dalam Respons

Rekam jepret tercantum dalam respons hanya jika include=snapshots parameter ditentukan pada URI. Rekam jepret yang tercantum dalam respons tidak menyertakan LeaseStatus elemen , karena rekam jepret tidak dapat memiliki sewa aktif.

Jika Anda memanggil List Blobs dengan pemisah, Anda juga tidak dapat menyertakan rekam jepret dalam enumerasi. Permintaan yang menyertakan keduanya mengembalikan kesalahan InvalidQueryParameter (kode status HTTP 400 – Permintaan Buruk).

Blob yang Tidak Dikomit dalam Respons

Blob yang tidak dikomit tercantum dalam respons hanya jika include=uncommittedblobs parameter ditentukan pada URI. Blob yang tidak dikomit yang tercantum dalam respons tidak menyertakan salah satu elemen berikut:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Blob yang Dihapus dalam Respons

Blob yang dihapus tercantum dalam respons hanya jika include=deleted parameter ditentukan pada URI. Blob yang dihapus yang tercantum dalam respons tidak menyertakan elemen Sewa karena blob yang dihapus tidak dapat memiliki sewa aktif.

Rekam jepret yang dihapus disertakan dalam respons daftar jika include=deleted,snapshot ditentukan pada URI.

Metadata Replikasi Objek dalam Respons

Elemen OrMetadata ini ada ketika kebijakan Replikasi Objek telah dievaluasi pada blob dan panggilan Daftar Blob dibuat menggunakan versi 2019-12-12 atau yang lebih baru. OrMetadata Dalam elemen , nilai setiap pasangan nama-nilai tercantum dalam elemen yang sesuai dengan nama pasangan. Format nama adalah or-{policy-id}_{rule-id}, di mana {policy-id} adalah panduan yang mewakili pengidentifikasi kebijakan replikasi objek pada akun penyimpanan dan {rule-id} merupakan panduan yang mewakili pengidentifikasi aturan pada kontainer penyimpanan. Nilai yang valid adalah complete/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>  
…  
  

Kebijakan Imutabilitas dalam Respons

Elemen ImmutabilityPolicyUntilDate, ImmutabilityPolicyMode hanya ada jika include=immutabilitypolicy parameter ditentukan pada URI.

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

Penahanan Legal dalam Respons

Elemen LegalHold hanya ada jika include=legalhold parameter ditentukan pada URI.

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

Mengembalikan Tataan Hasil Menggunakan Nilai Penanda

Jika Anda menentukan nilai untuk maxresults parameter dan jumlah blob yang akan dikembalikan melebihi nilai ini, atau melebihi nilai default untuk maxresults, isi respons akan berisi NextMarker elemen yang menunjukkan blob berikutnya untuk dikembalikan pada permintaan berikutnya. Dalam kasus tertentu, layanan dapat mengembalikan NextMarker elemen meskipun jumlah hasil yang dikembalikan kurang dari maxresultsnilai .

Untuk mengembalikan kumpulan item berikutnya, tentukan nilai NextMarker sebagai parameter penanda pada URI untuk permintaan berikutnya. Perhatikan bahwa nilai NextMarker harus diperlakukan sebagai buram.

Menggunakan Pemisah untuk Melintasi Namespace Blob

Parameter delimiter memungkinkan pemanggil melintasi namespace blob dengan menggunakan pemisah yang dikonfigurasi pengguna. Dengan cara ini, Anda dapat melintasi hierarki virtual blob seolah-olah itu adalah sistem file. Pemisah mungkin satu karakter atau string. Ketika permintaan menyertakan parameter ini, operasi mengembalikan BlobPrefix elemen . Elemen BlobPrefix dikembalikan sebagai pengganti semua blob yang namanya dimulai dengan substring yang sama hingga penampilan karakter pemisah. Nilai BlobPrefix elemen adalah substring+pemisah, di mana substring adalah substring umum yang memulai satu atau beberapa nama blob, dan pemisah adalah nilai parameter pemisah .

Anda dapat menggunakan nilai BlobPrefix untuk melakukan panggilan berikutnya untuk mencantumkan blob yang dimulai dengan awalan BlobPrefix ini, dengan menentukan nilai untuk prefix parameter pada URI permintaan.

Perhatikan bahwa setiap BlobPrefix elemen yang dikembalikan dihitung terhadap hasil maksimum, sama seperti setiap Blob elemen.

Blob tercantum dalam urutan alfabet dalam isi respons, dengan huruf besar tercantum terlebih dahulu.

Kesalahan salin di CopyStatusDescription

CopyStatusDescription berisi informasi lebih lanjut tentang kegagalan tersebut Copy Blob .

  • Ketika upaya salin gagal dan layanan Blob masih mencoba kembali operasi, CopyStatus diatur ke pending, dan CopyStatusDescription teks menjelaskan kegagalan yang mungkin terjadi selama upaya penyalinan terakhir.

  • Ketika CopyStatus diatur ke failed, CopyStatusDescription teks menjelaskan kesalahan yang menyebabkan operasi salin gagal.

Tabel berikut ini menjelaskan tiga bidang dari setiap CopyStatusDescription nilai.

Komponen Deskripsi
Kode status HTTP Bilangan bulat 3 digit standar yang menentukan kegagalan.
Kode kesalahan Kata kunci yang menjelaskan kesalahan yang disediakan oleh Azure dalam elemen <ErrorCode> . Jika tidak ada elemen <ErrorCode> yang muncul, kata kunci yang berisi teks kesalahan standar yang terkait dengan kode status HTTP 3 digit dalam spesifikasi HTTP digunakan. Lihat Kode Kesalahan REST API umum.
Informasi Deskripsi terperinci tentang kegagalan, dalam tanda kutip.

Tabel berikut ini menjelaskan CopyStatus nilai dan CopyStatusDescription skenario kegagalan umum.

Penting

Teks deskripsi yang ditampilkan di sini dapat berubah tanpa peringatan, bahkan tanpa perubahan versi, jadi jangan mengandalkan pencocokan teks yang tepat ini.

Skenario Nilai CopyStatus Nilai CopyStatusDescription
Operasi salin berhasil diselesaikan. success kosong
Pengguna membatalkan operasi salin sebelum selesai. Dibatalkan kosong
Kegagalan terjadi ketika membaca dari blob sumber selama operasi salin, tetapi operasi akan dicoba kembali. Tertunda 502 BadGateway "Mengalami kesalahan yang dapat diulang saat membaca sumbernya. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan terjadi saat menulis ke blob tujuan operasi salin, tetapi operasi akan dicoba kembali. Tertunda 500 InternalServerError "Mengalami kesalahan yang dapat diulang. Akan mencoba lagi. Waktu kegagalan: <waktu>"
Kegagalan yang tidak dapat dipulihkan terjadi saat membaca dari blob sumber operasi salin. gagal 404 ResourceNotFound "Salin gagal saat membaca sumber." Catatan: Saat melaporkan kesalahan yang mendasar ResourceNotFound ini, Azure kembali dalam elemen <ErrorCode> . Jika tidak ada elemen <ErrorCode> yang muncul dalam respons, representasi string standar dari status HTTP seperti NotFound akan muncul.
Periode batas waktu yang membatasi semua operasi penyalinan berlalu. (Saat ini periode batas waktu adalah 2 minggu.) gagal 500 OperationCancelled "Salinan melebihi waktu maksimum yang diizinkan."
Operasi salin gagal terlalu sering ketika membaca dari sumber, dan tidak memenuhi rasio minimum upaya untuk berhasil. (Batas waktu ini mencegah mencoba kembali sumber yang sangat buruk selama 2 minggu sebelum gagal). gagal 500 OperationCancelled "Salinan gagal saat membaca sumber."

Lihat juga

Status dan Kode Kesalahan
Kode Kesalahan Layanan Blob