From 1737386a85235b72e9676ed261b72cddb61355df Mon Sep 17 00:00:00 2001 From: AWS SDK for Go v2 automation user Date: Fri, 24 Jan 2025 19:28:54 +0000 Subject: [PATCH] Regenerated Clients --- .../8167579ac22544c99009c9d5bb2bd1d0.json | 8 + .../9d858fd730464b1eaba17f61ad79395f.json | 8 + .../a90ab456121140c8b80f62e574a42f9f.json | 8 + .../cf11d8320d374b0b8195f81968101c21.json | 8 + .../e3c4033f93af4049a1f90d8d02f6abf3.json | 8 + .../fb24bc2af22a47a9a490f12f8a5a6ef9.json | 8 + .../attributevalue/decode_test.go | 2 +- .../cloudtrail/api_op_GetInsightSelectors.go | 4 +- .../cloudtrail/api_op_PutEventSelectors.go | 4 +- .../cloudtrail/api_op_PutInsightSelectors.go | 4 +- .../cloudtrail/api_op_SearchSampleQueries.go | 173 +++++++++++ service/cloudtrail/deserializers.go | 288 ++++++++++++++++++ service/cloudtrail/generated.json | 1 + service/cloudtrail/serializers.go | 83 +++++ .../api_op_SearchSampleQueries.go.snap | 41 +++ service/cloudtrail/snapshot_test.go | 24 ++ service/cloudtrail/types/types.go | 27 +- service/cloudtrail/validators.go | 39 +++ service/eks/api_op_CreateAccessEntry.go | 26 +- service/eks/api_op_CreateAddon.go | 2 +- service/eks/api_op_CreateCluster.go | 18 +- service/eks/api_op_CreateFargateProfile.go | 2 +- service/eks/api_op_ListClusters.go | 2 +- service/eks/api_op_UpdateAddon.go | 2 +- service/eks/api_op_UpdateClusterConfig.go | 4 +- service/eks/api_op_UpdateClusterVersion.go | 2 +- service/eks/api_op_UpdateNodegroupConfig.go | 4 +- service/eks/deserializers.go | 9 + service/eks/serializers.go | 5 + service/eks/types/enums.go | 21 ++ service/eks/types/types.go | 81 +++-- .../healthlake/api_op_StartFHIRExportJob.go | 8 +- .../healthlake/api_op_StartFHIRImportJob.go | 8 +- service/healthlake/types/enums.go | 8 +- service/healthlake/validators.go | 6 - .../checksum/middleware_setup_context_test.go | 2 +- .../ssm/api_op_AssociateOpsItemRelatedItem.go | 3 +- service/ssm/api_op_CreateActivation.go | 9 +- service/ssm/api_op_CreateAssociation.go | 14 +- service/ssm/api_op_DescribePatchGroupState.go | 4 +- .../api_op_DisassociateOpsItemRelatedItem.go | 2 +- service/ssm/api_op_GetCalendarState.go | 2 +- ...p_GetDeployablePatchSnapshotForInstance.go | 6 +- service/ssm/api_op_GetParametersByPath.go | 3 +- service/ssm/api_op_ListAssociations.go | 2 +- service/ssm/api_op_ListOpsItemRelatedItems.go | 2 +- service/ssm/api_op_PutParameter.go | 7 +- service/ssm/api_op_SendCommand.go | 4 +- .../ssm/api_op_StartAutomationExecution.go | 6 +- .../ssm/api_op_StartChangeRequestExecution.go | 6 + service/ssm/api_op_StartSession.go | 5 +- service/ssm/api_op_UpdateAssociation.go | 14 +- service/ssm/doc.go | 18 +- service/ssm/types/types.go | 47 ++- service/ssooidc/api_op_CreateToken.go | 23 +- service/ssooidc/api_op_CreateTokenWithIAM.go | 6 +- service/ssooidc/api_op_RegisterClient.go | 16 +- service/ssooidc/doc.go | 7 +- service/transfer/api_op_CreateAgreement.go | 30 +- service/transfer/api_op_UpdateAgreement.go | 22 ++ service/transfer/deserializers.go | 81 +++++ service/transfer/serializers.go | 46 +++ service/transfer/types/types.go | 46 +++ service/transfer/validators.go | 40 ++- 64 files changed, 1230 insertions(+), 189 deletions(-) create mode 100644 .changelog/8167579ac22544c99009c9d5bb2bd1d0.json create mode 100644 .changelog/9d858fd730464b1eaba17f61ad79395f.json create mode 100644 .changelog/a90ab456121140c8b80f62e574a42f9f.json create mode 100644 .changelog/cf11d8320d374b0b8195f81968101c21.json create mode 100644 .changelog/e3c4033f93af4049a1f90d8d02f6abf3.json create mode 100644 .changelog/fb24bc2af22a47a9a490f12f8a5a6ef9.json create mode 100644 service/cloudtrail/api_op_SearchSampleQueries.go create mode 100644 service/cloudtrail/snapshot/api_op_SearchSampleQueries.go.snap diff --git a/.changelog/8167579ac22544c99009c9d5bb2bd1d0.json b/.changelog/8167579ac22544c99009c9d5bb2bd1d0.json new file mode 100644 index 00000000000..07de81e4d6e --- /dev/null +++ b/.changelog/8167579ac22544c99009c9d5bb2bd1d0.json @@ -0,0 +1,8 @@ +{ + "id": "8167579a-c225-44c9-9009-c9d5bb2bd1d0", + "type": "documentation", + "description": "Fixed typos in the descriptions.", + "modules": [ + "service/ssooidc" + ] +} \ No newline at end of file diff --git a/.changelog/9d858fd730464b1eaba17f61ad79395f.json b/.changelog/9d858fd730464b1eaba17f61ad79395f.json new file mode 100644 index 00000000000..bfb615333db --- /dev/null +++ b/.changelog/9d858fd730464b1eaba17f61ad79395f.json @@ -0,0 +1,8 @@ +{ + "id": "9d858fd7-3046-4b1e-aba1-7f61ad79395f", + "type": "feature", + "description": "This release introduces the SearchSampleQueries API that allows users to search for CloudTrail Lake sample queries.", + "modules": [ + "service/cloudtrail" + ] +} \ No newline at end of file diff --git a/.changelog/a90ab456121140c8b80f62e574a42f9f.json b/.changelog/a90ab456121140c8b80f62e574a42f9f.json new file mode 100644 index 00000000000..aca206ed9c2 --- /dev/null +++ b/.changelog/a90ab456121140c8b80f62e574a42f9f.json @@ -0,0 +1,8 @@ +{ + "id": "a90ab456-1211-40c8-b80f-62e574a42f9f", + "type": "feature", + "description": "Added new authorization strategy value 'SMART_ON_FHIR' for CreateFHIRDatastore API to support Smart App 2.0", + "modules": [ + "service/healthlake" + ] +} \ No newline at end of file diff --git a/.changelog/cf11d8320d374b0b8195f81968101c21.json b/.changelog/cf11d8320d374b0b8195f81968101c21.json new file mode 100644 index 00000000000..30f1ba94e9c --- /dev/null +++ b/.changelog/cf11d8320d374b0b8195f81968101c21.json @@ -0,0 +1,8 @@ +{ + "id": "cf11d832-0d37-4b0b-8195-f81968101c21", + "type": "documentation", + "description": "Systems Manager doc-only update for January, 2025.", + "modules": [ + "service/ssm" + ] +} \ No newline at end of file diff --git a/.changelog/e3c4033f93af4049a1f90d8d02f6abf3.json b/.changelog/e3c4033f93af4049a1f90d8d02f6abf3.json new file mode 100644 index 00000000000..227bea51bad --- /dev/null +++ b/.changelog/e3c4033f93af4049a1f90d8d02f6abf3.json @@ -0,0 +1,8 @@ +{ + "id": "e3c4033f-93af-4049-a1f9-0d8d02f6abf3", + "type": "feature", + "description": "Added CustomDirectories as a new directory option for storing inbound AS2 messages, MDN files and Status files.", + "modules": [ + "service/transfer" + ] +} \ No newline at end of file diff --git a/.changelog/fb24bc2af22a47a9a490f12f8a5a6ef9.json b/.changelog/fb24bc2af22a47a9a490f12f8a5a6ef9.json new file mode 100644 index 00000000000..c93247d5528 --- /dev/null +++ b/.changelog/fb24bc2af22a47a9a490f12f8a5a6ef9.json @@ -0,0 +1,8 @@ +{ + "id": "fb24bc2a-f22a-47a9-a490-f12f8a5a6ef9", + "type": "feature", + "description": "Adds support for UpdateStrategies in EKS Managed Node Groups.", + "modules": [ + "service/eks" + ] +} \ No newline at end of file diff --git a/feature/dynamodbstreams/attributevalue/decode_test.go b/feature/dynamodbstreams/attributevalue/decode_test.go index 666fdf1c004..0de682390cd 100644 --- a/feature/dynamodbstreams/attributevalue/decode_test.go +++ b/feature/dynamodbstreams/attributevalue/decode_test.go @@ -1271,7 +1271,7 @@ func TestUnmarshalBinary(t *testing.T) { type testStringItem string -func (t *testStringItem) UnmarshalDynamoDBStreasmAttributeValue(av types.AttributeValue) error { +func (t *testStringItem) UnmarshalDynamoDBStreamsAttributeValue(av types.AttributeValue) error { v, ok := av.(*types.AttributeValueMemberS) if !ok { return fmt.Errorf("expecting string value") diff --git a/service/cloudtrail/api_op_GetInsightSelectors.go b/service/cloudtrail/api_op_GetInsightSelectors.go index 4360b1e73bd..4eb6dcd6784 100644 --- a/service/cloudtrail/api_op_GetInsightSelectors.go +++ b/service/cloudtrail/api_op_GetInsightSelectors.go @@ -22,9 +22,9 @@ import ( // an event data store, or the TrailName parameter to the get Insights event // selectors for a trail. You cannot specify these parameters together. // -// For more information, see [Logging CloudTrail Insights events] in the CloudTrail User Guide. +// For more information, see [Working with CloudTrail Insights] in the CloudTrail User Guide. // -// [Logging CloudTrail Insights events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html +// [Working with CloudTrail Insights]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html func (c *Client) GetInsightSelectors(ctx context.Context, params *GetInsightSelectorsInput, optFns ...func(*Options)) (*GetInsightSelectorsOutput, error) { if params == nil { params = &GetInsightSelectorsInput{} diff --git a/service/cloudtrail/api_op_PutEventSelectors.go b/service/cloudtrail/api_op_PutEventSelectors.go index 3094b6c570d..1b67ab615f4 100644 --- a/service/cloudtrail/api_op_PutEventSelectors.go +++ b/service/cloudtrail/api_op_PutEventSelectors.go @@ -33,7 +33,7 @@ import ( // If you want your trail to log Insights events, be sure the event selector or // advanced event selector enables logging of the Insights event types you want // configured for your trail. For more information about logging Insights events, -// see [Logging Insights events]in the CloudTrail User Guide. By default, trails created without specific +// see [Working with CloudTrail Insights]in the CloudTrail User Guide. By default, trails created without specific // event selectors are configured to log all read and write management events, and // no data events or network activity events. // @@ -68,8 +68,8 @@ import ( // trail. For more information, see [Logging management events], [Logging data events], [Logging network activity events], and [Quotas in CloudTrail] in the CloudTrail User Guide. // // [Logging network activity events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html -// [Logging Insights events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html // [Logging management events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html +// [Working with CloudTrail Insights]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html // [Quotas in CloudTrail]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/WhatIsCloudTrail-Limits.html // [Logging data events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html func (c *Client) PutEventSelectors(ctx context.Context, params *PutEventSelectorsInput, optFns ...func(*Options)) (*PutEventSelectorsOutput, error) { diff --git a/service/cloudtrail/api_op_PutInsightSelectors.go b/service/cloudtrail/api_op_PutInsightSelectors.go index e788147b847..8a55d7b63f1 100644 --- a/service/cloudtrail/api_op_PutInsightSelectors.go +++ b/service/cloudtrail/api_op_PutInsightSelectors.go @@ -35,9 +35,9 @@ import ( // logs management events. You can call GetEventDataStore on an event data store // to check whether the event data store logs management events. // -// For more information, see [Logging CloudTrail Insights events] in the CloudTrail User Guide. +// For more information, see [Working with CloudTrail Insights] in the CloudTrail User Guide. // -// [Logging CloudTrail Insights events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html +// [Working with CloudTrail Insights]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-insights-events-with-cloudtrail.html func (c *Client) PutInsightSelectors(ctx context.Context, params *PutInsightSelectorsInput, optFns ...func(*Options)) (*PutInsightSelectorsOutput, error) { if params == nil { params = &PutInsightSelectorsInput{} diff --git a/service/cloudtrail/api_op_SearchSampleQueries.go b/service/cloudtrail/api_op_SearchSampleQueries.go new file mode 100644 index 00000000000..e4ffbd9ca1a --- /dev/null +++ b/service/cloudtrail/api_op_SearchSampleQueries.go @@ -0,0 +1,173 @@ +// Code generated by smithy-go-codegen DO NOT EDIT. + +package cloudtrail + +import ( + "context" + "fmt" + awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" + "github.com/aws/aws-sdk-go-v2/service/cloudtrail/types" + "github.com/aws/smithy-go/middleware" + smithyhttp "github.com/aws/smithy-go/transport/http" +) + +// Searches sample queries and returns a list of sample queries that are sorted +// +// by relevance. To search for sample queries, provide a natural language +// SearchPhrase in English. +func (c *Client) SearchSampleQueries(ctx context.Context, params *SearchSampleQueriesInput, optFns ...func(*Options)) (*SearchSampleQueriesOutput, error) { + if params == nil { + params = &SearchSampleQueriesInput{} + } + + result, metadata, err := c.invokeOperation(ctx, "SearchSampleQueries", params, optFns, c.addOperationSearchSampleQueriesMiddlewares) + if err != nil { + return nil, err + } + + out := result.(*SearchSampleQueriesOutput) + out.ResultMetadata = metadata + return out, nil +} + +type SearchSampleQueriesInput struct { + + // The natural language phrase to use for the semantic search. The phrase must be + // in English. The length constraint is in characters, not words. + // + // This member is required. + SearchPhrase *string + + // The maximum number of results to return on a single page. The default value is + // 10. + MaxResults *int32 + + // A token you can use to get the next page of results. The length constraint is + // in characters, not words. + NextToken *string + + noSmithyDocumentSerde +} + +type SearchSampleQueriesOutput struct { + + // A token you can use to get the next page of results. + NextToken *string + + // A list of objects containing the search results ordered from most relevant to + // least relevant. + SearchResults []types.SearchSampleQueriesSearchResult + + // Metadata pertaining to the operation's result. + ResultMetadata middleware.Metadata + + noSmithyDocumentSerde +} + +func (c *Client) addOperationSearchSampleQueriesMiddlewares(stack *middleware.Stack, options Options) (err error) { + if err := stack.Serialize.Add(&setOperationInputMiddleware{}, middleware.After); err != nil { + return err + } + err = stack.Serialize.Add(&awsAwsjson11_serializeOpSearchSampleQueries{}, middleware.After) + if err != nil { + return err + } + err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpSearchSampleQueries{}, middleware.After) + if err != nil { + return err + } + if err := addProtocolFinalizerMiddlewares(stack, options, "SearchSampleQueries"); err != nil { + return fmt.Errorf("add protocol finalizers: %v", err) + } + + if err = addlegacyEndpointContextSetter(stack, options); err != nil { + return err + } + if err = addSetLoggerMiddleware(stack, options); err != nil { + return err + } + if err = addClientRequestID(stack); err != nil { + return err + } + if err = addComputeContentLength(stack); err != nil { + return err + } + if err = addResolveEndpointMiddleware(stack, options); err != nil { + return err + } + if err = addComputePayloadSHA256(stack); err != nil { + return err + } + if err = addRetry(stack, options); err != nil { + return err + } + if err = addRawResponseToMetadata(stack); err != nil { + return err + } + if err = addRecordResponseTiming(stack); err != nil { + return err + } + if err = addSpanRetryLoop(stack, options); err != nil { + return err + } + if err = addClientUserAgent(stack, options); err != nil { + return err + } + if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { + return err + } + if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { + return err + } + if err = addSetLegacyContextSigningOptionsMiddleware(stack); err != nil { + return err + } + if err = addTimeOffsetBuild(stack, c); err != nil { + return err + } + if err = addUserAgentRetryMode(stack, options); err != nil { + return err + } + if err = addOpSearchSampleQueriesValidationMiddleware(stack); err != nil { + return err + } + if err = stack.Initialize.Add(newServiceMetadataMiddleware_opSearchSampleQueries(options.Region), middleware.Before); err != nil { + return err + } + if err = addRecursionDetection(stack); err != nil { + return err + } + if err = addRequestIDRetrieverMiddleware(stack); err != nil { + return err + } + if err = addResponseErrorMiddleware(stack); err != nil { + return err + } + if err = addRequestResponseLogging(stack, options); err != nil { + return err + } + if err = addDisableHTTPSMiddleware(stack, options); err != nil { + return err + } + if err = addSpanInitializeStart(stack); err != nil { + return err + } + if err = addSpanInitializeEnd(stack); err != nil { + return err + } + if err = addSpanBuildRequestStart(stack); err != nil { + return err + } + if err = addSpanBuildRequestEnd(stack); err != nil { + return err + } + return nil +} + +func newServiceMetadataMiddleware_opSearchSampleQueries(region string) *awsmiddleware.RegisterServiceMetadata { + return &awsmiddleware.RegisterServiceMetadata{ + Region: region, + ServiceID: ServiceID, + OperationName: "SearchSampleQueries", + } +} diff --git a/service/cloudtrail/deserializers.go b/service/cloudtrail/deserializers.go index 903d56d9e31..f3079719c0a 100644 --- a/service/cloudtrail/deserializers.go +++ b/service/cloudtrail/deserializers.go @@ -5950,6 +5950,123 @@ func awsAwsjson11_deserializeOpErrorRestoreEventDataStore(response *smithyhttp.R } } +type awsAwsjson11_deserializeOpSearchSampleQueries struct { +} + +func (*awsAwsjson11_deserializeOpSearchSampleQueries) ID() string { + return "OperationDeserializer" +} + +func (m *awsAwsjson11_deserializeOpSearchSampleQueries) HandleDeserialize(ctx context.Context, in middleware.DeserializeInput, next middleware.DeserializeHandler) ( + out middleware.DeserializeOutput, metadata middleware.Metadata, err error, +) { + out, metadata, err = next.HandleDeserialize(ctx, in) + if err != nil { + return out, metadata, err + } + + _, span := tracing.StartSpan(ctx, "OperationDeserializer") + endTimer := startMetricTimer(ctx, "client.call.deserialization_duration") + defer endTimer() + defer span.End() + response, ok := out.RawResponse.(*smithyhttp.Response) + if !ok { + return out, metadata, &smithy.DeserializationError{Err: fmt.Errorf("unknown transport type %T", out.RawResponse)} + } + + if response.StatusCode < 200 || response.StatusCode >= 300 { + return out, metadata, awsAwsjson11_deserializeOpErrorSearchSampleQueries(response, &metadata) + } + output := &SearchSampleQueriesOutput{} + out.Result = output + + var buff [1024]byte + ringBuffer := smithyio.NewRingBuffer(buff[:]) + + body := io.TeeReader(response.Body, ringBuffer) + decoder := json.NewDecoder(body) + decoder.UseNumber() + var shape interface{} + if err := decoder.Decode(&shape); err != nil && err != io.EOF { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + err = &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + return out, metadata, err + } + + err = awsAwsjson11_deserializeOpDocumentSearchSampleQueriesOutput(&output, shape) + if err != nil { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + err = &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + return out, metadata, err + } + + return out, metadata, err +} + +func awsAwsjson11_deserializeOpErrorSearchSampleQueries(response *smithyhttp.Response, metadata *middleware.Metadata) error { + var errorBuffer bytes.Buffer + if _, err := io.Copy(&errorBuffer, response.Body); err != nil { + return &smithy.DeserializationError{Err: fmt.Errorf("failed to copy error response body, %w", err)} + } + errorBody := bytes.NewReader(errorBuffer.Bytes()) + + errorCode := "UnknownError" + errorMessage := errorCode + + headerCode := response.Header.Get("X-Amzn-ErrorType") + + var buff [1024]byte + ringBuffer := smithyio.NewRingBuffer(buff[:]) + + body := io.TeeReader(errorBody, ringBuffer) + decoder := json.NewDecoder(body) + decoder.UseNumber() + bodyInfo, err := getProtocolErrorInfo(decoder) + if err != nil { + var snapshot bytes.Buffer + io.Copy(&snapshot, ringBuffer) + err = &smithy.DeserializationError{ + Err: fmt.Errorf("failed to decode response body, %w", err), + Snapshot: snapshot.Bytes(), + } + return err + } + + errorBody.Seek(0, io.SeekStart) + if typ, ok := resolveProtocolErrorType(headerCode, bodyInfo); ok { + errorCode = restjson.SanitizeErrorCode(typ) + } + if len(bodyInfo.Message) != 0 { + errorMessage = bodyInfo.Message + } + switch { + case strings.EqualFold("InvalidParameterException", errorCode): + return awsAwsjson11_deserializeErrorInvalidParameterException(response, errorBody) + + case strings.EqualFold("OperationNotPermittedException", errorCode): + return awsAwsjson11_deserializeErrorOperationNotPermittedException(response, errorBody) + + case strings.EqualFold("UnsupportedOperationException", errorCode): + return awsAwsjson11_deserializeErrorUnsupportedOperationException(response, errorBody) + + default: + genericError := &smithy.GenericAPIError{ + Code: errorCode, + Message: errorMessage, + } + return genericError + + } +} + type awsAwsjson11_deserializeOpStartDashboardRefresh struct { } @@ -16378,6 +16495,132 @@ func awsAwsjson11_deserializeDocumentS3ImportSource(v **types.S3ImportSource, va return nil } +func awsAwsjson11_deserializeDocumentSearchSampleQueriesSearchResult(v **types.SearchSampleQueriesSearchResult, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.SearchSampleQueriesSearchResult + if *v == nil { + sv = &types.SearchSampleQueriesSearchResult{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "Description": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected SampleQueryDescription to be of type string, got %T instead", value) + } + sv.Description = ptr.String(jtv) + } + + case "Name": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected SampleQueryName to be of type string, got %T instead", value) + } + sv.Name = ptr.String(jtv) + } + + case "Relevance": + if value != nil { + switch jtv := value.(type) { + case json.Number: + f64, err := jtv.Float64() + if err != nil { + return err + } + sv.Relevance = float32(f64) + + case string: + var f64 float64 + switch { + case strings.EqualFold(jtv, "NaN"): + f64 = math.NaN() + + case strings.EqualFold(jtv, "Infinity"): + f64 = math.Inf(1) + + case strings.EqualFold(jtv, "-Infinity"): + f64 = math.Inf(-1) + + default: + return fmt.Errorf("unknown JSON number value: %s", jtv) + + } + sv.Relevance = float32(f64) + + default: + return fmt.Errorf("expected SampleQueryRelevance to be a JSON Number, got %T instead", value) + + } + } + + case "SQL": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected SampleQuerySQL to be of type string, got %T instead", value) + } + sv.SQL = ptr.String(jtv) + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + +func awsAwsjson11_deserializeDocumentSearchSampleQueriesSearchResults(v *[]types.SearchSampleQueriesSearchResult, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.([]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var cv []types.SearchSampleQueriesSearchResult + if *v == nil { + cv = []types.SearchSampleQueriesSearchResult{} + } else { + cv = *v + } + + for _, value := range shape { + var col types.SearchSampleQueriesSearchResult + destAddr := &col + if err := awsAwsjson11_deserializeDocumentSearchSampleQueriesSearchResult(&destAddr, value); err != nil { + return err + } + col = *destAddr + cv = append(cv, col) + + } + *v = cv + return nil +} + func awsAwsjson11_deserializeDocumentServiceQuotaExceededException(v **types.ServiceQuotaExceededException, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) @@ -20226,6 +20469,51 @@ func awsAwsjson11_deserializeOpDocumentRestoreEventDataStoreOutput(v **RestoreEv return nil } +func awsAwsjson11_deserializeOpDocumentSearchSampleQueriesOutput(v **SearchSampleQueriesOutput, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *SearchSampleQueriesOutput + if *v == nil { + sv = &SearchSampleQueriesOutput{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "NextToken": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected PaginationToken to be of type string, got %T instead", value) + } + sv.NextToken = ptr.String(jtv) + } + + case "SearchResults": + if err := awsAwsjson11_deserializeDocumentSearchSampleQueriesSearchResults(&sv.SearchResults, value); err != nil { + return err + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + func awsAwsjson11_deserializeOpDocumentStartDashboardRefreshOutput(v **StartDashboardRefreshOutput, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) diff --git a/service/cloudtrail/generated.json b/service/cloudtrail/generated.json index c5de6530cc0..9e6b432dd47 100644 --- a/service/cloudtrail/generated.json +++ b/service/cloudtrail/generated.json @@ -52,6 +52,7 @@ "api_op_RegisterOrganizationDelegatedAdmin.go", "api_op_RemoveTags.go", "api_op_RestoreEventDataStore.go", + "api_op_SearchSampleQueries.go", "api_op_StartDashboardRefresh.go", "api_op_StartEventDataStoreIngestion.go", "api_op_StartImport.go", diff --git a/service/cloudtrail/serializers.go b/service/cloudtrail/serializers.go index 5c29cf115fc..8649123bd90 100644 --- a/service/cloudtrail/serializers.go +++ b/service/cloudtrail/serializers.go @@ -2701,6 +2701,67 @@ func (m *awsAwsjson11_serializeOpRestoreEventDataStore) HandleSerialize(ctx cont return next.HandleSerialize(ctx, in) } +type awsAwsjson11_serializeOpSearchSampleQueries struct { +} + +func (*awsAwsjson11_serializeOpSearchSampleQueries) ID() string { + return "OperationSerializer" +} + +func (m *awsAwsjson11_serializeOpSearchSampleQueries) HandleSerialize(ctx context.Context, in middleware.SerializeInput, next middleware.SerializeHandler) ( + out middleware.SerializeOutput, metadata middleware.Metadata, err error, +) { + _, span := tracing.StartSpan(ctx, "OperationSerializer") + endTimer := startMetricTimer(ctx, "client.call.serialization_duration") + defer endTimer() + defer span.End() + request, ok := in.Request.(*smithyhttp.Request) + if !ok { + return out, metadata, &smithy.SerializationError{Err: fmt.Errorf("unknown transport type %T", in.Request)} + } + + input, ok := in.Parameters.(*SearchSampleQueriesInput) + _ = input + if !ok { + return out, metadata, &smithy.SerializationError{Err: fmt.Errorf("unknown input parameters type %T", in.Parameters)} + } + + operationPath := "/" + if len(request.Request.URL.Path) == 0 { + request.Request.URL.Path = operationPath + } else { + request.Request.URL.Path = path.Join(request.Request.URL.Path, operationPath) + if request.Request.URL.Path != "/" && operationPath[len(operationPath)-1] == '/' { + request.Request.URL.Path += "/" + } + } + request.Request.Method = "POST" + httpBindingEncoder, err := httpbinding.NewEncoder(request.URL.Path, request.URL.RawQuery, request.Header) + if err != nil { + return out, metadata, &smithy.SerializationError{Err: err} + } + httpBindingEncoder.SetHeader("Content-Type").String("application/x-amz-json-1.1") + httpBindingEncoder.SetHeader("X-Amz-Target").String("CloudTrail_20131101.SearchSampleQueries") + + jsonEncoder := smithyjson.NewEncoder() + if err := awsAwsjson11_serializeOpDocumentSearchSampleQueriesInput(input, jsonEncoder.Value); err != nil { + return out, metadata, &smithy.SerializationError{Err: err} + } + + if request, err = request.SetStream(bytes.NewReader(jsonEncoder.Bytes())); err != nil { + return out, metadata, &smithy.SerializationError{Err: err} + } + + if request.Request, err = httpBindingEncoder.Encode(request.Request); err != nil { + return out, metadata, &smithy.SerializationError{Err: err} + } + in.Request = request + + endTimer() + span.End() + return next.HandleSerialize(ctx, in) +} + type awsAwsjson11_serializeOpStartDashboardRefresh struct { } @@ -4915,6 +4976,28 @@ func awsAwsjson11_serializeOpDocumentRestoreEventDataStoreInput(v *RestoreEventD return nil } +func awsAwsjson11_serializeOpDocumentSearchSampleQueriesInput(v *SearchSampleQueriesInput, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.MaxResults != nil { + ok := object.Key("MaxResults") + ok.Integer(*v.MaxResults) + } + + if v.NextToken != nil { + ok := object.Key("NextToken") + ok.String(*v.NextToken) + } + + if v.SearchPhrase != nil { + ok := object.Key("SearchPhrase") + ok.String(*v.SearchPhrase) + } + + return nil +} + func awsAwsjson11_serializeOpDocumentStartDashboardRefreshInput(v *StartDashboardRefreshInput, value smithyjson.Value) error { object := value.Object() defer object.Close() diff --git a/service/cloudtrail/snapshot/api_op_SearchSampleQueries.go.snap b/service/cloudtrail/snapshot/api_op_SearchSampleQueries.go.snap new file mode 100644 index 00000000000..a83c7b8233f --- /dev/null +++ b/service/cloudtrail/snapshot/api_op_SearchSampleQueries.go.snap @@ -0,0 +1,41 @@ +SearchSampleQueries + Initialize stack step + spanInitializeStart + RegisterServiceMetadata + legacyEndpointContextSetter + SetLogger + OperationInputValidation + spanInitializeEnd + Serialize stack step + spanBuildRequestStart + setOperationInput + ResolveEndpoint + OperationSerializer + Build stack step + ClientRequestID + ComputeContentLength + UserAgent + AddTimeOffsetMiddleware + RecursionDetection + spanBuildRequestEnd + Finalize stack step + spanRetryLoop + Retry + RetryMetricsHeader + ResolveAuthScheme + GetIdentity + ResolveEndpointV2 + disableHTTPS + ComputePayloadHash + setLegacyContextSigningOptions + Signing + Deserialize stack step + AddRawResponseToMetadata + ErrorCloseResponseBody + CloseResponseBody + ResponseErrorWrapper + RequestIDRetriever + OperationDeserializer + AddTimeOffsetMiddleware + RecordResponseTiming + RequestResponseLogger diff --git a/service/cloudtrail/snapshot_test.go b/service/cloudtrail/snapshot_test.go index 55cc6cd9af9..65a039dfabd 100644 --- a/service/cloudtrail/snapshot_test.go +++ b/service/cloudtrail/snapshot_test.go @@ -590,6 +590,18 @@ func TestCheckSnapshot_RestoreEventDataStore(t *testing.T) { } } +func TestCheckSnapshot_SearchSampleQueries(t *testing.T) { + svc := New(Options{}) + _, err := svc.SearchSampleQueries(context.Background(), nil, func(o *Options) { + o.APIOptions = append(o.APIOptions, func(stack *middleware.Stack) error { + return testSnapshot(stack, "SearchSampleQueries") + }) + }) + if _, ok := err.(snapshotOK); !ok && err != nil { + t.Fatal(err) + } +} + func TestCheckSnapshot_StartDashboardRefresh(t *testing.T) { svc := New(Options{}) _, err := svc.StartDashboardRefresh(context.Background(), nil, func(o *Options) { @@ -1261,6 +1273,18 @@ func TestUpdateSnapshot_RestoreEventDataStore(t *testing.T) { } } +func TestUpdateSnapshot_SearchSampleQueries(t *testing.T) { + svc := New(Options{}) + _, err := svc.SearchSampleQueries(context.Background(), nil, func(o *Options) { + o.APIOptions = append(o.APIOptions, func(stack *middleware.Stack) error { + return updateSnapshot(stack, "SearchSampleQueries") + }) + }) + if _, ok := err.(snapshotOK); !ok && err != nil { + t.Fatal(err) + } +} + func TestUpdateSnapshot_StartDashboardRefresh(t *testing.T) { svc := New(Options{}) _, err := svc.StartDashboardRefresh(context.Background(), nil, func(o *Options) { diff --git a/service/cloudtrail/types/types.go b/service/cloudtrail/types/types.go index 35e9c001e1b..ffbffea7fd1 100644 --- a/service/cloudtrail/types/types.go +++ b/service/cloudtrail/types/types.go @@ -16,7 +16,7 @@ import ( // You cannot apply both event selectors and advanced event selectors to a trail. // // For information about configurable advanced event selector fields, see [AdvancedEventSelector] in the -// CloudTrailUser Guide. +// CloudTrail API Reference. // // [Logging network activity events]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-network-events-with-cloudtrail.html // [AdvancedEventSelector]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedEventSelector.html @@ -44,7 +44,11 @@ type AdvancedFieldSelector struct { // items, Audit Manager evidence, or events outside of Amazon Web Services, the // field is used only for selecting events as filtering is not supported. // - // For more information, see [AdvancedFieldSelector] in the CloudTrailUser Guide. + // For more information, see [AdvancedFieldSelector] in the CloudTrail API Reference. + // + // Selectors don't support the use of wildcards like * . To match multiple values + // with a single condition, you may use StartsWith , EndsWith , NotStartsWith , or + // NotEndsWith to explicitly match the beginning or end of the event field. // // [AdvancedFieldSelector]: https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html // @@ -760,6 +764,25 @@ type S3ImportSource struct { noSmithyDocumentSerde } +// A search result returned by the SearchSampleQueries operation. +type SearchSampleQueriesSearchResult struct { + + // A longer description of a sample query. + Description *string + + // The name of a sample query. + Name *string + + // A value between 0 and 1 indicating the similarity between the search phrase + // and result. + Relevance float32 + + // The SQL code of the sample query. + SQL *string + + noSmithyDocumentSerde +} + // Contains configuration information about the channel. type SourceConfig struct { diff --git a/service/cloudtrail/validators.go b/service/cloudtrail/validators.go index ff0140b6f2f..1fa9b308712 100644 --- a/service/cloudtrail/validators.go +++ b/service/cloudtrail/validators.go @@ -710,6 +710,26 @@ func (m *validateOpRestoreEventDataStore) HandleInitialize(ctx context.Context, return next.HandleInitialize(ctx, in) } +type validateOpSearchSampleQueries struct { +} + +func (*validateOpSearchSampleQueries) ID() string { + return "OperationInputValidation" +} + +func (m *validateOpSearchSampleQueries) HandleInitialize(ctx context.Context, in middleware.InitializeInput, next middleware.InitializeHandler) ( + out middleware.InitializeOutput, metadata middleware.Metadata, err error, +) { + input, ok := in.Parameters.(*SearchSampleQueriesInput) + if !ok { + return out, metadata, fmt.Errorf("unknown input parameters type %T", in.Parameters) + } + if err := validateOpSearchSampleQueriesInput(input); err != nil { + return out, metadata, err + } + return next.HandleInitialize(ctx, in) +} + type validateOpStartDashboardRefresh struct { } @@ -1070,6 +1090,10 @@ func addOpRestoreEventDataStoreValidationMiddleware(stack *middleware.Stack) err return stack.Initialize.Add(&validateOpRestoreEventDataStore{}, middleware.After) } +func addOpSearchSampleQueriesValidationMiddleware(stack *middleware.Stack) error { + return stack.Initialize.Add(&validateOpSearchSampleQueries{}, middleware.After) +} + func addOpStartDashboardRefreshValidationMiddleware(stack *middleware.Stack) error { return stack.Initialize.Add(&validateOpStartDashboardRefresh{}, middleware.After) } @@ -1963,6 +1987,21 @@ func validateOpRestoreEventDataStoreInput(v *RestoreEventDataStoreInput) error { } } +func validateOpSearchSampleQueriesInput(v *SearchSampleQueriesInput) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "SearchSampleQueriesInput"} + if v.SearchPhrase == nil { + invalidParams.Add(smithy.NewErrParamRequired("SearchPhrase")) + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + func validateOpStartDashboardRefreshInput(v *StartDashboardRefreshInput) error { if v == nil { return nil diff --git a/service/eks/api_op_CreateAccessEntry.go b/service/eks/api_op_CreateAccessEntry.go index fab886ec73d..6da799e3691 100644 --- a/service/eks/api_op_CreateAccessEntry.go +++ b/service/eks/api_op_CreateAccessEntry.go @@ -53,11 +53,13 @@ type CreateAccessEntryInput struct { // This value can't be changed after access entry creation. // // The valid principals differ depending on the type of the access entry in the - // type field. The only valid ARN is IAM roles for the types of access entries for - // nodes: . You can use every IAM principal type for STANDARD access entries. You - // can't use the STS session principal type with access entries because this is a - // temporary principal for each session and not a permanent identity that can be - // assigned permissions. + // type field. For STANDARD access entries, you can use every IAM principal type. + // For nodes ( EC2 (for EKS Auto Mode), EC2_LINUX , EC2_WINDOWS , FARGATE_LINUX , + // and HYBRID_LINUX ), the only valid ARN is IAM roles. + // + // You can't use the STS session principal type with access entries because this + // is a temporary principal for each session and not a permanent identity that can + // be assigned permissions. // // [IAM best practices]recommend using IAM roles with temporary credentials, rather than IAM users // with long-term credentials. @@ -97,17 +99,19 @@ type CreateAccessEntryInput struct { // other cluster or Amazon Web Services resources. Tags map[string]string - // The type of the new access entry. Valid values are Standard , FARGATE_LINUX , - // EC2_LINUX , and EC2_WINDOWS . + // The type of the new access entry. Valid values are STANDARD , FARGATE_LINUX , + // EC2_LINUX , EC2_WINDOWS , EC2 (for EKS Auto Mode), HYBRID_LINUX , and + // HYPERPOD_LINUX . // // If the principalArn is for an IAM role that's used for self-managed Amazon EC2 // nodes, specify EC2_LINUX or EC2_WINDOWS . Amazon EKS grants the necessary // permissions to the node for you. If the principalArn is for any other purpose, // specify STANDARD . If you don't specify a value, Amazon EKS sets the value to - // STANDARD . It's unnecessary to create access entries for IAM roles used with - // Fargate profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries - // in the aws-auth ConfigMap for the roles. You can't change this value once - // you've created the access entry. + // STANDARD . If you have the access mode of the cluster set to API_AND_CONFIG_MAP + // , it's unnecessary to create access entries for IAM roles used with Fargate + // profiles or managed Amazon EC2 nodes, because Amazon EKS creates entries in the + // aws-auth ConfigMap for the roles. You can't change this value once you've + // created the access entry. // // If you set the value to EC2_LINUX or EC2_WINDOWS , you can't specify values for // kubernetesGroups , or associate an AccessPolicy to the access entry. diff --git a/service/eks/api_op_CreateAddon.go b/service/eks/api_op_CreateAddon.go index 7069ce2bcb3..17c0c2294e3 100644 --- a/service/eks/api_op_CreateAddon.go +++ b/service/eks/api_op_CreateAddon.go @@ -64,7 +64,7 @@ type CreateAddonInput struct { // An array of Pod Identity Assocations to be created. Each EKS Pod Identity // association maps a Kubernetes service account to an IAM Role. // - // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the EKS User Guide. + // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the Amazon EKS User Guide. // // [Attach an IAM Role to an Amazon EKS add-on using Pod Identity]: https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html PodIdentityAssociations []types.AddonPodIdentityAssociations diff --git a/service/eks/api_op_CreateCluster.go b/service/eks/api_op_CreateCluster.go index bc67f7dac08..28ac13b0991 100644 --- a/service/eks/api_op_CreateCluster.go +++ b/service/eks/api_op_CreateCluster.go @@ -127,8 +127,8 @@ type CreateClusterInput struct { KubernetesNetworkConfig *types.KubernetesNetworkConfigRequest // Enable or disable exporting the Kubernetes control plane logs for your cluster - // to CloudWatch Logs. By default, cluster control plane logs aren't exported to - // CloudWatch Logs. For more information, see [Amazon EKS Cluster control plane logs]in the Amazon EKS User Guide . + // to CloudWatch Logs . By default, cluster control plane logs aren't exported to + // CloudWatch Logs . For more information, see [Amazon EKS Cluster control plane logs]in the Amazon EKS User Guide . // // CloudWatch Logs ingestion, archive storage, and data scanning rates apply to // exported control plane logs. For more information, see [CloudWatch Pricing]. @@ -177,13 +177,13 @@ type CreateClusterInput struct { // traffic for a resource away from an impaired AZ until the zonal shift expires or // you cancel it. You can extend the zonal shift if necessary. // - // You can start a zonal shift for an EKS cluster, or you can allow Amazon Web - // Services to do it for you by enabling zonal autoshift. This shift updates the - // flow of east-to-west network traffic in your cluster to only consider network - // endpoints for Pods running on worker nodes in healthy AZs. Additionally, any ALB - // or NLB handling ingress traffic for applications in your EKS cluster will - // automatically route traffic to targets in the healthy AZs. For more information - // about zonal shift in EKS, see [Learn about Amazon Application Recovery Controller (ARC) Zonal Shift in Amazon EKS]in the Amazon EKS User Guide . + // You can start a zonal shift for an Amazon EKS cluster, or you can allow Amazon + // Web Services to do it for you by enabling zonal autoshift. This shift updates + // the flow of east-to-west network traffic in your cluster to only consider + // network endpoints for Pods running on worker nodes in healthy AZs. Additionally, + // any ALB or NLB handling ingress traffic for applications in your Amazon EKS + // cluster will automatically route traffic to targets in the healthy AZs. For more + // information about zonal shift in EKS, see [Learn about Amazon Application Recovery Controller (ARC) Zonal Shift in Amazon EKS]in the Amazon EKS User Guide . // // [Learn about Amazon Application Recovery Controller (ARC) Zonal Shift in Amazon EKS]: https://docs.aws.amazon.com/eks/latest/userguide/zone-shift.html ZonalShiftConfig *types.ZonalShiftConfigRequest diff --git a/service/eks/api_op_CreateFargateProfile.go b/service/eks/api_op_CreateFargateProfile.go index 497fbc472c8..b45f30c5c47 100644 --- a/service/eks/api_op_CreateFargateProfile.go +++ b/service/eks/api_op_CreateFargateProfile.go @@ -16,7 +16,7 @@ import ( // // The Fargate profile allows an administrator to declare which pods run on // Fargate and specify which pods run on which Fargate profile. This declaration is -// done through the profile’s selectors. Each profile can have up to five selectors +// done through the profile's selectors. Each profile can have up to five selectors // that contain a namespace and labels. A namespace is required for every selector. // The label field consists of multiple optional key-value pairs. Pods that match // the selectors are scheduled on Fargate. If a to-be-scheduled pod matches any of diff --git a/service/eks/api_op_ListClusters.go b/service/eks/api_op_ListClusters.go index 851921d495c..b107f57c921 100644 --- a/service/eks/api_op_ListClusters.go +++ b/service/eks/api_op_ListClusters.go @@ -59,7 +59,7 @@ type ListClustersInput struct { type ListClustersOutput struct { // A list of all of the clusters for your account in the specified Amazon Web - // Services Region. + // Services Region . Clusters []string // The nextToken value returned from a previous paginated request, where maxResults diff --git a/service/eks/api_op_UpdateAddon.go b/service/eks/api_op_UpdateAddon.go index 726351457bc..ccec5337c93 100644 --- a/service/eks/api_op_UpdateAddon.go +++ b/service/eks/api_op_UpdateAddon.go @@ -62,7 +62,7 @@ type UpdateAddonInput struct { // left blank, no change. If an empty array is provided, existing Pod Identity // Assocations owned by the Addon are deleted. // - // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the EKS User Guide. + // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the Amazon EKS User Guide. // // [Attach an IAM Role to an Amazon EKS add-on using Pod Identity]: https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html PodIdentityAssociations []types.AddonPodIdentityAssociations diff --git a/service/eks/api_op_UpdateClusterConfig.go b/service/eks/api_op_UpdateClusterConfig.go index bb563980448..654a873676f 100644 --- a/service/eks/api_op_UpdateClusterConfig.go +++ b/service/eks/api_op_UpdateClusterConfig.go @@ -85,8 +85,8 @@ type UpdateClusterConfigInput struct { KubernetesNetworkConfig *types.KubernetesNetworkConfigRequest // Enable or disable exporting the Kubernetes control plane logs for your cluster - // to CloudWatch Logs. By default, cluster control plane logs aren't exported to - // CloudWatch Logs. For more information, see [Amazon EKS cluster control plane logs]in the Amazon EKS User Guide . + // to CloudWatch Logs . By default, cluster control plane logs aren't exported to + // CloudWatch Logs . For more information, see [Amazon EKS cluster control plane logs]in the Amazon EKS User Guide . // // CloudWatch Logs ingestion, archive storage, and data scanning rates apply to // exported control plane logs. For more information, see [CloudWatch Pricing]. diff --git a/service/eks/api_op_UpdateClusterVersion.go b/service/eks/api_op_UpdateClusterVersion.go index 5a95547a4cb..1237bf88e63 100644 --- a/service/eks/api_op_UpdateClusterVersion.go +++ b/service/eks/api_op_UpdateClusterVersion.go @@ -22,7 +22,7 @@ import ( // Successful ), the cluster status moves to Active . // // If your cluster has managed node groups attached to it, all of your node -// groups’ Kubernetes versions must match the cluster’s Kubernetes version in order +// groups' Kubernetes versions must match the cluster's Kubernetes version in order // to update the cluster to a new Kubernetes version. func (c *Client) UpdateClusterVersion(ctx context.Context, params *UpdateClusterVersionInput, optFns ...func(*Options)) (*UpdateClusterVersionOutput, error) { if params == nil { diff --git a/service/eks/api_op_UpdateNodegroupConfig.go b/service/eks/api_op_UpdateNodegroupConfig.go index c287486c22a..242badf24b6 100644 --- a/service/eks/api_op_UpdateNodegroupConfig.go +++ b/service/eks/api_op_UpdateNodegroupConfig.go @@ -14,8 +14,8 @@ import ( // Updates an Amazon EKS managed node group configuration. Your node group // continues to function during the update. The response output includes an update // ID that you can use to track the status of your node group update with the DescribeUpdateAPI -// operation. Currently you can update the Kubernetes labels for a node group or -// the scaling configuration. +// operation. You can update the Kubernetes labels and taints for a node group and +// the scaling and version update configuration. func (c *Client) UpdateNodegroupConfig(ctx context.Context, params *UpdateNodegroupConfigInput, optFns ...func(*Options)) (*UpdateNodegroupConfigOutput, error) { if params == nil { params = &UpdateNodegroupConfigInput{} diff --git a/service/eks/deserializers.go b/service/eks/deserializers.go index 8c88fa242f9..830b7905dcc 100644 --- a/service/eks/deserializers.go +++ b/service/eks/deserializers.go @@ -14529,6 +14529,15 @@ func awsRestjson1_deserializeDocumentNodegroupUpdateConfig(v **types.NodegroupUp sv.MaxUnavailablePercentage = ptr.Int32(int32(i64)) } + case "updateStrategy": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected NodegroupUpdateStrategies to be of type string, got %T instead", value) + } + sv.UpdateStrategy = types.NodegroupUpdateStrategies(jtv) + } + default: _, _ = key, value diff --git a/service/eks/serializers.go b/service/eks/serializers.go index 80344615bd8..4e3b9b736ed 100644 --- a/service/eks/serializers.go +++ b/service/eks/serializers.go @@ -5963,6 +5963,11 @@ func awsRestjson1_serializeDocumentNodegroupUpdateConfig(v *types.NodegroupUpdat ok.Integer(*v.MaxUnavailablePercentage) } + if len(v.UpdateStrategy) > 0 { + ok := object.Key("updateStrategy") + ok.String(string(v.UpdateStrategy)) + } + return nil } diff --git a/service/eks/types/enums.go b/service/eks/types/enums.go index af84b0634e7..9f82c2245c1 100644 --- a/service/eks/types/enums.go +++ b/service/eks/types/enums.go @@ -692,6 +692,25 @@ func (NodegroupStatus) Values() []NodegroupStatus { } } +type NodegroupUpdateStrategies string + +// Enum values for NodegroupUpdateStrategies +const ( + NodegroupUpdateStrategiesDefault NodegroupUpdateStrategies = "DEFAULT" + NodegroupUpdateStrategiesMinimal NodegroupUpdateStrategies = "MINIMAL" +) + +// Values returns all known values for NodegroupUpdateStrategies. 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 (NodegroupUpdateStrategies) Values() []NodegroupUpdateStrategies { + return []NodegroupUpdateStrategies{ + "DEFAULT", + "MINIMAL", + } +} + type ResolveConflicts string // Enum values for ResolveConflicts @@ -781,6 +800,7 @@ const ( UpdateParamTypeMaxUnavailable UpdateParamType = "MaxUnavailable" UpdateParamTypeMaxUnavailablePercentage UpdateParamType = "MaxUnavailablePercentage" UpdateParamTypeNodeRepairEnabled UpdateParamType = "NodeRepairEnabled" + UpdateParamTypeUpdateStrategy UpdateParamType = "UpdateStrategy" UpdateParamTypeConfigurationValues UpdateParamType = "ConfigurationValues" UpdateParamTypeSecurityGroups UpdateParamType = "SecurityGroups" UpdateParamTypeSubnets UpdateParamType = "Subnets" @@ -823,6 +843,7 @@ func (UpdateParamType) Values() []UpdateParamType { "MaxUnavailable", "MaxUnavailablePercentage", "NodeRepairEnabled", + "UpdateStrategy", "ConfigurationValues", "SecurityGroups", "Subnets", diff --git a/service/eks/types/types.go b/service/eks/types/types.go index eef31f69715..58882088005 100644 --- a/service/eks/types/types.go +++ b/service/eks/types/types.go @@ -144,7 +144,7 @@ type Addon struct { // An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity // association maps a role to a service account in a namespace in the cluster. // - // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the EKS User Guide. + // For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the Amazon EKS User Guide. // // [Attach an IAM Role to an Amazon EKS add-on using Pod Identity]: https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html PodIdentityAssociations []string @@ -167,10 +167,12 @@ type Addon struct { noSmithyDocumentSerde } -// Contains compatibility information for an Amazon EKS add-on. +// The summary information about the Amazon EKS add-on compatibility for the next +// Kubernetes version for an insight check in the UPGRADE_READINESS category. type AddonCompatibilityDetail struct { - // A list of compatible add-on versions. + // The list of compatible Amazon EKS add-on versions for the next Kubernetes + // version. CompatibleVersions []string // The name of the Amazon EKS add-on. @@ -233,7 +235,7 @@ type AddonIssue struct { // Each EKS Pod Identity Association maps a role to a service account in a // namespace in the cluster. // -// For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the EKS User Guide. +// For more information, see [Attach an IAM Role to an Amazon EKS add-on using Pod Identity] in the Amazon EKS User Guide. // // [Attach an IAM Role to an Amazon EKS add-on using Pod Identity]: https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html type AddonPodIdentityAssociations struct { @@ -320,7 +322,7 @@ type AutoScalingGroup struct { // Auto Mode cluster. For example, if the capability is enabled or disabled. If the // block storage capability is enabled, EKS Auto Mode will create and delete EBS // volumes in your Amazon Web Services account. For more information, see EKS Auto -// Mode block storage capability in the EKS User Guide. +// Mode block storage capability in the Amazon EKS User Guide. type BlockStorage struct { // Indicates if the block storage capability is enabled on your EKS Auto Mode @@ -377,7 +379,7 @@ type Cluster struct { // Mode cluster. For example, if the capability is enabled or disabled. If the // compute capability is enabled, EKS Auto Mode will create and delete EC2 Managed // Instances in your Amazon Web Services account. For more information, see EKS - // Auto Mode compute capability in the EKS User Guide. + // Auto Mode compute capability in the Amazon EKS User Guide. ComputeConfig *ComputeConfigResponse // The configuration used to connect to a cluster for registration. @@ -450,7 +452,7 @@ type Cluster struct { // Auto Mode cluster. For example, if the capability is enabled or disabled. If the // block storage capability is enabled, EKS Auto Mode will create and delete EBS // volumes in your Amazon Web Services account. For more information, see EKS Auto - // Mode block storage capability in the EKS User Guide. + // Mode block storage capability in the Amazon EKS User Guide. StorageConfig *StorageConfigResponse // Metadata that assists with categorization and organization. Each tag consists @@ -460,9 +462,9 @@ type Cluster struct { // This value indicates if extended support is enabled or disabled for the cluster. // - // [Learn more about EKS Extended Support in the EKS User Guide.] + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.] // - // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html UpgradePolicy *UpgradePolicyResponse // The Kubernetes server version for the cluster. @@ -548,7 +550,7 @@ type Compatibility struct { // Request to update the configuration of the compute capability of your EKS Auto // Mode cluster. For example, enable the capability. For more information, see EKS -// Auto Mode compute capability in the EKS User Guide. +// Auto Mode compute capability in the Amazon EKS User Guide. type ComputeConfigRequest struct { // Request to enable or disable the compute capability on your EKS Auto Mode @@ -557,14 +559,14 @@ type ComputeConfigRequest struct { Enabled *bool // Configuration for node pools that defines the compute resources for your EKS - // Auto Mode cluster. For more information, see EKS Auto Mode Node Pools in the EKS - // User Guide. + // Auto Mode cluster. For more information, see EKS Auto Mode Node Pools in the + // Amazon EKS User Guide. NodePools []string // The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS // Auto Mode cluster. This value cannot be changed after the compute capability of - // EKS Auto Mode is enabled. For more information, see the IAM Reference in the EKS - // User Guide. + // EKS Auto Mode is enabled. For more information, see the IAM Reference in the + // Amazon EKS User Guide. NodeRoleArn *string noSmithyDocumentSerde @@ -580,8 +582,8 @@ type ComputeConfigResponse struct { Enabled *bool // Indicates the current configuration of node pools in your EKS Auto Mode - // cluster. For more information, see EKS Auto Mode Node Pools in the EKS User - // Guide. + // cluster. For more information, see EKS Auto Mode Node Pools in the Amazon EKS + // User Guide. NodePools []string // The ARN of the IAM Role EKS will assign to EC2 Managed Instances in your EKS @@ -766,8 +768,8 @@ type EksAnywhereSubscriptionTerm struct { // Indicates the current configuration of the load balancing capability on your // EKS Auto Mode cluster. For example, if the capability is enabled or disabled. -// For more information, see EKS Auto Mode load balancing capability in the EKS -// User Guide. +// For more information, see EKS Auto Mode load balancing capability in the Amazon +// EKS User Guide. type ElasticLoadBalancing struct { // Indicates if the load balancing capability is enabled on your EKS Auto Mode @@ -1161,7 +1163,7 @@ type KubernetesNetworkConfigRequest struct { // Request to enable or disable the load balancing capability on your EKS Auto // Mode cluster. For more information, see EKS Auto Mode load balancing capability - // in the EKS User Guide. + // in the Amazon EKS User Guide. ElasticLoadBalancing *ElasticLoadBalancing // Specify which IP family is used to assign Kubernetes pod and service IP @@ -1288,7 +1290,7 @@ type Logging struct { type LogSetup struct { // If a log type is enabled, that log type exports its control plane logs to - // CloudWatch Logs. If a log type isn't enabled, that log type doesn't export its + // CloudWatch Logs . If a log type isn't enabled, that log type doesn't export its // control plane logs. Each individual log type can be enabled or disabled // independently. Enabled *bool @@ -1485,7 +1487,9 @@ type NodegroupScalingConfig struct { noSmithyDocumentSerde } -// The node group update configuration. +// The node group update configuration. An Amazon EKS managed node group updates +// by replacing nodes with new nodes of newer AMI versions in parallel. You choose +// the maximum unavailable and the update strategy. type NodegroupUpdateConfig struct { // The maximum number of nodes unavailable at once during a version update. Nodes @@ -1498,6 +1502,23 @@ type NodegroupUpdateConfig struct { // or maxUnavailable is required to have a value. MaxUnavailablePercentage *int32 + // The configuration for the behavior to follow during a node group version update + // of this managed node group. You choose between two possible strategies for + // replacing nodes during an [UpdateNodegroupVersion]action. + // + // An Amazon EKS managed node group updates by replacing nodes with new nodes of + // newer AMI versions in parallel. The update strategy changes the managed node + // update behavior of the managed node group for each quantity. The default + // strategy has guardrails to protect you from misconfiguration and launches the + // new instances first, before terminating the old instances. The minimal strategy + // removes the guardrails and terminates the old instances before launching the new + // instances. This minimal strategy is useful in scenarios where you are + // constrained to resources or costs (for example, with hardware accelerators such + // as GPUs). + // + // [UpdateNodegroupVersion]: https://docs.aws.amazon.com/latest/APIReference/API_UpdateNodegroupVersion.html + UpdateStrategy NodegroupUpdateStrategies + noSmithyDocumentSerde } @@ -2034,7 +2055,7 @@ type RemotePodNetwork struct { // Request to update the configuration of the storage capability of your EKS Auto // Mode cluster. For example, enable the capability. For more information, see EKS -// Auto Mode block storage capability in the EKS User Guide. +// Auto Mode block storage capability in the Amazon EKS User Guide. type StorageConfigRequest struct { // Request to configure EBS Block Storage settings for your EKS Auto Mode cluster. @@ -2149,18 +2170,18 @@ type UpdateTaintsPayload struct { // have higher costs. The default value is EXTENDED . Use STANDARD to disable // extended support. // -// [Learn more about EKS Extended Support in the EKS User Guide.] +// [Learn more about EKS Extended Support in the Amazon EKS User Guide.] // -// [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html +// [Learn more about EKS Extended Support in the Amazon EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html type UpgradePolicyRequest struct { // If the cluster is set to EXTENDED , it will enter extended support at the end of // standard support. If the cluster is set to STANDARD , it will be automatically // upgraded at the end of standard support. // - // [Learn more about EKS Extended Support in the EKS User Guide.] + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.] // - // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html SupportType SupportType noSmithyDocumentSerde @@ -2168,18 +2189,18 @@ type UpgradePolicyRequest struct { // This value indicates if extended support is enabled or disabled for the cluster. // -// [Learn more about EKS Extended Support in the EKS User Guide.] +// [Learn more about EKS Extended Support in the Amazon EKS User Guide.] // -// [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html +// [Learn more about EKS Extended Support in the Amazon EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html type UpgradePolicyResponse struct { // If the cluster is set to EXTENDED , it will enter extended support at the end of // standard support. If the cluster is set to STANDARD , it will be automatically // upgraded at the end of standard support. // - // [Learn more about EKS Extended Support in the EKS User Guide.] + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.] // - // [Learn more about EKS Extended Support in the EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html + // [Learn more about EKS Extended Support in the Amazon EKS User Guide.]: https://docs.aws.amazon.com/eks/latest/userguide/extended-support-control.html SupportType SupportType noSmithyDocumentSerde diff --git a/service/healthlake/api_op_StartFHIRExportJob.go b/service/healthlake/api_op_StartFHIRExportJob.go index 03fd9cd3557..a5777d09b59 100644 --- a/service/healthlake/api_op_StartFHIRExportJob.go +++ b/service/healthlake/api_op_StartFHIRExportJob.go @@ -29,11 +29,6 @@ func (c *Client) StartFHIRExportJob(ctx context.Context, params *StartFHIRExport type StartFHIRExportJobInput struct { - // An optional user provided token used for ensuring idempotency. - // - // This member is required. - ClientToken *string - // The Amazon Resource Name used during the initiation of the job. // // This member is required. @@ -50,6 +45,9 @@ type StartFHIRExportJobInput struct { // This member is required. OutputDataConfig types.OutputDataConfig + // An optional user provided token used for ensuring idempotency. + ClientToken *string + // The user generated name for an export job. JobName *string diff --git a/service/healthlake/api_op_StartFHIRImportJob.go b/service/healthlake/api_op_StartFHIRImportJob.go index 832b719bf48..752ec350943 100644 --- a/service/healthlake/api_op_StartFHIRImportJob.go +++ b/service/healthlake/api_op_StartFHIRImportJob.go @@ -29,11 +29,6 @@ func (c *Client) StartFHIRImportJob(ctx context.Context, params *StartFHIRImport type StartFHIRImportJobInput struct { - // Optional user provided token used for ensuring idempotency. - // - // This member is required. - ClientToken *string - // The Amazon Resource Name (ARN) that gives AWS HealthLake access permission. // // This member is required. @@ -54,6 +49,9 @@ type StartFHIRImportJobInput struct { // This member is required. JobOutputDataConfig types.OutputDataConfig + // Optional user provided token used for ensuring idempotency. + ClientToken *string + // The name of the FHIR Import job in the StartFHIRImport job request. JobName *string diff --git a/service/healthlake/types/enums.go b/service/healthlake/types/enums.go index 4ba7f5ad9f5..16d563be6af 100644 --- a/service/healthlake/types/enums.go +++ b/service/healthlake/types/enums.go @@ -6,8 +6,9 @@ type AuthorizationStrategy string // Enum values for AuthorizationStrategy const ( - AuthorizationStrategySmartv1 AuthorizationStrategy = "SMART_ON_FHIR_V1" - AuthorizationStrategyAwsAuth AuthorizationStrategy = "AWS_AUTH" + AuthorizationStrategySmartv1 AuthorizationStrategy = "SMART_ON_FHIR_V1" + AuthorizationStrategySmartOnFhir AuthorizationStrategy = "SMART_ON_FHIR" + AuthorizationStrategyAwsAuth AuthorizationStrategy = "AWS_AUTH" ) // Values returns all known values for AuthorizationStrategy. Note that this can @@ -17,6 +18,7 @@ const ( func (AuthorizationStrategy) Values() []AuthorizationStrategy { return []AuthorizationStrategy{ "SMART_ON_FHIR_V1", + "SMART_ON_FHIR", "AWS_AUTH", } } @@ -106,6 +108,7 @@ type JobStatus string // Enum values for JobStatus const ( JobStatusSubmitted JobStatus = "SUBMITTED" + JobStatusQueued JobStatus = "QUEUED" JobStatusInProgress JobStatus = "IN_PROGRESS" JobStatusCompletedWithErrors JobStatus = "COMPLETED_WITH_ERRORS" JobStatusCompleted JobStatus = "COMPLETED" @@ -123,6 +126,7 @@ const ( func (JobStatus) Values() []JobStatus { return []JobStatus{ "SUBMITTED", + "QUEUED", "IN_PROGRESS", "COMPLETED_WITH_ERRORS", "COMPLETED", diff --git a/service/healthlake/validators.go b/service/healthlake/validators.go index a2ed431058c..20ded0babe7 100644 --- a/service/healthlake/validators.go +++ b/service/healthlake/validators.go @@ -598,9 +598,6 @@ func validateOpStartFHIRExportJobInput(v *StartFHIRExportJobInput) error { if v.DataAccessRoleArn == nil { invalidParams.Add(smithy.NewErrParamRequired("DataAccessRoleArn")) } - if v.ClientToken == nil { - invalidParams.Add(smithy.NewErrParamRequired("ClientToken")) - } if invalidParams.Len() > 0 { return invalidParams } else { @@ -629,9 +626,6 @@ func validateOpStartFHIRImportJobInput(v *StartFHIRImportJobInput) error { if v.DataAccessRoleArn == nil { invalidParams.Add(smithy.NewErrParamRequired("DataAccessRoleArn")) } - if v.ClientToken == nil { - invalidParams.Add(smithy.NewErrParamRequired("ClientToken")) - } if invalidParams.Len() > 0 { return invalidParams } else { diff --git a/service/internal/checksum/middleware_setup_context_test.go b/service/internal/checksum/middleware_setup_context_test.go index 38ed8f7ae7c..66ea3b2e79b 100644 --- a/service/internal/checksum/middleware_setup_context_test.go +++ b/service/internal/checksum/middleware_setup_context_test.go @@ -216,7 +216,7 @@ func TestSetupOutput(t *testing.T) { if e, a := c.expectInputValue, in.Value; e != a { t.Errorf("expect input checksum validation mode to be %v, got %v", e, a) } - + return out, metadata, nil }, )) diff --git a/service/ssm/api_op_AssociateOpsItemRelatedItem.go b/service/ssm/api_op_AssociateOpsItemRelatedItem.go index 5e030e98fde..5ef786de730 100644 --- a/service/ssm/api_op_AssociateOpsItemRelatedItem.go +++ b/service/ssm/api_op_AssociateOpsItemRelatedItem.go @@ -12,8 +12,7 @@ import ( // Associates a related item to a Systems Manager OpsCenter OpsItem. For example, // you can associate an Incident Manager incident or analysis with an OpsItem. -// Incident Manager and OpsCenter are capabilities of Amazon Web Services Systems -// Manager. +// Incident Manager and OpsCenter are tools in Amazon Web Services Systems Manager. func (c *Client) AssociateOpsItemRelatedItem(ctx context.Context, params *AssociateOpsItemRelatedItemInput, optFns ...func(*Options)) (*AssociateOpsItemRelatedItemOutput, error) { if params == nil { params = &AssociateOpsItemRelatedItemInput{} diff --git a/service/ssm/api_op_CreateActivation.go b/service/ssm/api_op_CreateActivation.go index 751cd09340d..e0cee74e153 100644 --- a/service/ssm/api_op_CreateActivation.go +++ b/service/ssm/api_op_CreateActivation.go @@ -15,11 +15,10 @@ import ( // Generates an activation code and activation ID you can use to register your // on-premises servers, edge devices, or virtual machine (VM) with Amazon Web // Services Systems Manager. Registering these machines with Systems Manager makes -// it possible to manage them using Systems Manager capabilities. You use the -// activation code and ID when installing SSM Agent on machines in your hybrid -// environment. For more information about requirements for managing on-premises -// machines using Systems Manager, see [Using Amazon Web Services Systems Manager in hybrid and multicloud environments]in the Amazon Web Services Systems Manager -// User Guide. +// it possible to manage them using Systems Manager tools. You use the activation +// code and ID when installing SSM Agent on machines in your hybrid environment. +// For more information about requirements for managing on-premises machines using +// Systems Manager, see [Using Amazon Web Services Systems Manager in hybrid and multicloud environments]in the Amazon Web Services Systems Manager User Guide. // // Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, and // on-premises servers and VMs that are configured for Systems Manager are all diff --git a/service/ssm/api_op_CreateAssociation.go b/service/ssm/api_op_CreateAssociation.go index 22b5ef21e23..4fa91f9f434 100644 --- a/service/ssm/api_op_CreateAssociation.go +++ b/service/ssm/api_op_CreateAssociation.go @@ -17,11 +17,11 @@ import ( // be closed. For static targets, the association specifies a schedule for when the // configuration is reapplied. For dynamic targets, such as an Amazon Web Services // resource group or an Amazon Web Services autoscaling group, State Manager, a -// capability of Amazon Web Services Systems Manager applies the configuration when -// new managed nodes are added to the group. The association also specifies actions -// to take when applying the configuration. For example, an association for -// anti-virus software might run once a day. If the software isn't installed, then -// State Manager installs it. If the software is installed, but the service isn't +// tool in Amazon Web Services Systems Manager applies the configuration when new +// managed nodes are added to the group. The association also specifies actions to +// take when applying the configuration. For example, an association for anti-virus +// software might run once a day. If the software isn't installed, then State +// Manager installs it. If the software is installed, but the service isn't // running, then the association might instruct State Manager to start the service. func (c *Client) CreateAssociation(ctx context.Context, params *CreateAssociationInput, optFns ...func(*Options)) (*CreateAssociationOutput, error) { if params == nil { @@ -79,8 +79,8 @@ type CreateAssociationInput struct { // Choose the parameter that will define how your automation will branch out. This // target is required for associations that use an Automation runbook and target - // resources by using rate controls. Automation is a capability of Amazon Web - // Services Systems Manager. + // resources by using rate controls. Automation is a tool in Amazon Web Services + // Systems Manager. AutomationTargetParameterName *string // The names or Amazon Resource Names (ARNs) of the Change Calendar type documents diff --git a/service/ssm/api_op_DescribePatchGroupState.go b/service/ssm/api_op_DescribePatchGroupState.go index 9f1955e8900..6740acfd2e5 100644 --- a/service/ssm/api_op_DescribePatchGroupState.go +++ b/service/ssm/api_op_DescribePatchGroupState.go @@ -91,8 +91,8 @@ type DescribePatchGroupStateOutput struct { InstancesWithSecurityNonCompliantPatches *int32 // The number of managed nodes with NotApplicable patches beyond the supported - // limit, which aren't reported by name to Inventory. Inventory is a capability of - // Amazon Web Services Systems Manager. + // limit, which aren't reported by name to Inventory. Inventory is a tool in Amazon + // Web Services Systems Manager. InstancesWithUnreportedNotApplicablePatches *int32 // Metadata pertaining to the operation's result. diff --git a/service/ssm/api_op_DisassociateOpsItemRelatedItem.go b/service/ssm/api_op_DisassociateOpsItemRelatedItem.go index b59d069d151..721540f117a 100644 --- a/service/ssm/api_op_DisassociateOpsItemRelatedItem.go +++ b/service/ssm/api_op_DisassociateOpsItemRelatedItem.go @@ -12,7 +12,7 @@ import ( // Deletes the association between an OpsItem and a related item. For example, // this API operation can delete an Incident Manager incident from an OpsItem. -// Incident Manager is a capability of Amazon Web Services Systems Manager. +// Incident Manager is a tool in Amazon Web Services Systems Manager. func (c *Client) DisassociateOpsItemRelatedItem(ctx context.Context, params *DisassociateOpsItemRelatedItemInput, optFns ...func(*Options)) (*DisassociateOpsItemRelatedItemOutput, error) { if params == nil { params = &DisassociateOpsItemRelatedItemInput{} diff --git a/service/ssm/api_op_GetCalendarState.go b/service/ssm/api_op_GetCalendarState.go index e9f3c106709..f4d8eb9ebbd 100644 --- a/service/ssm/api_op_GetCalendarState.go +++ b/service/ssm/api_op_GetCalendarState.go @@ -22,7 +22,7 @@ import ( // status of OPEN only if all calendars in the request are open. If one or more // calendars in the request are closed, the status returned is CLOSED . // -// For more information about Change Calendar, a capability of Amazon Web Services +// For more information about Change Calendar, a tool in Amazon Web Services // Systems Manager, see [Amazon Web Services Systems Manager Change Calendar]in the Amazon Web Services Systems Manager User Guide. // // [Amazon Web Services Systems Manager Change Calendar]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html diff --git a/service/ssm/api_op_GetDeployablePatchSnapshotForInstance.go b/service/ssm/api_op_GetDeployablePatchSnapshotForInstance.go index 2fec2c19bb2..54bb71cb5ca 100644 --- a/service/ssm/api_op_GetDeployablePatchSnapshotForInstance.go +++ b/service/ssm/api_op_GetDeployablePatchSnapshotForInstance.go @@ -18,9 +18,9 @@ import ( // If you run the command locally, such as with the Command Line Interface (CLI), // the system attempts to use your local Amazon Web Services credentials and the // operation fails. To avoid this, you can run the command in the Amazon Web -// Services Systems Manager console. Use Run Command, a capability of Amazon Web -// Services Systems Manager, with an SSM document that enables you to target a -// managed node with a script or command. For example, run the command using the +// Services Systems Manager console. Use Run Command, a tool in Amazon Web Services +// Systems Manager, with an SSM document that enables you to target a managed node +// with a script or command. For example, run the command using the // AWS-RunShellScript document or the AWS-RunPowerShellScript document. func (c *Client) GetDeployablePatchSnapshotForInstance(ctx context.Context, params *GetDeployablePatchSnapshotForInstanceInput, optFns ...func(*Options)) (*GetDeployablePatchSnapshotForInstanceOutput, error) { if params == nil { diff --git a/service/ssm/api_op_GetParametersByPath.go b/service/ssm/api_op_GetParametersByPath.go index 2c244d2585a..74c77d55d33 100644 --- a/service/ssm/api_op_GetParametersByPath.go +++ b/service/ssm/api_op_GetParametersByPath.go @@ -11,7 +11,8 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Retrieve information about one or more parameters in a specific hierarchy. +// Retrieve information about one or more parameters under a specified level in a +// hierarchy. // // Request results are returned on a best-effort basis. If you specify MaxResults // in the request, the response includes information up to the limit specified. The diff --git a/service/ssm/api_op_ListAssociations.go b/service/ssm/api_op_ListAssociations.go index dc3cb704f4a..f8b9919f673 100644 --- a/service/ssm/api_op_ListAssociations.go +++ b/service/ssm/api_op_ListAssociations.go @@ -14,7 +14,7 @@ import ( // Returns all State Manager associations in the current Amazon Web Services // account and Amazon Web Services Region. You can limit the results to a specific // State Manager association document or managed node by specifying a filter. State -// Manager is a capability of Amazon Web Services Systems Manager. +// Manager is a tool in Amazon Web Services Systems Manager. func (c *Client) ListAssociations(ctx context.Context, params *ListAssociationsInput, optFns ...func(*Options)) (*ListAssociationsOutput, error) { if params == nil { params = &ListAssociationsInput{} diff --git a/service/ssm/api_op_ListOpsItemRelatedItems.go b/service/ssm/api_op_ListOpsItemRelatedItems.go index f4616199806..994b53a5981 100644 --- a/service/ssm/api_op_ListOpsItemRelatedItems.go +++ b/service/ssm/api_op_ListOpsItemRelatedItems.go @@ -12,7 +12,7 @@ import ( ) // Lists all related-item resources associated with a Systems Manager OpsCenter -// OpsItem. OpsCenter is a capability of Amazon Web Services Systems Manager. +// OpsItem. OpsCenter is a tool in Amazon Web Services Systems Manager. func (c *Client) ListOpsItemRelatedItems(ctx context.Context, params *ListOpsItemRelatedItemsInput, optFns ...func(*Options)) (*ListOpsItemRelatedItemsOutput, error) { if params == nil { params = &ListOpsItemRelatedItemsInput{} diff --git a/service/ssm/api_op_PutParameter.go b/service/ssm/api_op_PutParameter.go index 727fa40a5ac..cb790412047 100644 --- a/service/ssm/api_op_PutParameter.go +++ b/service/ssm/api_op_PutParameter.go @@ -76,7 +76,8 @@ type PutParameterInput struct { // have a value limit of 4 KB. Advanced parameters have a value limit of 8 KB. // // Parameters can't be referenced or nested in the values of other parameters. You - // can't include {{}} or {{ssm:parameter-name}} in a parameter value. + // can't include values wrapped in double brackets {{}} or {{ssm:parameter-name}} + // in a parameter value. // // This member is required. Value *string @@ -139,8 +140,8 @@ type PutParameterInput struct { Overwrite *bool // One or more policies to apply to a parameter. This operation takes a JSON - // array. Parameter Store, a capability of Amazon Web Services Systems Manager - // supports the following policy types: + // array. Parameter Store, a tool in Amazon Web Services Systems Manager supports + // the following policy types: // // Expiration: This policy deletes the parameter after it expires. When you create // the policy, you specify the expiration date. You can update the expiration date diff --git a/service/ssm/api_op_SendCommand.go b/service/ssm/api_op_SendCommand.go index 493de7b2735..2b870b88eee 100644 --- a/service/ssm/api_op_SendCommand.go +++ b/service/ssm/api_op_SendCommand.go @@ -47,8 +47,8 @@ type SendCommandInput struct { AlarmConfiguration *types.AlarmConfiguration // Enables Amazon Web Services Systems Manager to send Run Command output to - // Amazon CloudWatch Logs. Run Command is a capability of Amazon Web Services - // Systems Manager. + // Amazon CloudWatch Logs. Run Command is a tool in Amazon Web Services Systems + // Manager. CloudWatchOutputConfig *types.CloudWatchOutputConfig // User-specified information about the command, such as a brief description of diff --git a/service/ssm/api_op_StartAutomationExecution.go b/service/ssm/api_op_StartAutomationExecution.go index cfbb6624c30..113f0908633 100644 --- a/service/ssm/api_op_StartAutomationExecution.go +++ b/service/ssm/api_op_StartAutomationExecution.go @@ -94,7 +94,11 @@ type StartAutomationExecutionInput struct { // // - Key=OS,Value=Windows // - // To add tags to an existing automation, use the AddTagsToResource operation. + // The Array Members maximum value is reported as 1000. This number includes + // capacity reserved for internal operations. When calling the + // StartAutomationExecution action, you can specify a maximum of 5 tags. You can, + // however, use the AddTagsToResourceaction to add up to a total of 50 tags to an existing + // automation configuration. Tags []types.Tag // A location is a combination of Amazon Web Services Regions and/or Amazon Web diff --git a/service/ssm/api_op_StartChangeRequestExecution.go b/service/ssm/api_op_StartChangeRequestExecution.go index ae23acbe9b6..2f631a43bde 100644 --- a/service/ssm/api_op_StartChangeRequestExecution.go +++ b/service/ssm/api_op_StartChangeRequestExecution.go @@ -100,6 +100,12 @@ type StartChangeRequestExecutionInput struct { // - Key=Environment,Value=Production // // - Key=Region,Value=us-east-2 + // + // The Array Members maximum value is reported as 1000. This number includes + // capacity reserved for internal operations. When calling the + // StartChangeRequestExecution action, you can specify a maximum of 5 tags. You + // can, however, use the AddTagsToResourceaction to add up to a total of 50 tags to an existing + // change request configuration. Tags []types.Tag noSmithyDocumentSerde diff --git a/service/ssm/api_op_StartSession.go b/service/ssm/api_op_StartSession.go index 268e15f5c62..eed0c276d53 100644 --- a/service/ssm/api_op_StartSession.go +++ b/service/ssm/api_op_StartSession.go @@ -57,7 +57,10 @@ type StartSessionInput struct { DocumentName *string // The values you want to specify for the parameters defined in the Session - // document. + // document. For more information about these parameters, see [Create a Session Manager preferences document]in the Amazon Web + // Services Systems Manager User Guide. + // + // [Create a Session Manager preferences document]: https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-create-preferences-cli.html Parameters map[string][]string // The reason for connecting to the instance. This value is included in the diff --git a/service/ssm/api_op_UpdateAssociation.go b/service/ssm/api_op_UpdateAssociation.go index 80b17c90f34..19f40756691 100644 --- a/service/ssm/api_op_UpdateAssociation.go +++ b/service/ssm/api_op_UpdateAssociation.go @@ -87,8 +87,8 @@ type UpdateAssociationInput struct { // Choose the parameter that will define how your automation will branch out. This // target is required for associations that use an Automation runbook and target - // resources by using rate controls. Automation is a capability of Amazon Web - // Services Systems Manager. + // resources by using rate controls. Automation is a tool in Amazon Web Services + // Systems Manager. AutomationTargetParameterName *string // The names or Amazon Resource Names (ARNs) of the Change Calendar type documents @@ -180,8 +180,8 @@ type UpdateAssociationInput struct { OutputLocation *types.InstanceAssociationOutputLocation // The parameters you want to update for the association. If you create a - // parameter using Parameter Store, a capability of Amazon Web Services Systems - // Manager, you can reference the parameter using {{ssm:parameter-name}} . + // parameter using Parameter Store, a tool in Amazon Web Services Systems Manager, + // you can reference the parameter using {{ssm:parameter-name}} . Parameters map[string][]string // The cron expression used to schedule the association that you want to update. @@ -207,9 +207,9 @@ type UpdateAssociationInput struct { // successfully, the association is NON-COMPLIANT . // // In MANUAL mode, you must specify the AssociationId as a parameter for the PutComplianceItems API - // operation. In this case, compliance data isn't managed by State Manager, a - // capability of Amazon Web Services Systems Manager. It is managed by your direct - // call to the PutComplianceItemsAPI operation. + // operation. In this case, compliance data isn't managed by State Manager, a tool + // in Amazon Web Services Systems Manager. It is managed by your direct call to the + // PutComplianceItemsAPI operation. // // By default, all associations use AUTO mode. SyncCompliance types.AssociationSyncCompliance diff --git a/service/ssm/doc.go b/service/ssm/doc.go index 02f238c371f..bc66312261c 100644 --- a/service/ssm/doc.go +++ b/service/ssm/doc.go @@ -11,17 +11,17 @@ // // Related resources // -// - For information about each of the capabilities that comprise Systems -// Manager, see [Systems Manager capabilities]in the Amazon Web Services Systems Manager User Guide. +// - For information about each of the tools that comprise Systems Manager, see [Using Systems Manager tools] +// in the Amazon Web Services Systems Manager User Guide. // -// - For details about predefined runbooks for Automation, a capability of -// Amazon Web Services Systems Manager, see the [Systems Manager Automation runbook reference]. +// - For details about predefined runbooks for Automation, a tool in Amazon Web +// Services Systems Manager, see the [Systems Manager Automation runbook reference]. // -// - For information about AppConfig, a capability of Systems Manager, see the [AppConfig User Guide] -// and the [AppConfig API Reference]. +// - For information about AppConfig, a tool in Systems Manager, see the [AppConfig User Guide]and the [AppConfig API Reference] +// . // -// - For information about Incident Manager, a capability of Systems Manager, -// see the [Systems Manager Incident Manager User Guide]and the [Systems Manager Incident Manager API Reference]. +// - For information about Incident Manager, a tool in Systems Manager, see the [Systems Manager Incident Manager User Guide] +// and the [Systems Manager Incident Manager API Reference]. // // [Amazon Web Services Systems Manager User Guide]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ // [AppConfig User Guide]: https://docs.aws.amazon.com/appconfig/latest/userguide/ @@ -30,5 +30,5 @@ // [Systems Manager Incident Manager API Reference]: https://docs.aws.amazon.com/incident-manager/latest/APIReference/ // [Setting up Amazon Web Services Systems Manager]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html // [Systems Manager Incident Manager User Guide]: https://docs.aws.amazon.com/incident-manager/latest/userguide/ -// [Systems Manager capabilities]: https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html#systems-manager-capabilities +// [Using Systems Manager tools]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-tools.html package ssm diff --git a/service/ssm/types/types.go b/service/ssm/types/types.go index 1c948f63c31..095c6001f98 100644 --- a/service/ssm/types/types.go +++ b/service/ssm/types/types.go @@ -193,8 +193,8 @@ type AssociationDescription struct { // Choose the parameter that will define how your automation will branch out. This // target is required for associations that use an Automation runbook and target - // resources by using rate controls. Automation is a capability of Amazon Web - // Services Systems Manager. + // resources by using rate controls. Automation is a tool in Amazon Web Services + // Systems Manager. AutomationTargetParameterName *string // The names or Amazon Resource Names (ARNs) of the Change Calendar type documents @@ -284,9 +284,9 @@ type AssociationDescription struct { // successfully, the association is NON-COMPLIANT . // // In MANUAL mode, you must specify the AssociationId as a parameter for the PutComplianceItems API - // operation. In this case, compliance data isn't managed by State Manager, a - // capability of Amazon Web Services Systems Manager. It is managed by your direct - // call to the PutComplianceItemsAPI operation. + // operation. In this case, compliance data isn't managed by State Manager, a tool + // in Amazon Web Services Systems Manager. It is managed by your direct call to the + // PutComplianceItemsAPI operation. // // By default, all associations use AUTO mode. SyncCompliance AssociationSyncCompliance @@ -565,9 +565,9 @@ type AssociationVersionInfo struct { // successfully, the association is NON-COMPLIANT . // // In MANUAL mode, you must specify the AssociationId as a parameter for the PutComplianceItems API - // operation. In this case, compliance data isn't managed by State Manager, a - // capability of Amazon Web Services Systems Manager. It is managed by your direct - // call to the PutComplianceItemsAPI operation. + // operation. In this case, compliance data isn't managed by State Manager, a tool + // in Amazon Web Services Systems Manager. It is managed by your direct call to the + // PutComplianceItemsAPI operation. // // By default, all associations use AUTO mode. SyncCompliance AssociationSyncCompliance @@ -1134,9 +1134,9 @@ type Command struct { // The date and time the command was requested. RequestedDateTime *time.Time - // The Identity and Access Management (IAM) service role that Run Command, a - // capability of Amazon Web Services Systems Manager, uses to act on your behalf - // when sending notifications about command status changes. + // The Identity and Access Management (IAM) service role that Run Command, a tool + // in Amazon Web Services Systems Manager, uses to act on your behalf when sending + // notifications about command status changes. ServiceRole *string // The status of the command. @@ -1341,10 +1341,9 @@ type CommandInvocation struct { // The time and date the request was sent to this managed node. RequestedDateTime *time.Time - // The Identity and Access Management (IAM) service role that Run Command, a - // capability of Amazon Web Services Systems Manager, uses to act on your behalf - // when sending notifications about command status changes on a per managed node - // basis. + // The Identity and Access Management (IAM) service role that Run Command, a tool + // in Amazon Web Services Systems Manager, uses to act on your behalf when sending + // notifications about command status changes on a per managed node basis. ServiceRole *string // The URL to the plugin's StdErr file in Amazon Simple Storage Service (Amazon @@ -1713,7 +1712,7 @@ type CreateAssociationBatchRequestEntry struct { // Specify the target for the association. This target is required for // associations that use an Automation runbook and target resources by using rate - // controls. Automation is a capability of Amazon Web Services Systems Manager. + // controls. Automation is a tool in Amazon Web Services Systems Manager. AutomationTargetParameterName *string // The names or Amazon Resource Names (ARNs) of the Change Calendar type documents @@ -1803,9 +1802,9 @@ type CreateAssociationBatchRequestEntry struct { // successfully, the association is NON-COMPLIANT . // // In MANUAL mode, you must specify the AssociationId as a parameter for the PutComplianceItems API - // operation. In this case, compliance data isn't managed by State Manager, a - // capability of Amazon Web Services Systems Manager. It is managed by your direct - // call to the PutComplianceItemsAPI operation. + // operation. In this case, compliance data isn't managed by State Manager, a tool + // in Amazon Web Services Systems Manager. It is managed by your direct call to the + // PutComplianceItemsAPI operation. // // By default, all associations use AUTO mode. SyncCompliance AssociationSyncCompliance @@ -2813,8 +2812,8 @@ type InstancePatchState struct { SnapshotId *string // The number of patches beyond the supported limit of NotApplicableCount that - // aren't reported by name to Inventory. Inventory is a capability of Amazon Web - // Services Systems Manager. + // aren't reported by name to Inventory. Inventory is a tool in Amazon Web Services + // Systems Manager. UnreportedNotApplicableCount *int32 noSmithyDocumentSerde @@ -4580,8 +4579,8 @@ type ParameterInlinePolicy struct { // The JSON text of the policy. PolicyText *string - // The type of policy. Parameter Store, a capability of Amazon Web Services - // Systems Manager, supports the following policy types: Expiration, + // The type of policy. Parameter Store, a tool in Amazon Web Services Systems + // Manager, supports the following policy types: Expiration, // ExpirationNotification, and NoChangeNotification. PolicyType *string @@ -5827,7 +5826,7 @@ type Tag struct { // // Supported formats include the following. // -// For all Systems Manager capabilities: +// For all Systems Manager tools: // // - Key=tag-key,Values=tag-value-1,tag-value-2 // diff --git a/service/ssooidc/api_op_CreateToken.go b/service/ssooidc/api_op_CreateToken.go index 5fb8d2ab946..2ab35244793 100644 --- a/service/ssooidc/api_op_CreateToken.go +++ b/service/ssooidc/api_op_CreateToken.go @@ -12,7 +12,7 @@ import ( // Creates and returns access and refresh tokens for clients that are // authenticated using client secrets. The access token can be used to fetch -// short-term credentials for the assigned AWS accounts or to access application +// short-lived credentials for the assigned AWS accounts or to access application // APIs using bearer authentication. func (c *Client) CreateToken(ctx context.Context, params *CreateTokenInput, optFns ...func(*Options)) (*CreateTokenOutput, error) { if params == nil { @@ -43,22 +43,21 @@ type CreateTokenInput struct { // This member is required. ClientSecret *string - // Supports the following OAuth grant types: Device Code and Refresh Token. - // Specify either of the following values, depending on the grant type that you - // want: + // Supports the following OAuth grant types: Authorization Code, Device Code, and + // Refresh Token. Specify one of the following values, depending on the grant type + // that you want: + // + // * Authorization Code - authorization_code // // * Device Code - urn:ietf:params:oauth:grant-type:device_code // // * Refresh Token - refresh_token // - // For information about how to obtain the device code, see the StartDeviceAuthorization topic. - // // This member is required. GrantType *string // Used only when calling this API for the Authorization Code grant type. The - // short-term code is used to identify this authorization request. This grant type - // is currently unsupported for the CreateTokenAPI. + // short-lived code is used to identify this authorization request. Code *string // Used only when calling this API for the Authorization Code grant type. This @@ -66,9 +65,9 @@ type CreateTokenInput struct { // challenge value the client passed at authorization time. CodeVerifier *string - // Used only when calling this API for the Device Code grant type. This short-term - // code is used to identify this authorization request. This comes from the result - // of the StartDeviceAuthorizationAPI. + // Used only when calling this API for the Device Code grant type. This + // short-lived code is used to identify this authorization request. This comes from + // the result of the StartDeviceAuthorizationAPI. DeviceCode *string // Used only when calling this API for the Authorization Code grant type. This @@ -77,7 +76,7 @@ type CreateTokenInput struct { RedirectUri *string // Used only when calling this API for the Refresh Token grant type. This token is - // used to refresh short-term tokens, such as the access token, that might expire. + // used to refresh short-lived tokens, such as the access token, that might expire. // // For more information about the features and limitations of the current IAM // Identity Center OIDC implementation, see Considerations for Using this Guide in diff --git a/service/ssooidc/api_op_CreateTokenWithIAM.go b/service/ssooidc/api_op_CreateTokenWithIAM.go index 8abd43690d2..e5253ce884f 100644 --- a/service/ssooidc/api_op_CreateTokenWithIAM.go +++ b/service/ssooidc/api_op_CreateTokenWithIAM.go @@ -12,7 +12,7 @@ import ( // Creates and returns access and refresh tokens for clients and applications that // are authenticated using IAM entities. The access token can be used to fetch -// short-term credentials for the assigned Amazon Web Services accounts or to +// short-lived credentials for the assigned Amazon Web Services accounts or to // access application APIs using bearer authentication. func (c *Client) CreateTokenWithIAM(ctx context.Context, params *CreateTokenWithIAMInput, optFns ...func(*Options)) (*CreateTokenWithIAMOutput, error) { if params == nil { @@ -59,7 +59,7 @@ type CreateTokenWithIAMInput struct { Assertion *string // Used only when calling this API for the Authorization Code grant type. This - // short-term code is used to identify this authorization request. The code is + // short-lived code is used to identify this authorization request. The code is // obtained through a redirect from IAM Identity Center to a redirect URI persisted // in the Authorization Code GrantOptions for the application. Code *string @@ -75,7 +75,7 @@ type CreateTokenWithIAMInput struct { RedirectUri *string // Used only when calling this API for the Refresh Token grant type. This token is - // used to refresh short-term tokens, such as the access token, that might expire. + // used to refresh short-lived tokens, such as the access token, that might expire. // // For more information about the features and limitations of the current IAM // Identity Center OIDC implementation, see Considerations for Using this Guide in diff --git a/service/ssooidc/api_op_RegisterClient.go b/service/ssooidc/api_op_RegisterClient.go index 03a3594be0b..2022270db2b 100644 --- a/service/ssooidc/api_op_RegisterClient.go +++ b/service/ssooidc/api_op_RegisterClient.go @@ -10,9 +10,9 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Registers a client with IAM Identity Center. This allows clients to initiate -// device authorization. The output should be persisted for reuse through many -// authentication requests. +// Registers a public client with IAM Identity Center. This allows clients to +// perform authorization using the authorization code grant with Proof Key for Code +// Exchange (PKCE) or the device code grant. func (c *Client) RegisterClient(ctx context.Context, params *RegisterClientInput, optFns ...func(*Options)) (*RegisterClientOutput, error) { if params == nil { params = &RegisterClientInput{} @@ -48,7 +48,15 @@ type RegisterClientInput struct { EntitledApplicationArn *string // The list of OAuth 2.0 grant types that are defined by the client. This list is - // used to restrict the token granting flows available to the client. + // used to restrict the token granting flows available to the client. Supports the + // following OAuth 2.0 grant types: Authorization Code, Device Code, and Refresh + // Token. + // + // * Authorization Code - authorization_code + // + // * Device Code - urn:ietf:params:oauth:grant-type:device_code + // + // * Refresh Token - refresh_token GrantTypes []string // The IAM Identity Center Issuer URL associated with an instance of IAM Identity diff --git a/service/ssooidc/doc.go b/service/ssooidc/doc.go index 1d258e5677b..f3510b18c54 100644 --- a/service/ssooidc/doc.go +++ b/service/ssooidc/doc.go @@ -8,9 +8,12 @@ // Center. The service also enables the client to fetch the user’s access token // upon successful authentication and authorization with IAM Identity Center. // -// IAM Identity Center uses the sso and identitystore API namespaces. +// # API namespaces // -// # Considerations for Using This Guide +// IAM Identity Center uses the sso and identitystore API namespaces. IAM Identity +// Center OpenID Connect uses the sso-oidc namespace. +// +// # Considerations for using this guide // // Before you begin using this guide, we recommend that you first review the // following important information about how the IAM Identity Center OIDC service diff --git a/service/transfer/api_op_CreateAgreement.go b/service/transfer/api_op_CreateAgreement.go index e056d3d1f50..27a4b6d6e3d 100644 --- a/service/transfer/api_op_CreateAgreement.go +++ b/service/transfer/api_op_CreateAgreement.go @@ -19,6 +19,9 @@ import ( // // The partner is identified with the PartnerProfileId , and the AS2 process is // identified with the LocalProfileId . +// +// Specify either BaseDirectory or CustomDirectories , but not both. Specifying +// both causes the command to fail. func (c *Client) CreateAgreement(ctx context.Context, params *CreateAgreementInput, optFns ...func(*Options)) (*CreateAgreementOutput, error) { if params == nil { params = &CreateAgreementInput{} @@ -69,13 +72,6 @@ type CreateAgreementInput struct { // This member is required. AccessRole *string - // The landing directory (folder) for files transferred by using the AS2 protocol. - // - // A BaseDirectory example is /amzn-s3-demo-bucket/home/mydirectory . - // - // This member is required. - BaseDirectory *string - // A unique identifier for the AS2 local profile. // // This member is required. @@ -92,6 +88,26 @@ type CreateAgreementInput struct { // This member is required. ServerId *string + // The landing directory (folder) for files transferred by using the AS2 protocol. + // + // A BaseDirectory example is /amzn-s3-demo-bucket/home/mydirectory . + BaseDirectory *string + + // A CustomDirectoriesType structure. This structure specifies custom directories + // for storing various AS2 message files. You can specify directories for the + // following types of files. + // + // - Failed files + // + // - MDN files + // + // - Payload files + // + // - Status files + // + // - Temporary files + CustomDirectories *types.CustomDirectoriesType + // A name or short description to identify the agreement. Description *string diff --git a/service/transfer/api_op_UpdateAgreement.go b/service/transfer/api_op_UpdateAgreement.go index 0d24614b1a9..acd4a774e25 100644 --- a/service/transfer/api_op_UpdateAgreement.go +++ b/service/transfer/api_op_UpdateAgreement.go @@ -14,6 +14,13 @@ import ( // Updates some of the parameters for an existing agreement. Provide the // AgreementId and the ServerId for the agreement that you want to update, along // with the new values for the parameters to update. +// +// Specify either BaseDirectory or CustomDirectories , but not both. Specifying +// both causes the command to fail. +// +// If you update an agreement from using base directory to custom directories, the +// base directory is no longer used. Similarly, if you change from custom +// directories to a base directory, the custom directories are no longer used. func (c *Client) UpdateAgreement(ctx context.Context, params *UpdateAgreementInput, optFns ...func(*Options)) (*UpdateAgreementOutput, error) { if params == nil { params = &UpdateAgreementInput{} @@ -79,6 +86,21 @@ type UpdateAgreementInput struct { // /amzn-s3-demo-bucket/home/mydirectory . BaseDirectory *string + // A CustomDirectoriesType structure. This structure specifies custom directories + // for storing various AS2 message files. You can specify directories for the + // following types of files. + // + // - Failed files + // + // - MDN files + // + // - Payload files + // + // - Status files + // + // - Temporary files + CustomDirectories *types.CustomDirectoriesType + // To replace the existing description, provide a short description for the // agreement. Description *string diff --git a/service/transfer/deserializers.go b/service/transfer/deserializers.go index 6662089bdd9..52b18233893 100644 --- a/service/transfer/deserializers.go +++ b/service/transfer/deserializers.go @@ -8921,6 +8921,82 @@ func awsAwsjson11_deserializeDocumentCopyStepDetails(v **types.CopyStepDetails, return nil } +func awsAwsjson11_deserializeDocumentCustomDirectoriesType(v **types.CustomDirectoriesType, value interface{}) error { + if v == nil { + return fmt.Errorf("unexpected nil of type %T", v) + } + if value == nil { + return nil + } + + shape, ok := value.(map[string]interface{}) + if !ok { + return fmt.Errorf("unexpected JSON type %v", value) + } + + var sv *types.CustomDirectoriesType + if *v == nil { + sv = &types.CustomDirectoriesType{} + } else { + sv = *v + } + + for key, value := range shape { + switch key { + case "FailedFilesDirectory": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected HomeDirectory to be of type string, got %T instead", value) + } + sv.FailedFilesDirectory = ptr.String(jtv) + } + + case "MdnFilesDirectory": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected HomeDirectory to be of type string, got %T instead", value) + } + sv.MdnFilesDirectory = ptr.String(jtv) + } + + case "PayloadFilesDirectory": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected HomeDirectory to be of type string, got %T instead", value) + } + sv.PayloadFilesDirectory = ptr.String(jtv) + } + + case "StatusFilesDirectory": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected HomeDirectory to be of type string, got %T instead", value) + } + sv.StatusFilesDirectory = ptr.String(jtv) + } + + case "TemporaryFilesDirectory": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected HomeDirectory to be of type string, got %T instead", value) + } + sv.TemporaryFilesDirectory = ptr.String(jtv) + } + + default: + _, _ = key, value + + } + } + *v = sv + return nil +} + func awsAwsjson11_deserializeDocumentCustomStepDetails(v **types.CustomStepDetails, value interface{}) error { if v == nil { return fmt.Errorf("unexpected nil of type %T", v) @@ -9257,6 +9333,11 @@ func awsAwsjson11_deserializeDocumentDescribedAgreement(v **types.DescribedAgree sv.BaseDirectory = ptr.String(jtv) } + case "CustomDirectories": + if err := awsAwsjson11_deserializeDocumentCustomDirectoriesType(&sv.CustomDirectories, value); err != nil { + return err + } + case "Description": if value != nil { jtv, ok := value.(string) diff --git a/service/transfer/serializers.go b/service/transfer/serializers.go index 16ca73b470d..f168f268fb4 100644 --- a/service/transfer/serializers.go +++ b/service/transfer/serializers.go @@ -4344,6 +4344,38 @@ func awsAwsjson11_serializeDocumentCopyStepDetails(v *types.CopyStepDetails, val return nil } +func awsAwsjson11_serializeDocumentCustomDirectoriesType(v *types.CustomDirectoriesType, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.FailedFilesDirectory != nil { + ok := object.Key("FailedFilesDirectory") + ok.String(*v.FailedFilesDirectory) + } + + if v.MdnFilesDirectory != nil { + ok := object.Key("MdnFilesDirectory") + ok.String(*v.MdnFilesDirectory) + } + + if v.PayloadFilesDirectory != nil { + ok := object.Key("PayloadFilesDirectory") + ok.String(*v.PayloadFilesDirectory) + } + + if v.StatusFilesDirectory != nil { + ok := object.Key("StatusFilesDirectory") + ok.String(*v.StatusFilesDirectory) + } + + if v.TemporaryFilesDirectory != nil { + ok := object.Key("TemporaryFilesDirectory") + ok.String(*v.TemporaryFilesDirectory) + } + + return nil +} + func awsAwsjson11_serializeDocumentCustomStepDetails(v *types.CustomStepDetails, value smithyjson.Value) error { object := value.Object() defer object.Close() @@ -5108,6 +5140,13 @@ func awsAwsjson11_serializeOpDocumentCreateAgreementInput(v *CreateAgreementInpu ok.String(*v.BaseDirectory) } + if v.CustomDirectories != nil { + ok := object.Key("CustomDirectories") + if err := awsAwsjson11_serializeDocumentCustomDirectoriesType(v.CustomDirectories, ok); err != nil { + return err + } + } + if v.Description != nil { ok := object.Key("Description") ok.String(*v.Description) @@ -6473,6 +6512,13 @@ func awsAwsjson11_serializeOpDocumentUpdateAgreementInput(v *UpdateAgreementInpu ok.String(*v.BaseDirectory) } + if v.CustomDirectories != nil { + ok := object.Key("CustomDirectories") + if err := awsAwsjson11_serializeDocumentCustomDirectoriesType(v.CustomDirectories, ok); err != nil { + return err + } + } + if v.Description != nil { ok := object.Key("Description") ok.String(*v.Description) diff --git a/service/transfer/types/types.go b/service/transfer/types/types.go index ae86a4283f1..d20e0f06db8 100644 --- a/service/transfer/types/types.go +++ b/service/transfer/types/types.go @@ -170,6 +170,37 @@ type CopyStepDetails struct { noSmithyDocumentSerde } +// Contains Amazon S3 locations for storing specific types of AS2 message files. +type CustomDirectoriesType struct { + + // Specifies a location to store failed AS2 message files. + // + // This member is required. + FailedFilesDirectory *string + + // Specifies a location to store MDN files. + // + // This member is required. + MdnFilesDirectory *string + + // Specifies a location to store the payload for AS2 message files. + // + // This member is required. + PayloadFilesDirectory *string + + // Specifies a location to store AS2 status messages. + // + // This member is required. + StatusFilesDirectory *string + + // Specifies a location to store temporary AS2 message files. + // + // This member is required. + TemporaryFilesDirectory *string + + noSmithyDocumentSerde +} + // Each step type has its own StepDetails structure. type CustomStepDetails struct { @@ -401,6 +432,21 @@ type DescribedAgreement struct { // protocol. BaseDirectory *string + // A CustomDirectoriesType structure. This structure specifies custom directories + // for storing various AS2 message files. You can specify directories for the + // following types of files. + // + // - Failed files + // + // - MDN files + // + // - Payload files + // + // - Status files + // + // - Temporary files + CustomDirectories *CustomDirectoriesType + // The name or short description that's used to identify the agreement. Description *string diff --git a/service/transfer/validators.go b/service/transfer/validators.go index 5cc00afd002..46865c60030 100644 --- a/service/transfer/validators.go +++ b/service/transfer/validators.go @@ -1498,6 +1498,33 @@ func addOpUpdateWebAppValidationMiddleware(stack *middleware.Stack) error { return stack.Initialize.Add(&validateOpUpdateWebApp{}, middleware.After) } +func validateCustomDirectoriesType(v *types.CustomDirectoriesType) error { + if v == nil { + return nil + } + invalidParams := smithy.InvalidParamsError{Context: "CustomDirectoriesType"} + if v.FailedFilesDirectory == nil { + invalidParams.Add(smithy.NewErrParamRequired("FailedFilesDirectory")) + } + if v.MdnFilesDirectory == nil { + invalidParams.Add(smithy.NewErrParamRequired("MdnFilesDirectory")) + } + if v.PayloadFilesDirectory == nil { + invalidParams.Add(smithy.NewErrParamRequired("PayloadFilesDirectory")) + } + if v.StatusFilesDirectory == nil { + invalidParams.Add(smithy.NewErrParamRequired("StatusFilesDirectory")) + } + if v.TemporaryFilesDirectory == nil { + invalidParams.Add(smithy.NewErrParamRequired("TemporaryFilesDirectory")) + } + if invalidParams.Len() > 0 { + return invalidParams + } else { + return nil + } +} + func validateDecryptStepDetails(v *types.DecryptStepDetails) error { if v == nil { return nil @@ -1814,9 +1841,6 @@ func validateOpCreateAgreementInput(v *CreateAgreementInput) error { if v.PartnerProfileId == nil { invalidParams.Add(smithy.NewErrParamRequired("PartnerProfileId")) } - if v.BaseDirectory == nil { - invalidParams.Add(smithy.NewErrParamRequired("BaseDirectory")) - } if v.AccessRole == nil { invalidParams.Add(smithy.NewErrParamRequired("AccessRole")) } @@ -1825,6 +1849,11 @@ func validateOpCreateAgreementInput(v *CreateAgreementInput) error { invalidParams.AddNested("Tags", err.(smithy.InvalidParamsError)) } } + if v.CustomDirectories != nil { + if err := validateCustomDirectoriesType(v.CustomDirectories); err != nil { + invalidParams.AddNested("CustomDirectories", err.(smithy.InvalidParamsError)) + } + } if invalidParams.Len() > 0 { return invalidParams } else { @@ -2770,6 +2799,11 @@ func validateOpUpdateAgreementInput(v *UpdateAgreementInput) error { if v.ServerId == nil { invalidParams.Add(smithy.NewErrParamRequired("ServerId")) } + if v.CustomDirectories != nil { + if err := validateCustomDirectoriesType(v.CustomDirectories); err != nil { + invalidParams.AddNested("CustomDirectories", err.(smithy.InvalidParamsError)) + } + } if invalidParams.Len() > 0 { return invalidParams } else {