Share maken
Met Create Share de bewerking wordt een nieuwe Azure Files-share gemaakt onder het opgegeven account. Hoewel deze API volledig wordt ondersteund, is dit een verouderde beheer-API. U wordt aangeraden in plaats daarvan Bestandsshares - Maken te gebruiken, die wordt geleverd door de Azure Storage-resourceprovider (Microsoft.Storage). Zie Bewerkingen op FileShares voor meer informatie over het programmatisch communiceren met FileShare resources met behulp van de Azure Storage-resourceprovider.
Als er al een share met dezelfde naam bestaat, mislukt de bewerking. De shareresource bevat metagegevens en eigenschappen voor die share. Deze bevat geen lijst met bestanden die zich in de share bevinden.
Protocol beschikbaarheid
| Bestandsshareprotocol ingeschakeld | Beschikbaar |
|---|---|
| Server Message Block (SMB) |  |
| Netwerkbestandssysteem (NFS) | |
Aanvraag
U kunt de Create Share aanvraag samenstellen zoals hier wordt weergegeven. U wordt aangeraden HTTPS te gebruiken.
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Vervang als volgt de padonderdelen die worden weergegeven in de aanvraag-URI door uw eigen onderdelen:
| Padonderdeel | Description |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van de bestandsshare. De naam mag alleen kleine letters bevatten. |
Zie Naam- en verwijzingsshares, mappen, bestanden en metagegevens voor meer informatie over beperkingen voor padnamen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Optioneel. De time-outparameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingen voor meer informatie. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de UTC-tijd (Coordinated Universal Time) voor de aanvraag op. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor Azure Storage-services voor meer informatie. |
x-ms-meta-name:value |
Optioneel. Een naam-waardepaar dat als metagegevens aan de share moet worden gekoppeld. Namen van metagegevens moeten voldoen aan de naamgevingsregels voor C#-id's. |
x-ms-share-quota |
Optioneel. Ondersteund in versie 2015-02-21 en hoger. Hiermee geeft u de maximale grootte van de share, in gibibytes (GiB). |
x-ms-access-tier |
Optioneel. Ondersteund in versie 2019-12-12 en hoger. Hiermee geeft u de toegangslaag van de share. Geldige waarden zijn TransactionOptimized, Hoten Cool. Zie Azure Files opslaglagen voor gedetailleerde informatie over bestandssharelagen. |
x-ms-enabled-protocols: <SMB \| NFS> |
Optioneel. Ondersteund in versie 2019-07-07 en hoger. Hiermee geeft u de ingeschakelde protocollen op de share. Als deze niet zijn opgegeven, is de standaardwaarde SMB. - SMB: De share is toegankelijk via SMBv3.0, SMBv2.1 en REST.- NFS: De share is toegankelijk via NFSv4.1. Voor deze optie is een Premium-account vereist. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Optioneel. Alleen NFS. Ondersteund in versie 2019-07-07 en hoger. Hiermee geeft u het basisverpletteringsgedrag op de share op wanneer NFS is ingeschakeld. Als dit niet is opgegeven, is de standaardwaarde NoRootSquash. - NoRootSquash: Hoofdverplettering uitschakelen.- RootSquash: Wijs aanvragen van uid/gid 0 toe aan de anonieme uid/gid.- AllSquash: wijs alle uids en gids toe aan de anonieme gebruiker. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Files bewaken voor meer informatie. |
Aanvraagbody
Geen.
Voorbeeldaanvraag
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Antwoord
Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.
Statuscode
Een geslaagde bewerking retourneert statuscode 201 (gemaakt).
Zie Status en foutcodes voor meer informatie.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Description |
|---|---|
ETag |
Bevat een waarde die de versie van de share vertegenwoordigt, tussen aanhalingstekens. |
Last-Modified |
Retourneert de datum en tijd waarop de share voor het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in kopteksten voor meer informatie. Elke bewerking die de share of de eigenschappen of metagegevens wijzigt, wordt de laatste wijzigingstijd bijgewerkt. Bewerkingen op bestanden hebben geen invloed op de laatste wijzigingstijd van de share. |
x-ms-request-id |
Identificeert de aanvraag op unieke wijze en u kunt deze gebruiken om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie |
x-ms-version |
Geeft de Azure Files versie aan die is gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is gestart. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
Geen.
Voorbeeldantwoord
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Shares worden direct in het opslagaccount gemaakt. Het is niet mogelijk om een share in een andere te nesten.
U kunt metagegevens voor een share opgeven wanneer u deze maakt door een of meer metagegevensheaders op te geven in de aanvraag. De indeling voor de metagegevensheader is x-ms-meta-name:value.
Als een share met dezelfde naam wordt verwijderd wanneer u aanroept Create Share, retourneert de server statuscode 409 (Conflict) en geeft aanvullende foutinformatie aan dat de share wordt verwijderd.
U kunt het quotum voor de sharegrootte gebruiken om de grootte te beperken van bestanden die op de share zijn opgeslagen. Het quotum beperkt de grootte van momentopnamen niet. De overhead die is gekoppeld aan bestanden en wordt gebruikt om de factureringsgrootte voor het opslagaccount te berekenen, wordt niet in het quotum opgenomen.
Wanneer de som van de grootte van de bestanden op de share het quotum overschrijdt dat voor de share is ingesteld, mislukken pogingen om de grootte van een bestand te vergroten en mislukt het maken van nieuwe niet-lege bestanden (via REST). U kunt nog steeds lege bestanden maken.
Het wijzigen of instellen van het quotum heeft geen invloed op de facturering. U wordt nog steeds gefactureerd voor de grootte van de bestanden plus de overhead.