lib/aws-sdk-fsx/client.rb in aws-sdk-fsx-1.31.0 vs lib/aws-sdk-fsx/client.rb in aws-sdk-fsx-1.32.0

- old
+ new

@@ -335,10 +335,90 @@ super end # @!group API Operations + # Use this action to associate one or more Domain Name Server (DNS) + # aliases with an existing Amazon FSx for Windows File Server file + # system. A file systen can have a maximum of 50 DNS aliases associated + # with it at any one time. If you try to associate a DNS alias that is + # already associated with the file system, FSx takes no action on that + # alias in the request. For more information, see [Working with DNS + # Aliases][1] and [Walkthrough 5: Using DNS aliases to access your file + # system][2], including additional steps you must take to be able to + # access your file system using a DNS alias. + # + # The system response shows the DNS aliases that Amazon FSx is + # attempting to associate with the file system. Use the API operation to + # monitor the status of the aliases Amazon FSx is associating with the + # file system. + # + # + # + # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-dns-aliases.html + # [2]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/walkthrough05-file-system-custom-CNAME.html + # + # @option params [String] :client_request_token + # (Optional) An idempotency token for resource creation, in a string of + # up to 64 ASCII characters. This token is automatically filled on your + # behalf when you use the AWS Command Line Interface (AWS CLI) or an AWS + # SDK. + # + # **A suitable default value is auto-generated.** You should normally + # not need to pass this option.** + # + # @option params [required, String] :file_system_id + # Specifies the file system with which you want to associate one or more + # DNS aliases. + # + # @option params [required, Array<String>] :aliases + # An array of one or more DNS alias names to associate with the file + # system. The alias name has to comply with the following formatting + # requirements: + # + # * Formatted as a fully-qualified domain name (FQDN), <i> + # <code>hostname.domain</code> </i>, for example, + # `accounting.corp.example.com`. + # + # * Can contain alphanumeric characters and the hyphen (-). + # + # * Cannot start or end with a hyphen. + # + # * Can start with a numeric. + # + # For DNS alias names, Amazon FSx stores alphabetic characters as + # lowercase letters (a-z), regardless of how you specify them: as + # uppercase letters, lowercase letters, or the corresponding letters in + # escape codes. + # + # @return [Types::AssociateFileSystemAliasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::AssociateFileSystemAliasesResponse#aliases #aliases} => Array&lt;Types::Alias&gt; + # + # @example Request syntax with placeholder values + # + # resp = client.associate_file_system_aliases({ + # client_request_token: "ClientRequestToken", + # file_system_id: "FileSystemId", # required + # aliases: ["AlternateDNSName"], # required + # }) + # + # @example Response structure + # + # resp.aliases #=> Array + # resp.aliases[0].name #=> String + # resp.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" + # + # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/AssociateFileSystemAliases AWS API Documentation + # + # @overload associate_file_system_aliases(params = {}) + # @param [Hash] params ({}) + def associate_file_system_aliases(params = {}, options = {}) + req = build_request(:associate_file_system_aliases, params) + req.send_request(options) + end + # Cancels an existing Amazon FSx for Lustre data repository task if that # task is in either the `PENDING` or `EXECUTING` state. When you cancel # a task, Amazon FSx does the following. # # * Any files that FSx has already exported are not reverted. @@ -506,11 +586,11 @@ # @example Response structure # # resp.backup.backup_id #=> String # resp.backup.lifecycle #=> String, one of "AVAILABLE", "CREATING", "TRANSFERRING", "DELETED", "FAILED" # resp.backup.failure_details.message #=> String - # resp.backup.type #=> String, one of "AUTOMATIC", "USER_INITIATED" + # resp.backup.type #=> String, one of "AUTOMATIC", "USER_INITIATED", "AWS_BACKUP" # resp.backup.progress_percent #=> Integer # resp.backup.creation_time #=> Time # resp.backup.kms_key_id #=> String # resp.backup.resource_arn #=> String # resp.backup.tags #=> Array @@ -551,10 +631,13 @@ # resp.backup.file_system.windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.backup.file_system.windows_configuration.weekly_maintenance_start_time #=> String # resp.backup.file_system.windows_configuration.daily_automatic_backup_start_time #=> String # resp.backup.file_system.windows_configuration.automatic_backup_retention_days #=> Integer # resp.backup.file_system.windows_configuration.copy_tags_to_backups #=> Boolean + # resp.backup.file_system.windows_configuration.aliases #=> Array + # resp.backup.file_system.windows_configuration.aliases[0].name #=> String + # resp.backup.file_system.windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.backup.file_system.lustre_configuration.weekly_maintenance_start_time #=> String # resp.backup.file_system.lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.backup.file_system.lustre_configuration.data_repository_configuration.import_path #=> String # resp.backup.file_system.lustre_configuration.data_repository_configuration.export_path #=> String # resp.backup.file_system.lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -566,11 +649,11 @@ # resp.backup.file_system.lustre_configuration.daily_automatic_backup_start_time #=> String # resp.backup.file_system.lustre_configuration.automatic_backup_retention_days #=> Integer # resp.backup.file_system.lustre_configuration.copy_tags_to_backups #=> Boolean # resp.backup.file_system.lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.backup.file_system.administrative_actions #=> Array - # resp.backup.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.backup.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.backup.file_system.administrative_actions[0].progress_percent #=> Integer # resp.backup.file_system.administrative_actions[0].request_time #=> Time # resp.backup.file_system.administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.backup.file_system.administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.backup.file_system.administrative_actions[0].failure_details.message #=> String @@ -835,20 +918,21 @@ # * {Types::CreateFileSystemResponse#file_system #file_system} => Types::FileSystem # # # @example Example: To create a new file system # - # # This operation creates a new file system. + # # This operation creates a new Amazon FSx for Windows File Server file system. # # resp = client.create_file_system({ # client_request_token: "a8ca07e4-61ec-4399-99f4-19853801bcd5", # file_system_type: "WINDOWS", - # kms_key_id: "arn:aws:kms:us-east-1:012345678912:key/0ff3ea8d-130e-4133-877f-93908b6fdbd6", + # kms_key_id: "arn:aws:kms:us-east-1:012345678912:key/1111abcd-2222-3333-4444-55556666eeff", # security_group_ids: [ # "sg-edcd9784", # ], - # storage_capacity: 300, + # storage_capacity: 3200, + # storage_type: "HDD", # subnet_ids: [ # "subnet-1234abcd", # ], # tags: [ # { @@ -856,28 +940,32 @@ # value: "MyFileSystem", # }, # ], # windows_configuration: { # active_directory_id: "d-1234abcd12", + # aliases: [ + # "accounting.corp.example.com", + # ], # automatic_backup_retention_days: 30, # daily_automatic_backup_start_time: "05:00", - # throughput_capacity: 8, + # throughput_capacity: 32, # weekly_maintenance_start_time: "1:05:00", # }, # }) # # resp.to_h outputs the following: # { # file_system: { # creation_time: Time.parse("1481841524.0"), - # dns_name: "fs-0498eed5fe91001ec.fsx.com", - # file_system_id: "fs-0498eed5fe91001ec", - # kms_key_id: "arn:aws:kms:us-east-1:012345678912:key/0ff3ea8d-130e-4133-877f-93908b6fdbd6", + # dns_name: "fs-0123456789abcdef0.fsx.com", + # file_system_id: "fs-0123456789abcdef0", + # kms_key_id: "arn:aws:kms:us-east-1:012345678912:key/1111abcd-2222-3333-4444-55556666eeff", # lifecycle: "CREATING", # owner_id: "012345678912", - # resource_arn: "arn:aws:fsx:us-east-1:012345678912:file-system/fs-0498eed5fe91001ec", - # storage_capacity: 300, + # resource_arn: "arn:aws:fsx:us-east-1:012345678912:file-system/fs-0123456789abcdef0", + # storage_capacity: 3200, + # storage_type: "HDD", # subnet_ids: [ # "subnet-1234abcd", # ], # tags: [ # { @@ -886,13 +974,19 @@ # }, # ], # vpc_id: "vpc-ab1234cd", # windows_configuration: { # active_directory_id: "d-1234abcd12", + # aliases: [ + # { + # lifecycle: "CREATING", + # name: "accounting.corp.example.com", + # }, + # ], # automatic_backup_retention_days: 30, # daily_automatic_backup_start_time: "05:00", - # throughput_capacity: 8, + # throughput_capacity: 32, # weekly_maintenance_start_time: "1:05:00", # }, # }, # } # @@ -927,10 +1021,11 @@ # throughput_capacity: 1, # required # weekly_maintenance_start_time: "WeeklyTime", # daily_automatic_backup_start_time: "DailyTime", # automatic_backup_retention_days: 1, # copy_tags_to_backups: false, + # aliases: ["AlternateDNSName"], # }, # lustre_configuration: { # weekly_maintenance_start_time: "WeeklyTime", # import_path: "ArchivePath", # export_path: "ArchivePath", @@ -982,10 +1077,13 @@ # resp.file_system.windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.file_system.windows_configuration.weekly_maintenance_start_time #=> String # resp.file_system.windows_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.windows_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.windows_configuration.copy_tags_to_backups #=> Boolean + # resp.file_system.windows_configuration.aliases #=> Array + # resp.file_system.windows_configuration.aliases[0].name #=> String + # resp.file_system.windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.file_system.lustre_configuration.weekly_maintenance_start_time #=> String # resp.file_system.lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.file_system.lustre_configuration.data_repository_configuration.import_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.export_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -997,11 +1095,11 @@ # resp.file_system.lustre_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.lustre_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.lustre_configuration.copy_tags_to_backups #=> Boolean # resp.file_system.lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.file_system.administrative_actions #=> Array - # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.file_system.administrative_actions[0].progress_percent #=> Integer # resp.file_system.administrative_actions[0].request_time #=> Time # resp.file_system.administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.file_system.administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.file_system.administrative_actions[0].failure_details.message #=> String @@ -1203,10 +1301,11 @@ # throughput_capacity: 1, # required # weekly_maintenance_start_time: "WeeklyTime", # daily_automatic_backup_start_time: "DailyTime", # automatic_backup_retention_days: 1, # copy_tags_to_backups: false, + # aliases: ["AlternateDNSName"], # }, # lustre_configuration: { # weekly_maintenance_start_time: "WeeklyTime", # import_path: "ArchivePath", # export_path: "ArchivePath", @@ -1259,10 +1358,13 @@ # resp.file_system.windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.file_system.windows_configuration.weekly_maintenance_start_time #=> String # resp.file_system.windows_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.windows_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.windows_configuration.copy_tags_to_backups #=> Boolean + # resp.file_system.windows_configuration.aliases #=> Array + # resp.file_system.windows_configuration.aliases[0].name #=> String + # resp.file_system.windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.file_system.lustre_configuration.weekly_maintenance_start_time #=> String # resp.file_system.lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.file_system.lustre_configuration.data_repository_configuration.import_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.export_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -1274,11 +1376,11 @@ # resp.file_system.lustre_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.lustre_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.lustre_configuration.copy_tags_to_backups #=> Boolean # resp.file_system.lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.file_system.administrative_actions #=> Array - # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.file_system.administrative_actions[0].progress_percent #=> Integer # resp.file_system.administrative_actions[0].request_time #=> Time # resp.file_system.administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.file_system.administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.file_system.administrative_actions[0].failure_details.message #=> String @@ -1575,11 +1677,11 @@ # # resp.backups #=> Array # resp.backups[0].backup_id #=> String # resp.backups[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "TRANSFERRING", "DELETED", "FAILED" # resp.backups[0].failure_details.message #=> String - # resp.backups[0].type #=> String, one of "AUTOMATIC", "USER_INITIATED" + # resp.backups[0].type #=> String, one of "AUTOMATIC", "USER_INITIATED", "AWS_BACKUP" # resp.backups[0].progress_percent #=> Integer # resp.backups[0].creation_time #=> Time # resp.backups[0].kms_key_id #=> String # resp.backups[0].resource_arn #=> String # resp.backups[0].tags #=> Array @@ -1620,10 +1722,13 @@ # resp.backups[0].file_system.windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.backups[0].file_system.windows_configuration.weekly_maintenance_start_time #=> String # resp.backups[0].file_system.windows_configuration.daily_automatic_backup_start_time #=> String # resp.backups[0].file_system.windows_configuration.automatic_backup_retention_days #=> Integer # resp.backups[0].file_system.windows_configuration.copy_tags_to_backups #=> Boolean + # resp.backups[0].file_system.windows_configuration.aliases #=> Array + # resp.backups[0].file_system.windows_configuration.aliases[0].name #=> String + # resp.backups[0].file_system.windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.backups[0].file_system.lustre_configuration.weekly_maintenance_start_time #=> String # resp.backups[0].file_system.lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.backups[0].file_system.lustre_configuration.data_repository_configuration.import_path #=> String # resp.backups[0].file_system.lustre_configuration.data_repository_configuration.export_path #=> String # resp.backups[0].file_system.lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -1635,11 +1740,11 @@ # resp.backups[0].file_system.lustre_configuration.daily_automatic_backup_start_time #=> String # resp.backups[0].file_system.lustre_configuration.automatic_backup_retention_days #=> Integer # resp.backups[0].file_system.lustre_configuration.copy_tags_to_backups #=> Boolean # resp.backups[0].file_system.lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.backups[0].file_system.administrative_actions #=> Array - # resp.backups[0].file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.backups[0].file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.backups[0].file_system.administrative_actions[0].progress_percent #=> Integer # resp.backups[0].file_system.administrative_actions[0].request_time #=> Time # resp.backups[0].file_system.administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.backups[0].file_system.administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.backups[0].file_system.administrative_actions[0].failure_details.message #=> String @@ -1745,10 +1850,74 @@ def describe_data_repository_tasks(params = {}, options = {}) req = build_request(:describe_data_repository_tasks, params) req.send_request(options) end + # Returns the DNS aliases that are associated with the specified Amazon + # FSx for Windows File Server file system. A history of all DNS aliases + # that have been associated with and disassociated from the file system + # is available in the list of AdministrativeAction provided in the + # DescribeFileSystems operation response. + # + # @option params [String] :client_request_token + # (Optional) An idempotency token for resource creation, in a string of + # up to 64 ASCII characters. This token is automatically filled on your + # behalf when you use the AWS Command Line Interface (AWS CLI) or an AWS + # SDK. + # + # **A suitable default value is auto-generated.** You should normally + # not need to pass this option.** + # + # @option params [required, String] :file_system_id + # The ID of the file system to return the associated DNS aliases for + # (String). + # + # @option params [Integer] :max_results + # Maximum number of DNS aliases to return in the response (integer). + # This parameter value must be greater than 0. The number of items that + # Amazon FSx returns is the minimum of the `MaxResults` parameter + # specified in the request and the service's internal maximum number of + # items per page. + # + # @option params [String] :next_token + # Opaque pagination token returned from a previous + # `DescribeFileSystemAliases` operation (String). If a token is included + # in the request, the action continues the list from where the previous + # returning call left off. + # + # @return [Types::DescribeFileSystemAliasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::DescribeFileSystemAliasesResponse#aliases #aliases} => Array&lt;Types::Alias&gt; + # * {Types::DescribeFileSystemAliasesResponse#next_token #next_token} => String + # + # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. + # + # @example Request syntax with placeholder values + # + # resp = client.describe_file_system_aliases({ + # client_request_token: "ClientRequestToken", + # file_system_id: "FileSystemId", # required + # max_results: 1, + # next_token: "NextToken", + # }) + # + # @example Response structure + # + # resp.aliases #=> Array + # resp.aliases[0].name #=> String + # resp.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" + # resp.next_token #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DescribeFileSystemAliases AWS API Documentation + # + # @overload describe_file_system_aliases(params = {}) + # @param [Hash] params ({}) + def describe_file_system_aliases(params = {}, options = {}) + req = build_request(:describe_file_system_aliases, params) + req.send_request(options) + end + # Returns the description of specific Amazon FSx file systems, if a # `FileSystemIds` value is provided for that file system. Otherwise, it # returns descriptions of all file systems owned by your AWS account in # the AWS Region of the endpoint that you're calling. # @@ -1887,10 +2056,13 @@ # resp.file_systems[0].windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.file_systems[0].windows_configuration.weekly_maintenance_start_time #=> String # resp.file_systems[0].windows_configuration.daily_automatic_backup_start_time #=> String # resp.file_systems[0].windows_configuration.automatic_backup_retention_days #=> Integer # resp.file_systems[0].windows_configuration.copy_tags_to_backups #=> Boolean + # resp.file_systems[0].windows_configuration.aliases #=> Array + # resp.file_systems[0].windows_configuration.aliases[0].name #=> String + # resp.file_systems[0].windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.file_systems[0].lustre_configuration.weekly_maintenance_start_time #=> String # resp.file_systems[0].lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.file_systems[0].lustre_configuration.data_repository_configuration.import_path #=> String # resp.file_systems[0].lustre_configuration.data_repository_configuration.export_path #=> String # resp.file_systems[0].lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -1902,11 +2074,11 @@ # resp.file_systems[0].lustre_configuration.daily_automatic_backup_start_time #=> String # resp.file_systems[0].lustre_configuration.automatic_backup_retention_days #=> Integer # resp.file_systems[0].lustre_configuration.copy_tags_to_backups #=> Boolean # resp.file_systems[0].lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.file_systems[0].administrative_actions #=> Array - # resp.file_systems[0].administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.file_systems[0].administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.file_systems[0].administrative_actions[0].progress_percent #=> Integer # resp.file_systems[0].administrative_actions[0].request_time #=> Time # resp.file_systems[0].administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.file_systems[0].administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.file_systems[0].administrative_actions[0].failure_details.message #=> String @@ -1919,10 +2091,68 @@ def describe_file_systems(params = {}, options = {}) req = build_request(:describe_file_systems, params) req.send_request(options) end + # Use this action to disassociate, or remove, one or more Domain Name + # Service (DNS) aliases from an Amazon FSx for Windows File Server file + # system. If you attempt to disassociate a DNS alias that is not + # associated with the file system, Amazon FSx responds with a 400 Bad + # Request. For more information, see [Working with DNS Aliases][1]. + # + # The system generated response showing the DNS aliases that Amazon FSx + # is attempting to disassociate from the file system. Use the API + # operation to monitor the status of the aliases Amazon FSx is + # disassociating with the file system. + # + # + # + # [1]: https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-dns-aliases.html + # + # @option params [String] :client_request_token + # (Optional) An idempotency token for resource creation, in a string of + # up to 64 ASCII characters. This token is automatically filled on your + # behalf when you use the AWS Command Line Interface (AWS CLI) or an AWS + # SDK. + # + # **A suitable default value is auto-generated.** You should normally + # not need to pass this option.** + # + # @option params [required, String] :file_system_id + # Specifies the file system from which to disassociate the DNS aliases. + # + # @option params [required, Array<String>] :aliases + # An array of one or more DNS alias names to disassociate, or remove, + # from the file system. + # + # @return [Types::DisassociateFileSystemAliasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::DisassociateFileSystemAliasesResponse#aliases #aliases} => Array&lt;Types::Alias&gt; + # + # @example Request syntax with placeholder values + # + # resp = client.disassociate_file_system_aliases({ + # client_request_token: "ClientRequestToken", + # file_system_id: "FileSystemId", # required + # aliases: ["AlternateDNSName"], # required + # }) + # + # @example Response structure + # + # resp.aliases #=> Array + # resp.aliases[0].name #=> String + # resp.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" + # + # @see http://docs.aws.amazon.com/goto/WebAPI/fsx-2018-03-01/DisassociateFileSystemAliases AWS API Documentation + # + # @overload disassociate_file_system_aliases(params = {}) + # @param [Hash] params ({}) + def disassociate_file_system_aliases(params = {}, options = {}) + req = build_request(:disassociate_file_system_aliases, params) + req.send_request(options) + end + # Lists tags for an Amazon FSx file systems and backups in the case of # Amazon FSx for Windows File Server. # # When retrieving all tags, you can optionally specify the `MaxResults` # parameter to limit the number of tags in a response. If more tags @@ -2269,10 +2499,13 @@ # resp.file_system.windows_configuration.maintenance_operations_in_progress[0] #=> String, one of "PATCHING", "BACKING_UP" # resp.file_system.windows_configuration.weekly_maintenance_start_time #=> String # resp.file_system.windows_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.windows_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.windows_configuration.copy_tags_to_backups #=> Boolean + # resp.file_system.windows_configuration.aliases #=> Array + # resp.file_system.windows_configuration.aliases[0].name #=> String + # resp.file_system.windows_configuration.aliases[0].lifecycle #=> String, one of "AVAILABLE", "CREATING", "DELETING", "CREATE_FAILED", "DELETE_FAILED" # resp.file_system.lustre_configuration.weekly_maintenance_start_time #=> String # resp.file_system.lustre_configuration.data_repository_configuration.lifecycle #=> String, one of "CREATING", "AVAILABLE", "MISCONFIGURED", "UPDATING", "DELETING" # resp.file_system.lustre_configuration.data_repository_configuration.import_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.export_path #=> String # resp.file_system.lustre_configuration.data_repository_configuration.imported_file_chunk_size #=> Integer @@ -2284,11 +2517,11 @@ # resp.file_system.lustre_configuration.daily_automatic_backup_start_time #=> String # resp.file_system.lustre_configuration.automatic_backup_retention_days #=> Integer # resp.file_system.lustre_configuration.copy_tags_to_backups #=> Boolean # resp.file_system.lustre_configuration.drive_cache_type #=> String, one of "NONE", "READ" # resp.file_system.administrative_actions #=> Array - # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION" + # resp.file_system.administrative_actions[0].administrative_action_type #=> String, one of "FILE_SYSTEM_UPDATE", "STORAGE_OPTIMIZATION", "FILE_SYSTEM_ALIAS_ASSOCIATION", "FILE_SYSTEM_ALIAS_DISASSOCIATION" # resp.file_system.administrative_actions[0].progress_percent #=> Integer # resp.file_system.administrative_actions[0].request_time #=> Time # resp.file_system.administrative_actions[0].status #=> String, one of "FAILED", "IN_PROGRESS", "PENDING", "COMPLETED", "UPDATED_OPTIMIZING" # resp.file_system.administrative_actions[0].target_file_system_values #=> Types::FileSystem # resp.file_system.administrative_actions[0].failure_details.message #=> String @@ -2313,10 +2546,10 @@ operation: config.api.operation(operation_name), client: self, params: params, config: config) context[:gem_name] = 'aws-sdk-fsx' - context[:gem_version] = '1.31.0' + context[:gem_version] = '1.32.0' Seahorse::Client::Request.new(handlers, context) end # @api private # @deprecated