Partilhar via

az storage share-rm

Gerencie compartilhamentos de arquivos do Azure usando o provedor de recursos Microsoft.Storage.

Comandos

Nome Descrição Tipo Estado
az storage share-rm create

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

 Core disponibilidade geral
az storage share-rm delete

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado.

 Core disponibilidade geral
az storage share-rm exists

Verifique a existência de um compartilhamento de arquivos do Azure.

 Core disponibilidade geral
az storage share-rm list

Liste todos os compartilhamentos.

 Core disponibilidade geral
az storage share-rm restore

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão suave de compartilhamento estiver habilitada.

 Core disponibilidade geral
az storage share-rm show

Mostrar as propriedades de um compartilhamento de arquivos ou instantâneo de compartilhamento do Azure especificado.

 Core disponibilidade geral
az storage share-rm snapshot

Crie um instantâneo de um compartilhamento existente na conta especificada.

 Core Preview
az storage share-rm stats

Obtenha os bytes de uso dos dados armazenados no compartilhamento.

 Core disponibilidade geral
az storage share-rm update

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

 Core disponibilidade geral

az storage share-rm create

Editar

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

az storage share-rm create --account-name --storage-account
                           --name --share-name
                           [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--bursting-max-mibps --paid-bursting-max-bandwidth-mibps]
                           [--enabled-protocols {NFS, SMB}]
                           [--metadata]
                           [--paid-bursting-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                           [--paid-bursting-max-iops]
                           [--provisioned-bandwidth --provisioned-bandwidth-mibps]
                           [--provisioned-iops]
                           [--quota]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]

Exemplos

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 10 GB na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 6000 GB na conta de armazenamento 'mystorageaccount' (nome da conta) que permite o compartilhamento de arquivos grande no grupo de recursos 'MyResourceGroup'.

az storage account update -g MyResourceGroup --name mystorageaccount --enable-large-file-share
az storage share-rm create -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 6000 --metadata key1=value1 key2=value2

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' com metadados e cota como 10 GB na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm create --storage-account mystorageaccount --name myfileshare --quota 10 --metadata key1=value1 key2=value2

Crie um novo compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' que habilita provisionedv2 no grupo de recursos 'MyResourceGroup'.

az storage account create -g res3376 --name sto328 --sku StandardV2_LRS --kind FileStorage
az storage share-rm create --storage-account sto328  -g res3376  -n share1 --provisioned-bandwidth-mibps 60 --provisioned-iops 500

Parâmetros Obrigatórios

--account-name --storage-account

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.

--name --share-name -n

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.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--access-tier

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.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Cool, Hot, Premium, TransactionOptimized
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--enabled-protocols

O protocolo de autenticação usado para o compartilhamento de arquivos. O protocolo NFS só estará disponível para compartilhamentos de arquivos premium (compartilhamentos de arquivos no tipo de conta FileStorage). Só pode ser especificado ao criar um compartilhamento.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: NFS, SMB
--metadata

Um par nome-valor para associar ao compartilhamento como metadados. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--paid-bursting-enabled

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--paid-bursting-max-iops

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--provisioned-iops

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--quota -q

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.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--root-squash

Redução dos direitos de acesso para o superutilizador remoto. A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: AllSquash, NoRootSquash, RootSquash
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm delete

Editar

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado.

Exclua o compartilhamento de arquivos ou o instantâneo de compartilhamento do Azure especificado. BREAKING CHANGE: Snapshot não pode ser excluído por padrão e adicionamos um novo parâmetro para usar se você quiser incluir sanpshots para operação de exclusão.

az storage share-rm delete [--account-name --storage-account]
                           [--ids]
                           [--include]
                           [--name --share-name]
                           [--resource-group]
                           [--snapshot]
                           [--subscription]
                           [--yes]

Exemplos

Exclua um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm delete -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Exclua um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm delete --storage-account mystorageaccount --name myfileshare

Exclua um compartilhamento de arquivos do Azure por ID de recurso.

az storage share-rm delete --ids file-share-id

Exclua um instantâneo de compartilhamento de arquivos do Azure.

az storage share-rm delete --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Exclua um compartilhamento de arquivos do Azure e todos os seus instantâneos.

az storage share-rm delete --include snapshots -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Exclua um compartilhamento de arquivos do Azure e todos os seus instantâneos (alugados/não alugados).

az storage share-rm delete --include leased-snapshots -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--account-name --storage-account

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--include

