File Shares - Create

Cria um novo compartilhamento na conta especificada, conforme descrito pelo corpo da solicitação. O recurso do compartilhamento inclui os metadados e as propriedades desse compartilhamento. Ele não inclui uma lista dos arquivos presentes no compartilhamento.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?$expand={$expand}&api-version=2023-01-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres, usar números e apenas letras minúsculas.

Regex pattern: ^[a-z0-9]+$

resourceGroupName
path True

string

O nome do grupo de recursos na assinatura do usuário. O nome diferencia maiúsculas de minúsculas.

Regex pattern: ^[-\w\._\(\)]+$

shareName
path True

string

O nome do compartilhamento de arquivos dentro da 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 (-). Todo caractere de traço (-) precisa ser precedido e seguido imediatamente por uma letra ou um 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: instantâneos. Deve ser passado como uma cadeia de caracteres com o delimitador ','

Corpo da solicitação

Nome Tipo Description
properties.accessTier

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta gpv2 pode escolher entre TransactionOptimized (padrão), Frequente e Esporádico. 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 de nome-valor a ser associado ao compartilhamento como metadados.

properties.rootSquash

RootSquashType

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

properties.shareQuota

integer

O tamanho máximo do compartilhamento, em gigabytes. Deve ser maior que 0 e menor ou igual a 5 TB (5120). Para Compartilhamentos de Arquivos Grandes, o tamanho máximo é 102400.

properties.signedIdentifiers

SignedIdentifier[]

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

Respostas

Nome Tipo Description
200 OK

FileShare

OK -- O compartilhamento já foi criado.

201 Created

FileShare

Criado – Operação Criar Compartilhamento concluída com êxito.

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create NFS Shares
PutShares
PutShares with Access Tier

Create NFS Shares

Sample Request

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

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

Sample Response

{
  "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

Sample Request

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

{}

Sample Response

{
  "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

Sample Request

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

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

Sample Response

{
  "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

Nome 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 concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido.

LeaseState

Estado de concessão do compartilhamento.

LeaseStatus

O status de concessão do compartilhamento.

RootSquashType

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

ShareAccessTier

Camada de acesso para compartilhamento específico. A conta gpv2 pode escolher entre TransactionOptimized (padrão), Frequente e Esporádico. A conta FileStorage pode escolher Premium.

SignedIdentifier

AccessPolicy

Nome Tipo Description
expiryTime

string

Hora de expiração 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.

Nome Tipo Description
error

CloudErrorBody

Uma resposta de erro do serviço de Armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de Armazenamento.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O destino 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.

Nome Tipo Description
NFS

string

SMB

string

FileShare

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

Nome Tipo Description
etag

string

Etag de recurso.

id

string

ID de recurso totalmente qualificada 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), Frequente e Esporádico. A conta FileStorage pode escolher Premium.

properties.accessTierChangeTime

string

Indica a hora 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

Retorna a data e a hora em que o compartilhamento foi modificado pela última vez.

properties.leaseDuration

LeaseDuration

Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido.

properties.leaseState

LeaseState

Estado de concessão do compartilhamento.

properties.leaseStatus

LeaseStatus

O status de concessão do compartilhamento.

properties.metadata

object

Um par de nome-valor a ser associado ao compartilhamento como metadados.

properties.remainingRetentionDays

integer

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

properties.rootSquash

RootSquashType

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

properties.shareQuota

integer

O tamanho máximo do compartilhamento, em gigabytes. Deve ser maior que 0 e menor ou igual a 5 TB (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 recém-criados ou redimensionados recentemente.

properties.signedIdentifiers

SignedIdentifier[]

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

properties.snapshotTime

string

O tempo de criação do compartilhamento instantâneo retornado na resposta de compartilhamentos de lista com "instantâneos" de parâmetro de expansão.

properties.version

string

A versão do compartilhamento.

type

string

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

LeaseDuration

Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido.

Nome Tipo Description
Fixed

string

Infinite

string

LeaseState

Estado de concessão do compartilhamento.

Nome Tipo Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

O status de concessão do compartilhamento.

Nome Tipo Description
Locked

string

Unlocked

string

RootSquashType

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

Nome 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), Frequente e Esporádico. A conta FileStorage pode escolher Premium.

Nome Tipo Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

Nome Tipo Description
accessPolicy

AccessPolicy

Política de acesso

id

string

Um identificador exclusivo da política de acesso armazenada.