Criar compartilhamento
A Create Share
operação cria um novo compartilhamento de Arquivos do Azure na conta especificada. Embora essa API tenha suporte total, essa é uma API de gerenciamento herdada. Recomendamos que você use Compartilhamentos de Arquivos – Criar, que é fornecido pelo provedor de recursos do Armazenamento do Azure (Microsoft.Storage). Para saber mais sobre como interagir programaticamente com FileShare
recursos usando o provedor de recursos do Armazenamento do Azure, consulte Operações em FileShares.
Se já existir um compartilhamento com o mesmo nome, a operação falhará. O recurso do compartilhamento inclui os metadados e as propriedades desse compartilhamento. Ele não inclui uma lista dos arquivos contidos no compartilhamento.
Disponibilidade do protocolo
Protocolo de compartilhamento de arquivos habilitado | Disponível |
---|---|
Protocolo SMB | |
NFS (sistema de arquivos de rede) |
Solicitação
Você pode construir a solicitação Create Share
conforme mostrado aqui. Recomendamos que você use HTTPS.
Método | URI da solicitação | 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 próprio, da seguinte maneira:
Componente path | Descrição |
---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome do seu compartilhamento de arquivo. 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 do URI
Você pode especificar os seguintes parâmetros adicionais no URI da solicitação:
Parâmetro | Descrição |
---|---|
timeout |
Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações de serviço de arquivo. |
Cabeçalhos da 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 |
Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure. |
Date ou x-ms-date |
Obrigatórios. Especifica a hora do Tempo Universal Coordenado (UTC) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure. |
x-ms-version |
Necessário para todas as solicitações autorizadas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para serviços de Armazenamento do Azure. |
x-ms-meta-name:value |
Opcional. Um par de nome-valor a ser associado ao compartilhamento como metadados. Os nomes de metadados devem seguir as regras de nomenclatura para identificadores C#. |
x-ms-share-quota |
Opcional. Com suporte na versão 2015-02-21 e posterior. Especifica o tamanho máximo do compartilhamento, em gibibytes (GiB). |
x-ms-access-tier |
Opcional. Com suporte na versão 2019-12-12 e posterior. Especifica a camada de acesso do compartilhamento. Os valores válidos são TransactionOptimized , Hot e Cool . Para obter informações detalhadas sobre camadas de compartilhamento de arquivos, consulte Arquivos do Azure camadas de armazenamento. |
x-ms-enabled-protocols: <SMB \| NFS> |
Opcional. Com suporte 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. Uma conta premium é necessária para essa opção. |
x-ms-root-squash: <NoRootSquash \| RootSquash \| AllSquash> |
Opcional. Somente NFS. Com suporte na versão 2019-07-07 e posterior. Especifica o comportamento de squashing raiz no compartilhamento quando o NFS está habilitado. Se não for especificado, o padrão será NoRootSquash. - NoRootSquash : desative o squashing raiz.- RootSquash : mapeie solicitações de uid/gid 0 para o uid/gid anônimo.- AllSquash : mapeie todas as uids e gids para o usuário anônimo. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres KiB (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorar Arquivos do Azure. |
Corpo da solicitação
Nenhum.
Solicitação de exemplo
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 cabeçalhos a seguir. 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 de resposta | Descrição |
---|---|
ETag |
Contém um valor que representa a versão do compartilhamento, entre aspas. |
Last-Modified |
Retorna a data e a hora em que o compartilhamento foi modificado pela última vez. O formato da data segue RFC 1123. Para obter mais informações, consulte Representar valores de data/hora em cabeçalhos. Qualquer operação que modifique o compartilhamento, 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 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 será igual ao valor do x-ms-client-request-id cabeçalho se ele estiver presente na solicitação e o valor não contiver mais de 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, ele não estará presente na resposta. |
Corpo da resposta
Nenhum.
Resposta de exemplo
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
Somente o proprietário da conta pode chamar essa operação.
Comentários
Os compartilhamentos são criados imediatamente dentro da conta de armazenamento. Não é possível aninhar uma parte dentro de 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á status código 409 (Conflito) e informações de erro adicionais indicarão que o compartilhamento está sendo excluído.
Você pode usar a cota de tamanho do 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 da cobrança da conta de armazenamento não é contabilizado 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 cota não tem nenhum efeito sobre a cobrança. Você ainda será cobrado pelo tamanho dos arquivos mais a sobrecarga.