Aan de slag met hulpprogramma's voor opslagontwikkeling in Azure Stack Hub
Microsoft Azure Stack Hub biedt een set opslagservices met blob-, tabel- en wachtrijopslag.
Gebruik dit artikel als richtlijn om aan de slag te gaan met de ontwikkelhulpprogramma's voor Azure Stack Hub-opslag. Meer gedetailleerde informatie en voorbeeldcode vindt u in de bijbehorende Azure Storage-zelfstudies.
Notitie
Er zijn verschillen tussen Azure Stack Hub-opslag en Azure-opslag, met inbegrip van specifieke vereisten voor elk platform. Er zijn bijvoorbeeld specifieke vereisten voor clientbibliotheken en eindpuntachtervoegsels voor Azure Stack Hub. Zie Azure Stack Hub-opslag: verschillen en overwegingen voor meer informatie.
Azure-clientbibliotheken
Houd voor de opslagclientbibliotheken rekening met de versie die compatibel is met de REST API. U moet ook het Azure Stack Hub-eindpunt opgeven in uw code.
Update 2301 en nieuwer
Notitie
Er is een beveiligingsprobleem met hoge ernst in de oude versie van .NET en Java-clientbibliotheek, vanwege de afhankelijkheden van een kwetsbare versie van Jackson-pakket. Het wordt sterk aanbevolen om de meest recente ondersteunde versie van .NET en Java-clientbibliotheek te gebruiken om beveiligingsproblemen te voorkomen.
PHP-client installeren via Composer - current
Installeren via Composer: (neem de blob als voorbeeld).
Maak een bestand met de naam composer.json in de hoofdmap van het project met de volgende code:
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }Download composer.phar naar de hoofdmap van het project.
Uitvoeren:
php composer.phar install.
API-versie opgeven
De nieuwe .NET-clientbibliotheek (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) en Java-clientbibliotheek (Algemeen: v12.8.0) gebruiken12.0 / Blob: v12.13.0 / Queue: v12.10.0), moet u expliciet de serviceVersion opgeven in elke clientklasse (inclusief BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient en QueueClient), omdat de standaardversie in de clientklasse momenteel niet wordt ondersteund door Azure Stack Hub.
Voorbeelden
.NET
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
Java
BlobServiceVersion version = BlobServiceVersion.V2019_07_07;
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
.endpoint("<your_endpoint>")
.sasToken("<your_SAS_token>")
.serviceVersion(version)
.buildClient();
Update van 2008 en nieuwer
PHP-client installeren via Composer - current
Installeren via Composer: (neem de blob als voorbeeld).
Maak een bestand met de naam composer.json in de hoofdmap van het project met de volgende code:
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }Download composer.phar naar de hoofdmap van het project.
Uitvoeren:
php composer.phar install.
API-versie opgeven
De nieuwe .NET-clientbibliotheek (Common: v12.9.0 / Blob: v12.10.0 / Queue: v12.8.0) en Java-clientbibliotheek (common: v12.0) gebruiken12.0 / Blob: v12.13.0 / Queue: v12.10.0), moet u expliciet de serviceVersion opgeven in elke clientklasse (inclusief BlobServiceClient, BlobContainerClient, BlobClient, QueueServiceClient en QueueClient), omdat de standaardversie in de clientklasse momenteel niet wordt ondersteund door Azure Stack Hub.
Voorbeelden
.NET
BlobClientOptions options = new BlobClientOptions(BlobClientOptions.ServiceVersion.V2019_07_07);
BlobServiceClient client = new BlobServiceClient("<connection_string>", options);
Java
BlobServiceVersion version = BlobServiceVersion.V2019_07_07;
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
.endpoint("<your_endpoint>")
.sasToken("<your_SAS_token>")
.serviceVersion(version)
.buildClient();
2005-update
PHP-client installeren via Composer - current
Installeren via Composer: (neem de blob als voorbeeld).
Maak een bestand met de naam composer.json in de hoofdmap van het project met de volgende code:
{ "require": { "Microsoft/azure-storage-blob":"1.2.0" } }Download composer.phar naar de hoofdmap van het project.
Uitvoeren:
php composer.phar install.
Eindpuntdeclaratie
Een Azure Stack Hub-eindpunt bestaat uit twee onderdelen: de naam van een regio en het Azure Stack Hub-domein. In de Azure Stack Development Kit is het standaardeindpunt local.azurestack.external. Neem contact op met uw cloudbeheerder als u niet zeker bent over uw eindpunt.
Voorbeelden
.NET
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het app.config-bestand:
<add key="StorageConnectionString"
value="DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=mykey;
EndpointSuffix=local.azurestack.external;" />
Java
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:
public static final String storageConnectionString =
"DefaultEndpointsProtocol=http;" +
"AccountName=your_storage_account;" +
"AccountKey=your_storage_account_key;" +
"EndpointSuffix=local.azurestack.external";
Node.js
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het declaratie-exemplaar:
var blobSvc = azure.createBlobService('myaccount', 'mykey',
'myaccount.blob.local.azurestack.external');
C++
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:
const utility::string_t storage_connection_string(U("DefaultEndpointsProtocol=https;
AccountName=your_storage_account;
AccountKey=your_storage_account_key;
EndpointSuffix=local.azurestack.external"));
PHP
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:
$connectionString = 'BlobEndpoint=https://<storage account name>.blob.local.azurestack.external/;
QueueEndpoint=https:// <storage account name>.queue.local.azurestack.external/;
TableEndpoint=https:// <storage account name>.table.local.azurestack.external/;
AccountName=<storage account name>;AccountKey=<storage account key>'
Python
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in het declaratie-exemplaar:
block_blob_service = BlockBlobService(account_name='myaccount',
account_key='mykey',
endpoint_suffix='local.azurestack.external')
Ruby
Voor Azure Stack Hub wordt het eindpuntachtervoegsel opgegeven in de installatie van verbindingsreeks:
set
AZURE_STORAGE_CONNECTION_STRING=DefaultEndpointsProtocol=https;
AccountName=myaccount;
AccountKey=mykey;
EndpointSuffix=local.azurestack.external
Blob Storage
De volgende zelfstudies voor Azure Blob Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .
- Aan de slag met Azure Blob Storage met .NET
- Blob Storage gebruiken met Java
- Blob Storage gebruiken met Node.js
- Blob-opslag gebruiken vanuit C++
- Blob Storage gebruiken met PHP
- Azure Blob Storage gebruiken vanuit Python
- Blob Storage gebruiken met Ruby
Queue Storage
De volgende zelfstudies voor Azure Queue Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .
- Aan de slag met Azure Queue Storage met behulp van .NET
- Queue Storage gebruiken met Java
- Queue Storage gebruiken met Node.js
- Queue Storage gebruiken vanuit C++
- Queue Storage gebruiken met PHP
- Queue Storage gebruiken met Python
- Queue Storage gebruiken met Ruby
Table Storage
De volgende zelfstudies voor Azure Table Storage zijn van toepassing op Azure Stack Hub. Let op de specifieke vereiste voor eindpuntachtervoegsels voor Azure Stack Hub, zoals beschreven in de vorige sectie Voorbeelden .
- Aan de slag met Azure Table Storage met .NET
- Table Storage gebruiken met Java
- Azure Table Storage gebruiken met Node.js
- Table Storage gebruiken vanuit C++
- Table Storage gebruiken met PHP
- Table Storage gebruiken in Python
- Table Storage gebruiken met Ruby