import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Manages a FSx Storage Virtual Machine. * See the [FSx ONTAP User Guide](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html) for more information. * * ## Example Usage * * ### Basic Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const test = new aws.fsx.OntapStorageVirtualMachine("test", { * fileSystemId: testAwsFsxOntapFileSystem.id, * name: "test", * }); * ``` * * ### Using a Self-Managed Microsoft Active Directory * * Additional information for using AWS Directory Service with ONTAP File Systems can be found in the [FSx ONTAP Guide](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/self-managed-AD.html). * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const test = new aws.fsx.OntapStorageVirtualMachine("test", { * activeDirectoryConfiguration: { * selfManagedActiveDirectoryConfiguration: { * dnsIps: [ * "10.0.0.111", * "10.0.0.222", * ], * domainName: "corp.example.com", * password: "avoid-plaintext-passwords", * username: "Admin", * }, * netbiosName: "mysvm", * }, * fileSystemId: testAwsFsxOntapFileSystem.id, * name: "mysvm", * }); * ``` * * ## Import * * Using `pulumi import`, import FSx Storage Virtual Machine using the `id`. For example: * * ```sh * $ pulumi import aws:fsx/ontapStorageVirtualMachine:OntapStorageVirtualMachine example svm-12345678abcdef123 * ``` * * Certain resource arguments, like `svmAdminPassword` and the `selfManagedActiveDirectory` configuation block `password`, do not have a FSx API method for reading the information after creation. If these arguments are set in the Pulumi program on an imported resource, Pulumi will always show a difference. To workaround this behavior, either omit the argument from the Pulumi program or use `ignoreChanges` to hide the difference. For example: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.fsx.OntapStorageVirtualMachine("example", {svmAdminPassword: "avoid-plaintext-passwords"}, { * ignoreChanges: ["svmAdminPassword"], * }); * ``` */ export declare class OntapStorageVirtualMachine extends pulumi.CustomResource { /** * Get an existing OntapStorageVirtualMachine 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 state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: OntapStorageVirtualMachineState, opts?: pulumi.CustomResourceOptions): OntapStorageVirtualMachine; /** * Returns true if the given object is an instance of OntapStorageVirtualMachine. 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 OntapStorageVirtualMachine; /** * Configuration block that Amazon FSx uses to join the FSx ONTAP Storage Virtual Machine(SVM) to your Microsoft Active Directory (AD) directory. Detailed below. */ readonly activeDirectoryConfiguration: pulumi.Output; /** * ARN of the storage virtual machine. */ readonly arn: pulumi.Output; /** * Endpoints that are used to access data or to manage the storage virtual machine using the NetApp ONTAP CLI, REST API, or NetApp SnapMirror. See `endpoints` below. */ readonly endpoints: pulumi.Output; /** * ID of the Amazon FSx ONTAP File System that this SVM will be created on. */ readonly fileSystemId: pulumi.Output; /** * Name of the SVM. You can use a maximum of 47 alphanumeric characters, plus the underscore (_) special character. */ readonly name: pulumi.Output; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ readonly region: pulumi.Output; /** * Root volume security style. Valid values are `UNIX`, `NTFS`, and `MIXED`. All volumes created under this SVM will inherit the root security style unless the security style is specified on the volume. Default value is `UNIX`. */ readonly rootVolumeSecurityStyle: pulumi.Output; /** * SVM's subtype, e.g. `DEFAULT` */ readonly subtype: pulumi.Output; /** * Password to use when logging on to the SVM using a secure shell (SSH) connection to the SVM's management endpoint. Doing so enables you to manage the SVM using the NetApp ONTAP CLI or REST API. If you do not specify a password, you can still use the file system's fsxadmin user to manage the SVM. */ readonly svmAdminPassword: pulumi.Output; /** * Map of tags to assign to the storage virtual machine. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ readonly tagsAll: pulumi.Output<{ [key: string]: string; }>; /** * SVM's UUID (universally unique identifier). */ readonly uuid: pulumi.Output; /** * Create a OntapStorageVirtualMachine 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: OntapStorageVirtualMachineArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering OntapStorageVirtualMachine resources. */ export interface OntapStorageVirtualMachineState { /** * Configuration block that Amazon FSx uses to join the FSx ONTAP Storage Virtual Machine(SVM) to your Microsoft Active Directory (AD) directory. Detailed below. */ activeDirectoryConfiguration?: pulumi.Input; /** * ARN of the storage virtual machine. */ arn?: pulumi.Input; /** * Endpoints that are used to access data or to manage the storage virtual machine using the NetApp ONTAP CLI, REST API, or NetApp SnapMirror. See `endpoints` below. */ endpoints?: pulumi.Input[] | undefined>; /** * ID of the Amazon FSx ONTAP File System that this SVM will be created on. */ fileSystemId?: pulumi.Input; /** * Name of the SVM. You can use a maximum of 47 alphanumeric characters, plus the underscore (_) special character. */ name?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Root volume security style. Valid values are `UNIX`, `NTFS`, and `MIXED`. All volumes created under this SVM will inherit the root security style unless the security style is specified on the volume. Default value is `UNIX`. */ rootVolumeSecurityStyle?: pulumi.Input; /** * SVM's subtype, e.g. `DEFAULT` */ subtype?: pulumi.Input; /** * Password to use when logging on to the SVM using a secure shell (SSH) connection to the SVM's management endpoint. Doing so enables you to manage the SVM using the NetApp ONTAP CLI or REST API. If you do not specify a password, you can still use the file system's fsxadmin user to manage the SVM. */ svmAdminPassword?: pulumi.Input; /** * Map of tags to assign to the storage virtual machine. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ tagsAll?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * SVM's UUID (universally unique identifier). */ uuid?: pulumi.Input; } /** * The set of arguments for constructing a OntapStorageVirtualMachine resource. */ export interface OntapStorageVirtualMachineArgs { /** * Configuration block that Amazon FSx uses to join the FSx ONTAP Storage Virtual Machine(SVM) to your Microsoft Active Directory (AD) directory. Detailed below. */ activeDirectoryConfiguration?: pulumi.Input; /** * ID of the Amazon FSx ONTAP File System that this SVM will be created on. */ fileSystemId: pulumi.Input; /** * Name of the SVM. You can use a maximum of 47 alphanumeric characters, plus the underscore (_) special character. */ name?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Root volume security style. Valid values are `UNIX`, `NTFS`, and `MIXED`. All volumes created under this SVM will inherit the root security style unless the security style is specified on the volume. Default value is `UNIX`. */ rootVolumeSecurityStyle?: pulumi.Input; /** * Password to use when logging on to the SVM using a secure shell (SSH) connection to the SVM's management endpoint. Doing so enables you to manage the SVM using the NetApp ONTAP CLI or REST API. If you do not specify a password, you can still use the file system's fsxadmin user to manage the SVM. */ svmAdminPassword?: pulumi.Input; /** * Map of tags to assign to the storage virtual machine. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; } //# sourceMappingURL=ontapStorageVirtualMachine.d.ts.map