Optional. Os valores válidos são: snapshots, leased-snapshots, none. O valor padrão é none. Para 'instantâneos', o compartilhamento de arquivos é excluído, incluindo todos os seus instantâneos de compartilhamento de arquivos. Se o compartilhamento de arquivos contiver instantâneos concedidos, a exclusão falhará. Para 'snapshots concedidos', o compartilhamento de arquivos é excluído incluindo todos os seus instantâneos de compartilhamento de arquivos (alugados/não alugados). Para 'nenhum', o compartilhamento de arquivos é excluído se não tiver instantâneos de compartilhamento. Se o compartilhamento de arquivos contiver instantâneos (alugados ou não concedidos), a exclusão falhará.

Propriedade Valor
Valor padrão: none
--name --share-name -n

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--snapshot

Opcional, usado para excluir um instantâneo. O valor DateTime que especifica o instantâneo de compartilhamento a ser recuperado.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm exists

Editar

Verifique a existência de um compartilhamento de arquivos do Azure.

az storage share-rm exists [--ids]
                           [--name]
                           [--resource-group]
                           [--storage-account]
                           [--subscription]

Exemplos

Verifique a existência de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm exists -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Verifique a existência de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm exists --storage-account mystorageaccount --name myfileshare

Verifique a existência de um compartilhamento de arquivos do Azure por ID de recurso.

az storage share-rm exists --ids file-share-id

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivos.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--storage-account

O nome ou ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm list

Editar

Liste todos os compartilhamentos.

az storage share-rm list --account-name --storage-account
                         [--filter]
                         [--include-deleted {0, 1, f, false, n, no, t, true, y, yes}]
                         [--include-snapshot {0, 1, f, false, n, no, t, true, y, yes}]
                         [--max-items]
                         [--maxpagesize]
                         [--next-token]
                         [--resource-group]

Exemplos

Liste os compartilhamentos de arquivos do Azure na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm list -g MyResourceGroup --storage-account mystorageaccount

Liste os compartilhamentos de arquivos do Azure na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm list --storage-account mystorageaccount

Listar todos os compartilhamentos de arquivos incluem excluídos sob a conta de armazenamento 'mystorageaccount' .

az storage share-rm list --storage-account mystorageaccount --include-deleted

Listar todos os compartilhamentos de arquivos inclui todos os snapshots na conta de armazenamento 'mystorageaccount'

az storage share-rm list --storage-account mystorageaccount --include-snapshot

Listar todos os compartilhamentos de arquivos inclui todos os instantâneos e compartilhamentos de arquivos excluídos na conta de armazenamento 'mystorageaccount'

az storage share-rm list --storage-account mystorageaccount --include-deleted --include-snapshot

Parâmetros Obrigatórios

--account-name --storage-account

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.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--filter

Optional. Quando especificado, apenas os nomes de compartilhamento que começam com o filtro serão listados.

--include-deleted

Inclua compartilhamentos de arquivos excluídos suavemente quando especificado.

Propriedade Valor
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--include-snapshot

Inclua instantâneos de compartilhamento de arquivos quando especificado.

Propriedade Valor
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--maxpagesize

Optional. Número máximo especificado de ações que podem ser incluídas na lista.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

Propriedade Valor
Grupo de parâmetros: Pagination Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm restore

Editar

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão suave de compartilhamento estiver habilitada.

az storage share-rm restore --deleted-version
                            [--ids]
                            [--name]
                            [--resource-group]
                            [--restored-name]
                            [--storage-account]
                            [--subscription]

Exemplos

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão suave de compartilhamento estiver habilitada.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 -g MyResourceGroup --storage-account mystorageaccount

Restaure um compartilhamento de arquivos dentro de um dia de retenção válido se a exclusão suave de compartilhamento estiver habilitada para um novo nome.

az storage share-rm restore -n deletedshare --deleted-version 01D64EB9886F00C4 --restored-name newname -g MyResourceGroup --storage-account mystorageaccount

Parâmetros Obrigatórios

--deleted-version

Identifique a versão do compartilhamento excluído que será restaurada.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivos. Identifique o nome do compartilhamento excluído que será restaurado.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--restored-name

Um novo nome de compartilhamento de arquivos a ser restaurado. Se não for especificado, o nome de compartilhamento excluído será usado.

--storage-account

O nome ou ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm show

Editar

Mostrar as propriedades de um compartilhamento de arquivos ou instantâneo de compartilhamento do Azure especificado.

az storage share-rm show [--account-name --storage-account]
                         [--expand]
                         [--ids]
                         [--name --share-name]
                         [--resource-group]
                         [--snapshot]
                         [--subscription]

Exemplos

Mostrar as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm show -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Mostrar as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm show --storage-account mystorageaccount --name myfileshare

