Udostępnij za pośrednictwem


File Services - Set Service Properties

Ustawia właściwości usług plików na kontach magazynu, w tym reguły CORS (współużytkowanie zasobów między źródłami).

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery.

FileServicesName
path True

FileServicesName

Nazwa usługi plików w ramach określonego konta magazynu. Nazwa usługi plików musi być "domyślna"

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

Nazwa grupy zasobów w ramach subskrypcji użytkownika. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
properties.cors

CorsRules

Określa reguły CORS dla usługi plików. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy corsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi plików.

properties.protocolSettings

ProtocolSettings

Ustawienia protokołu dla usługi plików

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

Właściwości usługi plików do usuwania nietrwałego udziału.

Odpowiedzi

Nazwa Typ Opis
200 OK

FileServiceProperties

OK — ustawia właściwości usługi plików konta magazynu pomyślnie.

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

PutFileServices
PutFileServices_EnableSecureSmbFeatures
PutFileServices_EnableSMBMultichannel

PutFileServices

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

PutFileServices_EnableSecureSmbFeatures

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "versions": "SMB2.1;SMB3.0;SMB3.1.1",
        "authenticationMethods": "NTLMv2;Kerberos",
        "kerberosTicketEncryption": "RC4-HMAC;AES-256",
        "channelEncryption": "AES-128-CCM;AES-128-GCM;AES-256-GCM"
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

PutFileServices_EnableSMBMultichannel

Przykładowe żądanie

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2024-01-01

{
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  }
}

Przykładowa odpowiedź

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/fileServices",
  "properties": {
    "protocolSettings": {
      "smb": {
        "multichannel": {
          "enabled": true
        }
      }
    }
  },
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}

Definicje

Nazwa Opis
AllowedMethods

Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.

CloudError

Odpowiedź na błąd z usługi Storage.

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

CorsRule

Określa regułę CORS dla usługi Blob Service.

CorsRules

Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.

DeleteRetentionPolicy

Właściwości usługi do usuwania nietrwałego.

FileServiceProperties

Właściwości usług plików na koncie magazynu.

FileServicesName

Nazwa usługi plików w ramach określonego konta magazynu. Nazwa usługi plików musi być "domyślna"

Multichannel

Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.

ProtocolSettings

Ustawienia protokołu dla usługi plików

Sku

Jednostka SKU konta magazynu.

SkuName

Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType.

SkuTier

Poziom SKU. Jest to oparte na nazwie jednostki SKU.

SmbSetting

Ustawienie protokołu SMB

AllowedMethods

Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.

Wartość Opis
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

CloudError

Odpowiedź na błąd z usługi Storage.

Nazwa Typ Opis
error

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

CloudErrorBody

Odpowiedź na błąd z usługi Storage.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

details

CloudErrorBody[]

Lista dodatkowych szczegółów dotyczących błędu.

message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

target

string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

CorsRule

Określa regułę CORS dla usługi Blob Service.

Nazwa Typ Opis
allowedHeaders

string[]

Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków, które mogą być częścią żądania między źródłami.

allowedMethods

AllowedMethods[]

Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło.

allowedOrigins

string[]

Wymagane, jeśli element CorsRule jest obecny. Lista domen pochodzenia, które będą dozwolone za pośrednictwem mechanizmu CORS lub "*", aby zezwolić na wszystkie domeny

exposedHeaders

string[]

Wymagane, jeśli element CorsRule jest obecny. Lista nagłówków odpowiedzi, które mają być widoczne dla klientów CORS.

maxAgeInSeconds

integer

Wymagane, jeśli element CorsRule jest obecny. Liczba sekund, przez które klient/przeglądarka powinna buforować odpowiedź wstępną.

CorsRules

Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.

Nazwa Typ Opis
corsRules

CorsRule[]

Lista reguł CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule.

DeleteRetentionPolicy

Właściwości usługi do usuwania nietrwałego.

Nazwa Typ Opis
allowPermanentDelete

boolean

Ta właściwość po ustawieniu wartości true umożliwia usunięcie nietrwałych wersji obiektów blob i migawek. Tej właściwości nie można używać zasad przywracania obiektów blob. Ta właściwość dotyczy tylko usługi blob i nie ma zastosowania do kontenerów ani udziału plików.

days

integer

minimum: 1
maximum: 365

Wskazuje liczbę dni przechowywania usuniętego elementu. Minimalna określona wartość może wynosić 1, a maksymalna wartość może wynosić 365.

enabled

boolean

Wskazuje, czy opcja DeleteRetentionPolicy jest włączona.

FileServiceProperties

Właściwości usług plików na koncie magazynu.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nazwa zasobu

properties.cors

CorsRules

Określa reguły CORS dla usługi plików. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. Jeśli żadne elementy corsRule nie zostaną uwzględnione w treści żądania, wszystkie reguły CORS zostaną usunięte, a mechanizm CORS zostanie wyłączony dla usługi plików.

properties.protocolSettings

ProtocolSettings

Ustawienia protokołu dla usługi plików

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

Właściwości usługi plików do usuwania nietrwałego udziału.

sku

Sku

Nazwa jednostki SKU i warstwa.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

FileServicesName

Nazwa usługi plików w ramach określonego konta magazynu. Nazwa usługi plików musi być "domyślna"

Wartość Opis
default

Multichannel

Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.

Nazwa Typ Opis
enabled

boolean

Wskazuje, czy włączono obsługę wielu kanałów

ProtocolSettings

Ustawienia protokołu dla usługi plików

Nazwa Typ Opis
smb

SmbSetting

Ustawienie protokołu SMB

Sku

Jednostka SKU konta magazynu.

Nazwa Typ Opis
name

SkuName

Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType.

tier

SkuTier

Poziom SKU. Jest to oparte na nazwie jednostki SKU.

SkuName

Nazwa jednostki SKU. Wymagane do utworzenia konta; opcjonalnie do aktualizacji. Należy pamiętać, że w starszych wersjach nazwa jednostki SKU nosiła nazwę accountType.

Wartość Opis
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

Poziom SKU. Jest to oparte na nazwie jednostki SKU.

Wartość Opis
Standard
Premium

SmbSetting

Ustawienie protokołu SMB

Nazwa Typ Opis
authenticationMethods

string

Metody uwierzytelniania SMB obsługiwane przez serwer. Prawidłowe wartości to NTLMv2, Kerberos. Należy przekazać jako ciąg z ogranicznikiem ";".

channelEncryption

string

Szyfrowanie kanału SMB obsługiwane przez serwer. Prawidłowe wartości to AES-128-CCM, AES-128-GCM, AES-256-GCM. Należy przekazać jako ciąg z ogranicznikiem ";".

kerberosTicketEncryption

string

Szyfrowanie biletów Kerberos obsługiwane przez serwer. Prawidłowe wartości to RC4-HMAC, AES-256. Należy przekazać jako ciąg z ogranicznikiem ";"

multichannel

Multichannel

Ustawienie wielokanałowe. Dotyczy tylko usługi FileStorage w warstwie Premium.

versions

string

Wersje protokołu SMB obsługiwane przez serwer. Prawidłowe wartości to SMB2.1, SMB3.0, SMB3.1.1. Należy przekazać jako ciąg z ogranicznikiem ";".