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 FileShare resurser med hjälp av Azure Storage-resursprovidern finns i Operations on FileShares.
Om det redan finns en resurs med samma namn misslyckas åtgärden. Resursen innehåller metadata och egenskaper för den resursen. Den innehåller inte en lista över de filer som finns i resursen.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB (Server Message Block) |
|
| NFS (Network File System) |
|
Begäran
Du kan skapa Create Share begäran enligt nedan. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | 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 | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. Namnet får bara innehålla gemener. |
Mer information om sökvägsnamnsbegränsningar 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 |
Valfri. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
Begärandehuvuden
De obligatoriska och valfria begäranderubrikerna 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 |
Valfri. 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 |
Valfri. Stöds i version 2015-02-21 och senare. Anger den maximala storleken på resursen i gibibyte (GiB). |
x-ms-access-tier |
Valfri. Stöds i version 2019-12-12 och senare. Anger resursens åtkomstnivå. Giltiga värden är TransactionOptimized, Hotoch Cool. Detaljerad information om filresursnivåer finns i Azure Files-lagringsnivåer. |
x-ms-enabled-protocols: <SMB \| NFS> |
Valfri. 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 premiumkonto krävs för det här alternativet. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Valfri. Endast NFS. Stöds i version 2019-07-07 och senare. Anger rotens squashbeteende på resursen när NFS är aktiverat. Om den inte anges är standardvärdet NoRootSquash. - NoRootSquash: Stäng av rot squash.- RootSquash: Mappa begäranden från uid/gid 0 till den anonyma uid/gid.- AllSquash: Mappa alla uids och gids till den anonyma användaren. |
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Valfri. Stöds i version 2024-08-04 och senare. Anger om den virtuella katalogen för ögonblicksbilder ska vara tillgänglig vid roten för resursmonteringspunkten när NFS är aktiverat. Om det inte anges är standardvärdet sant. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. 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-. |
x-ms-share-paid-bursting-enabled: <true \| false> |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser (filresurser i lagringskontotypen FileStorage). Den här egenskapen möjliggör betald bursting. Om egenskapen inte har angetts är standardvärdet falskt. |
x-ms-share-paid-bursting-max-iops |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser. Ett heltal som representerar maximalt antal betalda in- och utdataåtgärder per sekund (IOPS) som tillåts för resursen. Standardvärdet om det inte anges är det högsta tillåtna IOPS för en resurs. Om det här huvudet anges måste x-ms-share-paid-bursting-enabled också anges till true. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Valfri. Stöds i version 2024-11-04 och senare. Tillåts endast för Premium-filresurser. Ett heltal som representerar det högsta antal betalda mebibyte per sekund (MiB/s) som tillåts för resursen. Standardvärdet om det inte anges är det högsta tillåtna MiB/s för en resurs. Om det här huvudet anges måste x-ms-share-paid-bursting-enabled också anges till true. |
Begärandetext
Ingen.
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=
Svar
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 STANDARD HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Beskrivning |
|---|---|
ETag |
Innehåller ett värde som representerar resursens version, omgiven av citattecken. |
Last-Modified |
Returnerar datum och tid då resursen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum/tid-värden i rubriker. Alla åtgärder som ändrar resursen eller dess egenskaper eller metadata uppdaterar den senaste ändrade tiden. Å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 UTC-datum/tid-värde 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 för x-ms-client-request-id-huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om x-ms-client-request-id-huvudet inte finns i begäran finns det inte i svaret. |
Svarstext
Ingen.
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
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Anmärkningar
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 Sharereturnerar servern statuskoden 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. De omkostnader som är associerade med 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 har angetts för resursen misslyckas försöken att öka storleken på en fil och nya filer som inte är tomma (via REST) misslyckas. 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.