File Shares - Get
Obtém as propriedades de um compartilhamento especificado.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices/default/shares/{shareName}?api-version=2023-01-01&$expand={$expand}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
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: |
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura do usuário. O nome diferencia maiúsculas de minúsculas. Regex pattern: |
share
|
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. |
subscription
|
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: estatísticas. Deve ser passado como uma cadeia de caracteres com o delimitador ','. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
x-ms-snapshot |
string |
Opcional, usado para recuperar propriedades de um instantâneo. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OK -- A operação Obter Compartilhamento foi concluída com êxito. |
|
Other Status Codes |
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
Get |
Get |
GetShares
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024
}
}
GetShareStats
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634?api-version=2023-01-01&$expand=stats
Sample Response
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res9871/providers/Microsoft.Storage/storageAccounts/sto6217/fileServices/default/shares/share1634",
"name": "share1634",
"type": "Microsoft.Storage/storageAccounts/fileServices/shares",
"etag": "\"0x8D592D74CC20EBA\"",
"properties": {
"lastModifiedTime": "2019-05-26T05:06:14Z",
"shareQuota": 1024,
"shareUsageBytes": 652945
}
}
Definições
Nome | Description |
---|---|
Access |
|
Cloud |
Uma resposta de erro do serviço de Armazenamento. |
Cloud |
Uma resposta de erro do serviço de Armazenamento. |
Enabled |
O protocolo de autenticação usado para o compartilhamento de arquivos. Só pode ser especificado ao criar um compartilhamento. |
File |
Propriedades do compartilhamento de arquivos, incluindo ID, nome do recurso, tipo de recurso, Etag. |
Lease |
Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido. |
Lease |
Estado de concessão do compartilhamento. |
Lease |
O status de concessão do compartilhamento. |
Root |
A propriedade é somente para compartilhamento NFS. O padrão é NoRootSquash. |
Share |
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. |
Signed |
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 |
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 |
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 |
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 |
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 |
Especifica se a concessão em um compartilhamento é de duração infinita ou fixa, somente quando o compartilhamento é concedido. |
|
properties.leaseState |
Estado de concessão do compartilhamento. |
|
properties.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 |
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 |
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 |
Política de acesso |
|
id |
string |
Um identificador exclusivo da política de acesso armazenada. |