Criar Partilha
A operação Create Share cria um novo compartilhamento de Arquivos do Azure na conta especificada. Embora essa API seja totalmente suportada, ela é uma API de gerenciamento herdada. Recomendamos que, em vez disso, você use Compartilhamentos de Arquivos - Criar, que é fornecido pelo provedor de recursos de Armazenamento do Azure (Microsoft.Storage). Para saber mais sobre como interagir programaticamente com recursos FileShare usando o provedor de recursos de Armazenamento do Azure, consulte Operations on FileShares.
Se já existir uma partilha com o mesmo nome, a operação falhará. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.
Disponibilidade do protocolo
| Protocolo de compartilhamento de arquivos habilitado | Disponível |
|---|---|
| Bloco de mensagens do servidor (SMB) |
|
| Sistema de arquivos de rede (NFS) |
|
Solicitar
Você pode construir a solicitação de Create Share como mostrado aqui. Recomendamos que você use HTTPS.
| Método | Solicitar URI | Versão HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Substitua os componentes de caminho mostrados no URI de solicitação pelo seu, da seguinte maneira:
| Componente Caminho | Descrição |
|---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome do seu compartilhamento de arquivos. O nome pode conter apenas caracteres minúsculos. |
Para obter mais informações sobre restrições de nomenclatura de caminho, consulte Compartilhamentos de nome e referência, diretórios, arquivos e metadados.
Parâmetros de URI
Você pode especificar os seguintes parâmetros adicionais no URI de solicitação:
| Parâmetro | Descrição |
|---|---|
timeout |
Opcional. O parâmetro de tempo limite é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações de serviço de arquivo. |
Cabeçalhos de solicitação
Os cabeçalhos de solicitação obrigatórios e opcionais são descritos na tabela a seguir:
| Cabeçalho da solicitação | Descrição |
|---|---|
Authorization |
Necessário. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. |
Date ou x-ms-date |
Necessário. Especifica a hora UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. |
x-ms-version |
Obrigatório para todos os pedidos autorizados. Especifica a versão da operação a ser usada para essa solicitação. Para obter mais informações, consulte Versionamento para serviços de Armazenamento do Azure. |
x-ms-meta-name:value |
Opcional. Um par nome-valor para associar ao compartilhamento como metadados. Os nomes de metadados devem aderir às regras de nomenclatura para identificadores C#. |
x-ms-share-quota |
Opcional. Suportado na versão 2015-02-21 e posterior. Especifica o tamanho máximo do compartilhamento, em gibibytes (GiB). |
x-ms-access-tier |
Opcional. Suportado na versão 2019-12-12 e posterior. Especifica a camada de acesso do compartilhamento. Os valores válidos são TransactionOptimized, Hote Cool. Para obter informações detalhadas sobre camadas de compartilhamento de arquivos, consulte camadas de armazenamento do Azure Files. |
x-ms-enabled-protocols: <SMB \| NFS> |
Opcional. Suportado na versão 2019-07-07 e posterior. Especifica os protocolos habilitados no compartilhamento. Se eles não forem especificados, o padrão será SMB. - SMB: O compartilhamento pode ser acessado por SMBv3.0, SMBv2.1 e REST.- NFS: O compartilhamento pode ser acessado pelo NFSv4.1. É necessária uma conta premium para esta opção. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Opcional. Apenas NFS. Suportado na versão 2019-07-07 e posterior. Especifica o comportamento de esmagamento de raiz no compartilhamento quando o NFS está habilitado. Se não for especificado, o padrão é NoRootSquash. - NoRootSquash: Desligue o esmagamento de raízes.- RootSquash: Mapeie solicitações de uid/gid 0 para o anônimo uid/gid.- AllSquash: Mapeie todos os uids e gids para o usuário anônimo. |
x-ms-enable-snapshot-virtual-directory-access: <true \| false> |
Opcional. Suportado na versão 2024-08-04 e posterior. Especifica se o diretório virtual de instantâneo deve estar acessível na raiz do ponto de montagem do compartilhamento quando o NFS está habilitado. Se não for especificado, o padrão será true. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 kibibyte (KiB) que é registrado nos logs quando o log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações que o servidor recebe. Para obter mais informações, consulte Monitorar arquivos do Azure. |
x-ms-share-paid-bursting-enabled: <true \| false> |
Opcional. Suportado na versão 2024-11-04 e posterior. Permitido apenas para compartilhamentos de arquivos premium (compartilhamentos de arquivos dentro do tipo de conta de armazenamento FileStorage). Esta propriedade permite bursting pago. Se a propriedade não for especificada, o valor padrão será false. |
x-ms-share-paid-bursting-max-iops |
Opcional. Suportado na versão 2024-11-04 e posterior. Apenas permitido para compartilhamentos de arquivos premium. Um inteiro que representa o máximo pago de operações de entrada/saída por segundo (IOPS) permitidas para a ação. O padrão, se não especificado, é o máximo de IOPS permitido para um compartilhamento. Se esse cabeçalho estiver definido, x-ms-share-paid-bursting-enabled também deverá ser definido como true. |
x-ms-share-paid-bursting-max-bandwidth-mibps |
Opcional. Suportado na versão 2024-11-04 e posterior. Apenas permitido para compartilhamentos de arquivos premium. Um inteiro que representa o máximo de mebibytes de bursting pagos por segundo (MiB/s) permitidos para o compartilhamento. O padrão, se não especificado, é o MiB/s máximo permitido para uma ação. Se esse cabeçalho estiver definido, x-ms-share-paid-bursting-enabled também deverá ser definido como true. |
Corpo do pedido
Nenhuma.
Pedido de amostra
PUT https://myaccount.file.core.windows.net/myshare?restype=share HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: <date>
x-ms-meta-Name: StorageSample
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Resposta
A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.
Código de status
Uma operação bem-sucedida retorna o código de status 201 (Criado).
Para obter mais informações, consulte Status e códigos de erro.
Cabeçalhos de resposta
A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.
| Cabeçalho da resposta | Descrição |
|---|---|
ETag |
Contém um valor que representa a versão do compartilhamento, entre aspas. |
Last-Modified |
Devolve a data e hora em que a partilha foi modificada pela última vez. O formato de data segue o RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Qualquer operação que modifique o compartilhamento ou suas propriedades ou metadados atualiza a hora da última modificação. As operações em arquivos não afetam a hora da última modificação do compartilhamento. |
x-ms-request-id |
Identifica exclusivamente a solicitação e você pode usá-la para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API |
x-ms-version |
Indica a versão dos Arquivos do Azure que foi usada para executar a solicitação. |
Date |
Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada. |
x-ms-client-request-id |
Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do cabeçalho x-ms-client-request-id se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o cabeçalho x-ms-client-request-id não estiver presente na solicitação, ele não estará presente na resposta. |
Corpo de resposta
Nenhuma.
Resposta da amostra
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CB14C3E29B7E82"
Last-Modified: <date>
x-ms-version: 2020-02-10
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorização
Apenas o proprietário da conta pode chamar esta operação.
Comentários
Os compartilhamentos são criados imediatamente dentro da conta de armazenamento. Não é possível aninhar uma ação dentro da outra.
Você pode especificar metadados para um compartilhamento ao criá-lo incluindo um ou mais cabeçalhos de metadados na solicitação. O formato do cabeçalho de metadados é x-ms-meta-name:value.
Se um compartilhamento com o mesmo nome estiver sendo excluído quando você chamar Create Share, o servidor retornará o código de status 409 (Conflito) e informações de erro adicionais indicarão que o compartilhamento está sendo excluído.
Você pode usar a cota de tamanho de compartilhamento para limitar o tamanho dos arquivos armazenados no compartilhamento. A cota não limita o tamanho dos instantâneos. A sobrecarga associada aos arquivos e usada para calcular o tamanho do faturamento da conta de armazenamento não é contabilizada na cota.
Quando a soma dos tamanhos dos arquivos no compartilhamento exceder a cota definida no compartilhamento, as tentativas de aumentar o tamanho de um arquivo falharão e a criação de novos arquivos não vazios (via REST) falhará. Você ainda poderá criar arquivos vazios.
Alterar ou definir a quota não tem qualquer efeito na faturação. Você ainda é cobrado pelo tamanho dos arquivos mais a sobrecarga.