Azure Storage REST API naslag

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. Storage-services kunnen worden gebruikt 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.

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.

Met de REST API's voor opslagservices wordt het opslagaccount als resource gebruikt.

Blob-service

De Blob service biedt opslag voor entiteiten, zoals binaire bestanden en tekstbestanden. De REST API voor de Blob service twee resources beschikbaar: containers en blobs. Een container is net als een map met een set blobs; 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 vóór 2009-09-19.

• 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 ondersteuning geven voor de Azure-VM's.

• Blobs die zijn geoptimaliseerd voor alleen app-bewerkingen. App-blobs zijn alleen beschikbaar met versie 2015-02-21 en hoger.

Containers en blobs ondersteunen door de gebruiker gedefinieerde metagegevens in de vorm van naam-waardeparen die zijn opgegeven als headers voor een aanvraagbewerking.

Met de REST API voor de Blob service kunnen ontwikkelaars een hiërarchische naamruimte maken die vergelijkbaar is met een bestandssysteem. Blobnamen 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 enumeratiebewerking voor blobs ondersteunt het doorlopen van de virtuele hiërarchie op een manier die vergelijkbaar is met die van een bestandssysteem, zodat u een set blobs kunt retourneren die zijn geordend onder een groep. U kunt bijvoorbeeld alle blobs opsnoemen die zijn geordend onder MyGroup/.

Een blok-blob kan op twee manieren worden gemaakt. U kunt een blob uploaden met één Put Blob-bewerking, of u kunt een blob uploaden als een set blokken met een Put Block-bewerking en de blokken met een Put Block List-bewerking naar een blob door te voeren.

Pagina-blobs worden gemaakt en initialiseerd 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.

U kunt blobs aanroepen door Put Blob aan te roepen. Een toevoegende blob die is gemaakt met de bewerking Put Blob 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, maximaal 4 MiB. De maximale grootte voor een append-blob is 195 GiB en een append-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 op te halen aan te roepen. Een client kan de hele blob of een willekeurig bereik van bytes lezen.

Zie Blob Blob service voor de api-REST API voor services.

Queue-service

De Queue-service betrouwbare, permanente berichten binnen en tussen services. De REST API voor de Queue-service 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 met een unieke naam 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 verwacht dat de consument het bericht verwerkt en vervolgens verwijdert. Nadat het bericht is gelezen, wordt het onzichtbaar gemaakt voor andere consumenten voor een opgegeven interval. 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 Queue-service voor meer informatie over REST API voor services.

Tabelservice

De Table-service biedt gestructureerde opslag in de vorm van tabellen. De Table-service ondersteunt een REST API het OData-protocol implementeert.

Binnen een opslagaccount kan een ontwikkelaar tabellen maken. Tabellen slaan gegevens op als entiteiten. Een entiteit is een verzameling benoemde eigenschappen en hun waarden, vergelijkbaar met een rij. Tabellen worden gepartitief om taakverdeling tussen opslagknooppunten te ondersteunen. Elke tabel heeft als eerste eigenschap een partitiesleutel die de partitie specificeert waar een entiteit bij hoort. De tweede eigenschap is een rijsleutel die een entiteit binnen een bepaalde partitie identificeert. De combinatie van de partitiesleutel en de rijsleutel vormt een primaire sleutel die elke entiteit uniek in de tabel identificeert.

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 Tabelgegevens voor meer informatie over de tabelservice REST API voor services.

Bestandsservice

Het Server Message Block protocol (SMB) is het voorkeursprotocol voor bestands delen dat momenteel on-premises wordt gebruikt. Met de Microsoft Azure File-service kunnen klanten gebruikmaken van de beschikbaarheid en schaalbaarheid van de Cloud Infrastructure as a Service (IaaS) SMB van Azure zonder dat ze SMB-clienttoepassingen opnieuw moeten schrijven.

De Azure File-service biedt ook een aantrekkelijk alternatief voor traditionele OPLOSSINGEN voor Direct Attached Storage (DAS) en Storage Area Network (SAN), 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 Bestandsservice biedt de volgende vier resources: het opslagaccount, shares, mappen en bestanden. Shares bieden een manier om sets bestanden te organiseren en kunnen ook worden bevestigd als een SMB-bestands share die wordt gehost in de cloud.

Zie ook

Blob-REST API voor services Wachtrij REST API voor services Tabel REST API voor services Bestandsde REST API voor services