Naslaginformatie over REST API voor Azure Storage
De REST API’s voor de Microsoft Azure-opslagservices bieden programmatische toegang tot de blob-, wachtrij-, tabel- en bestandsservices in Azure of in de ontwikkelomgeving via de opslagemulator.
Alle opslagservices zijn toegankelijk via REST API's. Opslagservices kunnen worden geopend vanuit een service die wordt uitgevoerd in Azure of rechtstreeks via internet vanuit elke toepassing die een HTTP/HTTPS-aanvraag kan verzenden en een HTTP/HTTPS-antwoord kan ontvangen.
Belangrijk
De Azure-opslagservices ondersteunen zowel HTTP als HTTPS; Het gebruik van HTTPS wordt echter ten zeerste aanbevolen.
Opslagaccount
Alle toegang tot opslagservices vindt plaats via het opslagaccount. Het opslagaccount is het hoogste niveau van de naamruimte voor toegang tot elk van de fundamentele services. Het is ook de basis voor autorisatie.
De REST API's voor opslagservices stellen het opslagaccount beschikbaar als een resource.
Blob-service
De Blob-service biedt opslag voor entiteiten, zoals binaire bestanden en tekstbestanden. De REST API voor de Blob-service maakt twee resources beschikbaar: containers en blobs. Een container is als een map, die een set blobs bevat; elke blob moet zich in een container bevinden. De Blob-service definieert drie typen blobs:
Blok-blobs, die zijn geoptimaliseerd voor streaming. Dit type blob is het enige blobtype dat beschikbaar is met versies ouder dan 19-09-2009.
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. Pagina-blobs zijn beschikbaar met versie 2009-09-19 en hoger. Deze worden voornamelijk gebruikt voor de VHD-bestanden die back-ups maken van de Azure-VM's.
Toevoeg-blobs, die alleen zijn geoptimaliseerd voor toevoegbewerkingen. Toevoeg-blobs zijn alleen beschikbaar met versie 21-02-2015 en hoger.
Containers en blobs ondersteunen door de gebruiker gedefinieerde metagegevens in de vorm van naam-waardeparen die zijn opgegeven als headers bij een aanvraagbewerking.
Met behulp van de REST API voor de Blob-service kunnen ontwikkelaars een hiërarchische naamruimte maken die vergelijkbaar is met een bestandssysteem. Blob-namen kunnen een hiërarchie coderen met behulp van een configureerbaar padscheidingsteken. De blobnamen MyGroup/MyBlob1 en MyGroup/MyBlob2 impliceren bijvoorbeeld een virtueel organisatieniveau voor blobs. De opsommingsbewerking voor blobs ondersteunt het doorkruisen van de virtuele hiërarchie op een manier die vergelijkbaar is met die van een bestandssysteem, zodat u een set blobs kunt retourneren die onder een groep zijn geordend. U kunt bijvoorbeeld alle blobs opsommen die zijn georganiseerd onder Mijngroep/.
Een blok-blob kan op twee manieren worden gemaakt. U kunt een blob uploaden met één put-blobbewerking of u kunt een blob uploaden als een set blokken met een putblokbewerking en de blokken doorvoeren in een blob met een bewerking Lijst met blokkeringen .
Pagina-blobs worden gemaakt en geïnitialiseerd met een maximale grootte met een aanroep naar Put Blob. Als u inhoud naar een pagina-blob wilt schrijven, roept u de bewerking Pagina plaatsen aan.
Toevoeg-blobs kunnen worden gemaakt door Put Blob aan te roepen. Een toevoeg-blob die is gemaakt met de bewerking Blob plaatsen bevat geen inhoud. Als u inhoud naar een toevoeg-blob wilt schrijven, voegt u blokken toe aan het einde van de blob door de bewerking Toevoegblok aan te roepen. Het bijwerken of verwijderen van bestaande blokken wordt niet ondersteund. Elk blok kan een andere grootte hebben, tot maximaal 4 MiB. De maximale grootte voor een toevoeg-blob is 195 GiB en een toevoeg-blob mag niet meer dan 50.000 blokken bevatten.
Blobs ondersteunen voorwaardelijke updatebewerkingen die nuttig kunnen zijn voor gelijktijdigheidsbeheer en efficiënt uploaden.
Blobs kunnen worden gelezen door de bewerking Blob ophalen aan te roepen. Een client kan de volledige blob of een willekeurig bereik van bytes lezen.
Zie Blob Service REST API voor naslaginformatie over de Blob-service-API.
Queue-service
De Queue-service biedt betrouwbare, permanente berichten binnen en tussen services. De REST API voor de Queue-service maakt twee resources beschikbaar: wachtrijen en berichten.
Wachtrijen ondersteunen door de gebruiker gedefinieerde metagegevens in de vorm van naam-waardeparen die zijn opgegeven als headers voor een aanvraagbewerking.
Elk opslagaccount kan een onbeperkt aantal berichtenwachtrijen hebben die een unieke naam hebben binnen het account. Elke berichtenwachtrij kan een onbeperkt aantal berichten bevatten. De maximale grootte voor een bericht is beperkt tot 64 KiB voor versie 2011-08-18 en 8 KiB voor eerdere versies.
Wanneer een bericht uit de wachtrij wordt gelezen, wordt van de consument verwacht dat het bericht wordt verwerkt en vervolgens wordt verwijderd. Nadat het bericht is gelezen, wordt het gedurende een opgegeven interval onzichtbaar gemaakt voor andere gebruikers. Als het bericht nog niet is verwijderd op het moment dat het interval verloopt, wordt de zichtbaarheid ervan hersteld, zodat een andere consument het kan verwerken.
Zie Queue Service REST API voor meer informatie over de Queue-service.
Tabelservice
De Tabelservice biedt gestructureerde opslag in de vorm van tabellen. De Table-service ondersteunt een REST API waarmee het OData-protocol wordt geïmplementeerd.
Binnen een opslagaccount kan een ontwikkelaar tabellen maken. In tabellen worden gegevens opgeslagen als entiteiten. Een entiteit is een verzameling benoemde eigenschappen en hun waarden, vergelijkbaar met een rij. Tabellen worden gepartitioneerd om taakverdeling over opslagknooppunten te ondersteunen. Elke tabel heeft als eerste eigenschap een partitiesleutel die de partitie aangeeft waartoe een entiteit behoort. De tweede eigenschap is een rijsleutel waarmee een entiteit binnen een bepaalde partitie wordt geïdentificeerd. De combinatie van de partitiesleutel en de rijsleutel vormt een primaire sleutel die elke entiteit uniek identificeert binnen de tabel.
De Table-service dwingt geen schema af. Een ontwikkelaar kan ervoor kiezen om een schema aan de clientzijde te implementeren en af te dwingen. Zie Table Service REST API voor meer informatie over de Table-service.
Bestandsservice
Het SMB-protocol (Server Message Block) is het voorkeursprotocol voor bestandsshares dat momenteel on-premises wordt gebruikt. Met de Microsoft Azure File-service kunnen klanten gebruikmaken van de beschikbaarheid en schaalbaarheid van De IaaS-SMB (Cloud Infrastructure as a Service) van Azure zonder dat ze SMB-clienttoepassingen hoeven te herschrijven.
De Azure File-service biedt ook een aantrekkelijk alternatief voor traditionele DAS- (Direct Attached Storage) en SAN-oplossingen (Storage Area Network), die vaak complex en duur zijn om te installeren, te configureren en te gebruiken.
Bestanden die zijn opgeslagen in Azure File Service-shares zijn toegankelijk via het SMB-protocol en ook via REST API's. De File-service biedt de volgende vier resources: het opslagaccount, shares, mappen en bestanden. Shares bieden een manier om sets bestanden te organiseren en kunnen ook worden gekoppeld als een SMB-bestandsshare die wordt gehost in de cloud.
Zie ook
Blob Service REST APIQueue Service REST APITable Service REST APIFile Service REST API