Partilhar via


File Shares - Create

Cria um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso de compartilhamento inclui metadados e propriedades para esse compartilhamento. Ele não inclui uma lista dos arquivos contidos pelo compartilhamento.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-05-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?$expand={$expand}&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]+$

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\._\(\)]+$

shareName
path True

string

O nome do compartilhamento de arquivos na conta de armazenamento especificada. Os nomes de compartilhamento de arquivos devem ter entre 3 e 63 caracteres e usar números, letras minúsculas e traço (-) apenas. Cada caractere de traço (-) deve ser imediatamente precedido e seguido por uma letra ou número.

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.

$expand
query

string

Opcional, usado para expandir as propriedades dentro das propriedades do compartilhamento. Os valores válidos são: snapshots. Deve ser passado como uma cadeia de caracteres com delimitador ',;

Corpo do Pedido

Name Tipo Description
properties.accessTier

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

properties.enabledProtocols

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

properties.metadata

object

Um par nome-valor para associar ao compartilhamento como metadados.

properties.rootSquash

RootSquashType

A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

properties.shareQuota

integer

O tamanho máximo da partilha, em gigabytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400.

properties.signedIdentifiers

SignedIdentifier[]

Lista de políticas de acesso armazenado especificadas no compartilhamento.

Respostas

Name Tipo Description
200 OK

FileShare

OK -- O compartilhamento já está criado.

201 Created

FileShare

Criado -- Operação Criar compartilhamento concluída 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

Create NFS Shares
PutShares
PutShares with Access Tier

Create NFS Shares

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2023-05-01

{
  "properties": {
    "enabledProtocols": "NFS"
  }
}

Resposta da amostra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "enabledProtocols": "NFS"
  }
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "enabledProtocols": "NFS"
  }
}

PutShares

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2023-05-01

{}

Resposta da amostra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares"
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185",
  "name": "share6185",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares"
}

PutShares with Access Tier

Pedido de amostra

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2023-05-01

{
  "properties": {
    "accessTier": "Hot"
  }
}

Resposta da amostra

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "accessTier": "Hot"
  }
}
{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
  "name": "share1235",
  "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
  "properties": {
    "accessTier": "Hot"
  }
}

Definições

Name Description
AccessPolicy
CloudError

Uma resposta de erro do serviço de armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de armazenamento.

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

FileShare

Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag.

LeaseDuration

Especifica se a locação de uma ação é de duração infinita ou fixa, somente quando a ação é arrendada.

LeaseState

Estado de locação da ação.

LeaseStatus

O status de locação da ação.

RootSquashType

A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

SignedIdentifier

AccessPolicy

Name Tipo Description
expiryTime

string

Prazo de validade da política de acesso

permission

string

Lista de permissões abreviadas.

startTime

string

Hora de início da política de acesso

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.

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

Name Tipo Description
NFS

string

SMB

string

FileShare

Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag.

Name Tipo Description
etag

string

Etag de recurso.

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.accessTier

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

properties.accessTierChangeTime

string

Indica o tempo da última modificação para a camada de acesso de compartilhamento.

properties.accessTierStatus

string

Indica se há uma transição pendente para a camada de acesso.

properties.deleted

boolean

Indica se o compartilhamento foi excluído.

properties.deletedTime

string

A hora excluída se o compartilhamento foi excluído.

properties.enabledProtocols

EnabledProtocols

O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.

properties.lastModifiedTime

string

Devolve a data e a hora em que a partilha foi modificada pela última vez.

properties.leaseDuration

LeaseDuration

Especifica se a locação de uma ação é de duração infinita ou fixa, somente quando a ação é arrendada.

properties.leaseState

LeaseState

Estado de locação da ação.

properties.leaseStatus

LeaseStatus

O status de locação da ação.

properties.metadata

object

Um par nome-valor para associar ao compartilhamento como metadados.

properties.remainingRetentionDays

integer

Dias de retenção restantes para compartilhamento que foi excluído suavemente.

properties.rootSquash

RootSquashType

A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

properties.shareQuota

integer

O tamanho máximo da partilha, em gigabytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400.

properties.shareUsageBytes

integer

O tamanho aproximado dos dados armazenados no compartilhamento. Observe que esse valor pode não incluir todos os arquivos criados ou redimensionados recentemente.

properties.signedIdentifiers

SignedIdentifier[]

Lista de políticas de acesso armazenado especificadas no compartilhamento.

properties.snapshotTime

string

Tempo de criação do snapshot de compartilhamento retornado na resposta de compartilhamentos de lista com expand param "snapshots".

properties.version

string

A versão do compartilhamento.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

LeaseDuration

Especifica se a locação de uma ação é de duração infinita ou fixa, somente quando a ação é arrendada.

Name Tipo Description
Fixed

string

Infinite

string

LeaseState

Estado de locação da ação.

Name Tipo Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

O status de locação da ação.

Name Tipo Description
Locked

string

Unlocked

string

RootSquashType

A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

Name Tipo Description
AllSquash

string

NoRootSquash

string

RootSquash

string

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta GpV2 pode escolher entre TransactionOptimized (padrão), Hot e Cool. A conta FileStorage pode escolher Premium.

Name Tipo Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

Name Tipo Description
accessPolicy

AccessPolicy

Política de acesso

id

string

Um identificador exclusivo da política de acesso armazenado.