From 57954c376287dfa6ea9afd317dc5c25b74d905ae Mon Sep 17 00:00:00 2001 From: AWS SDK for Go v2 automation user Date: Mon, 4 Mar 2024 19:15:59 +0000 Subject: [PATCH] Regenerated Clients --- .../1367452cc1ad4e7c90d825184d6e5b40.json | 8 ++ .../c211fa8fea714bdeb522d50514c4e81f.json | 8 ++ .../f864dd4525754476928348e14081585f.json | 8 ++ .../cloudformation/api_op_CreateChangeSet.go | 5 +- service/cloudformation/api_op_CreateStack.go | 11 +-- .../api_op_EstimateTemplateCost.go | 5 +- .../api_op_GetTemplateSummary.go | 5 +- .../cloudformation/api_op_SetStackPolicy.go | 5 +- .../api_op_SetTypeConfiguration.go | 13 +-- service/cloudformation/api_op_UpdateStack.go | 20 +++-- .../cloudformation/api_op_ValidateTemplate.go | 5 +- service/cloudformation/deserializers.go | 26 ++++++ service/cloudformation/types/enums.go | 20 +++++ service/cloudformation/types/types.go | 72 +++++++++++---- service/fsx/api_op_CreateFileSystem.go | 8 +- .../fsx/api_op_CreateStorageVirtualMachine.go | 12 +-- .../api_op_DescribeSharedVpcConfiguration.go | 4 +- service/fsx/api_op_DescribeSnapshots.go | 6 +- service/fsx/types/types.go | 88 +++++++++++-------- service/organizations/types/types.go | 17 ++-- 20 files changed, 238 insertions(+), 108 deletions(-) create mode 100644 .changelog/1367452cc1ad4e7c90d825184d6e5b40.json create mode 100644 .changelog/c211fa8fea714bdeb522d50514c4e81f.json create mode 100644 .changelog/f864dd4525754476928348e14081585f.json diff --git a/.changelog/1367452cc1ad4e7c90d825184d6e5b40.json b/.changelog/1367452cc1ad4e7c90d825184d6e5b40.json new file mode 100644 index 00000000000..26418761ef0 --- /dev/null +++ b/.changelog/1367452cc1ad4e7c90d825184d6e5b40.json @@ -0,0 +1,8 @@ +{ + "id": "1367452c-c1ad-4e7c-90d8-25184d6e5b40", + "type": "feature", + "description": "Documentation update for AWS Organizations", + "modules": [ + "service/organizations" + ] +} \ No newline at end of file diff --git a/.changelog/c211fa8fea714bdeb522d50514c4e81f.json b/.changelog/c211fa8fea714bdeb522d50514c4e81f.json new file mode 100644 index 00000000000..89aac5b3db8 --- /dev/null +++ b/.changelog/c211fa8fea714bdeb522d50514c4e81f.json @@ -0,0 +1,8 @@ +{ + "id": "c211fa8f-ea71-4bde-b522-d50514c4e81f", + "type": "feature", + "description": "Add DetailedStatus field to DescribeStackEvents and DescribeStacks APIs", + "modules": [ + "service/cloudformation" + ] +} \ No newline at end of file diff --git a/.changelog/f864dd4525754476928348e14081585f.json b/.changelog/f864dd4525754476928348e14081585f.json new file mode 100644 index 00000000000..45e8dc24e43 --- /dev/null +++ b/.changelog/f864dd4525754476928348e14081585f.json @@ -0,0 +1,8 @@ +{ + "id": "f864dd45-2575-4476-9283-48e14081585f", + "type": "feature", + "description": "Added support for creating FSx for NetApp ONTAP file systems with up to 12 HA pairs, delivering up to 72 GB/s of read throughput and 12 GB/s of write throughput.", + "modules": [ + "service/fsx" + ] +} \ No newline at end of file diff --git a/service/cloudformation/api_op_CreateChangeSet.go b/service/cloudformation/api_op_CreateChangeSet.go index dd56b311cc8..50d1be62587 100644 --- a/service/cloudformation/api_op_CreateChangeSet.go +++ b/service/cloudformation/api_op_CreateChangeSet.go @@ -213,8 +213,9 @@ type CreateChangeSetInput struct { // The location of the file that contains the revised template. The URL must point // to a template (max size: 460,800 bytes) that's located in an Amazon S3 bucket or // a Systems Manager document. CloudFormation generates the change set by comparing - // this template with the stack that you specified. Conditional: You must specify - // only TemplateBody or TemplateURL . + // this template with the stack that you specified. The location for an Amazon S3 + // bucket must start with https:// . Conditional: You must specify only + // TemplateBody or TemplateURL . TemplateURL *string // Whether to reuse the template that's associated with the stack to create the diff --git a/service/cloudformation/api_op_CreateStack.go b/service/cloudformation/api_op_CreateStack.go index 495812b4085..2193f42cf65 100644 --- a/service/cloudformation/api_op_CreateStack.go +++ b/service/cloudformation/api_op_CreateStack.go @@ -55,7 +55,7 @@ type CreateStackInput struct { // an InsufficientCapabilities error. If your stack template contains these // resources, we recommend that you review all permissions associated with them and // edit their permissions if necessary. - // - AWS::IAM::AccessKey (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html) + // - AWS::IAM::AccessKey AWS::IAM::AccessKey (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-accesskey.html) // - AWS::IAM::Group (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-group.html) // - AWS::IAM::InstanceProfile (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-instanceprofile.html) // - AWS::IAM::Policy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-iam-policy.html) @@ -175,8 +175,8 @@ type CreateStackInput struct { // Location of a file containing the stack policy. The URL must point to a policy // (maximum size: 16 KB) located in an S3 bucket in the same Region as the stack. - // You can specify either the StackPolicyBody or the StackPolicyURL parameter, but - // not both. + // The location for an Amazon S3 bucket must start with https:// . You can specify + // either the StackPolicyBody or the StackPolicyURL parameter, but not both. StackPolicyURL *string // Key-value pairs to associate with this stack. CloudFormation also propagates @@ -193,8 +193,9 @@ type CreateStackInput struct { // Location of file containing the template body. The URL must point to a template // (max size: 460,800 bytes) that's located in an Amazon S3 bucket or a Systems // Manager document. For more information, go to the Template anatomy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) - // in the CloudFormation User Guide. Conditional: You must specify either the - // TemplateBody or the TemplateURL parameter, but not both. + // in the CloudFormation User Guide. The location for an Amazon S3 bucket must + // start with https:// . Conditional: You must specify either the TemplateBody or + // the TemplateURL parameter, but not both. TemplateURL *string // The amount of time that can pass before the stack status becomes CREATE_FAILED ; diff --git a/service/cloudformation/api_op_EstimateTemplateCost.go b/service/cloudformation/api_op_EstimateTemplateCost.go index 7015c0c4e84..704af514706 100644 --- a/service/cloudformation/api_op_EstimateTemplateCost.go +++ b/service/cloudformation/api_op_EstimateTemplateCost.go @@ -44,8 +44,9 @@ type EstimateTemplateCostInput struct { // Location of file containing the template body. The URL must point to a template // that's located in an Amazon S3 bucket or a Systems Manager document. For more // information, go to Template Anatomy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) - // in the CloudFormation User Guide. Conditional: You must pass TemplateURL or - // TemplateBody . If both are passed, only TemplateBody is used. + // in the CloudFormation User Guide. The location for an Amazon S3 bucket must + // start with https:// . Conditional: You must pass TemplateURL or TemplateBody . + // If both are passed, only TemplateBody is used. TemplateURL *string noSmithyDocumentSerde diff --git a/service/cloudformation/api_op_GetTemplateSummary.go b/service/cloudformation/api_op_GetTemplateSummary.go index dfb57e48c0f..481256fd379 100644 --- a/service/cloudformation/api_op_GetTemplateSummary.go +++ b/service/cloudformation/api_op_GetTemplateSummary.go @@ -74,8 +74,9 @@ type GetTemplateSummaryInput struct { // Location of file containing the template body. The URL must point to a template // (max size: 460,800 bytes) that's located in an Amazon S3 bucket or a Systems // Manager document. For more information about templates, see Template anatomy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) - // in the CloudFormation User Guide. Conditional: You must specify only one of the - // following parameters: StackName , StackSetName , TemplateBody , or TemplateURL . + // in the CloudFormation User Guide. The location for an Amazon S3 bucket must + // start with https:// . Conditional: You must specify only one of the following + // parameters: StackName , StackSetName , TemplateBody , or TemplateURL . TemplateURL *string noSmithyDocumentSerde diff --git a/service/cloudformation/api_op_SetStackPolicy.go b/service/cloudformation/api_op_SetStackPolicy.go index 333b2d033e9..c04c4910350 100644 --- a/service/cloudformation/api_op_SetStackPolicy.go +++ b/service/cloudformation/api_op_SetStackPolicy.go @@ -42,8 +42,9 @@ type SetStackPolicyInput struct { // Location of a file containing the stack policy. The URL must point to a policy // (maximum size: 16 KB) located in an Amazon S3 bucket in the same Amazon Web - // Services Region as the stack. You can specify either the StackPolicyBody or the - // StackPolicyURL parameter, but not both. + // Services Region as the stack. The location for an Amazon S3 bucket must start + // with https:// . You can specify either the StackPolicyBody or the StackPolicyURL + // parameter, but not both. StackPolicyURL *string noSmithyDocumentSerde diff --git a/service/cloudformation/api_op_SetTypeConfiguration.go b/service/cloudformation/api_op_SetTypeConfiguration.go index d4a52d09e5d..296d3935cf6 100644 --- a/service/cloudformation/api_op_SetTypeConfiguration.go +++ b/service/cloudformation/api_op_SetTypeConfiguration.go @@ -57,12 +57,13 @@ type SetTypeConfigurationInput struct { Type types.ThirdPartyType // The Amazon Resource Name (ARN) for the extension, in this account and Region. - // For public extensions, this will be the ARN assigned when you activate the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) - // in this account and Region. For private extensions, this will be the ARN - // assigned when you register the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) - // in this account and Region. Do not include the extension versions suffix at the - // end of the ARN. You can set the configuration for an extension, but not for a - // specific extension version. + // For public extensions, this will be the ARN assigned when you call the + // ActivateType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) + // API operation in this account and Region. For private extensions, this will be + // the ARN assigned when you call the RegisterType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) + // API operation in this account and Region. Do not include the extension versions + // suffix at the end of the ARN. You can set the configuration for an extension, + // but not for a specific extension version. TypeArn *string // The name of the extension. Conditional: You must specify ConfigurationArn , or diff --git a/service/cloudformation/api_op_UpdateStack.go b/service/cloudformation/api_op_UpdateStack.go index faeb7ff119a..68fccd3e365 100644 --- a/service/cloudformation/api_op_UpdateStack.go +++ b/service/cloudformation/api_op_UpdateStack.go @@ -165,8 +165,9 @@ type UpdateStackInput struct { // Location of a file containing the temporary overriding stack policy. The URL // must point to a policy (max size: 16KB) located in an S3 bucket in the same - // Region as the stack. You can specify either the StackPolicyDuringUpdateBody or - // the StackPolicyDuringUpdateURL parameter, but not both. If you want to update + // Region as the stack. The location for an Amazon S3 bucket must start with + // https:// . You can specify either the StackPolicyDuringUpdateBody or the + // StackPolicyDuringUpdateURL parameter, but not both. If you want to update // protected resources, specify a temporary overriding stack policy during this // update. If you don't specify a stack policy, the current policy that is // associated with the stack will be used. @@ -174,10 +175,11 @@ type UpdateStackInput struct { // Location of a file containing the updated stack policy. The URL must point to a // policy (max size: 16KB) located in an S3 bucket in the same Region as the stack. - // You can specify either the StackPolicyBody or the StackPolicyURL parameter, but - // not both. You might update the stack policy, for example, in order to protect a - // new resource that you created during a stack update. If you don't specify a - // stack policy, the current policy that is associated with the stack is unchanged. + // The location for an Amazon S3 bucket must start with https:// . You can specify + // either the StackPolicyBody or the StackPolicyURL parameter, but not both. You + // might update the stack policy, for example, in order to protect a new resource + // that you created during a stack update. If you don't specify a stack policy, the + // current policy that is associated with the stack is unchanged. StackPolicyURL *string // Key-value pairs to associate with this stack. CloudFormation also propagates @@ -197,9 +199,9 @@ type UpdateStackInput struct { // Location of file containing the template body. The URL must point to a template // that's located in an Amazon S3 bucket or a Systems Manager document. For more // information, go to Template Anatomy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) - // in the CloudFormation User Guide. Conditional: You must specify only one of the - // following parameters: TemplateBody , TemplateURL , or set the - // UsePreviousTemplate to true . + // in the CloudFormation User Guide. The location for an Amazon S3 bucket must + // start with https:// . Conditional: You must specify only one of the following + // parameters: TemplateBody , TemplateURL , or set the UsePreviousTemplate to true . TemplateURL *string // Reuse the existing template that is associated with the stack that you are diff --git a/service/cloudformation/api_op_ValidateTemplate.go b/service/cloudformation/api_op_ValidateTemplate.go index 25d59ab9f93..a2c44208771 100644 --- a/service/cloudformation/api_op_ValidateTemplate.go +++ b/service/cloudformation/api_op_ValidateTemplate.go @@ -41,8 +41,9 @@ type ValidateTemplateInput struct { // Location of file containing the template body. The URL must point to a template // (max size: 460,800 bytes) that is located in an Amazon S3 bucket or a Systems // Manager document. For more information, go to Template Anatomy (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-anatomy.html) - // in the CloudFormation User Guide. Conditional: You must pass TemplateURL or - // TemplateBody . If both are passed, only TemplateBody is used. + // in the CloudFormation User Guide. The location for an Amazon S3 bucket must + // start with https:// . Conditional: You must pass TemplateURL or TemplateBody . + // If both are passed, only TemplateBody is used. TemplateURL *string noSmithyDocumentSerde diff --git a/service/cloudformation/deserializers.go b/service/cloudformation/deserializers.go index d48bceb4577..32fcd84815c 100644 --- a/service/cloudformation/deserializers.go +++ b/service/cloudformation/deserializers.go @@ -15825,6 +15825,19 @@ func awsAwsquery_deserializeDocumentStack(v **types.Stack, decoder smithyxml.Nod sv.Description = ptr.String(xtv) } + case strings.EqualFold("DetailedStatus", t.Name.Local): + val, err := decoder.Value() + if err != nil { + return err + } + if val == nil { + break + } + { + xtv := string(val) + sv.DetailedStatus = types.DetailedStatus(xtv) + } + case strings.EqualFold("DisableRollback", t.Name.Local): val, err := decoder.Value() if err != nil { @@ -16215,6 +16228,19 @@ func awsAwsquery_deserializeDocumentStackEvent(v **types.StackEvent, decoder smi sv.ClientRequestToken = ptr.String(xtv) } + case strings.EqualFold("DetailedStatus", t.Name.Local): + val, err := decoder.Value() + if err != nil { + return err + } + if val == nil { + break + } + { + xtv := string(val) + sv.DetailedStatus = types.DetailedStatus(xtv) + } + case strings.EqualFold("EventId", t.Name.Local): val, err := decoder.Value() if err != nil { diff --git a/service/cloudformation/types/enums.go b/service/cloudformation/types/enums.go index 15491283e13..b26dd48cfce 100644 --- a/service/cloudformation/types/enums.go +++ b/service/cloudformation/types/enums.go @@ -274,6 +274,24 @@ func (DeprecatedStatus) Values() []DeprecatedStatus { } } +type DetailedStatus string + +// Enum values for DetailedStatus +const ( + DetailedStatusConfigurationComplete DetailedStatus = "CONFIGURATION_COMPLETE" + DetailedStatusValidationFailed DetailedStatus = "VALIDATION_FAILED" +) + +// Values returns all known values for DetailedStatus. Note that this can be +// expanded in the future, and so it is only as up to date as the client. The +// ordering of this slice is not guaranteed to be stable across updates. +func (DetailedStatus) Values() []DetailedStatus { + return []DetailedStatus{ + "CONFIGURATION_COMPLETE", + "VALIDATION_FAILED", + } +} + type DifferenceType string // Enum values for DifferenceType @@ -1004,6 +1022,7 @@ const ( StackInstanceDetailedStatusCancelled StackInstanceDetailedStatus = "CANCELLED" StackInstanceDetailedStatusInoperable StackInstanceDetailedStatus = "INOPERABLE" StackInstanceDetailedStatusSkippedSuspendedAccount StackInstanceDetailedStatus = "SKIPPED_SUSPENDED_ACCOUNT" + StackInstanceDetailedStatusFailedImport StackInstanceDetailedStatus = "FAILED_IMPORT" ) // Values returns all known values for StackInstanceDetailedStatus. Note that this @@ -1018,6 +1037,7 @@ func (StackInstanceDetailedStatus) Values() []StackInstanceDetailedStatus { "CANCELLED", "INOPERABLE", "SKIPPED_SUSPENDED_ACCOUNT", + "FAILED_IMPORT", } } diff --git a/service/cloudformation/types/types.go b/service/cloudformation/types/types.go index f4ce2fe78cd..cf245ee58d0 100644 --- a/service/cloudformation/types/types.go +++ b/service/cloudformation/types/types.go @@ -651,7 +651,7 @@ type ResourceDefinition struct { ResourceIdentifier map[string]string // The type of the resource, such as AWS::DynamoDB::Table . For the list of - // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html) + // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) // in the CloudFormation User Guide // // This member is required. @@ -691,7 +691,7 @@ type ResourceDetail struct { ResourceStatusReason *string // The type of the resource, such as AWS::DynamoDB::Table . For the list of - // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html) + // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) // In the CloudFormation User Guide ResourceType *string @@ -883,7 +883,7 @@ type ScannedResource struct { ResourceIdentifier map[string]string // The type of the resource, such as AWS::DynamoDB::Table . For the list of - // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html) + // supported resources, see Resource type support (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) // In the CloudFormation User Guide ResourceType *string @@ -908,8 +908,8 @@ type ScannedResourceIdentifier struct { ResourceIdentifier map[string]string // The type of the resource, such as AWS::DynamoDB::Table . For the list of - // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/generate-IaC-supported-resources.html) - // In the CloudFormation User Guide + // supported resources, see IaC generator supported resource types (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html) + // In the CloudFormation User Guide. // // This member is required. ResourceType *string @@ -947,6 +947,14 @@ type Stack struct { // A user-defined description associated with the stack. Description *string + // The detailed status of the resource or stack. If CONFIGURATION_COMPLETE is + // present, the resource or resource configuration phase has completed and the + // stabilization of the resources is in progress. The stack sets + // CONFIGURATION_COMPLETE when all of the resources in the stack have reached that + // event. For more information, see CloudFormation stack deployment (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html) + // in the CloudFormation User Guide. + DetailedStatus DetailedStatus + // Boolean to enable or disable rollback on stack creation failures: // - true : disable rollback. // - false : enable rollback. @@ -1112,6 +1120,17 @@ type StackEvent struct { // Console-CreateStack-7f59c3cf-00d2-40c7-b2ff-e75db0987002 . ClientRequestToken *string + // An optional field containing information about the detailed status of the stack + // event. + // - CONFIGURATION_COMPLETE - all of the resources in the stack have reached that + // event. For more information, see CloudFormation stack deployment (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stack-resource-configuration-complete.html) + // in the CloudFormation User Guide. + // + // - VALIDATION_FAILED - template validation failed because of invalid properties + // in the template. The ResourceStatusReason field shows what properties are + // defined incorrectly. + DetailedStatus DetailedStatus + // Specify the hook failure mode for non-compliant resources in the followings // ways. // - FAIL Stops provisioning resources. @@ -1217,7 +1236,11 @@ type StackInstance struct { // in an unstable state. Stacks in this state are excluded from further // UpdateStackSet operations. You might need to perform a DeleteStackInstances // operation, with RetainStacks set to true , to delete the stack instance, and - // then delete the stack manually. + // then delete the stack manually. INOPERABLE can be returned here when the cause + // is a failed import. If it's due to a failed import, the operation can be retried + // once the failures are fixed. To see if this is due to a failed import, look at + // the DetailedStatus member in the StackInstanceSummary member that is a peer to + // this Status member. // - OUTDATED : The stack isn't currently up to date with the stack set because: // - The associated stack failed during a CreateStackSet or UpdateStackSet // operation. @@ -1242,6 +1265,11 @@ type StackInstanceComprehensiveStatus struct { // - FAILED : The operation in the specified account and Region failed. If the // stack set operation fails in enough accounts within a Region, the failure // tolerance for the stack set operation as a whole might be exceeded. + // - FAILED_IMPORT : The import of the stack instance in the specified account + // and Region failed and left the stack in an unstable state. Once the issues + // causing the failure are fixed, the import operation can be retried. If enough + // stack set operations fail in enough accounts within a Region, the failure + // tolerance for the stack set operation as a whole might be exceeded. // - INOPERABLE : A DeleteStackInstances operation has failed and left the stack // in an unstable state. Stacks in this state are excluded from further // UpdateStackSet operations. You might need to perform a DeleteStackInstances @@ -1383,7 +1411,11 @@ type StackInstanceSummary struct { // in an unstable state. Stacks in this state are excluded from further // UpdateStackSet operations. You might need to perform a DeleteStackInstances // operation, with RetainStacks set to true , to delete the stack instance, and - // then delete the stack manually. + // then delete the stack manually. INOPERABLE can be returned here when the cause + // is a failed import. If it's due to a failed import, the operation can be retried + // once the failures are fixed. To see if this is due to a failed import, call the + // DescribeStackInstance API operation, look at the DetailedStatus member + // returned in the StackInstanceSummary member. // - OUTDATED : The stack isn't currently up to date with the stack set because: // - The associated stack failed during a CreateStackSet or UpdateStackSet // operation. @@ -2396,10 +2428,11 @@ type TypeConfigurationDetails struct { LastUpdated *time.Time // The Amazon Resource Name (ARN) for the extension, in this account and Region. - // For public extensions, this will be the ARN assigned when you activate the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) - // in this account and Region. For private extensions, this will be the ARN - // assigned when you register the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) - // in this account and Region. + // For public extensions, this will be the ARN assigned when you call the + // ActivateType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) + // API operation in this account and Region. For private extensions, this will be + // the ARN assigned when you call the RegisterType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) + // API operation in this account and Region. TypeArn *string // The name of the extension. @@ -2415,10 +2448,11 @@ type TypeConfigurationIdentifier struct { Type ThirdPartyType // The Amazon Resource Name (ARN) for the extension, in this account and Region. - // For public extensions, this will be the ARN assigned when you activate the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) - // in this account and Region. For private extensions, this will be the ARN - // assigned when you register the type (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) - // in this account and Region. + // For public extensions, this will be the ARN assigned when you call the + // ActivateType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) + // API operation in this account and Region. For private extensions, this will be + // the ARN assigned when you call the RegisterType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_RegisterType.html) + // API operation in this account and Region. TypeArn *string // The alias specified for this configuration, if one was specified when the @@ -2538,10 +2572,10 @@ type TypeSummary struct { // The Amazon Resource Name (ARN) of the extension. TypeArn *string - // The name of the extension. If you specified a TypeNameAlias when you activate - // this extension (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) - // in your account and Region, CloudFormation considers that alias as the type - // name. + // The name of the extension. If you specified a TypeNameAlias when you call the + // ActivateType (https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ActivateType.html) + // API operation in your account and Region, CloudFormation considers that alias as + // the type name. TypeName *string noSmithyDocumentSerde diff --git a/service/fsx/api_op_CreateFileSystem.go b/service/fsx/api_op_CreateFileSystem.go index 91872b6d06d..892aacdcde4 100644 --- a/service/fsx/api_op_CreateFileSystem.go +++ b/service/fsx/api_op_CreateFileSystem.go @@ -79,8 +79,8 @@ type CreateFileSystemInput struct { // increments of 3600 GiB. // FSx for ONTAP file systems - The amount of storage capacity that you can // configure depends on the value of the HAPairs property. The minimum value is - // calculated as 1,024 * HAPairs and the maxium is calculated as 524,288 * HAPairs - // .. FSx for OpenZFS file systems - The amount of storage capacity that you can + // calculated as 1,024 * HAPairs and the maximum is calculated as 524,288 * HAPairs + // . FSx for OpenZFS file systems - The amount of storage capacity that you can // configure is from 64 GiB up to 524,288 GiB (512 TiB). FSx for Windows File // Server file systems - The amount of storage capacity that you can configure // depends on the value that you set for StorageType as follows: @@ -152,7 +152,9 @@ type CreateFileSystemInput struct { // A list of IDs specifying the security groups to apply to all network interfaces // created for file system access. This list isn't returned in later requests to - // describe the file system. + // describe the file system. You must specify a security group if you are creating + // a Multi-AZ FSx for ONTAP file system in a VPC subnet that has been shared with + // you. SecurityGroupIds []string // Sets the storage type for the file system that you're creating. Valid values diff --git a/service/fsx/api_op_CreateStorageVirtualMachine.go b/service/fsx/api_op_CreateStorageVirtualMachine.go index 548f15b02eb..4ca17cff480 100644 --- a/service/fsx/api_op_CreateStorageVirtualMachine.go +++ b/service/fsx/api_op_CreateStorageVirtualMachine.go @@ -41,7 +41,7 @@ type CreateStorageVirtualMachineInput struct { // Describes the self-managed Microsoft Active Directory to which you want to join // the SVM. Joining an Active Directory provides user authentication and access - // control for SMB clients, including Microsoft Windows and macOS client accessing + // control for SMB clients, including Microsoft Windows and macOS clients accessing // the file system. ActiveDirectoryConfiguration *types.CreateSvmActiveDirectoryConfiguration @@ -55,11 +55,11 @@ type CreateStorageVirtualMachineInput struct { // - UNIX if the file system is managed by a UNIX administrator, the majority of // users are NFS clients, and an application accessing the data uses a UNIX user as // the service account. - // - NTFS if the file system is managed by a Windows administrator, the majority - // of users are SMB clients, and an application accessing the data uses a Windows - // user as the service account. - // - MIXED if the file system is managed by both UNIX and Windows administrators - // and users consist of both NFS and SMB clients. + // - NTFS if the file system is managed by a Microsoft Windows administrator, the + // majority of users are SMB clients, and an application accessing the data uses a + // Microsoft Windows user as the service account. + // - MIXED This is an advanced setting. For more information, see Volume + // security style in the Amazon FSx for NetApp ONTAP User Guide. RootVolumeSecurityStyle types.StorageVirtualMachineRootVolumeSecurityStyle // The password to use when managing the SVM using the NetApp ONTAP CLI or REST diff --git a/service/fsx/api_op_DescribeSharedVpcConfiguration.go b/service/fsx/api_op_DescribeSharedVpcConfiguration.go index e2583cabfab..5e63b50c51f 100644 --- a/service/fsx/api_op_DescribeSharedVpcConfiguration.go +++ b/service/fsx/api_op_DescribeSharedVpcConfiguration.go @@ -12,8 +12,8 @@ import ( // Indicates whether participant accounts in your organization can create Amazon // FSx for NetApp ONTAP Multi-AZ file systems in subnets that are shared by a -// virtual private cloud (VPC) owner. For more information, see the Amazon FSx for -// NetApp ONTAP User Guide (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/maz-shared-vpc.html) +// virtual private cloud (VPC) owner. For more information, see Creating FSx for +// ONTAP file systems in shared subnets (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/creating-file-systems.html#fsxn-vpc-shared-subnets) // . func (c *Client) DescribeSharedVpcConfiguration(ctx context.Context, params *DescribeSharedVpcConfigurationInput, optFns ...func(*Options)) (*DescribeSharedVpcConfigurationOutput, error) { if params == nil { diff --git a/service/fsx/api_op_DescribeSnapshots.go b/service/fsx/api_op_DescribeSnapshots.go index 0137e1e6ae2..c6fd2ebc9a0 100644 --- a/service/fsx/api_op_DescribeSnapshots.go +++ b/service/fsx/api_op_DescribeSnapshots.go @@ -49,9 +49,9 @@ type DescribeSnapshotsInput struct { // The filters structure. The supported names are file-system-id or volume-id . Filters []types.SnapshotFilter - // Set to false (default) if you want to only see the snapshots in your Amazon Web - // Services account. Set to true if you want to see the snapshots in your account - // and the ones shared with you from another account. + // Set to false (default) if you want to only see the snapshots owned by your + // Amazon Web Services account. Set to true if you want to see the snapshots in + // your account and the ones shared with you from another account. IncludeShared *bool // The maximum number of resources to return in the response. This value must be diff --git a/service/fsx/types/types.go b/service/fsx/types/types.go index 0e967ab5159..686db0c0575 100644 --- a/service/fsx/types/types.go +++ b/service/fsx/types/types.go @@ -409,8 +409,8 @@ type CompletionReport struct { noSmithyDocumentSerde } -// Used to specify the configuration options for a volume's storage aggregate or -// aggregates. +// Used to specify the configuration options for an FSx for ONTAP volume's storage +// aggregate or aggregates. type CreateAggregateConfiguration struct { // Used to specify the names of aggregates on which the volume will be created. @@ -659,13 +659,14 @@ type CreateFileSystemOntapConfiguration struct { // administer your file system using the NetApp ONTAP CLI and REST API. FsxAdminPassword *string - // Specifies how many high-availability (HA) pairs the file system will have. The - // default value is 1. The value of this property affects the values of - // StorageCapacity , Iops , and ThroughputCapacity . For more information, see - // High-availability (HA) pairs (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/HA-pairs.html) + // Specifies how many high-availability (HA) pairs of file servers will power your + // file system. Scale-up file systems are powered by 1 HA pair. The default value + // is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The + // value of this property affects the values of StorageCapacity , Iops , and + // ThroughputCapacity . For more information, see High-availability (HA) pairs (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/HA-pairs.html) // in the FSx for ONTAP user guide. Amazon FSx responds with an HTTP status code // 400 (Bad Request) for the following conditions: - // - The value of HAPairs is less than 1 or greater than 6. + // - The value of HAPairs is less than 1 or greater than 12. // - The value of HAPairs is greater than 1 and the value of DeploymentType is // SINGLE_AZ_1 or MULTI_AZ_1 . HAPairs *int32 @@ -678,7 +679,11 @@ type CreateFileSystemOntapConfiguration struct { // rules for routing traffic to the correct file server. You should specify all // virtual private cloud (VPC) route tables associated with the subnets in which // your clients are located. By default, Amazon FSx selects your VPC's default - // route table. + // route table. Amazon FSx manages these route tables for Multi-AZ file systems + // using tag-based authentication. These route tables are tagged with Key: + // AmazonFSx; Value: ManagedByAmazonFSx . When creating FSx for ONTAP Multi-AZ file + // systems using CloudFormation we recommend that you add the Key: AmazonFSx; + // Value: ManagedByAmazonFSx tag manually. RouteTableIds []string // Sets the throughput capacity for the file system that you're creating in @@ -693,18 +698,19 @@ type CreateFileSystemOntapConfiguration struct { ThroughputCapacity *int32 // Use to choose the throughput capacity per HA pair, rather than the total - // throughput for the file system. This field and ThroughputCapacity cannot be - // defined in the same API call, but one is required. This field and - // ThroughputCapacity are the same for file systems with one HA pair. - // - For SINGLE_AZ_1 and MULTI_AZ_1 , valid values are 128, 256, 512, 1024, 2048, - // or 4096 MBps. - // - For SINGLE_AZ_2 , valid values are 3072 or 6144 MBps. + // throughput for the file system. You can define either the + // ThroughputCapacityPerHAPair or the ThroughputCapacity when creating a file + // system, but not both. This field and ThroughputCapacity are the same for + // scale-up file systems powered by one HA pair. + // - For SINGLE_AZ_1 and MULTI_AZ_1 file systems, valid values are 128, 256, 512, + // 1024, 2048, or 4096 MBps. + // - For SINGLE_AZ_2 file systems, valid values are 3072 or 6144 MBps. // Amazon FSx responds with an HTTP status code 400 (Bad Request) for the // following conditions: // - The value of ThroughputCapacity and ThroughputCapacityPerHAPair are not the // same value for file systems with one HA pair. // - The value of deployment type is SINGLE_AZ_2 and ThroughputCapacity / - // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 6). + // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 12). // - The value of ThroughputCapacityPerHAPair is not a valid value. ThroughputCapacityPerHAPair *int32 @@ -966,7 +972,7 @@ type CreateOntapVolumeConfiguration struct { // Specifies the security style for the volume. If a volume's security style is // not specified, it is automatically set to the root volume's security style. The // security style determines the type of permissions that FSx for ONTAP uses to - // control data access. For more information, see Volume security style (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-security-style) + // control data access. For more information, see Volume security style (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style) // in the Amazon FSx for NetApp ONTAP User Guide. Specify one of the following // values: // - UNIX if the file system is managed by a UNIX administrator, the majority of @@ -975,14 +981,18 @@ type CreateOntapVolumeConfiguration struct { // - NTFS if the file system is managed by a Windows administrator, the majority // of users are SMB clients, and an application accessing the data uses a Windows // user as the service account. - // - MIXED if the file system is managed by both UNIX and Windows administrators - // and users consist of both NFS and SMB clients. + // - MIXED This is an advanced setting. For more information, see the topic What + // the security styles and their effects are (https://docs.netapp.com/us-en/ontap/nfs-admin/security-styles-their-effects-concept.html) + // in the NetApp Documentation Center. + // For more information, see Volume security style (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style.html) + // in the FSx for ONTAP User Guide. SecurityStyle SecurityStyle - // The configured size of the volume, in bytes. + // Specifies the configured size of the volume, in bytes. SizeInBytes *int64 - // Specifies the size of the volume, in megabytes (MB), that you are creating. + // Use SizeInBytes instead. Specifies the size of the volume, in megabytes (MB), + // that you are creating. // // Deprecated: This property is deprecated, use SizeInBytes instead SizeInMegabytes *int32 @@ -1006,8 +1016,9 @@ type CreateOntapVolumeConfiguration struct { SnapshotPolicy *string // Set to true to enable deduplication, compression, and compaction storage - // efficiency features on the volume, or set to false to disable them. This - // parameter is required. + // efficiency features on the volume, or set to false to disable them. + // StorageEfficiencyEnabled is required when creating a RW volume ( OntapVolumeType + // set to RW ). StorageEfficiencyEnabled *bool // Describes the data tiering policy for an ONTAP volume. When enabled, Amazon FSx @@ -1027,9 +1038,10 @@ type CreateOntapVolumeConfiguration struct { // being moved to the capacity pool tier. TieringPolicy *TieringPolicy - // Use to specify the style of an ONTAP volume. For more information about - // FlexVols and FlexGroups, see Volume types (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-types.html) - // in Amazon FSx for NetApp ONTAP User Guide. + // Use to specify the style of an ONTAP volume. FSx for ONTAP offers two styles of + // volumes that you can use for different purposes, FlexVol and FlexGroup volumes. + // For more information, see Volume styles (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-styles.html) + // in the Amazon FSx for NetApp ONTAP User Guide. VolumeStyle VolumeStyle noSmithyDocumentSerde @@ -1139,7 +1151,7 @@ type CreateOpenZFSVolumeConfiguration struct { // in the Amazon FSx for OpenZFS User Guide. StorageCapacityReservationGiB *int32 - // An object specifying how much storage users or groups can use on the volume. + // Configures how much storage users and groups can use on the volume. UserAndGroupQuotas []OpenZFSUserOrGroupQuota noSmithyDocumentSerde @@ -1203,7 +1215,7 @@ type CreateSnaplockConfiguration struct { // The configuration that Amazon FSx uses to join the ONTAP storage virtual // machine (SVM) to your self-managed (including on-premises) Microsoft Active -// Directory (AD) directory. +// Directory directory. type CreateSvmActiveDirectoryConfiguration struct { // The NetBIOS name of the Active Directory computer object that will be created @@ -1768,7 +1780,7 @@ type DiskIopsConfiguration struct { Iops *int64 // Specifies whether the file system is using the AUTOMATIC setting of SSD IOPS of - // 3 IOPS per GB of storage capacity, , or if it using a USER_PROVISIONED value. + // 3 IOPS per GB of storage capacity, or if it using a USER_PROVISIONED value. Mode DiskIopsConfigurationMode noSmithyDocumentSerde @@ -2192,8 +2204,8 @@ type FileSystem struct { SubnetIds []string // The tags to associate with the file system. For more information, see Tagging - // your Amazon EC2 resources (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html) - // in the Amazon EC2 User Guide. + // your Amazon FSx resources (https://docs.aws.amazon.com/fsx/latest/LustreGuide/tag-resources.html) + // in the Amazon FSx for Lustre User Guide. Tags []Tag // The ID of the primary virtual private cloud (VPC) for the file system. @@ -2529,7 +2541,7 @@ type OntapFileSystemConfiguration struct { // High-availability (HA) pairs (https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/HA-pairs.html) // in the FSx for ONTAP user guide. Amazon FSx responds with an HTTP status code // 400 (Bad Request) for the following conditions: - // - The value of HAPairs is less than 1 or greater than 6. + // - The value of HAPairs is less than 1 or greater than 12. // - The value of HAPairs is greater than 1 and the value of DeploymentType is // SINGLE_AZ_1 or MULTI_AZ_1 . HAPairs *int32 @@ -2560,7 +2572,7 @@ type OntapFileSystemConfiguration struct { // - The value of ThroughputCapacity and ThroughputCapacityPerHAPair are not the // same value. // - The value of deployment type is SINGLE_AZ_2 and ThroughputCapacity / - // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 6). + // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 12). // - The value of ThroughputCapacityPerHAPair is not a valid value. ThroughputCapacityPerHAPair *int32 @@ -2863,20 +2875,22 @@ type OpenZFSOriginSnapshotConfiguration struct { noSmithyDocumentSerde } -// The configuration for how much storage a user or group can use on the volume. +// Used to configure quotas that define how much storage a user or group can use +// on an FSx for OpenZFS volume. For more information, see Volume properties (https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/managing-volumes.html#volume-properties) +// in the FSx for OpenZFS User Guide. type OpenZFSUserOrGroupQuota struct { - // The ID of the user or group. + // The ID of the user or group that the quota applies to. // // This member is required. Id *int32 - // The amount of storage that the user or group can use in gibibytes (GiB). + // The user or group's storage quota, in gibibytes (GiB). // // This member is required. StorageCapacityQuotaGiB *int32 - // A value that specifies whether the quota applies to a user or group. + // Specifies whether the quota applies to a user or group. // // This member is required. Type OpenZFSQuotaType @@ -3657,7 +3671,7 @@ type UpdateFileSystemOntapConfiguration struct { // - The value of ThroughputCapacity and ThroughputCapacityPerHAPair are not the // same value for file systems with one HA pair. // - The value of deployment type is SINGLE_AZ_2 and ThroughputCapacity / - // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 6). + // ThroughputCapacityPerHAPair is a valid HA pair (a value between 2 and 12). // - The value of ThroughputCapacityPerHAPair is not a valid value. ThroughputCapacityPerHAPair *int32 diff --git a/service/organizations/types/types.go b/service/organizations/types/types.go index cab36bb4324..4fa3fd7ee61 100644 --- a/service/organizations/types/types.go +++ b/service/organizations/types/types.go @@ -410,11 +410,12 @@ type OrganizationalUnit struct { // in the Amazon Web Services Service Authorization Reference. Arn *string - // The unique identifier (ID) associated with this OU. The regex pattern (http://wikipedia.org/wiki/regex) - // for an organizational unit ID string requires "ou-" followed by from 4 to 32 - // lowercase letters or digits (the ID of the root that contains the OU). This - // string is followed by a second "-" dash and from 8 to 32 additional lowercase - // letters or digits. + // The unique identifier (ID) associated with this OU. The ID is unique to the + // organization only. The regex pattern (http://wikipedia.org/wiki/regex) for an + // organizational unit ID string requires "ou-" followed by from 4 to 32 lowercase + // letters or digits (the ID of the root that contains the OU). This string is + // followed by a second "-" dash and from 8 to 32 additional lowercase letters or + // digits. Id *string // The friendly name of this OU. The regex pattern (http://wikipedia.org/wiki/regex) @@ -571,9 +572,9 @@ type Root struct { // in the Amazon Web Services Service Authorization Reference. Arn *string - // The unique identifier (ID) for the root. The regex pattern (http://wikipedia.org/wiki/regex) - // for a root ID string requires "r-" followed by from 4 to 32 lowercase letters or - // digits. + // The unique identifier (ID) for the root. The ID is unique to the organization + // only. The regex pattern (http://wikipedia.org/wiki/regex) for a root ID string + // requires "r-" followed by from 4 to 32 lowercase letters or digits. Id *string // The friendly name of the root. The regex pattern (http://wikipedia.org/wiki/regex)