Mostrar as propriedades de um compartilhamento de arquivos do Azure por id de recurso.

az storage share-rm show --ids file-share-id

Mostrar as propriedades de um instantâneo de compartilhamento de arquivos do Azure

az storage share-rm show --ids file-share-id --snapshot "2021-03-25T05:29:56.0000000Z"

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--account-name --storage-account

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--expand

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name --share-name -n

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--snapshot

Opcional, usado para excluir um instantâneo. O valor DateTime que especifica o instantâneo de compartilhamento a ser recuperado.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm snapshot

Editar
Previsualizar

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um instantâneo de um compartilhamento existente na conta especificada.

az storage share-rm snapshot [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                             [--enabled-protocols {NFS, SMB}]
                             [--ids]
                             [--metadata]
                             [--name]
                             [--quota]
                             [--resource-group]
                             [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                             [--storage-account]
                             [--subscription]

Exemplos

Crie um instantâneo de um compartilhamento existente na conta especificada.

az storage share-rm snapshot -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--access-tier

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.

Propriedade Valor
Valores aceites: Cool, Hot, Premium, TransactionOptimized
--enabled-protocols

Propriedade imutável para o protocolo de compartilhamentos de arquivos. O protocolo NFS só estará disponível para compartilhamentos de arquivos premium (compartilhamentos de arquivos no tipo de conta FileStorage).

Propriedade Valor
Valores aceites: NFS, SMB
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--metadata

Metadados em pares chave=valor separados por espaço associados ao compartilhamento. Isso substitui quaisquer metadados existentes.

--name -n

O nome do compartilhamento de arquivos.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--quota -q

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

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--root-squash

Redução dos direitos de acesso para o superutilizador remoto.

Propriedade Valor
Valores aceites: AllSquash, NoRootSquash, RootSquash
--storage-account

O nome ou ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm stats

Editar

Obtenha os bytes de uso dos dados armazenados no compartilhamento.

az storage share-rm stats [--ids]
                          [--name]
                          [--resource-group]
                          [--storage-account]
                          [--subscription]

Exemplos

Obtenha os bytes de uso dos dados armazenados no compartilhamento.

az storage share-rm stats -g MyResourceGroup --storage-account mystorageaccount --name myfileshare

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome do compartilhamento de arquivos.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--storage-account

O nome ou ID da conta de armazenamento.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az storage share-rm update

Editar

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

az storage share-rm update [--access-tier {Cool, Hot, Premium, TransactionOptimized}]
                           [--account-name --storage-account]
                           [--add]
                           [--bursting-max-mibps --paid-bursting-max-bandwidth-mibps]
                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                           [--ids]
                           [--metadata]
                           [--name --share-name]
                           [--paid-bursting-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                           [--paid-bursting-max-iops]
                           [--provisioned-bandwidth --provisioned-bandwidth-mibps]
                           [--provisioned-iops]
                           [--quota]
                           [--remove]
                           [--resource-group]
                           [--root-squash {AllSquash, NoRootSquash, RootSquash}]
                           [--set]
                           [--subscription]

Exemplos

Atualize as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (nome da conta) no grupo de recursos 'MyResourceGroup'.

az storage share-rm update -g MyResourceGroup --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Atualize as propriedades de um compartilhamento de arquivos do Azure 'myfileshare' na conta de armazenamento 'mystorageaccount' (ID da conta).

az storage share-rm update --storage-account mystorageaccount --name myfileshare --quota 3 --metadata key1=value1 key2=value2

Atualize as propriedades de um compartilhamento de arquivos do Azure por ID de recurso.

az storage share-rm update --ids file-share-id --quota 3 --metadata key1=value1 key2=value2

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--access-tier

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.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: Cool, Hot, Premium, TransactionOptimized
--account-name --storage-account

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--bursting-max-mibps --paid-bursting-max-bandwidth-mibps

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--metadata

Um par nome-valor para associar ao compartilhamento como metadados. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--name --share-name -n

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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--paid-bursting-enabled

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--paid-bursting-max-iops

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V1 Paid Bursting Arguments
--provisioned-bandwidth --provisioned-bandwidth-mibps

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--provisioned-iops

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.

Propriedade Valor
Grupo de parâmetros: Provisioned V2 Arguments
--quota -q

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.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--root-squash

Redução dos direitos de acesso para o superutilizador remoto. A propriedade é apenas para compartilhamento NFS. O padrão é NoRootSquash.

Propriedade Valor
Grupo de parâmetros: Properties Arguments
Valores aceites: AllSquash, NoRootSquash, RootSquash
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False