Share maken
Met de Create Share bewerking maakt u een nieuwe Azure Files-share onder het opgegeven account. Hoewel deze API volledig wordt ondersteund, is dit een verouderde beheer-API. U wordt aangeraden in plaats daarvan bestandsshares te gebruiken:maken, die wordt geleverd door de Azure Storage-resourceprovider (Microsoft.Storage). Zie Operations on FileSharesvoor meer informatie over het programmatisch werken 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. Het bevat geen lijst met de bestanden die zich in de share bevinden.
Beschikbaarheid van protocol
| Protocol voor bestandsshare ingeschakeld | Beschikbaar |
|---|---|
| Server Message Block (SMB) |
|
| Network File System (NFS) |
|
Verzoek
U kunt de Create Share aanvraag maken, 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 | Beschrijving |
|---|---|
myaccount |
De naam van uw opslagaccount. |
myshare |
De naam van uw bestandsshare. De naam mag alleen kleine letters bevatten. |
Zie Naam- en referentieshares, mappen, bestanden en metagegevensvoor meer informatie over padnaamgevingsbeperkingen.
URI-parameters
U kunt de volgende aanvullende parameters opgeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
timeout |
Facultatief. De time-outparameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor bestandsservicebewerkingenvoor 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 op. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
Date of x-ms-date |
Vereist. Hiermee geeft u de UTC-tijd (Coordinated Universal Time) tijd voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storagevoor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Zie Versiebeheer voor Azure Storage-servicesvoor meer informatie. |
x-ms-meta-name:value |
Facultatief. 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 |
Facultatief. Ondersteund in versie 2015-02-21 en hoger. Hiermee geeft u de maximale grootte van de share, in gibibytes (GiB). |
x-ms-access-tier |
Facultatief. 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-opslaglagenvoor gedetailleerde informatie over bestandssharelagen. |
x-ms-enabled-protocols: <SMB \| NFS> |
Facultatief. Ondersteund in versie 2019-07-07 en hoger. Hiermee geeft u de ingeschakelde protocollen op de share. Als ze 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> |
Facultatief. Alleen NFS. Ondersteund in versie 2019-07-07 en hoger. Hiermee geeft u het root-squashgedrag op de share wanneer NFS is ingeschakeld. Als deze niet is opgegeven, is de standaardwaarde NoRootSquash. - NoRootSquash: Root squashen 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-enable-snapshot-virtual-directory-access: <true \| false> |
Facultatief. Ondersteund in versie 2024-08-04 en hoger. Hiermee geeft u op of de virtuele map van de momentopname toegankelijk moet zijn in de hoofdmap van het share-koppelpunt wanneer NFS is ingeschakeld. Als dit niet is opgegeven, is de standaardwaarde waar. |
x-ms-client-request-id |
Facultatief. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet 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 Monitor Azure Filesvoor meer informatie. |
x-ms-share-paid-bursting-enabled: <true \| false> |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares (bestandsshares binnen het type FileStorage-opslagaccount). Met deze eigenschap kunt u betaalde bursting inschakelen. Als de eigenschap niet is opgegeven, is de standaardwaarde onwaar. |
x-ms-share-paid-bursting-max-iops |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares. Een geheel getal dat de maximaal betaalde bursting-invoer-/uitvoerbewerkingen per seconde (IOPS) vertegenwoordigt die is toegestaan voor de share. De standaardinstelling als deze niet is opgegeven, is de maximaal toegestane IOPS voor een share. Als deze koptekst is ingesteld, moet x-ms-share-paid-bursting-enabled ook worden ingesteld op true. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Facultatief. Ondersteund in versie 2024-11-04 en hoger. Alleen toegestaan voor Premium-bestandsshares. Een geheel getal dat de maximaal betaalde bursting mebibytes per seconde (MiB/s) vertegenwoordigt die is toegestaan voor de share. De standaardinstelling als deze niet is opgegeven, is de maximaal toegestane MiB/s voor een share. Als deze koptekst is ingesteld, moet x-ms-share-paid-bursting-enabled ook worden ingesteld op true. |
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 foutcodesvoor meer informatie.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Beschrijving |
|---|---|
ETag |
Bevat een waarde die de versie van de share vertegenwoordigt, tussen aanhalingstekens. |
Last-Modified |
Retourneert de datum en tijd waarop de share het laatst is gewijzigd. De datumnotatie volgt RFC 1123. Zie Datum-/tijdwaarden weergeven in koptekstenvoor meer informatie. Elke bewerking waarmee de share of de eigenschappen of metagegevens van de share worden gewijzigd, wordt de laatste wijzigingstijd bijgewerkt. Bewerkingen op bestanden hebben geen invloed op de laatste wijzigingstijd van de share. |
x-ms-request-id |
Identificeer 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 Versie van Azure Files aan die is gebruikt om de aanvraag uit te voeren. |
Date |
Een UTC-datum/tijdwaarde die wordt gegenereerd door de service, wat 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 antwoord
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
Machtiging
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Shares worden direct in het opslagaccount gemaakt. Het is niet mogelijk om één share te nesten binnen een andere.
U kunt metagegevens voor een share opgeven wanneer u deze maakt door een of meer metagegevensheaders op de aanvraag op te geven. De indeling voor de metagegevensheader is x-ms-meta-name:value.
Als een share met dezelfde naam wordt verwijderd wanneer u Create Shareaanroept, 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 van bestanden te beperken die zijn opgeslagen op de share. 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 grootten van de bestanden op de share het quotum overschrijdt dat is ingesteld op de share, 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 facturering. U wordt nog steeds gefactureerd voor de grootte van de bestanden plus de overhead.