1. Packages
  2. Azure Native v2
  3. API Docs
  4. storage
  5. getFileServiceProperties
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

azure-native-v2.storage.getFileServiceProperties

Explore with Pulumi AI

These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi

Gets the properties of file services in storage accounts, including CORS (Cross-Origin Resource Sharing) rules. Azure REST API version: 2022-09-01.

Other available API versions: 2023-01-01, 2023-04-01, 2023-05-01.

Using getFileServiceProperties

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getFileServiceProperties(args: GetFileServicePropertiesArgs, opts?: InvokeOptions): Promise<GetFileServicePropertiesResult>
function getFileServicePropertiesOutput(args: GetFileServicePropertiesOutputArgs, opts?: InvokeOptions): Output<GetFileServicePropertiesResult>
Copy
def get_file_service_properties(account_name: Optional[str] = None,
                                file_services_name: Optional[str] = None,
                                resource_group_name: Optional[str] = None,
                                opts: Optional[InvokeOptions] = None) -> GetFileServicePropertiesResult
def get_file_service_properties_output(account_name: Optional[pulumi.Input[str]] = None,
                                file_services_name: Optional[pulumi.Input[str]] = None,
                                resource_group_name: Optional[pulumi.Input[str]] = None,
                                opts: Optional[InvokeOptions] = None) -> Output[GetFileServicePropertiesResult]
Copy
func LookupFileServiceProperties(ctx *Context, args *LookupFileServicePropertiesArgs, opts ...InvokeOption) (*LookupFileServicePropertiesResult, error)
func LookupFileServicePropertiesOutput(ctx *Context, args *LookupFileServicePropertiesOutputArgs, opts ...InvokeOption) LookupFileServicePropertiesResultOutput
Copy

> Note: This function is named LookupFileServiceProperties in the Go SDK.

