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 |
---|---|---|---|---|
account
|
path | True |
string minLength: 3maxLength: 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. |
File
|
path | True |
Nazwa usługi plików w ramach określonego konta magazynu. Nazwa usługi plików musi być "domyślna" |
|
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nazwa grupy zasobów w ramach subskrypcji użytkownika. Nazwa jest niewrażliwa na wielkość liter. |
subscription
|
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 |
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 |
Ustawienia protokołu dla usługi plików |
|
properties.shareDeleteRetentionPolicy |
Właściwości usługi plików do usuwania nietrwałego udziału. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK — ustawia właściwości usługi plików konta magazynu pomyślnie. |
|
Other Status Codes |
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
Put |
Put |
Put |
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 |
---|---|
Allowed |
Wymagane, jeśli element CorsRule jest obecny. Lista metod HTTP, które mogą być wykonywane przez źródło. |
Cloud |
Odpowiedź na błąd z usługi Storage. |
Cloud |
Odpowiedź na błąd z usługi Storage. |
Cors |
Określa regułę CORS dla usługi Blob Service. |
Cors |
Ustawia reguły CORS. W żądaniu można uwzględnić maksymalnie pięć elementów CorsRule. |
Delete |
Właściwości usługi do usuwania nietrwałego. |
File |
Właściwości usług plików na koncie magazynu. |
File |
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. |
Protocol |
Ustawienia protokołu dla usługi plików |
Sku |
Jednostka SKU konta magazynu. |
Sku |
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. |
Sku |
Poziom SKU. Jest to oparte na nazwie jednostki SKU. |
Smb |
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 |
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 |
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 |
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 |
Cors |
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: 1maximum: 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 |
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 |
Ustawienia protokołu dla usługi plików |
|
properties.shareDeleteRetentionPolicy |
Właściwości usługi plików do usuwania nietrwałego udziału. |
|
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 |
Ustawienie protokołu SMB |
Sku
Jednostka SKU konta magazynu.
Nazwa | Typ | Opis |
---|---|---|
name |
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 |
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 |
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 ";". |