File Shares - List

Listas todos los recursos compartidos.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
path True

string

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuentas de almacenamiento deben tener entre 3 y 24 caracteres, y usar solo números y letras minúsculas.

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

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas.

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

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

$expand
query

string

Opcional, se usa para expandir las propiedades dentro de las propiedades del recurso compartido. Los valores válidos son: eliminados, instantáneas. Se debe pasar como una cadena con el delimitador ','

$filter
query

string

Opcional. Cuando se especifica, solo se mostrarán los nombres de recurso compartido que comiencen por el filtro.

$maxpagesize
query

string

Opcional. Número máximo especificado de recursos compartidos que se pueden incluir en la lista.

Respuestas

Nombre Tipo Description
200 OK

FileShareItems

Aceptar: la operación Enumerar recursos compartidos se completó correctamente.

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

ListDeletedShares
ListShares
ListShareSnapshots

ListDeletedShares

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01&$expand=deleted

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644_1234567890",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024,
        "version": "1234567890",
        "deleted": true,
        "deletedTime": "2019-12-14T08:20:47Z",
        "remainingRetentionDays": 30
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ]
}

ListShares

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share1644",
      "name": "share1644",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847D51C7DE\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2019-05-14T08:20:47Z",
        "shareQuota": 1024
      }
    }
  ],
  "nextLink": "https://sto1590endpoint/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2022-09-01&$maxpagesize=2&$skipToken=/sto1590/share5103"
}

ListShareSnapshots

Sample Request

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares?api-version=2023-01-01&$expand=snapshots

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024
      }
    },
    {
      "id": "/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices/default/shares/share4052",
      "name": "share4052",
      "type": "Microsoft.Storage/storageAccounts/fileServices/shares",
      "etag": "\"0x8D589847DAB5AF9\"",
      "properties": {
        "lastModifiedTime": "2020-10-26T05:47:05.0000000Z",
        "shareQuota": 1024,
        "snapshotTime": "2020-10-26T05:48:07.0000000Z"
      }
    }
  ]
}

Definiciones

Nombre Description
AccessPolicy
CloudError

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

FileShareItem

Las propiedades del recurso compartido de archivos se muestran.

FileShareItems

Esquema de respuesta. Contiene la lista de recursos compartidos devueltos y, si se solicita o se requiere la paginación, una dirección URL a la página siguiente de recursos compartidos.

LeaseDuration

Especifica si la concesión de un recurso compartido tiene una duración infinita o fija, solo cuando se alquila el recurso compartido.

LeaseState

Estado de concesión del recurso compartido.

LeaseStatus

Estado de concesión del recurso compartido.

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta gpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta fileStorage puede elegir Premium.

SignedIdentifier

AccessPolicy

Nombre Tipo Description
expiryTime

string

Hora de expiración de la directiva de acceso

permission

string

Lista de permisos abreviados.

startTime

string

Hora de inicio de la directiva de acceso

CloudError

Respuesta de error del servicio Storage.

Nombre Tipo Description
error

CloudErrorBody

Respuesta de error del servicio Storage.

CloudErrorBody

Respuesta de error del servicio Storage.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

details

CloudErrorBody[]

Lista de detalles adicionales sobre el error.

message

string

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

target

string

Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

Nombre Tipo Description
NFS

string

SMB

string

FileShareItem

Las propiedades del recurso compartido de archivos se muestran.

Nombre Tipo Description
etag

string

Etag de recursos.

id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nombre del recurso.

properties.accessTier

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta gpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta fileStorage puede elegir Premium.

properties.accessTierChangeTime

string

Indica la hora de la última modificación del nivel de acceso compartido.

properties.accessTierStatus

string

Indica si hay una transición pendiente para el nivel de acceso.

properties.deleted

boolean

Indica si se eliminó el recurso compartido.

properties.deletedTime

string

Hora eliminada si se eliminó el recurso compartido.

properties.enabledProtocols

EnabledProtocols

Protocolo de autenticación que se usa para el recurso compartido de archivos. Solo se puede especificar al crear un recurso compartido.

properties.lastModifiedTime

string

Devuelve la fecha y hora en que se modificó por última vez el recurso compartido.

properties.leaseDuration

LeaseDuration

Especifica si la concesión de un recurso compartido tiene una duración infinita o fija, solo cuando se alquila el recurso compartido.

properties.leaseState

LeaseState

Estado de concesión del recurso compartido.

properties.leaseStatus

LeaseStatus

Estado de concesión del recurso compartido.

properties.metadata

object

Par nombre-valor que se va a asociar al recurso compartido como metadatos.

properties.remainingRetentionDays

integer

Días de retención restantes para el recurso compartido que se eliminó temporalmente.

properties.rootSquash

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

properties.shareQuota

integer

Tamaño máximo del recurso compartido, en gigabytes. Debe ser mayor que 0 y menor o igual que 5TB (5120). En el caso de los recursos compartidos de archivos grandes, el tamaño máximo es 102400.

properties.shareUsageBytes

integer

Tamaño aproximado de los datos almacenados en el recurso compartido. Tenga en cuenta que es posible que este valor no incluya todos los archivos creados recientemente o recientemente cambiados de tamaño.

properties.signedIdentifiers

SignedIdentifier[]

Lista de directivas de acceso almacenadas especificadas en el recurso compartido.

properties.snapshotTime

string

Tiempo de creación de la instantánea de recurso compartido devuelta en la respuesta de los recursos compartidos de lista con el parámetro expand "snapshots".

properties.version

string

La versión del recurso compartido.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

FileShareItems

Esquema de respuesta. Contiene la lista de recursos compartidos devueltos y, si se solicita o se requiere la paginación, una dirección URL a la página siguiente de recursos compartidos.

Nombre Tipo Description
nextLink

string

Dirección URL de solicitud que se puede usar para consultar la página siguiente de recursos compartidos. Se devuelve cuando el número total de recursos compartidos solicitados supera el tamaño máximo de página.

value

FileShareItem[]

Lista de recursos compartidos de archivos devueltos.

LeaseDuration

Especifica si la concesión de un recurso compartido tiene una duración infinita o fija, solo cuando se alquila el recurso compartido.

Nombre Tipo Description
Fixed

string

Infinite

string

LeaseState

Estado de concesión del recurso compartido.

Nombre Tipo Description
Available

string

Breaking

string

Broken

string

Expired

string

Leased

string

LeaseStatus

Estado de concesión del recurso compartido.

Nombre Tipo Description
Locked

string

Unlocked

string

RootSquashType

La propiedad es solo para el recurso compartido NFS. El valor predeterminado es NoRootSquash.

Nombre Tipo Description
AllSquash

string

NoRootSquash

string

RootSquash

string

ShareAccessTier

Nivel de acceso para un recurso compartido específico. La cuenta gpV2 puede elegir entre TransactionOptimized (valor predeterminado), Frecuente y Esporádico. La cuenta fileStorage puede elegir Premium.

Nombre Tipo Description
Cool

string

Hot

string

Premium

string

TransactionOptimized

string

SignedIdentifier

Nombre Tipo Description
accessPolicy

AccessPolicy

Directiva de acceso

id

string

Identificador único de la directiva de acceso almacenada.