public static class GetFileServiceProperties 
{
    public static Task<GetFileServicePropertiesResult> InvokeAsync(GetFileServicePropertiesArgs args, InvokeOptions? opts = null)
    public static Output<GetFileServicePropertiesResult> Invoke(GetFileServicePropertiesInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetFileServicePropertiesResult> getFileServiceProperties(GetFileServicePropertiesArgs args, InvokeOptions options)
public static Output<GetFileServicePropertiesResult> getFileServiceProperties(GetFileServicePropertiesArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: azure-native:storage:getFileServiceProperties
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

AccountName
This property is required.
Changes to this property will trigger replacement.
string
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
FileServicesName
This property is required.
Changes to this property will trigger replacement.
string
The name of the file Service within the specified storage account. File Service Name must be "default"
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group within the user's subscription. The name is case insensitive.
AccountName
This property is required.
Changes to this property will trigger replacement.
string
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
FileServicesName
This property is required.
Changes to this property will trigger replacement.
string
The name of the file Service within the specified storage account. File Service Name must be "default"
ResourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group within the user's subscription. The name is case insensitive.
accountName
This property is required.
Changes to this property will trigger replacement.
String
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
fileServicesName
This property is required.
Changes to this property will trigger replacement.
String
The name of the file Service within the specified storage account. File Service Name must be "default"
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group within the user's subscription. The name is case insensitive.
accountName
This property is required.
Changes to this property will trigger replacement.
string
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
fileServicesName
This property is required.
Changes to this property will trigger replacement.
string
The name of the file Service within the specified storage account. File Service Name must be "default"
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
string
The name of the resource group within the user's subscription. The name is case insensitive.
account_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
file_services_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the file Service within the specified storage account. File Service Name must be "default"
resource_group_name
This property is required.
Changes to this property will trigger replacement.
str
The name of the resource group within the user's subscription. The name is case insensitive.
accountName
This property is required.
Changes to this property will trigger replacement.
String
The name of the storage account within the specified resource group. Storage account names must be between 3 and 24 characters in length and use numbers and lower-case letters only.
fileServicesName
This property is required.
Changes to this property will trigger replacement.
String
The name of the file Service within the specified storage account. File Service Name must be "default"
resourceGroupName
This property is required.
Changes to this property will trigger replacement.
String
The name of the resource group within the user's subscription. The name is case insensitive.

getFileServiceProperties Result

The following output properties are available:

Id string
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
Name string
The name of the resource
Sku Pulumi.AzureNative.Storage.Outputs.SkuResponse
Sku name and tier.
Type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
Cors Pulumi.AzureNative.Storage.Outputs.CorsRulesResponse
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
ProtocolSettings Pulumi.AzureNative.Storage.Outputs.ProtocolSettingsResponse
Protocol settings for file service
ShareDeleteRetentionPolicy Pulumi.AzureNative.Storage.Outputs.DeleteRetentionPolicyResponse
The file service properties for share soft delete.
Id string
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
Name string
The name of the resource
Sku SkuResponse
Sku name and tier.
Type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
Cors CorsRulesResponse
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
ProtocolSettings ProtocolSettingsResponse
Protocol settings for file service
ShareDeleteRetentionPolicy DeleteRetentionPolicyResponse
The file service properties for share soft delete.
id String
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name String
The name of the resource
sku SkuResponse
Sku name and tier.
type String
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
cors CorsRulesResponse
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
protocolSettings ProtocolSettingsResponse
Protocol settings for file service
shareDeleteRetentionPolicy DeleteRetentionPolicyResponse
The file service properties for share soft delete.
id string
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name string
The name of the resource
sku SkuResponse
Sku name and tier.
type string
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
cors CorsRulesResponse
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
protocolSettings ProtocolSettingsResponse
Protocol settings for file service
shareDeleteRetentionPolicy DeleteRetentionPolicyResponse
The file service properties for share soft delete.
id str
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name str
The name of the resource
sku SkuResponse
Sku name and tier.
type str
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
cors CorsRulesResponse
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
protocol_settings ProtocolSettingsResponse
Protocol settings for file service
share_delete_retention_policy DeleteRetentionPolicyResponse
The file service properties for share soft delete.
id String
Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name String
The name of the resource
sku Property Map
Sku name and tier.
type String
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
cors Property Map
Specifies CORS rules for the File service. You can include up to five CorsRule elements in the request. If no CorsRule elements are included in the request body, all CORS rules will be deleted, and CORS will be disabled for the File service.
protocolSettings Property Map
Protocol settings for file service
shareDeleteRetentionPolicy Property Map
The file service properties for share soft delete.

Supporting Types

CorsRuleResponse

AllowedHeaders This property is required. List<string>
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
AllowedMethods This property is required. List<string>
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
AllowedOrigins This property is required. List<string>
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
ExposedHeaders This property is required. List<string>
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
MaxAgeInSeconds This property is required. int
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.
AllowedHeaders This property is required. []string
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
AllowedMethods This property is required. []string
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
AllowedOrigins This property is required. []string
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
ExposedHeaders This property is required. []string
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
MaxAgeInSeconds This property is required. int
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.
allowedHeaders This property is required. List<String>
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
allowedMethods This property is required. List<String>
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
allowedOrigins This property is required. List<String>
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
exposedHeaders This property is required. List<String>
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
maxAgeInSeconds This property is required. Integer
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.
allowedHeaders This property is required. string[]
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
allowedMethods This property is required. string[]
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
allowedOrigins This property is required. string[]
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
exposedHeaders This property is required. string[]
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
maxAgeInSeconds This property is required. number
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.
allowed_headers This property is required. Sequence[str]
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
allowed_methods This property is required. Sequence[str]
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
allowed_origins This property is required. Sequence[str]
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
exposed_headers This property is required. Sequence[str]
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
max_age_in_seconds This property is required. int
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.
allowedHeaders This property is required. List<String>
Required if CorsRule element is present. A list of headers allowed to be part of the cross-origin request.
allowedMethods This property is required. List<String>
Required if CorsRule element is present. A list of HTTP methods that are allowed to be executed by the origin.
allowedOrigins This property is required. List<String>
Required if CorsRule element is present. A list of origin domains that will be allowed via CORS, or "*" to allow all domains
exposedHeaders This property is required. List<String>
Required if CorsRule element is present. A list of response headers to expose to CORS clients.
maxAgeInSeconds This property is required. Number
Required if CorsRule element is present. The number of seconds that the client/browser should cache a preflight response.

CorsRulesResponse

CorsRules List<Pulumi.AzureNative.Storage.Inputs.CorsRuleResponse>
The List of CORS rules. You can include up to five CorsRule elements in the request.
CorsRules []CorsRuleResponse
The List of CORS rules. You can include up to five CorsRule elements in the request.
corsRules List<CorsRuleResponse>
The List of CORS rules. You can include up to five CorsRule elements in the request.
corsRules CorsRuleResponse[]
The List of CORS rules. You can include up to five CorsRule elements in the request.
cors_rules Sequence[CorsRuleResponse]
The List of CORS rules. You can include up to five CorsRule elements in the request.
corsRules List<Property Map>
The List of CORS rules. You can include up to five CorsRule elements in the request.

DeleteRetentionPolicyResponse

AllowPermanentDelete bool
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
Days int
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
Enabled bool
Indicates whether DeleteRetentionPolicy is enabled.
AllowPermanentDelete bool
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
Days int
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
Enabled bool
Indicates whether DeleteRetentionPolicy is enabled.
allowPermanentDelete Boolean
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
days Integer
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
enabled Boolean
Indicates whether DeleteRetentionPolicy is enabled.
allowPermanentDelete boolean
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
days number
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
enabled boolean
Indicates whether DeleteRetentionPolicy is enabled.
allow_permanent_delete bool
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
days int
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
enabled bool
Indicates whether DeleteRetentionPolicy is enabled.
allowPermanentDelete Boolean
This property when set to true allows deletion of the soft deleted blob versions and snapshots. This property cannot be used blob restore policy. This property only applies to blob service and does not apply to containers or file share.
days Number
Indicates the number of days that the deleted item should be retained. The minimum specified value can be 1 and the maximum value can be 365.
enabled Boolean
Indicates whether DeleteRetentionPolicy is enabled.

MultichannelResponse

Enabled bool
Indicates whether multichannel is enabled
Enabled bool
Indicates whether multichannel is enabled
enabled Boolean
Indicates whether multichannel is enabled
enabled boolean
Indicates whether multichannel is enabled
enabled bool
Indicates whether multichannel is enabled
enabled Boolean
Indicates whether multichannel is enabled

ProtocolSettingsResponse

Smb SmbSettingResponse
Setting for SMB protocol
smb SmbSettingResponse
Setting for SMB protocol
smb SmbSettingResponse
Setting for SMB protocol
smb SmbSettingResponse
Setting for SMB protocol
smb Property Map
Setting for SMB protocol

SkuResponse

Name This property is required. string
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
Tier This property is required. string
The SKU tier. This is based on the SKU name.
Name This property is required. string
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
Tier This property is required. string
The SKU tier. This is based on the SKU name.
name This property is required. String
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
tier This property is required. String
The SKU tier. This is based on the SKU name.
name This property is required. string
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
tier This property is required. string
The SKU tier. This is based on the SKU name.
name This property is required. str
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
tier This property is required. str
The SKU tier. This is based on the SKU name.
name This property is required. String
The SKU name. Required for account creation; optional for update. Note that in older versions, SKU name was called accountType.
tier This property is required. String
The SKU tier. This is based on the SKU name.

SmbSettingResponse

AuthenticationMethods string
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
ChannelEncryption string
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
KerberosTicketEncryption string
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
Multichannel Pulumi.AzureNative.Storage.Inputs.MultichannelResponse
Multichannel setting. Applies to Premium FileStorage only.
Versions string
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.
AuthenticationMethods string
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
ChannelEncryption string
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
KerberosTicketEncryption string
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
Multichannel MultichannelResponse
Multichannel setting. Applies to Premium FileStorage only.
Versions string
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.
authenticationMethods String
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
channelEncryption String
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
kerberosTicketEncryption String
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
multichannel MultichannelResponse
Multichannel setting. Applies to Premium FileStorage only.
versions String
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.
authenticationMethods string
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
channelEncryption string
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
kerberosTicketEncryption string
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
multichannel MultichannelResponse
Multichannel setting. Applies to Premium FileStorage only.
versions string
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.
authentication_methods str
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
channel_encryption str
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
kerberos_ticket_encryption str
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
multichannel MultichannelResponse
Multichannel setting. Applies to Premium FileStorage only.
versions str
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.
authenticationMethods String
SMB authentication methods supported by server. Valid values are NTLMv2, Kerberos. Should be passed as a string with delimiter ';'.
channelEncryption String
SMB channel encryption supported by server. Valid values are AES-128-CCM, AES-128-GCM, AES-256-GCM. Should be passed as a string with delimiter ';'.
kerberosTicketEncryption String
Kerberos ticket encryption supported by server. Valid values are RC4-HMAC, AES-256. Should be passed as a string with delimiter ';'
multichannel Property Map
Multichannel setting. Applies to Premium FileStorage only.
versions String
SMB protocol versions supported by server. Valid values are SMB2.1, SMB3.0, SMB3.1.1. Should be passed as a string with delimiter ';'.

Package Details

Repository
azure-native-v2 pulumi/pulumi-azure-native
License
Apache-2.0
These are the docs for Azure Native v2. We recommenend using the latest version, Azure Native v3.
Azure Native v2 v2.90.0 published on Thursday, Mar 27, 2025 by Pulumi