Compartilhar via


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
accountName
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: ^[a-z0-9]+$

FileServicesName
path True

FileServicesName

O nome do serviço de arquivo dentro da conta de armazenamento especificada. Nome do Serviço de Arquivo deve ser "padrão"

resourceGroupName
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: ^[-\w\._\(\)]+$

subscriptionId
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

CorsRules

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

ProtocolSettings

Configurações de protocolo para serviço de arquivo

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de arquivo para exclusão suave de compartilhamento.

Respostas

Name Tipo Description
200 OK

FileServiceProperties

OK -- Define as propriedades do serviço de arquivo de uma conta de armazenamento com êxito.

Other Status Codes

CloudError

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

PutFileServices
PutFileServices_EnableSecureSmbFeatures
PutFileServices_EnableSMBMultichannel

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
AllowedMethods

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.

CloudError

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

CorsRule

Especifica uma regra CORS para o serviço Blob.

CorsRules

Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

DeleteRetentionPolicy

As propriedades de serviço para exclusão suave.

FileServiceProperties

As propriedades dos serviços de arquivo na conta de armazenamento.

FileServicesName

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.

ProtocolSettings

Configurações de protocolo para serviço de arquivo

Sku

O SKU da conta de armazenamento.

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.

SkuTier

A camada de SKU. Isso é baseado no nome SKU.

SmbSetting

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

CloudErrorBody

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

CloudErrorBody[]

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

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

CorsRule[]

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

CorsRules

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

ProtocolSettings

Configurações de protocolo para serviço de arquivo

properties.shareDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de arquivo para exclusão suave de compartilhamento.

sku

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

SmbSetting

Configuração para o protocolo SMB

Sku

O SKU da conta de armazenamento.

Name Tipo Description
name

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.

tier

SkuTier

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

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 ';'.