@pulumi/azure-native
Version:
[](https://slack.pulumi.com) [](https://npmjs.com/package/@pulumi/azure-native) [ • 10.7 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "../types/input";
import * as outputs from "../types/output";
import * as enums from "../types/enums";
/**
* Properties of the file share, including Id, resource name, resource type, Etag.
*
* Uses Azure REST API version 2024-01-01. In version 2.x of the Azure Native provider, it used API version 2022-09-01.
*
* Other available API versions: 2022-09-01, 2023-01-01, 2023-04-01, 2023-05-01, 2025-01-01. These can be accessed by generating a local SDK package using the CLI command `pulumi package add azure-native storage [ApiVersion]`. See the [version guide](../../../version-guide/#accessing-any-api-version-via-local-packages) for details.
*/
export declare class FileShare extends pulumi.CustomResource {
/**
* Get an existing FileShare resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, opts?: pulumi.CustomResourceOptions): FileShare;
/**
* Returns true if the given object is an instance of FileShare. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is FileShare;
/**
* Access tier for specific share. GpV2 account can choose between TransactionOptimized (default), Hot, and Cool. FileStorage account can choose Premium.
*/
readonly accessTier: pulumi.Output<string | undefined>;
/**
* Indicates the last modification time for share access tier.
*/
readonly accessTierChangeTime: pulumi.Output<string>;
/**
* Indicates if there is a pending transition for access tier.
*/
readonly accessTierStatus: pulumi.Output<string>;
/**
* The Azure API version of the resource.
*/
readonly azureApiVersion: pulumi.Output<string>;
/**
* Indicates whether the share was deleted.
*/
readonly deleted: pulumi.Output<boolean>;
/**
* The deleted time if the share was deleted.
*/
readonly deletedTime: pulumi.Output<string>;
/**
* The authentication protocol that is used for the file share. Can only be specified when creating a share.
*/
readonly enabledProtocols: pulumi.Output<string | undefined>;
/**
* Resource Etag.
*/
readonly etag: pulumi.Output<string>;
/**
* File Share Paid Bursting properties.
*/
readonly fileSharePaidBursting: pulumi.Output<outputs.storage.FileSharePropertiesResponseFileSharePaidBursting | undefined>;
/**
* The calculated burst IOPS of the share. This property is only for file shares created under Files Provisioned v2 account type.
*/
readonly includedBurstIops: pulumi.Output<number>;
/**
* Returns the date and time the share was last modified.
*/
readonly lastModifiedTime: pulumi.Output<string>;
/**
* Specifies whether the lease on a share is of infinite or fixed duration, only when the share is leased.
*/
readonly leaseDuration: pulumi.Output<string>;
/**
* Lease state of the share.
*/
readonly leaseState: pulumi.Output<string>;
/**
* The lease status of the share.
*/
readonly leaseStatus: pulumi.Output<string>;
/**
* The calculated maximum burst credits for the share. This property is only for file shares created under Files Provisioned v2 account type.
*/
readonly maxBurstCreditsForIops: pulumi.Output<number>;
/**
* A name-value pair to associate with the share as metadata.
*/
readonly metadata: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* The name of the resource
*/
readonly name: pulumi.Output<string>;
/**
* Returns the next allowed provisioned bandwidth downgrade time for the share. This property is only for file shares created under Files Provisioned v2 account type.
*/
readonly nextAllowedProvisionedBandwidthDowngradeTime: pulumi.Output<string>;
/**
* Returns the next allowed provisioned IOPS downgrade time for the share. This property is only for file shares created under Files Provisioned v2 account type.
*/
readonly nextAllowedProvisionedIopsDowngradeTime: pulumi.Output<string>;
/**
* Returns the next allowed provisioned storage size downgrade time for the share. This property is only for file shares created under Files Provisioned v1 SSD and Files Provisioned v2 account type
*/
readonly nextAllowedQuotaDowngradeTime: pulumi.Output<string>;
/**
* The provisioned bandwidth of the share, in mebibytes per second. This property is only for file shares created under Files Provisioned v2 account type. Please refer to the GetFileServiceUsage API response for the minimum and maximum allowed value for provisioned bandwidth.
*/
readonly provisionedBandwidthMibps: pulumi.Output<number | undefined>;
/**
* The provisioned IOPS of the share. This property is only for file shares created under Files Provisioned v2 account type. Please refer to the GetFileServiceUsage API response for the minimum and maximum allowed value for provisioned IOPS.
*/
readonly provisionedIops: pulumi.Output<number | undefined>;
/**
* Remaining retention days for share that was soft deleted.
*/
readonly remainingRetentionDays: pulumi.Output<number>;
/**
* The property is for NFS share only. The default is NoRootSquash.
*/
readonly rootSquash: pulumi.Output<string | undefined>;
/**
* The provisioned size of the share, in gibibytes. Must be greater than 0, and less than or equal to 5TB (5120). For Large File Shares, the maximum size is 102400. For file shares created under Files Provisioned v2 account type, please refer to the GetFileServiceUsage API response for the minimum and maximum allowed provisioned storage size.
*/
readonly shareQuota: pulumi.Output<number | undefined>;
/**
* The approximate size of the data stored on the share. Note that this value may not include all recently created or recently resized files.
*/
readonly shareUsageBytes: pulumi.Output<number>;
/**
* List of stored access policies specified on the share.
*/
readonly signedIdentifiers: pulumi.Output<outputs.storage.SignedIdentifierResponse[] | undefined>;
/**
* Creation time of share snapshot returned in the response of list shares with expand param "snapshots".
*/
readonly snapshotTime: pulumi.Output<string>;
/**
* The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
*/
readonly type: pulumi.Output<string>;
/**
* The version of the share.
*/
readonly version: pulumi.Output<string>;
/**
* Create a FileShare resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: FileShareArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* The set of arguments for constructing a FileShare resource.
*/
export interface FileShareArgs {
/**
* Access tier for specific share. GpV2 account can choose between TransactionOptimized (default), Hot, and Cool. FileStorage account can choose Premium.
*/
accessTier?: pulumi.Input<string | enums.storage.ShareAccessTier>;
/**
* 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.
*/
accountName: pulumi.Input<string>;
/**
* The authentication protocol that is used for the file share. Can only be specified when creating a share.
*/
enabledProtocols?: pulumi.Input<string | enums.storage.EnabledProtocols>;
/**
* Optional, used to expand the properties within share's properties. Valid values are: snapshots. Should be passed as a string with delimiter ','
*/
expand?: pulumi.Input<string>;
/**
* File Share Paid Bursting properties.
*/
fileSharePaidBursting?: pulumi.Input<inputs.storage.FileSharePropertiesFileSharePaidBurstingArgs>;
/**
* A name-value pair to associate with the share as metadata.
*/
metadata?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
}>;
/**
* The provisioned bandwidth of the share, in mebibytes per second. This property is only for file shares created under Files Provisioned v2 account type. Please refer to the GetFileServiceUsage API response for the minimum and maximum allowed value for provisioned bandwidth.
*/
provisionedBandwidthMibps?: pulumi.Input<number>;
/**
* The provisioned IOPS of the share. This property is only for file shares created under Files Provisioned v2 account type. Please refer to the GetFileServiceUsage API response for the minimum and maximum allowed value for provisioned IOPS.
*/
provisionedIops?: pulumi.Input<number>;
/**
* The name of the resource group within the user's subscription. The name is case insensitive.
*/
resourceGroupName: pulumi.Input<string>;
/**
* The property is for NFS share only. The default is NoRootSquash.
*/
rootSquash?: pulumi.Input<string | enums.storage.RootSquashType>;
/**
* The name of the file share within the specified storage account. File share names must be between 3 and 63 characters in length and use numbers, lower-case letters and dash (-) only. Every dash (-) character must be immediately preceded and followed by a letter or number.
*/
shareName?: pulumi.Input<string>;
/**
* The provisioned size of the share, in gibibytes. Must be greater than 0, and less than or equal to 5TB (5120). For Large File Shares, the maximum size is 102400. For file shares created under Files Provisioned v2 account type, please refer to the GetFileServiceUsage API response for the minimum and maximum allowed provisioned storage size.
*/
shareQuota?: pulumi.Input<number>;
/**
* List of stored access policies specified on the share.
*/
signedIdentifiers?: pulumi.Input<pulumi.Input<inputs.storage.SignedIdentifierArgs>[]>;
}