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=2026-09-01
Com parâmetros opcionais:
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2026-09-01&$expand={$expand}
Parâmetros do URI
| Nome |
Em |
Obrigatório |
Tipo |
Descrição |
|
accountName
|
path |
True
|
string
minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$
|
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.
|
|
resourceGroupName
|
path |
True
|
string
minLength: 1 maxLength: 90
|
O nome do grupo de recursos. O nome não faz distinção entre maiúsculas e minúsculas.
|
|
shareName
|
path |
True
|
string
minLength: 3 maxLength: 63
|
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
(uuid)
|
O ID da assinatura de destino. O valor deve ser um UUID.
|
|
api-version
|
query |
True
|
string
minLength: 1
|
A versão da API a utilizar 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
| Nome |
Tipo |
Descrição |
|
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.fileSharePaidBursting
|
FileSharePropertiesFileSharePaidBursting
|
Propriedades de intermitência paga de compartilhamento de arquivos.
|
|
properties.metadata
|
object
|
Um par nome-valor para associar ao compartilhamento como metadados.
|
|
properties.provisionedBandwidthMibps
|
integer
(int32)
|
A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada.
|
|
properties.provisionedIops
|
integer
(int32)
|
O IOPS provisionado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionadas.
|
|
properties.rootSquash
|
RootSquashType
|
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.
|
|
properties.shareQuota
|
integer
(int32)
|
O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em Arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para obter o tamanho mínimo e máximo permitido de armazenamento provisionado.
|
|
properties.signedIdentifiers
|
SignedIdentifier[]
|
Lista de políticas de acesso armazenado especificadas no compartilhamento.
|
Respostas
| Nome |
Tipo |
Descrição |
|
200 OK
|
FileShare
|
Operação de atualização 'FileShare' de recursos bem-sucedida
|
|
201 Created
|
FileShare
|
Operação de criação de recurso 'FileShare' bem-sucedida
|
|
Other Status Codes
|
CloudError
|
Uma resposta de erro inesperada.
|
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Nome |
Descrição |
|
user_impersonation
|
assumir a identidade da sua conta de utilizador
|
Exemplos
Create NFS Shares
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2026-09-01
{
"properties": {
"enabledProtocols": "NFS"
}
}
import com.azure.resourcemanager.storage.fluent.models.FileShareInner;
import com.azure.resourcemanager.storage.models.EnabledProtocols;
/**
* Samples for FileShares Create.
*/
public final class Main {
/*
* x-ms-original-file: 2026-09-01/FileSharesPut_NFS.json
*/
/**
* Sample code: Create NFS Shares.
*
* @param manager Entry point to StorageManager.
*/
public static void createNFSShares(com.azure.resourcemanager.storage.StorageManager manager) {
manager.serviceClient().getFileShares().createWithResponse("res346", "sto666", "share1235",
new FileShareInner().withEnabledProtocols(EnabledProtocols.NFS), null, com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-storage
# USAGE
python file_shares_put_nfs.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = StorageManagementClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.file_shares.create(
resource_group_name="res346",
account_name="sto666",
share_name="share1235",
file_share={"properties": {"enabledProtocols": "NFS"}},
)
print(response)
# x-ms-original-file: 2026-09-01/FileSharesPut_NFS.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armstorage_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)
// Generated from example definition: 2026-09-01/FileSharesPut_NFS.json
func ExampleFileSharesClient_Create_createNfsShares() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewFileSharesClient().Create(ctx, "res346", "sto666", "share1235", armstorage.FileShare{
FileShareProperties: &armstorage.FileShareProperties{
EnabledProtocols: to.Ptr(armstorage.EnabledProtocolsNFS),
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armstorage.FileSharesClientCreateResponse{
// FileShare: armstorage.FileShare{
// Name: to.Ptr("share1235"),
// Type: to.Ptr("Microsoft.Storage/storageAccounts/fileServices/shares"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235"),
// FileShareProperties: &armstorage.FileShareProperties{
// EnabledProtocols: to.Ptr(armstorage.EnabledProtocolsNFS),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
*
* @summary creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
* x-ms-original-file: 2026-09-01/FileSharesPut_NFS.json
*/
async function createNFSShares() {
const credential = new DefaultAzureCredential();
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new StorageManagementClient(credential, subscriptionId);
const result = await client.fileShares.create("res346", "sto666", "share1235", {
enabledProtocols: "NFS",
});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Resposta da amostra
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"enabledProtocols": "NFS"
}
}
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"enabledProtocols": "NFS"
}
}
PutShares
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185?api-version=2026-09-01
{}
import com.azure.resourcemanager.storage.fluent.models.FileShareInner;
/**
* Samples for FileShares Create.
*/
public final class Main {
/*
* x-ms-original-file: 2026-09-01/FileSharesPut.json
*/
/**
* Sample code: PutShares.
*
* @param manager Entry point to StorageManager.
*/
public static void putShares(com.azure.resourcemanager.storage.StorageManager manager) {
manager.serviceClient().getFileShares().createWithResponse("res3376", "sto328", "share6185",
new FileShareInner(), null, com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-storage
# USAGE
python file_shares_put.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = StorageManagementClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.file_shares.create(
resource_group_name="res3376",
account_name="sto328",
share_name="share6185",
file_share={
"etag": "str",
"id": "str",
"name": "str",
"properties": {
"accessTier": "str",
"accessTierChangeTime": "2020-02-20 00:00:00",
"accessTierStatus": "str",
"deleted": bool,
"deletedTime": "2020-02-20 00:00:00",
"enabledProtocols": "str",
"fileSharePaidBursting": {
"paidBurstingEnabled": bool,
"paidBurstingMaxBandwidthMibps": 0,
"paidBurstingMaxIops": 0,
},
"includedBurstIops": 0,
"lastModifiedTime": "2020-02-20 00:00:00",
"leaseDuration": "str",
"leaseState": "str",
"leaseStatus": "str",
"maxBurstCreditsForIops": 0,
"metadata": {"str": "str"},
"nextAllowedProvisionedBandwidthDowngradeTime": "2020-02-20 00:00:00",
"nextAllowedProvisionedIopsDowngradeTime": "2020-02-20 00:00:00",
"nextAllowedQuotaDowngradeTime": "2020-02-20 00:00:00",
"provisionedBandwidthMibps": 0,
"provisionedIops": 0,
"remainingRetentionDays": 0,
"rootSquash": "str",
"shareQuota": 0,
"shareUsageBytes": 0,
"signedIdentifiers": [
{
"accessPolicy": {
"expiryTime": "2020-02-20 00:00:00",
"permission": "str",
"startTime": "2020-02-20 00:00:00",
},
"id": "str",
}
],
"snapshotTime": "2020-02-20 00:00:00",
"version": "str",
},
"systemData": {
"createdAt": "2020-02-20 00:00:00",
"createdBy": "str",
"createdByType": "str",
"lastModifiedAt": "2020-02-20 00:00:00",
"lastModifiedBy": "str",
"lastModifiedByType": "str",
},
"type": "str",
},
)
print(response)
# x-ms-original-file: 2026-09-01/FileSharesPut.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armstorage_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)
// Generated from example definition: 2026-09-01/FileSharesPut.json
func ExampleFileSharesClient_Create_putShares() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewFileSharesClient().Create(ctx, "res3376", "sto328", "share6185", armstorage.FileShare{}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armstorage.FileSharesClientCreateResponse{
// FileShare: armstorage.FileShare{
// Name: to.Ptr("share6185"),
// Type: to.Ptr("Microsoft.Storage/storageAccounts/fileServices/shares"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185"),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
*
* @summary creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
* x-ms-original-file: 2026-09-01/FileSharesPut.json
*/
async function putShares() {
const credential = new DefaultAzureCredential();
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new StorageManagementClient(credential, subscriptionId);
const result = await client.fileShares.create("res3376", "sto328", "share6185", {});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Resposta da amostra
{
"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",
"id": "/subscriptions/{subscription-id}/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/fileServices/default/shares/share6185"
}
PutShares with Access Tier
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2026-09-01
{
"properties": {
"accessTier": "Hot"
}
}
import com.azure.resourcemanager.storage.fluent.models.FileShareInner;
import com.azure.resourcemanager.storage.models.ShareAccessTier;
/**
* Samples for FileShares Create.
*/
public final class Main {
/*
* x-ms-original-file: 2026-09-01/FileSharesPut_AccessTier.json
*/
/**
* Sample code: PutShares with Access Tier.
*
* @param manager Entry point to StorageManager.
*/
public static void putSharesWithAccessTier(com.azure.resourcemanager.storage.StorageManager manager) {
manager.serviceClient().getFileShares().createWithResponse("res346", "sto666", "share1235",
new FileShareInner().withAccessTier(ShareAccessTier.HOT), null, com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-storage
# USAGE
python file_shares_put_access_tier.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = StorageManagementClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.file_shares.create(
resource_group_name="res346",
account_name="sto666",
share_name="share1235",
file_share={"properties": {"accessTier": "Hot"}},
)
print(response)
# x-ms-original-file: 2026-09-01/FileSharesPut_AccessTier.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armstorage_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)
// Generated from example definition: 2026-09-01/FileSharesPut_AccessTier.json
func ExampleFileSharesClient_Create_putSharesWithAccessTier() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewFileSharesClient().Create(ctx, "res346", "sto666", "share1235", armstorage.FileShare{
FileShareProperties: &armstorage.FileShareProperties{
AccessTier: to.Ptr(armstorage.ShareAccessTierHot),
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armstorage.FileSharesClientCreateResponse{
// FileShare: armstorage.FileShare{
// Name: to.Ptr("share1235"),
// Type: to.Ptr("Microsoft.Storage/storageAccounts/fileServices/shares"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235"),
// FileShareProperties: &armstorage.FileShareProperties{
// AccessTier: to.Ptr(armstorage.ShareAccessTierHot),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
*
* @summary creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
* x-ms-original-file: 2026-09-01/FileSharesPut_AccessTier.json
*/
async function putSharesWithAccessTier() {
const credential = new DefaultAzureCredential();
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new StorageManagementClient(credential, subscriptionId);
const result = await client.fileShares.create("res346", "sto666", "share1235", {
accessTier: "Hot",
});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Resposta da amostra
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"accessTier": "Hot"
}
}
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"accessTier": "Hot"
}
}
PutShares with Paid Bursting
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2026-09-01
{
"properties": {
"fileSharePaidBursting": {
"paidBurstingEnabled": true,
"paidBurstingMaxBandwidthMibps": 10340,
"paidBurstingMaxIops": 102400
}
}
}
import com.azure.resourcemanager.storage.fluent.models.FileShareInner;
import com.azure.resourcemanager.storage.models.FileSharePropertiesFileSharePaidBursting;
/**
* Samples for FileShares Create.
*/
public final class Main {
/*
* x-ms-original-file: 2026-09-01/FileSharesPut_PaidBursting.json
*/
/**
* Sample code: PutShares with Paid Bursting.
*
* @param manager Entry point to StorageManager.
*/
public static void putSharesWithPaidBursting(com.azure.resourcemanager.storage.StorageManager manager) {
manager.serviceClient().getFileShares().createWithResponse("res346", "sto666", "share1235",
new FileShareInner()
.withFileSharePaidBursting(new FileSharePropertiesFileSharePaidBursting().withPaidBurstingEnabled(true)
.withPaidBurstingMaxIops(102400).withPaidBurstingMaxBandwidthMibps(10340)),
null, com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-storage
# USAGE
python file_shares_put_paid_bursting.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = StorageManagementClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.file_shares.create(
resource_group_name="res346",
account_name="sto666",
share_name="share1235",
file_share={
"properties": {
"fileSharePaidBursting": {
"paidBurstingEnabled": True,
"paidBurstingMaxBandwidthMibps": 10340,
"paidBurstingMaxIops": 102400,
}
}
},
)
print(response)
# x-ms-original-file: 2026-09-01/FileSharesPut_PaidBursting.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armstorage_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)
// Generated from example definition: 2026-09-01/FileSharesPut_PaidBursting.json
func ExampleFileSharesClient_Create_putSharesWithPaidBursting() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewFileSharesClient().Create(ctx, "res346", "sto666", "share1235", armstorage.FileShare{
FileShareProperties: &armstorage.FileShareProperties{
FileSharePaidBursting: &armstorage.FileSharePropertiesFileSharePaidBursting{
PaidBurstingEnabled: to.Ptr(true),
PaidBurstingMaxBandwidthMibps: to.Ptr[int32](10340),
PaidBurstingMaxIops: to.Ptr[int32](102400),
},
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armstorage.FileSharesClientCreateResponse{
// FileShare: armstorage.FileShare{
// Name: to.Ptr("share1235"),
// Type: to.Ptr("Microsoft.Storage/storageAccounts/fileServices/shares"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235"),
// FileShareProperties: &armstorage.FileShareProperties{
// FileSharePaidBursting: &armstorage.FileSharePropertiesFileSharePaidBursting{
// PaidBurstingEnabled: to.Ptr(true),
// PaidBurstingMaxBandwidthMibps: to.Ptr[int32](10340),
// PaidBurstingMaxIops: to.Ptr[int32](102400),
// },
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
*
* @summary creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
* x-ms-original-file: 2026-09-01/FileSharesPut_PaidBursting.json
*/
async function putSharesWithPaidBursting() {
const credential = new DefaultAzureCredential();
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new StorageManagementClient(credential, subscriptionId);
const result = await client.fileShares.create("res346", "sto666", "share1235", {
fileSharePaidBursting: {
paidBurstingEnabled: true,
paidBurstingMaxBandwidthMibps: 10340,
paidBurstingMaxIops: 102400,
},
});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Resposta da amostra
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"fileSharePaidBursting": {
"paidBurstingEnabled": true,
"paidBurstingMaxBandwidthMibps": 10340,
"paidBurstingMaxIops": 102400
}
}
}
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"fileSharePaidBursting": {
"paidBurstingEnabled": true,
"paidBurstingMaxBandwidthMibps": 10340,
"paidBurstingMaxIops": 102400
}
}
}
PutSharesProvisionedV2
Pedido de amostra
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235?api-version=2026-09-01
{
"properties": {
"provisionedBandwidthMibps": 200,
"provisionedIops": 5000,
"shareQuota": 100
}
}
import com.azure.resourcemanager.storage.fluent.models.FileShareInner;
/**
* Samples for FileShares Create.
*/
public final class Main {
/*
* x-ms-original-file: 2026-09-01/FileSharesPut_ProvisionedV2.json
*/
/**
* Sample code: PutSharesProvisionedV2.
*
* @param manager Entry point to StorageManager.
*/
public static void putSharesProvisionedV2(com.azure.resourcemanager.storage.StorageManager manager) {
manager.serviceClient().getFileShares().createWithResponse("res346", "sto666", "share1235",
new FileShareInner().withShareQuota(100).withProvisionedIops(5000).withProvisionedBandwidthMibps(200), null,
com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.storage import StorageManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-storage
# USAGE
python file_shares_put_provisioned_v2.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = StorageManagementClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.file_shares.create(
resource_group_name="res346",
account_name="sto666",
share_name="share1235",
file_share={"properties": {"provisionedBandwidthMibps": 200, "provisionedIops": 5000, "shareQuota": 100}},
)
print(response)
# x-ms-original-file: 2026-09-01/FileSharesPut_ProvisionedV2.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armstorage_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/storage/armstorage/v4"
)
// Generated from example definition: 2026-09-01/FileSharesPut_ProvisionedV2.json
func ExampleFileSharesClient_Create_putSharesProvisionedV2() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armstorage.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewFileSharesClient().Create(ctx, "res346", "sto666", "share1235", armstorage.FileShare{
FileShareProperties: &armstorage.FileShareProperties{
ProvisionedBandwidthMibps: to.Ptr[int32](200),
ProvisionedIops: to.Ptr[int32](5000),
ShareQuota: to.Ptr[int32](100),
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armstorage.FileSharesClientCreateResponse{
// FileShare: armstorage.FileShare{
// Name: to.Ptr("share1235"),
// Type: to.Ptr("Microsoft.Storage/storageAccounts/fileServices/shares"),
// ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235"),
// FileShareProperties: &armstorage.FileShareProperties{
// IncludedBurstIops: to.Ptr[int32](15000),
// MaxBurstCreditsForIops: to.Ptr[int64](36000000),
// ProvisionedBandwidthMibps: to.Ptr[int32](200),
// ProvisionedIops: to.Ptr[int32](5000),
// ShareQuota: to.Ptr[int32](100),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { StorageManagementClient } = require("@azure/arm-storage");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
*
* @summary creates a new share under the specified account as described by request body. The share resource includes metadata and properties for that share. It does not include a list of the files contained by the share.
* x-ms-original-file: 2026-09-01/FileSharesPut_ProvisionedV2.json
*/
async function putSharesProvisionedV2() {
const credential = new DefaultAzureCredential();
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new StorageManagementClient(credential, subscriptionId);
const result = await client.fileShares.create("res346", "sto666", "share1235", {
provisionedBandwidthMibps: 200,
provisionedIops: 5000,
shareQuota: 100,
});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Resposta da amostra
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"includedBurstIops": 15000,
"maxBurstCreditsForIops": 36000000,
"provisionedBandwidthMibps": 200,
"provisionedIops": 5000,
"shareQuota": 100
}
}
{
"name": "share1235",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"id": "/subscriptions/{subscription-id}/resourceGroups/res346/providers/Microsoft.Storage/storageAccounts/sto666/fileServices/default/shares/share1235",
"properties": {
"includedBurstIops": 15000,
"maxBurstCreditsForIops": 36000000,
"provisionedBandwidthMibps": 200,
"provisionedIops": 5000,
"shareQuota": 100
}
}
Definições
| Nome |
Descrição |
|
AccessPolicy
|
|
|
CloudError
|
Uma resposta de erro do serviço de armazenamento.
|
|
CloudErrorBody
|
Uma resposta de erro do serviço de armazenamento.
|
|
createdByType
|
O tipo de identidade que criou o recurso.
|
|
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.
|
|
FileSharePropertiesFileSharePaidBursting
|
Propriedades de intermitência paga de compartilhamento de arquivos.
|
|
LeaseDuration
|
Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é alugado.
|
|
LeaseState
|
Estado de locação do contêiner.
|
|
LeaseStatus
|
O status de concessão do contêiner.
|
|
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
|
|
|
systemData
|
Metadados referentes à criação e última modificação do recurso.
|
AccessPolicy
Object
| Nome |
Tipo |
Descrição |
|
expiryTime
|
string
(date-time)
|
Prazo de validade da política de acesso
|
|
permission
|
string
|
Lista de permissões abreviadas.
|
|
startTime
|
string
(date-time)
|
Hora de início da política de acesso
|
CloudError
Object
Uma resposta de erro do serviço de armazenamento.
| Nome |
Tipo |
Descrição |
|
error
|
CloudErrorBody
|
Uma resposta de erro do serviço de armazenamento.
|
CloudErrorBody
Object
Uma resposta de erro do serviço de armazenamento.
| Nome |
Tipo |
Descrição |
|
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.
|
createdByType
Enumeração
O tipo de identidade que criou o recurso.
| Valor |
Descrição |
|
User
|
|
|
Application
|
|
|
ManagedIdentity
|
|
|
Key
|
|
EnabledProtocols
Enumeração
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento.
FileShare
Object
Propriedades do compartilhamento de arquivos, incluindo Id, nome do recurso, tipo de recurso, Etag.
| Nome |
Tipo |
Descrição |
|
etag
|
string
|
Etag de recurso.
|
|
id
|
string
(arm-id)
|
ID de recurso totalmente qualificado para o recurso. Por exemplo, "/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
(date-time)
|
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
(date-time)
|
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.fileSharePaidBursting
|
FileSharePropertiesFileSharePaidBursting
|
Propriedades de intermitência paga de compartilhamento de arquivos.
|
|
properties.includedBurstIops
|
integer
(int32)
|
O IOPS de intermitência calculado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta.
|
|
properties.lastModifiedTime
|
string
(date-time)
|
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.maxBurstCreditsForIops
|
integer
(int64)
|
Os créditos máximos de burst calculados para a ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta.
|
|
properties.metadata
|
object
|
Um par nome-valor para associar ao compartilhamento como metadados.
|
|
properties.nextAllowedProvisionedBandwidthDowngradeTime
|
string
(date-time-rfc7231)
|
Retorna o próximo tempo de downgrade de largura de banda provisionada permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta.
|
|
properties.nextAllowedProvisionedIopsDowngradeTime
|
string
(date-time-rfc7231)
|
Retorna o próximo tempo de downgrade de IOPS provisionado permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta.
|
|
properties.nextAllowedQuotaDowngradeTime
|
string
(date-time-rfc7231)
|
Retorna o próximo tempo de downgrade de tamanho de armazenamento provisionado permitido para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos Provisionados v1 SSD e Arquivos Provisionados v2 tipo de conta
|
|
properties.provisionedBandwidthMibps
|
integer
(int32)
|
A largura de banda provisionada do compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para largura de banda provisionada.
|
|
properties.provisionedIops
|
integer
(int32)
|
O IOPS provisionado da ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v2 tipo de conta. Consulte a resposta da API GetFileServiceUsage para obter o valor mínimo e máximo permitido para IOPS provisionadas.
|
|
properties.remainingRetentionDays
|
integer
(int32)
|
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
(int32)
|
O tamanho provisionado do compartilhamento, em gibibytes. Deve ser maior que 0 e menor ou igual a 5TB (5120). Para compartilhamentos de arquivos grandes, o tamanho máximo é 102400. Para compartilhamentos de arquivos criados em Arquivos provisionados tipo de conta v2, consulte a resposta da API GetFileServiceUsage para obter o tamanho mínimo e máximo permitido de armazenamento provisionado.
|
|
properties.shareUsageBytes
|
integer
(int64)
|
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
(date-time)
|
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.
|
|
systemData
|
systemData
|
Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
|
|
type
|
string
|
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"
|
FileSharePropertiesFileSharePaidBursting
Object
Propriedades de intermitência paga de compartilhamento de arquivos.
| Nome |
Tipo |
Descrição |
|
paidBurstingEnabled
|
boolean
|
Indica se o bursting pago está habilitado para o compartilhamento. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta.
|
|
paidBurstingMaxBandwidthMibps
|
integer
(int32)
|
A largura de banda máxima de bursting paga para o compartilhamento, em mebibytes por segundo. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. O valor máximo permitido é 10340, que é a largura de banda máxima permitida para um compartilhamento.
|
|
paidBurstingMaxIops
|
integer
(int32)
|
O máximo pago de IOPS bursting para a ação. Esta propriedade é apenas para compartilhamentos de arquivos criados em Arquivos provisionados v1 SSD tipo de conta. O valor máximo permitido é 102400, que é o máximo permitido IOPS para uma ação.
|
LeaseDuration
Enumeração
Especifica se a concessão em um contêiner é de duração infinita ou fixa, somente quando o contêiner é alugado.
| Valor |
Descrição |
|
Infinite
|
|
|
Fixed
|
|
LeaseState
Enumeração
Estado de locação do contêiner.
| Valor |
Descrição |
|
Available
|
|
|
Leased
|
|
|
Expired
|
|
|
Breaking
|
|
|
Broken
|
|
LeaseStatus
Enumeração
O status de concessão do contêiner.
| Valor |
Descrição |
|
Locked
|
|
|
Unlocked
|
|
RootSquashType
Enumeração
A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.
| Valor |
Descrição |
|
NoRootSquash
|
|
|
RootSquash
|
|
|
AllSquash
|
|
ShareAccessTier
Enumeração
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.
| Valor |
Descrição |
|
TransactionOptimized
|
|
|
Hot
|
|
|
Cool
|
|
|
Premium
|
|
SignedIdentifier
Object
| Nome |
Tipo |
Descrição |
|
accessPolicy
|
AccessPolicy
|
Política de acesso
|
|
id
|
string
|
Um identificador exclusivo da política de acesso armazenado.
|
systemData
Object
Metadados referentes à criação e última modificação do recurso.
| Nome |
Tipo |
Descrição |
|
createdAt
|
string
(date-time)
|
A marca temporal da criação do recurso (UTC).
|
|
createdBy
|
string
|
A identidade que criou o recurso.
|
|
createdByType
|
createdByType
|
O tipo de identidade que criou o recurso.
|
|
lastModifiedAt
|
string
(date-time)
|
A data e hora da última modificação do recurso (UTC)
|
|
lastModifiedBy
|
string
|
A identidade que modificou o recurso pela última vez.
|
|
lastModifiedByType
|
createdByType
|
O tipo de identidade que modificou o recurso pela última vez.
|