Azure Blob Storage REST API
Azure Blob Storage slaat tekst en binaire gegevens op als objecten in de cloud. Blob Storage biedt de volgende resources: het opslagaccount, containers en blobs. Binnen uw opslagaccount bieden containers een manier om sets blobs te organiseren.
U kunt tekst en binaire gegevens opslaan in een van de volgende typen blobs:
Blok-blobs, die zijn geoptimaliseerd voor streaming.
Toevoeg-blobs, die zijn geoptimaliseerd voor toevoegbewerkingen.
Pagina-blobs, die zijn geoptimaliseerd voor willekeurige lees-/schrijfbewerkingen en die de mogelijkheid bieden om te schrijven naar een bereik van bytes in een blob.
Zie Informatie over blok-blobs, toevoeg-blobs en pagina-blobs voor meer informatie.
De REST API voor Blob Storage definieert HTTP-bewerkingen voor het opslagaccount, containers en blobs. De API bevat de bewerkingen die in de volgende tabel worden vermeld.
| Bewerking | Resourcetype | Description |
|---|---|---|
| Containers weergeven | Account | Lijsten alle containers in een opslagaccount. |
| Blob Storage-eigenschappen instellen | Account | Hiermee stelt u de eigenschappen van Blob Storage in, waaronder instellingen voor logboekregistratie en metrische gegevens, en de standaardserviceversie. |
| Eigenschappen van Blob Storage ophalen | Account | Hiermee haalt u de eigenschappen Blob Storage op, inclusief instellingen voor logboekregistratie en metrische gegevens, en de standaardserviceversie. |
| Voorbereidende blobaanvraag | Account | Query's uitvoeren op de CORS-regels (Cross-Origin Resource Sharing) voor Blob Storage, voordat de werkelijke aanvraag wordt verzonden. |
| Blob Storage-statistieken ophalen | Account | Hiermee worden statistieken opgehaald met betrekking tot replicatie voor Blob Storage. Deze bewerking is alleen beschikbaar op het eindpunt van de secundaire locatie wanneer geografisch redundante replicatie met leestoegang is ingeschakeld voor het opslagaccount. |
| Accountgegevens ophalen | Account | Retourneert de SKU-naam en het accounttype voor het opgegeven account. |
| Sleutel voor gebruikersdelegatie ophalen | Account | Hiermee haalt u een sleutel op die kan worden gebruikt voor het ondertekenen van een shared access signature voor gebruikersdelegatie. Deze handtekening verleent toegang tot resources in Blob Storage met behulp van Microsoft Entra referenties. |
| Container maken | Container | Hiermee maakt u een nieuwe container in een opslagaccount. |
| Containereigenschappen ophalen | Container | Retourneert alle door de gebruiker gedefinieerde metagegevens en systeemeigenschappen van een container. |
| Containermetagegevens ophalen | Container | Retourneert alleen door de gebruiker gedefinieerde metagegevens van een container. |
| Containermetagegevens instellen | Container | Hiermee stelt u door de gebruiker gedefinieerde metagegevens van een container in. |
| Container-ACL ophalen | Container | Hiermee haalt u het openbare toegangsbeleid en eventueel opgeslagen toegangsbeleid voor de container op. |
| Container-ACL instellen | Container | Hiermee stelt u het beleid voor openbare toegang en eventueel opgeslagen toegangsbeleid voor de container in. |
| Leasecontainer | Container | Hiermee wordt een vergrendeling voor een container voor verwijderingsbewerkingen tot stand brengt en beheerd. |
| Container verwijderen | Container | Hiermee verwijdert u de container en eventuele blobs die deze bevat. |
| Blobs weergeven | Container | Lijsten alle blobs in een container. |
| Blob plaatsen | Blok-, toevoeg- en pagina-blobs | Hiermee maakt u een nieuwe blob of vervangt u een bestaande blob in een container. |
| Blob ophalen | Blok-, toevoeg- en pagina-blobs | Leest of downloadt een blob uit Blob Storage, inclusief de door de gebruiker gedefinieerde metagegevens en systeemeigenschappen. |
| Blob-eigenschappen ophalen | Blok-, toevoeg- en pagina-blobs | Retourneert alle systeemeigenschappen en door de gebruiker gedefinieerde metagegevens op de blob. |
| Blobeigenschappen instellen | Blok-, toevoeg- en pagina-blobs | Hiermee stelt u systeemeigenschappen in die zijn gedefinieerd voor een bestaande blob. |
| Verloop van blob instellen | Blok-blobs | Hiermee stelt u de verlooptijd voor een bestaande blob in. |
| Blob-metagegevens ophalen | Blok-, toevoeg- en pagina-blobs | Haalt alle door de gebruiker gedefinieerde metagegevens van een bestaande blob of momentopname op. |
| Blobmetagegevens instellen | Blok-, toevoeg- en pagina-blobs | Hiermee stelt u door de gebruiker gedefinieerde metagegevens van een bestaande blob in. |
| Blobtags ophalen | Blok-, toevoeg- en pagina-blobs | Haalt door de gebruiker gedefinieerde tags van een bestaande blob op. |
| Blobtags instellen | Blok-, toevoeg- en pagina-blobs | Hiermee stelt u door de gebruiker gedefinieerde tags van een bestaande blob in die een secundaire index vormen. |
| Blobs zoeken op tags | Blok-, toevoeg- en pagina-blobs | Lijsten blobs op basis van de door de gebruiker gedefinieerde tags. |
| Blob verwijderen | Blok-, toevoeg- en pagina-blobs | Markeert een blob voor verwijdering. |
| Verwijderen van blob ongedaan maken | Blobs blokkeren, toevoegen en pagina-blobs | Hiermee herstelt u de inhoud en metagegevens van een voorlopig verwijderde blob of alle bijbehorende voorlopig verwijderde momentopnamen. |
| Lease-blob | Blobs blokkeren, toevoegen en pagina-blobs | Hiermee worden schrijf- en verwijderbewerkingen vergrendeld en beheerd. Als u een vergrendelde blob wilt verwijderen of naar een vergrendelde blob wilt schrijven, moet een client de lease-id opgeven. |
| Momentopname maken van blob | Blobs blokkeren, toevoegen en pagina-blobs | Hiermee maakt u een alleen-lezen momentopname van een blob. |
| Blob kopiëren | Blobs blokkeren, toevoegen en pagina-blobs | Kopieert een bron-blob naar een doel-blob in dit opslagaccount of in een ander opslagaccount. |
| Blob kopiëren afbreken | Blobs blokkeren, toevoegen en pagina-blobs | Stopt een bewerking in behandeling Copy Blob en laat een doel-blob met nul lengte en volledige metagegevens over. |
| Blok plaatsen | Alleen blok-blobs | Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blok-blob. |
| Blok van URL plaatsen | Alleen blok-blobs | Hiermee maakt u een nieuw blok dat moet worden doorgevoerd als onderdeel van een blok-blob waarin de inhoud van een URL wordt gelezen. |
| Lijst met blokkeringen plaatsen | Alleen blok-blobs | Hiermee wordt een blob doorgevoerd door de set blok-id's op te geven waaruit de blok-blob bestaat. |
| Blokkeringslijst ophalen | Alleen blok-blobs | Hiermee haalt u de lijst met blokken op die zijn geüpload als onderdeel van een blok-blob. |
| Inhoud van queryblob | Alleen blok-blobs | Past een eenvoudige sql-instructie (Structured Query Language) toe op de inhoud van een blob en retourneert alleen de opgevraagde subset van de gegevens. |
| Blob-laag instellen | Blok- en pagina-blobs | Hiermee stelt u de laag van een blob in. |
| Pagina plaatsen | Alleen pagina-blobs | Hiermee wordt een reeks pagina's naar een pagina-blob geschreven. |
| Paginabereiken ophalen | Alleen pagina-blobs | Retourneert een lijst met geldige paginabereiken voor een pagina-blob of een momentopname van een pagina-blob. |
| Blob incrementeel kopiëren | Alleen pagina-blobs | Hiermee kopieert u een momentopname van een bronpagina-blob naar een doelpagina-blob. Alleen differentiële wijzigingen worden overgedragen. |
| Toevoegblok | Alleen blobs toevoegen | Hiermee schrijft u een gegevensblok naar het einde van een toevoeg-blob. |
In deze sectie
Bewerkingen voor het account (Blob Storage)
Bewerkingen op blobs (accounts met hiërarchische naamruimte)