File Services - Set Service Properties
Define as propriedades dos serviços de arquivo em contas de armazenamento, incluindo regras CORS (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default?api-version=2023-05-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes das contas de armazenamento devem ter entre 3 e 24 caracteres e usar apenas números e letras minúsculas. Padrão Regex: |
File
|
path | True |
O nome do serviço de arquivo dentro da conta de armazenamento especificada. Nome do Serviço de Arquivo deve ser "padrão" |
|
resource
|
path | True |
string |
O nome do grupo de recursos dentro da assinatura do usuário. O nome não diferencia maiúsculas de minúsculas. Padrão Regex: |
subscription
|
path | True |
string |
A ID da assinatura de destino. |
api-version
|
query | True |
string |
A versão da API a ser usada para esta operação. |
Corpo do Pedido
Name | Tipo | Description |
---|---|---|
properties.cors |
Especifica regras CORS para o serviço de arquivo. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do CORS serão excluídas e o CORS será desabilitado para o serviço de arquivo. |
|
properties.protocolSettings |
Configurações de protocolo para serviço de arquivo |
|
properties.shareDeleteRetentionPolicy |
As propriedades do serviço de arquivo para exclusão suave de compartilhamento. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK -- Define as propriedades do serviço de arquivo de uma conta de armazenamento com êxito. |
|
Other Status Codes |
Resposta de erro descrevendo por que a operação falhou. |
Segurança
azure_auth
Azure Ative Directory OAuth2 Flow
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
Name | Description |
---|---|
user_impersonation | personificar a sua conta de utilizador |
Exemplos
Put |
Put |
Put |
PutFileServices
Pedido de amostra
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-05-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*"
]
}
]
}
}
}
Resposta da amostra
{
"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
Pedido de amostra
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-05-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"
}
}
}
}
Resposta da amostra
{
"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
Pedido de amostra
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default?api-version=2023-05-01
{
"properties": {
"protocolSettings": {
"smb": {
"multichannel": {
"enabled": true
}
}
}
}
}
Resposta da amostra
{
"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"
}
}
Definições
Name | Description |
---|---|
Allowed |
Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. |
Cloud |
Uma resposta de erro do serviço de armazenamento. |
Cloud |
Uma resposta de erro do serviço de armazenamento. |
Cors |
Especifica uma regra CORS para o serviço Blob. |
Cors |
Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação. |
Delete |
As propriedades de serviço para exclusão suave. |
File |
As propriedades dos serviços de arquivo na conta de armazenamento. |
File |
O nome do serviço de arquivo dentro da conta de armazenamento especificada. Nome do Serviço de Arquivo deve ser "padrão" |
Multichannel |
Configuração multicanal. Aplica-se apenas ao Premium FileStorage. |
Protocol |
Configurações de protocolo para serviço de arquivo |
Sku |
O SKU da conta de armazenamento. |
Sku |
O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType. |
Sku |
A camada de SKU. Isso é baseado no nome SKU. |
Smb |
Configuração para o protocolo SMB |
AllowedMethods
Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.
Name | Tipo | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
CloudError
Uma resposta de erro do serviço de armazenamento.
Name | Tipo | Description |
---|---|---|
error |
Uma resposta de erro do serviço de armazenamento. |
CloudErrorBody
Uma resposta de erro do serviço de armazenamento.
Name | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente. |
details |
Uma lista de detalhes adicionais sobre o erro. |
|
message |
string |
Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário. |
target |
string |
O alvo do erro específico. Por exemplo, o nome da propriedade em erro. |
CorsRule
Especifica uma regra CORS para o serviço Blob.
Name | Tipo | Description |
---|---|---|
allowedHeaders |
string[] |
Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos que podem fazer parte da solicitação de origem cruzada. |
allowedMethods |
Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. |
|
allowedOrigins |
string[] |
Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS, ou "*" para permitir todos os domínios |
exposedHeaders |
string[] |
Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS. |
maxAgeInSeconds |
integer |
Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de comprovação. |
CorsRules
Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.
Name | Tipo | Description |
---|---|---|
corsRules |
Cors |
A lista de regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação. |
DeleteRetentionPolicy
As propriedades de serviço para exclusão suave.
Name | Tipo | Description |
---|---|---|
allowPermanentDelete |
boolean |
Esta propriedade, quando definida como true, permite a exclusão das versões e instantâneos de blob excluídos suavemente. Esta propriedade não pode ser usada política de restauração de blob. Essa propriedade só se aplica ao serviço de blob e não se aplica a contêineres ou compartilhamento de arquivos. |
days |
integer |
Indica o número de dias em que o item excluído deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365. |
enabled |
boolean |
Indica se DeleteRetentionPolicy está habilitado. |
FileServiceProperties
As propriedades dos serviços de arquivo na conta de armazenamento.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties.cors |
Especifica regras CORS para o serviço de arquivo. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do CORS serão excluídas e o CORS será desabilitado para o serviço de arquivo. |
|
properties.protocolSettings |
Configurações de protocolo para serviço de arquivo |
|
properties.shareDeleteRetentionPolicy |
As propriedades do serviço de arquivo para exclusão suave de compartilhamento. |
|
sku |
Nome e camada da Sku. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
FileServicesName
O nome do serviço de arquivo dentro da conta de armazenamento especificada. Nome do Serviço de Arquivo deve ser "padrão"
Name | Tipo | Description |
---|---|---|
default |
string |
Multichannel
Configuração multicanal. Aplica-se apenas ao Premium FileStorage.
Name | Tipo | Description |
---|---|---|
enabled |
boolean |
Indica se o multicanal está habilitado |
ProtocolSettings
Configurações de protocolo para serviço de arquivo
Name | Tipo | Description |
---|---|---|
smb |
Configuração para o protocolo SMB |
Sku
O SKU da conta de armazenamento.
Name | Tipo | Description |
---|---|---|
name |
O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType. |
|
tier |
A camada de SKU. Isso é baseado no nome SKU. |
SkuName
O nome SKU. Necessário para a criação de conta; opcional para atualização. Observe que, em versões mais antigas, o nome da SKU era chamado accountType.
Name | Tipo | Description |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
A camada de SKU. Isso é baseado no nome SKU.
Name | Tipo | Description |
---|---|---|
Premium |
string |
|
Standard |
string |
SmbSetting
Configuração para o protocolo SMB
Name | Tipo | Description |
---|---|---|
authenticationMethods |
string |
Métodos de autenticação SMB suportados pelo servidor. Os valores válidos são NTLMv2, Kerberos. Deve ser passado como uma cadeia de caracteres com delimitador ';'. |
channelEncryption |
string |
Criptografia de canal SMB suportada pelo servidor. Os valores válidos são AES-128-CCM, AES-128-GCM, AES-256-GCM. Deve ser passado como uma cadeia de caracteres com delimitador ';'. |
kerberosTicketEncryption |
string |
Criptografia de tíquete Kerberos suportada pelo servidor. Os valores válidos são RC4-HMAC, AES-256. Deve ser passado como uma cadeia de caracteres com delimitador ';' |
multichannel |
Configuração multicanal. Aplica-se apenas ao Premium FileStorage. |
|
versions |
string |
Versões do protocolo SMB suportadas pelo servidor. Os valores válidos são SMB2.1, SMB3.0, SMB3.1.1. Deve ser passado como uma cadeia de caracteres com delimitador ';'. |