File Services - List
Enumeración de todos los servicios de archivos en cuentas de almacenamiento
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/fileServices?api-version=2023-01-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
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: |
resource
|
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: |
subscription
|
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. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar: la operación de los servicios de archivos de lista se completó correctamente. |
|
Other Status Codes |
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
ListFileServices
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res9290/providers/Microsoft.Storage/storageAccounts/sto1590/fileServices?api-version=2023-01-01
Sample Response
{
"value": [
{
"id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/fileServices/default",
"name": "default",
"type": "Microsoft.Storage/storageAccounts/fileServices",
"properties": {
"cors": {
"corsRules": [
{
"allowedOrigins": [
"http://www.contoso.com",
"http://www.fabrikam.com"
],
"allowedMethods": [
"GET",
"HEAD",
"POST",
"OPTIONS",
"MERGE",
"PUT"
],
"maxAgeInSeconds": 100,
"exposedHeaders": [
"x-ms-meta-*"
],
"allowedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
]
},
{
"allowedOrigins": [
"*"
],
"allowedMethods": [
"GET"
],
"maxAgeInSeconds": 2,
"exposedHeaders": [
"*"
],
"allowedHeaders": [
"*"
]
},
{
"allowedOrigins": [
"http://www.abc23.com",
"https://www.fabrikam.com/*"
],
"allowedMethods": [
"GET",
"PUT"
],
"maxAgeInSeconds": 2000,
"exposedHeaders": [
"x-ms-meta-abc",
"x-ms-meta-data*",
"x-ms-meta-target*"
],
"allowedHeaders": [
"x-ms-meta-12345675754564*"
]
}
]
}
},
"sku": {
"name": "Standard_GRS",
"tier": "Standard"
}
}
]
}
Definiciones
Nombre | Description |
---|---|
Allowed |
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar. |
Cloud |
Respuesta de error del servicio Storage. |
Cloud |
Respuesta de error del servicio Storage. |
Cors |
Especifica una regla de CORS para Blob service. |
Cors |
Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. |
Delete |
Las propiedades del servicio para la eliminación temporal. |
File |
|
File |
Propiedades de servicios de archivos en la cuenta de almacenamiento. |
Multichannel |
Configuración multicanal. Solo se aplica a FileStorage Premium. |
Protocol |
Configuración del protocolo para el servicio de archivos |
Sku |
SKU de la cuenta de almacenamiento. |
Sku |
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType. |
Sku |
Nivel de SKU. Esto se basa en el nombre de la SKU. |
Smb |
Configuración del protocolo SMB |
AllowedMethods
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar.
Nombre | Tipo | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
CloudError
Respuesta de error del servicio Storage.
Nombre | Tipo | Description |
---|---|---|
error |
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 |
Lista de detalles adicionales sobre el error. |
|
message |
string |
Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario. |
target |
string |
Destino del error determinado. Por ejemplo, el nombre de la propiedad en error. |
CorsRule
Especifica una regla de CORS para Blob service.
Nombre | Tipo | Description |
---|---|---|
allowedHeaders |
string[] |
Obligatorio si el elemento CorsRule está presente. Lista de encabezados que pueden formar parte de la solicitud entre orígenes. |
allowedMethods |
Obligatorio si el elemento CorsRule está presente. Lista de métodos HTTP que el origen puede ejecutar. |
|
allowedOrigins |
string[] |
Obligatorio si el elemento CorsRule está presente. Una lista de dominios de origen que se permitirán a través de CORS o "*" para permitir todos los dominios |
exposedHeaders |
string[] |
Obligatorio si el elemento CorsRule está presente. Lista de encabezados de respuesta que se van a exponer a los clientes CORS. |
maxAgeInSeconds |
integer |
Obligatorio si el elemento CorsRule está presente. Número de segundos durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias. |
CorsRules
Establece las reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud.
Nombre | Tipo | Description |
---|---|---|
corsRules |
Cors |
La lista de reglas de CORS. Puede incluir hasta cinco elementos CorsRule en la solicitud. |
DeleteRetentionPolicy
Las propiedades del servicio para la eliminación temporal.
Nombre | Tipo | Description |
---|---|---|
allowPermanentDelete |
boolean |
Esta propiedad cuando se establece en true permite eliminar las instantáneas y las versiones de blobs eliminadas temporalmente. Esta propiedad no se puede usar la directiva de restauración de blobs. Esta propiedad solo se aplica a Blob Service y no se aplica a contenedores o recursos compartidos de archivos. |
days |
integer |
Indica el número de días que se debe conservar el elemento eliminado. El valor mínimo especificado puede ser 1 y el valor máximo puede ser 365. |
enabled |
boolean |
Indica si DeleteRetentionPolicy está habilitado. |
FileServiceItems
Nombre | Tipo | Description |
---|---|---|
value |
Lista de servicios de archivo devueltos. |
FileServiceProperties
Propiedades de servicios de archivos en la cuenta de almacenamiento.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nombre del recurso. |
properties.cors |
Especifica las reglas de CORS para el servicio File. Puede incluir hasta cinco elementos CorsRule en la solicitud. Si no se incluyen elementos CorsRule en el cuerpo de la solicitud, se eliminarán todas las reglas de CORS y CORS se deshabilitará para el servicio de archivos. |
|
properties.protocolSettings |
Configuración del protocolo para el servicio de archivos |
|
properties.shareDeleteRetentionPolicy |
Propiedades del servicio de archivos para la eliminación temporal de recursos compartidos. |
|
sku |
Nombre y nivel de SKU. |
|
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
Multichannel
Configuración multicanal. Solo se aplica a FileStorage Premium.
Nombre | Tipo | Description |
---|---|---|
enabled |
boolean |
Indica si está habilitado multicanal. |
ProtocolSettings
Configuración del protocolo para el servicio de archivos
Nombre | Tipo | Description |
---|---|---|
smb |
Configuración del protocolo SMB |
Sku
SKU de la cuenta de almacenamiento.
Nombre | Tipo | Description |
---|---|---|
name |
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType. |
|
tier |
Nivel de SKU. Esto se basa en el nombre de la SKU. |
SkuName
El nombre de la SKU. Necesario para la creación de cuentas; opcional para la actualización. Tenga en cuenta que en versiones anteriores, el nombre de la SKU se llamó accountType.
Nombre | Tipo | Description |
---|---|---|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
Standard_GRS |
string |
|
Standard_GZRS |
string |
|
Standard_LRS |
string |
|
Standard_RAGRS |
string |
|
Standard_RAGZRS |
string |
|
Standard_ZRS |
string |
SkuTier
Nivel de SKU. Esto se basa en el nombre de la SKU.
Nombre | Tipo | Description |
---|---|---|
Premium |
string |
|
Standard |
string |
SmbSetting
Configuración del protocolo SMB
Nombre | Tipo | Description |
---|---|---|
authenticationMethods |
string |
Métodos de autenticación SMB admitidos por el servidor. Los valores válidos son NTLMv2, Kerberos. Debe pasarse como una cadena con delimitador ';'. |
channelEncryption |
string |
Cifrado de canal SMB compatible con el servidor. Los valores válidos son AES-128-CCM, AES-128-GCM, AES-256-GCM. Debe pasarse como una cadena con delimitador ';'. |
kerberosTicketEncryption |
string |
Cifrado de vales Kerberos compatible con el servidor. Los valores válidos son RC4-HMAC, AES-256. Debe pasarse como una cadena con delimitador ';' |
multichannel |
Configuración multicanal. Solo se aplica a FileStorage Premium. |
|
versions |
string |
Versiones de protocolo SMB compatibles con el servidor. Los valores válidos son SMB2.1, SMB3.0, SMB3.1.1. Debe pasarse como una cadena con delimitador ';'. |