Skapa resurs
Åtgärden Create Share
skapar en ny Azure Files resurs under det angivna kontot. Även om det här API:et stöds fullt ut är detta ett äldre hanterings-API. Vi rekommenderar att du i stället använder Filresurser – Skapa, som tillhandahålls av Azure Storage-resursprovidern (Microsoft.Storage). Mer information om hur du interagerar programmatiskt med resurser med FileShare
hjälp av Azure Storage-resursprovidern finns i Åtgärder på Filresurser.
Om det redan finns en resurs med samma namn misslyckas åtgärden. Resursen innehåller metadata och egenskaper för resursen. Den innehåller inte en lista över de filer som finns i resursen.
Protokolltillgänglighet
Aktiverat filresursprotokoll | Tillgängligt |
---|---|
Server Message Block (SMB) | |
Network File System (NFS) |
Förfrågan
Du kan skapa begäran enligt Create Share
nedan. Vi rekommenderar att du använder HTTPS.
Metod | URI för förfrågan | HTTP-version |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:
Sökvägskomponent | Description |
---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. Namnet får bara innehålla gemener. |
Mer information om begränsningar för namngivning av sökvägar finns i Namn- och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar på begärande-URI:n:
Parameter | Beskrivning |
---|---|
timeout |
Valfritt. Timeout-parametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
Begärandehuvuden
De obligatoriska och valfria begärandehuvudena beskrivs i följande tabell:
Begärandehuvud | Beskrivning |
---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Krävs. Anger UTC-tid (Coordinated Universal Time) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänster. |
x-ms-meta-name:value |
Valfritt. Ett namn/värde-par som ska associeras med resursen som metadata. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. |
x-ms-share-quota |
Valfritt. Stöds i version 2015-02-21 och senare. Anger den maximala storleken för resursen i gibibyte (GiB). |
x-ms-access-tier |
Valfritt. Stöds i version 2019-12-12 och senare. Anger resursens åtkomstnivå. Giltiga värden är TransactionOptimized , Hot och Cool . Detaljerad information om filresursnivåer finns i Azure Files lagringsnivåer. |
x-ms-enabled-protocols: <SMB \| NFS> |
Valfritt. Stöds i version 2019-07-07 och senare. Anger de aktiverade protokollen på resursen. Om de inte anges är standardvärdet SMB. - SMB : Resursen kan nås av SMBv3.0, SMBv2.1 och REST.- NFS : Resursen kan nås av NFSv4.1. Ett Premium-konto krävs för det här alternativet. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Valfritt. Endast NFS. Stöds i version 2019-07-07 och senare. Anger rot squashbeteendet på resursen när NFS är aktiverat. Om det inte anges är standardvärdet NoRootSquash. - NoRootSquash : Stäng av rot squash.- RootSquash : Mappa begäranden från uid/gid 0 till anonym uid/gid.- AllSquash : Mappa alla uids och gids till den anonyma användaren. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files. |
Begärandetext
Inga.
Exempelbegäran
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=
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad).
Mer information finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
Svarsrubrik | Description |
---|---|
ETag |
Innehåller ett värde som representerar resursens version inom citattecken. |
Last-Modified |
Returnerar datum och tid då resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum-/tidsvärden i rubriker. Alla åtgärder som ändrar resursen eller dess egenskaper eller metadata uppdaterar den senaste ändringstiden. Åtgärder på filer påverkar inte resursens senaste ändringstid. |
x-ms-request-id |
Identifierar begäran unikt och du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder |
x-ms-version |
Anger den Azure Files version som användes för att köra begäran. |
Date |
Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Inga.
Exempelsvar
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
Auktorisering
Endast kontoinnehavaren kan anropa den här åtgärden.
Kommentarer
Resurser skapas omedelbart i lagringskontot. Det går inte att kapsla en resurs i en annan.
Du kan ange metadata för en resurs när du skapar den genom att inkludera en eller flera metadatahuvuden i begäran. Formatet för metadatahuvudet är x-ms-meta-name:value
.
Om en resurs med samma namn tas bort när du anropar Create Share
returnerar servern statuskod 409 (konflikt) och ytterligare felinformation anger att resursen tas bort.
Du kan använda resursstorlekskvoten för att begränsa storleken på filer som lagras på resursen. Kvoten begränsar inte storleken på ögonblicksbilder. Kostnaden som är kopplad till filer och används för att beräkna faktureringsstorleken för lagringskontot redovisas inte i kvoten.
När summan av storleken på filerna på resursen överskrider den kvot som angetts för resursen misslyckas försök att öka storleken på en fil och det går inte att skapa nya filer som inte är tomma (via REST). Du kommer fortfarande att kunna skapa tomma filer.
Att ändra eller ange kvoten påverkar inte faktureringen. Du debiteras fortfarande för storleken på filerna plus omkostnaderna.