Criar Partilha
A Create Share operação cria uma nova partilha de Ficheiros do Azure na conta especificada. Embora esta API seja totalmente suportada, trata-se de uma API de gestão legada. Recomendamos que, em vez disso, utilize Partilhas de Ficheiros – Criar, que é fornecida pelo fornecedor de recursos do Armazenamento do Azure (Microsoft.Storage). Para saber mais sobre como interagir programaticamente com recursos com FileShare o fornecedor de recursos do Armazenamento do Azure, veja Operações em FileShares.
Se já existir uma partilha com o mesmo nome, a operação falhará. O recurso de partilha inclui metadados e propriedades para essa partilha. Não inclui uma lista dos ficheiros contidos na partilha.
Disponibilidade do protocolo
| Protocolo de partilha de ficheiros ativado | Disponível |
|---|---|
| Bloco de Mensagem de Servidor (SMB) |  |
| NFS (Network File System) | |
Pedir
Pode construir o Create Share pedido conforme mostrado aqui. Recomendamos que utilize HTTPS.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
Substitua os componentes do caminho que são apresentados no URI do pedido pelo seu, da seguinte forma:
| Componente caminho | Description |
|---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome da partilha de ficheiros. O nome só pode conter carateres em minúsculas. |
Para obter mais informações sobre restrições de nomenclatura de caminhos, veja Partilhas de nomes e referências, diretórios, ficheiros e metadados.
Parâmetros do URI
Pode especificar os seguintes parâmetros adicionais no URI do pedido:
| Parâmetro | Description |
|---|---|
timeout |
Opcional. O parâmetro de tempo limite é expresso em segundos. Para obter mais informações, veja Definir tempos limite para operações do Serviço de ficheiros. |
Cabeçalhos do pedido
Os cabeçalhos de pedido obrigatórios e opcionais estão descritos na tabela seguinte:
| Cabeçalho do pedido | Description |
|---|---|
Authorization |
Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
Date ou x-ms-date |
Obrigatório. Especifica a hora Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure. |
x-ms-version |
Necessário para todos os pedidos autorizados. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure. |
x-ms-meta-name:value |
Opcional. Um par nome-valor para associar à partilha como metadados. Os nomes de metadados têm de cumprir as regras de nomenclatura dos identificadores C#. |
x-ms-share-quota |
Opcional. Suportado na versão 2015-02-21 e posterior. Especifica o tamanho máximo da partilha, em gibibytes (GiB). |
x-ms-access-tier |
Opcional. Suportado na versão 2019-12-12 e posterior. Especifica a camada de acesso da partilha. Os valores válidos são TransactionOptimized, Hote Cool. Para obter informações detalhadas sobre as camadas de partilha de ficheiros, veja Ficheiros do Azure camadas de armazenamento. |
x-ms-enabled-protocols: <SMB \| NFS> |
Opcional. Suportado na versão 2019-07-07 e posterior. Especifica os protocolos ativados na partilha. Se não forem especificados, a predefinição é SMB. - SMB: a partilha pode ser acedida por SMBv3.0, SMBv2.1 e REST.- NFS: a partilha pode ser acedida 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 eliminação de raiz na partilha quando o NFS está ativado. Se não for especificado, a predefinição é NoRootSquash. - NoRootSquash: desative o esmagamento de raiz.- RootSquash: mapeie pedidos de uid/gid 0 para o uid/gid anónimo.- AllSquash: mapeie todos os uids e gids para o utilizador anónimo. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar Ficheiros do Azure. |
Corpo do pedido
Nenhum.
Pedido 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 estado HTTP e um conjunto de cabeçalhos de resposta.
Código de estado
Uma operação bem-sucedida devolve o código de estado 201 (Criado).
Para obter mais informações, veja Códigos de estado e 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 de resposta | Descrição |
|---|---|
ETag |
Contém um valor que representa a versão da partilha, entre aspas. |
Last-Modified |
Devolve a data e hora em que a partilha foi modificada pela última vez. O formato de data segue RFC 1123. Para obter mais informações, veja Representar valores de data/hora em cabeçalhos. Qualquer operação que modifique a partilha ou as respetivas propriedades ou metadados atualiza a hora da última modificação. As operações em ficheiros não afetam a hora da última modificação da partilha. |
x-ms-request-id |
Identifica exclusivamente o pedido e pode utilizá-lo para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API |
x-ms-version |
Indica a versão Ficheiros do Azure que foi utilizada para executar o pedido. |
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 utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor não contiver mais de 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, não está presente na resposta. |
Corpo da resposta
Nenhum.
Resposta de 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.
Observações
As partilhas são criadas imediatamente na conta de armazenamento. Não é possível aninhar uma partilha dentro de outra.
Pode especificar metadados para uma partilha ao criá-la ao incluir um ou mais cabeçalhos de metadados no pedido. O formato do cabeçalho de metadados é x-ms-meta-name:value.
Se uma partilha com o mesmo nome estiver a ser eliminada quando chama Create Share, o servidor devolve o código de estado 409 (Conflito) e informações de erro adicionais indicam que a partilha está a ser eliminada.
Pode utilizar a quota de tamanho da partilha para limitar o tamanho dos ficheiros armazenados na partilha. A quota não limita o tamanho dos instantâneos. A sobrecarga associada aos ficheiros e utilizada para calcular o tamanho da faturação da conta de armazenamento não é contabilizada na quota.
Quando a soma dos tamanhos dos ficheiros na partilha exceder a quota definida na partilha, as tentativas de aumentar o tamanho de um ficheiro falharão e a criação de novos ficheiros não vazios (através de REST) falhará. Continuará a poder criar ficheiros vazios.
Alterar ou definir a quota não tem qualquer efeito na faturação. Ainda lhe é faturado o tamanho dos ficheiros e a sobrecarga.