File Shares - Update

Aktualizace sdílet vlastnosti uvedené v textu požadavku. Vlastnosti, které nejsou uvedené v požadavku, se nezmění. Aktualizace selže, pokud zadaná sdílená složka ještě neexistuje.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
path True

string

Název účtu úložiště v rámci zadané skupiny prostředků. Názvy účtů úložiště musí mít délku 3 až 24 znaků a musí používat jenom číslice a malá písmena.

Regex pattern: ^[a-z0-9]+$

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného uživatele. V názvu se rozlišují malá a velká písmena.

Regex pattern: ^[-\w\._\(\)]+$

shareName
path True

string

Název sdílené složky v rámci zadaného účtu úložiště. Názvy sdílených složek musí mít délku 3 až 63 znaků a musí obsahovat pouze číslice, malá písmena a pomlčky (-). Každá pomlčka (-) musí bezprostředně předcházet písmenu nebo číslici.

subscriptionId
path True

string

ID cílového předplatného.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
properties.accessTier

ShareAccessTier

Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium.

properties.enabledProtocols

EnabledProtocols

Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky.

properties.metadata

object

Pár název-hodnota, který se přidruží ke sdílené složce jako metadata.

properties.rootSquash

RootSquashType

Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash.

properties.shareQuota

integer

Maximální velikost sdílené složky v gigabajtech Musí být větší než 0 a menší nebo roven 5 TB (5120). Maximální velikost velkých sdílených složek je 102400.

properties.signedIdentifiers

SignedIdentifier[]

Seznam uložených zásad přístupu zadaných ve sdílené složce

Odpovědi

Name Typ Description
200 OK

FileShare

OK – Operace aktualizace sdílené složky byla úspěšně dokončena.

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

UpdateShareAcls
UpdateShares

UpdateShareAcls

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "signedIdentifiers": [
      {
        "id": "MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI",
        "accessPolicy": {
          "startTime": "2021-04-01T08:49:37.0000000Z",
          "expiryTime": "2021-05-01T08:49:37.0000000Z",
          "permission": "rwd"
        }
      }
    ]
  }
}

UpdateShares

Sample Request

PATCH https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-01-01

{
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "metadata": {
      "type": "image"
    }
  }
}

Definice

Name Description
AccessPolicy
CloudError

Chybová odpověď ze služby Storage.

CloudErrorBody

Chybová odpověď ze služby Storage.

EnabledProtocols

Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky.

FileShare

Vlastnosti sdílené složky, včetně ID, názvu prostředku, typu prostředku, značky Etag.

LeaseDuration

Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená.

LeaseState

Stav zapůjčení sdílené složky

LeaseStatus

Stav zapůjčení sdílené složky

RootSquashType

Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash.

ShareAccessTier

Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium.

SignedIdentifier

AccessPolicy

Name Typ Description
expiryTime

string

Čas vypršení platnosti zásad přístupu

permission

string

Seznam zkrácených oprávnění

startTime

string

Počáteční čas zásad přístupu

CloudError

Chybová odpověď ze služby Storage.

Name Typ Description
error

CloudErrorBody

Chybová odpověď ze služby Storage.

CloudErrorBody

Chybová odpověď ze služby Storage.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou neutrální a mají být využívány programově.

details

CloudErrorBody[]

Seznam dalších podrobností o chybě

message

string

Zpráva popisující chybu, která má být vhodná k zobrazení v uživatelském rozhraní.

target

string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

EnabledProtocols

Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky.

Name Typ Description
NFS

string

SMB

string

FileShare

Vlastnosti sdílené složky, včetně ID, názvu prostředku, typu prostředku, značky Etag.

Name Typ Description
etag

string

Značka ETag prostředku.

id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

name

string

Název prostředku

properties.accessTier

ShareAccessTier

Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium.

properties.accessTierChangeTime

string

Označuje čas poslední změny úrovně přístupu sdílené složky.

properties.accessTierStatus

string

Označuje, jestli čeká na přechod na úroveň přístupu.

properties.deleted

boolean

Určuje, jestli byla sdílená složka odstraněna.

properties.deletedTime

string

Čas odstranění sdílené složky.

properties.enabledProtocols

EnabledProtocols

Ověřovací protokol, který se používá pro sdílenou složku. Lze zadat pouze při vytváření sdílené složky.

properties.lastModifiedTime

string

Vrátí datum a čas poslední změny sdílené složky.

properties.leaseDuration

LeaseDuration

Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená.

properties.leaseState

LeaseState

Stav zapůjčení sdílené složky

properties.leaseStatus

LeaseStatus

Stav zapůjčení sdílené složky

properties.metadata

object

Pár název-hodnota, který se přidruží ke sdílené složce jako metadata.

properties.remainingRetentionDays

integer

Zbývající dny uchovávání pro sdílenou složku, která byla odstraněna obnovitelně.

properties.rootSquash

RootSquashType

Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash.

properties.shareQuota

integer

Maximální velikost sdílené složky v gigabajtech Musí být větší než 0 a menší nebo roven 5 TB (5120). Maximální velikost velkých sdílených složek je 102400.

properties.shareUsageBytes

integer

Přibližná velikost dat uložených ve sdílené složce Všimněte si, že tato hodnota nemusí zahrnovat všechny nedávno vytvořené soubory nebo soubory s nedávno změněnou velikostí.

properties.signedIdentifiers

SignedIdentifier[]

Seznam uložených zásad přístupu zadaných ve sdílené složce

properties.snapshotTime

string

Čas vytvoření snímku sdílené složky vrácený v odpovědi sdílených složek seznamu s rozbalením parametru "snímky".

properties.version

string

Verze sdílené složky.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

LeaseDuration

Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání, jenom když je sdílená složka zapůjčená.

Name Typ Description
Fixed

string

Infinite

string

LeaseState

Stav zapůjčení sdílené složky

Name Typ Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

Stav zapůjčení sdílené složky

Name Typ Description
Locked

string

Unlocked

string

RootSquashType

Vlastnost je určená jenom pro sdílenou složku NFS. Výchozí hodnota je NoRootSquash.

Name Typ Description
AllSquash

string

NoRootSquash

string

RootSquash

string

ShareAccessTier

Úroveň přístupu pro konkrétní sdílenou složku. Účet GpV2 si může vybrat mezi TransactionOptimized (výchozí), Horkou a Studenou. Účet FileStorage může zvolit Premium.

Name Typ Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

Name Typ Description
accessPolicy

AccessPolicy

Zásady přístupu

id

string

Jedinečný identifikátor uložených zásad přístupu.