diff --git a/.changelog/90bc24c6e2404675b311f1fdc9c3a5cf.json b/.changelog/90bc24c6e2404675b311f1fdc9c3a5cf.json new file mode 100644 index 00000000000..7f0a73f03b9 --- /dev/null +++ b/.changelog/90bc24c6e2404675b311f1fdc9c3a5cf.json @@ -0,0 +1,8 @@ +{ + "id": "90bc24c6-e240-4675-b311-f1fdc9c3a5cf", + "type": "documentation", + "description": "Systems Manager doc-only updates for August 2024.", + "modules": [ + "service/ssm" + ] +} \ No newline at end of file diff --git a/.changelog/aaf624b0d8914aa99a310815bc9646cd.json b/.changelog/aaf624b0d8914aa99a310815bc9646cd.json new file mode 100644 index 00000000000..3d2b25d21ad --- /dev/null +++ b/.changelog/aaf624b0d8914aa99a310815bc9646cd.json @@ -0,0 +1,8 @@ +{ + "id": "aaf624b0-d891-4aa9-9a31-0815bc9646cd", + "type": "documentation", + "description": "Fixed a description of AdvancedSecurityAdditionalFlows in Amazon Cognito user pool configuration.", + "modules": [ + "service/cognitoidentityprovider" + ] +} \ No newline at end of file diff --git a/.changelog/d80fa6836f3849cfb22a10dedbbb6235.json b/.changelog/d80fa6836f3849cfb22a10dedbbb6235.json new file mode 100644 index 00000000000..8a89079586d --- /dev/null +++ b/.changelog/d80fa6836f3849cfb22a10dedbbb6235.json @@ -0,0 +1,8 @@ +{ + "id": "d80fa683-6f38-49cf-b22a-10dedbbb6235", + "type": "feature", + "description": "This release supports adding RoutingCriteria via UpdateContactRoutingData public API.", + "modules": [ + "service/connect" + ] +} \ No newline at end of file diff --git a/feature/dynamodbstreams/attributevalue/go_module_metadata.go b/feature/dynamodbstreams/attributevalue/go_module_metadata.go index af510c59b9e..505e79ec5c4 100644 --- a/feature/dynamodbstreams/attributevalue/go_module_metadata.go +++ b/feature/dynamodbstreams/attributevalue/go_module_metadata.go @@ -3,4 +3,4 @@ package attributevalue // goModuleVersion is the tagged release for this module -const goModuleVersion = "1.13.60" +const goModuleVersion = "1.14.10" diff --git a/service/athena/internal/endpoints/endpoints.go b/service/athena/internal/endpoints/endpoints.go index 511b3339a10..798b19cf2a4 100644 --- a/service/athena/internal/endpoints/endpoints.go +++ b/service/athena/internal/endpoints/endpoints.go @@ -241,6 +241,18 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ca-central-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ca-central-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "athena-fips.ca-central-1.amazonaws.com", + }, + endpoints.EndpointKey{ + Region: "ca-central-1", + Variant: endpoints.FIPSVariant | endpoints.DualStackVariant, + }: { + Hostname: "athena-fips.ca-central-1.api.aws", + }, endpoints.EndpointKey{ Region: "ca-central-1", Variant: endpoints.DualStackVariant, @@ -250,6 +262,18 @@ var defaultPartitions = endpoints.Partitions{ endpoints.EndpointKey{ Region: "ca-west-1", }: endpoints.Endpoint{}, + endpoints.EndpointKey{ + Region: "ca-west-1", + Variant: endpoints.FIPSVariant, + }: { + Hostname: "athena-fips.ca-west-1.amazonaws.com", + }, + endpoints.EndpointKey{ + Region: "ca-west-1", + Variant: endpoints.FIPSVariant | endpoints.DualStackVariant, + }: { + Hostname: "athena-fips.ca-west-1.api.aws", + }, endpoints.EndpointKey{ Region: "ca-west-1", Variant: endpoints.DualStackVariant, @@ -328,6 +352,24 @@ var defaultPartitions = endpoints.Partitions{ }: { Hostname: "athena.eu-west-3.api.aws", }, + endpoints.EndpointKey{ + Region: "fips-ca-central-1", + }: endpoints.Endpoint{ + Hostname: "athena-fips.ca-central-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "ca-central-1", + }, + Deprecated: aws.TrueTernary, + }, + endpoints.EndpointKey{ + Region: "fips-ca-west-1", + }: endpoints.Endpoint{ + Hostname: "athena-fips.ca-west-1.amazonaws.com", + CredentialScope: endpoints.CredentialScope{ + Region: "ca-west-1", + }, + Deprecated: aws.TrueTernary, + }, endpoints.EndpointKey{ Region: "fips-us-east-1", }: endpoints.Endpoint{ diff --git a/service/cognitoidentityprovider/api_op_AdminCreateUser.go b/service/cognitoidentityprovider/api_op_AdminCreateUser.go index f2364ebbf52..9d2241ba086 100644 --- a/service/cognitoidentityprovider/api_op_AdminCreateUser.go +++ b/service/cognitoidentityprovider/api_op_AdminCreateUser.go @@ -25,10 +25,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // This message is based on a template that you configured in your call to create diff --git a/service/cognitoidentityprovider/api_op_AdminInitiateAuth.go b/service/cognitoidentityprovider/api_op_AdminInitiateAuth.go index 735a11bb570..0f54c3ca938 100644 --- a/service/cognitoidentityprovider/api_op_AdminInitiateAuth.go +++ b/service/cognitoidentityprovider/api_op_AdminInitiateAuth.go @@ -22,10 +22,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Amazon Cognito evaluates Identity and Access Management (IAM) policies in diff --git a/service/cognitoidentityprovider/api_op_AdminResetUserPassword.go b/service/cognitoidentityprovider/api_op_AdminResetUserPassword.go index 79a80809ad9..f13bf2c2a93 100644 --- a/service/cognitoidentityprovider/api_op_AdminResetUserPassword.go +++ b/service/cognitoidentityprovider/api_op_AdminResetUserPassword.go @@ -25,10 +25,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Deactivates a user's password, requiring them to change it. If a user tries to diff --git a/service/cognitoidentityprovider/api_op_AdminRespondToAuthChallenge.go b/service/cognitoidentityprovider/api_op_AdminRespondToAuthChallenge.go index 1acd70f72dc..4b38b31fe51 100644 --- a/service/cognitoidentityprovider/api_op_AdminRespondToAuthChallenge.go +++ b/service/cognitoidentityprovider/api_op_AdminRespondToAuthChallenge.go @@ -29,10 +29,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Amazon Cognito evaluates Identity and Access Management (IAM) policies in diff --git a/service/cognitoidentityprovider/api_op_AdminUpdateUserAttributes.go b/service/cognitoidentityprovider/api_op_AdminUpdateUserAttributes.go index 755687f583d..144ae692564 100644 --- a/service/cognitoidentityprovider/api_op_AdminUpdateUserAttributes.go +++ b/service/cognitoidentityprovider/api_op_AdminUpdateUserAttributes.go @@ -20,10 +20,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Updates the specified user's attributes, including developer attributes, as an diff --git a/service/cognitoidentityprovider/api_op_CreateUserPool.go b/service/cognitoidentityprovider/api_op_CreateUserPool.go index 90b4c94dbc0..5c8c8529038 100644 --- a/service/cognitoidentityprovider/api_op_CreateUserPool.go +++ b/service/cognitoidentityprovider/api_op_CreateUserPool.go @@ -20,10 +20,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Creates a new Amazon Cognito user pool and sets the password policy for the diff --git a/service/cognitoidentityprovider/api_op_ForgotPassword.go b/service/cognitoidentityprovider/api_op_ForgotPassword.go index a32856075e5..78cd8a4183e 100644 --- a/service/cognitoidentityprovider/api_op_ForgotPassword.go +++ b/service/cognitoidentityprovider/api_op_ForgotPassword.go @@ -42,10 +42,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_GetUserAttributeVerificationCode.go b/service/cognitoidentityprovider/api_op_GetUserAttributeVerificationCode.go index 702aa7dedb2..0bb00700eba 100644 --- a/service/cognitoidentityprovider/api_op_GetUserAttributeVerificationCode.go +++ b/service/cognitoidentityprovider/api_op_GetUserAttributeVerificationCode.go @@ -33,10 +33,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_InitiateAuth.go b/service/cognitoidentityprovider/api_op_InitiateAuth.go index febe3b6dc10..801d4f599ca 100644 --- a/service/cognitoidentityprovider/api_op_InitiateAuth.go +++ b/service/cognitoidentityprovider/api_op_InitiateAuth.go @@ -30,10 +30,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [Adding user pool sign-in through a third party]: https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-identity-federation.html diff --git a/service/cognitoidentityprovider/api_op_ResendConfirmationCode.go b/service/cognitoidentityprovider/api_op_ResendConfirmationCode.go index 664102558cd..a1f60ca93f6 100644 --- a/service/cognitoidentityprovider/api_op_ResendConfirmationCode.go +++ b/service/cognitoidentityprovider/api_op_ResendConfirmationCode.go @@ -29,10 +29,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_RespondToAuthChallenge.go b/service/cognitoidentityprovider/api_op_RespondToAuthChallenge.go index 198e70f1d81..eeb0a893c95 100644 --- a/service/cognitoidentityprovider/api_op_RespondToAuthChallenge.go +++ b/service/cognitoidentityprovider/api_op_RespondToAuthChallenge.go @@ -35,10 +35,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_SetUserPoolMfaConfig.go b/service/cognitoidentityprovider/api_op_SetUserPoolMfaConfig.go index 53b3ac28309..5857afb12b1 100644 --- a/service/cognitoidentityprovider/api_op_SetUserPoolMfaConfig.go +++ b/service/cognitoidentityprovider/api_op_SetUserPoolMfaConfig.go @@ -22,10 +22,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_SignUp.go b/service/cognitoidentityprovider/api_op_SignUp.go index 9ea5fa24fbb..6fdfa8e9c5e 100644 --- a/service/cognitoidentityprovider/api_op_SignUp.go +++ b/service/cognitoidentityprovider/api_op_SignUp.go @@ -29,10 +29,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_UpdateUserAttributes.go b/service/cognitoidentityprovider/api_op_UpdateUserAttributes.go index f0e1b7ba089..149e72e663e 100644 --- a/service/cognitoidentityprovider/api_op_UpdateUserAttributes.go +++ b/service/cognitoidentityprovider/api_op_UpdateUserAttributes.go @@ -35,10 +35,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // [SMS message settings for Amazon Cognito user pools]: https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-sms-settings.html diff --git a/service/cognitoidentityprovider/api_op_UpdateUserPool.go b/service/cognitoidentityprovider/api_op_UpdateUserPool.go index 7149447b435..6f707a237ae 100644 --- a/service/cognitoidentityprovider/api_op_UpdateUserPool.go +++ b/service/cognitoidentityprovider/api_op_UpdateUserPool.go @@ -20,10 +20,10 @@ import ( // sign in. // // If you have never used SMS text messages with Amazon Cognito or any other -// Amazon Web Service, Amazon Simple Notification Service might place your account -// in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone numbers. -// After you test your app while in the sandbox environment, you can move out of -// the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon +// Amazon Web Services service, Amazon Simple Notification Service might place your +// account in the SMS sandbox. In [sandbox mode], you can send messages only to verified phone +// numbers. After you test your app while in the sandbox environment, you can move +// out of the sandbox and into production. For more information, see [SMS message settings for Amazon Cognito user pools]in the Amazon // Cognito Developer Guide. // // Updates the specified user pool with the specified attributes. You can get a diff --git a/service/cognitoidentityprovider/types/types.go b/service/cognitoidentityprovider/types/types.go index 29f047c9151..352b8eadc27 100644 --- a/service/cognitoidentityprovider/types/types.go +++ b/service/cognitoidentityprovider/types/types.go @@ -101,8 +101,7 @@ type AdminCreateUserConfigType struct { } // Advanced security configuration options for additional authentication types in -// your user pool, including custom authentication and refresh-token -// authentication. +// your user pool, including custom authentication. type AdvancedSecurityAdditionalFlowsType struct { // The operating mode of advanced security features in custom authentication with [Custom authentication challenge Lambda triggers] @@ -1717,8 +1716,7 @@ type UserPoolAddOnsType struct { AdvancedSecurityMode AdvancedSecurityModeType // Advanced security configuration options for additional authentication types in - // your user pool, including custom authentication and refresh-token - // authentication. + // your user pool, including custom authentication. AdvancedSecurityAdditionalFlows *AdvancedSecurityAdditionalFlowsType noSmithyDocumentSerde diff --git a/service/connect/api_op_CreateInstance.go b/service/connect/api_op_CreateInstance.go index 3a69bfcbf0f..77af7260fab 100644 --- a/service/connect/api_op_CreateInstance.go +++ b/service/connect/api_op_CreateInstance.go @@ -18,11 +18,15 @@ import ( // S3) or Amazon Kinesis. It also does not allow for any configurations on // features, such as Contact Lens for Amazon Connect. // +// For more information, see [Create an Amazon Connect instance] in the Amazon Connect Administrator Guide. +// // Amazon Connect enforces a limit on the total number of instances that you can // create or delete in 30 days. If you exceed this limit, you will get an error // message indicating there has been an excessive number of attempts at creating or // deleting instances. You must wait 30 days before you can restart creating and // deleting instances in your account. +// +// [Create an Amazon Connect instance]: https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-instances.html func (c *Client) CreateInstance(ctx context.Context, params *CreateInstanceInput, optFns ...func(*Options)) (*CreateInstanceOutput, error) { if params == nil { params = &CreateInstanceInput{} diff --git a/service/connect/api_op_CreatePredefinedAttribute.go b/service/connect/api_op_CreatePredefinedAttribute.go index 55d5fff893c..1e552796e85 100644 --- a/service/connect/api_op_CreatePredefinedAttribute.go +++ b/service/connect/api_op_CreatePredefinedAttribute.go @@ -12,6 +12,11 @@ import ( ) // Creates a new predefined attribute for the specified Amazon Connect instance. +// Predefined attributes are attributes in an Amazon Connect instance that can be +// used to route contacts to an agent or pools of agents within a queue. For more +// information, see [Create predefined attributes for routing contacts to agents]. +// +// [Create predefined attributes for routing contacts to agents]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html func (c *Client) CreatePredefinedAttribute(ctx context.Context, params *CreatePredefinedAttributeInput, optFns ...func(*Options)) (*CreatePredefinedAttributeOutput, error) { if params == nil { params = &CreatePredefinedAttributeInput{} diff --git a/service/connect/api_op_CreateSecurityProfile.go b/service/connect/api_op_CreateSecurityProfile.go index 4833a78f37a..6f075f5ac9b 100644 --- a/service/connect/api_op_CreateSecurityProfile.go +++ b/service/connect/api_op_CreateSecurityProfile.go @@ -12,6 +12,13 @@ import ( ) // Creates a security profile. +// +// For information about security profiles, see [Security Profiles] in the Amazon Connect +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. +// +// [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) CreateSecurityProfile(ctx context.Context, params *CreateSecurityProfileInput, optFns ...func(*Options)) (*CreateSecurityProfileOutput, error) { if params == nil { params = &CreateSecurityProfileInput{} diff --git a/service/connect/api_op_DeleteInstance.go b/service/connect/api_op_DeleteInstance.go index fc8f7a1a213..3ba2410d0d2 100644 --- a/service/connect/api_op_DeleteInstance.go +++ b/service/connect/api_op_DeleteInstance.go @@ -12,13 +12,16 @@ import ( // This API is in preview release for Amazon Connect and is subject to change. // -// Deletes the Amazon Connect instance. +// Deletes the Amazon Connect instance. For more information, see [Delete your Amazon Connect instance] in the Amazon +// Connect Administrator Guide. // // Amazon Connect enforces a limit on the total number of instances that you can // create or delete in 30 days. If you exceed this limit, you will get an error // message indicating there has been an excessive number of attempts at creating or // deleting instances. You must wait 30 days before you can restart creating and // deleting instances in your account. +// +// [Delete your Amazon Connect instance]: https://docs.aws.amazon.com/connect/latest/adminguide/delete-connect-instance.html func (c *Client) DeleteInstance(ctx context.Context, params *DeleteInstanceInput, optFns ...func(*Options)) (*DeleteInstanceOutput, error) { if params == nil { params = &DeleteInstanceInput{} diff --git a/service/connect/api_op_DeleteQueue.go b/service/connect/api_op_DeleteQueue.go index 9d0b8196a80..cc0da27dbbc 100644 --- a/service/connect/api_op_DeleteQueue.go +++ b/service/connect/api_op_DeleteQueue.go @@ -10,7 +10,8 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Deletes a queue. +// Deletes a queue. It isn't possible to delete a queue by using the Amazon +// Connect admin website. func (c *Client) DeleteQueue(ctx context.Context, params *DeleteQueueInput, optFns ...func(*Options)) (*DeleteQueueOutput, error) { if params == nil { params = &DeleteQueueInput{} diff --git a/service/connect/api_op_DescribePredefinedAttribute.go b/service/connect/api_op_DescribePredefinedAttribute.go index b7b8b0fb257..bcb4e5f0208 100644 --- a/service/connect/api_op_DescribePredefinedAttribute.go +++ b/service/connect/api_op_DescribePredefinedAttribute.go @@ -12,6 +12,11 @@ import ( ) // Describes a predefined attribute for the specified Amazon Connect instance. +// Predefined attributes are attributes in an Amazon Connect instance that can be +// used to route contacts to an agent or pools of agents within a queue. For more +// information, see [Create predefined attributes for routing contacts to agents]. +// +// [Create predefined attributes for routing contacts to agents]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html func (c *Client) DescribePredefinedAttribute(ctx context.Context, params *DescribePredefinedAttributeInput, optFns ...func(*Options)) (*DescribePredefinedAttributeOutput, error) { if params == nil { params = &DescribePredefinedAttributeInput{} diff --git a/service/connect/api_op_DescribeSecurityProfile.go b/service/connect/api_op_DescribeSecurityProfile.go index 5d6b148855a..9eaf7af9cbc 100644 --- a/service/connect/api_op_DescribeSecurityProfile.go +++ b/service/connect/api_op_DescribeSecurityProfile.go @@ -11,7 +11,14 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Gets basic information about the security profle. +// Gets basic information about the security profile. +// +// For information about security profiles, see [Security Profiles] in the Amazon Connect +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. +// +// [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) DescribeSecurityProfile(ctx context.Context, params *DescribeSecurityProfileInput, optFns ...func(*Options)) (*DescribeSecurityProfileOutput, error) { if params == nil { params = &DescribeSecurityProfileInput{} diff --git a/service/connect/api_op_ListPredefinedAttributes.go b/service/connect/api_op_ListPredefinedAttributes.go index a732fda4665..3dd1b2c8adf 100644 --- a/service/connect/api_op_ListPredefinedAttributes.go +++ b/service/connect/api_op_ListPredefinedAttributes.go @@ -12,6 +12,11 @@ import ( ) // Lists predefined attributes for the specified Amazon Connect instance. +// Predefined attributes are attributes in an Amazon Connect instance that can be +// used to route contacts to an agent or pools of agents within a queue. For more +// information, see [Create predefined attributes for routing contacts to agents]. +// +// [Create predefined attributes for routing contacts to agents]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html func (c *Client) ListPredefinedAttributes(ctx context.Context, params *ListPredefinedAttributesInput, optFns ...func(*Options)) (*ListPredefinedAttributesOutput, error) { if params == nil { params = &ListPredefinedAttributesInput{} diff --git a/service/connect/api_op_ListSecurityProfilePermissions.go b/service/connect/api_op_ListSecurityProfilePermissions.go index 51da42f0326..efc5c14eec1 100644 --- a/service/connect/api_op_ListSecurityProfilePermissions.go +++ b/service/connect/api_op_ListSecurityProfilePermissions.go @@ -12,6 +12,13 @@ import ( ) // Lists the permissions granted to a security profile. +// +// For information about security profiles, see [Security Profiles] in the Amazon Connect +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. +// +// [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) ListSecurityProfilePermissions(ctx context.Context, params *ListSecurityProfilePermissionsInput, optFns ...func(*Options)) (*ListSecurityProfilePermissionsOutput, error) { if params == nil { params = &ListSecurityProfilePermissionsInput{} diff --git a/service/connect/api_op_ListSecurityProfiles.go b/service/connect/api_op_ListSecurityProfiles.go index 5e188da5780..1b7837a99f2 100644 --- a/service/connect/api_op_ListSecurityProfiles.go +++ b/service/connect/api_op_ListSecurityProfiles.go @@ -15,9 +15,11 @@ import ( // Amazon Connect instance. // // For more information about security profiles, see [Security Profiles] in the Amazon Connect -// Administrator Guide. +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. // // [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) ListSecurityProfiles(ctx context.Context, params *ListSecurityProfilesInput, optFns ...func(*Options)) (*ListSecurityProfilesOutput, error) { if params == nil { params = &ListSecurityProfilesInput{} diff --git a/service/connect/api_op_SearchPredefinedAttributes.go b/service/connect/api_op_SearchPredefinedAttributes.go index c3867759865..69a343632a4 100644 --- a/service/connect/api_op_SearchPredefinedAttributes.go +++ b/service/connect/api_op_SearchPredefinedAttributes.go @@ -11,7 +11,12 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Predefined attributes that meet certain criteria. +// Searches predefined attributes that meet certain criteria. Predefined +// attributes are attributes in an Amazon Connect instance that can be used to +// route contacts to an agent or pools of agents within a queue. For more +// information, see [Create predefined attributes for routing contacts to agents]. +// +// [Create predefined attributes for routing contacts to agents]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html func (c *Client) SearchPredefinedAttributes(ctx context.Context, params *SearchPredefinedAttributesInput, optFns ...func(*Options)) (*SearchPredefinedAttributesOutput, error) { if params == nil { params = &SearchPredefinedAttributesInput{} diff --git a/service/connect/api_op_SearchSecurityProfiles.go b/service/connect/api_op_SearchSecurityProfiles.go index 7a3395a3e39..ae0db98cf6d 100644 --- a/service/connect/api_op_SearchSecurityProfiles.go +++ b/service/connect/api_op_SearchSecurityProfiles.go @@ -13,6 +13,13 @@ import ( // Searches security profiles in an Amazon Connect instance, with optional // filtering. +// +// For information about security profiles, see [Security Profiles] in the Amazon Connect +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. +// +// [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) SearchSecurityProfiles(ctx context.Context, params *SearchSecurityProfilesInput, optFns ...func(*Options)) (*SearchSecurityProfilesOutput, error) { if params == nil { params = &SearchSecurityProfilesInput{} diff --git a/service/connect/api_op_UpdateContactRoutingData.go b/service/connect/api_op_UpdateContactRoutingData.go index ab4d8f1eb89..80cd1151449 100644 --- a/service/connect/api_op_UpdateContactRoutingData.go +++ b/service/connect/api_op_UpdateContactRoutingData.go @@ -6,6 +6,7 @@ import ( "context" "fmt" awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" + "github.com/aws/aws-sdk-go-v2/service/connect/types" "github.com/aws/smithy-go/middleware" smithyhttp "github.com/aws/smithy-go/transport/http" ) @@ -66,6 +67,10 @@ type UpdateContactRoutingDataInput struct { // their position in queue. QueueTimeAdjustmentSeconds *int32 + // Updates the routing criteria on the contact. These properties can be used to + // change how a
 contact is routed within the queue. + RoutingCriteria *types.RoutingCriteriaInput + noSmithyDocumentSerde } diff --git a/service/connect/api_op_UpdatePredefinedAttribute.go b/service/connect/api_op_UpdatePredefinedAttribute.go index 871be3f8b3a..ec554be9e04 100644 --- a/service/connect/api_op_UpdatePredefinedAttribute.go +++ b/service/connect/api_op_UpdatePredefinedAttribute.go @@ -12,6 +12,11 @@ import ( ) // Updates a predefined attribute for the specified Amazon Connect instance. +// Predefined attributes are attributes in an Amazon Connect instance that can be +// used to route contacts to an agent or pools of agents within a queue. For more +// information, see [Create predefined attributes for routing contacts to agents]. +// +// [Create predefined attributes for routing contacts to agents]: https://docs.aws.amazon.com/connect/latest/adminguide/predefined-attributes.html func (c *Client) UpdatePredefinedAttribute(ctx context.Context, params *UpdatePredefinedAttributeInput, optFns ...func(*Options)) (*UpdatePredefinedAttributeOutput, error) { if params == nil { params = &UpdatePredefinedAttributeInput{} diff --git a/service/connect/api_op_UpdateSecurityProfile.go b/service/connect/api_op_UpdateSecurityProfile.go index 784153e94fb..fdc561c836f 100644 --- a/service/connect/api_op_UpdateSecurityProfile.go +++ b/service/connect/api_op_UpdateSecurityProfile.go @@ -12,6 +12,13 @@ import ( ) // Updates a security profile. +// +// For information about security profiles, see [Security Profiles] in the Amazon Connect +// Administrator Guide. For a mapping of the API name and user interface name of +// the security profile permissions, see [List of security profile permissions]. +// +// [Security Profiles]: https://docs.aws.amazon.com/connect/latest/adminguide/connect-security-profiles.html +// [List of security profile permissions]: https://docs.aws.amazon.com/connect/latest/adminguide/security-profile-list.html func (c *Client) UpdateSecurityProfile(ctx context.Context, params *UpdateSecurityProfileInput, optFns ...func(*Options)) (*UpdateSecurityProfileOutput, error) { if params == nil { params = &UpdateSecurityProfileInput{} diff --git a/service/connect/serializers.go b/service/connect/serializers.go index e950665fae4..ee21494f920 100644 --- a/service/connect/serializers.go +++ b/service/connect/serializers.go @@ -19477,6 +19477,13 @@ func awsRestjson1_serializeOpDocumentUpdateContactRoutingDataInput(v *UpdateCont ok.Integer(*v.QueueTimeAdjustmentSeconds) } + if v.RoutingCriteria != nil { + ok := object.Key("RoutingCriteria") + if err := awsRestjson1_serializeDocumentRoutingCriteriaInput(v.RoutingCriteria, ok); err != nil { + return err + } + } + return nil } @@ -23220,6 +23227,17 @@ func awsRestjson1_serializeDocumentAgentHierarchyGroups(v *types.AgentHierarchyG return nil } +func awsRestjson1_serializeDocumentAgentIds(v []string, value smithyjson.Value) error { + array := value.Array() + defer array.Close() + + for i := range v { + av := array.Value() + av.String(v[i]) + } + return nil +} + func awsRestjson1_serializeDocumentAgentResourceIdList(v []string, value smithyjson.Value) error { array := value.Array() defer array.Close() @@ -23231,6 +23249,20 @@ func awsRestjson1_serializeDocumentAgentResourceIdList(v []string, value smithyj return nil } +func awsRestjson1_serializeDocumentAgentsCriteria(v *types.AgentsCriteria, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.AgentIds != nil { + ok := object.Key("AgentIds") + if err := awsRestjson1_serializeDocumentAgentIds(v.AgentIds, ok); err != nil { + return err + } + } + + return nil +} + func awsRestjson1_serializeDocumentAgentsMinOneMaxHundred(v []string, value smithyjson.Value) error { array := value.Array() defer array.Close() @@ -23428,6 +23460,53 @@ func awsRestjson1_serializeDocumentAttributeAndCondition(v *types.AttributeAndCo return nil } +func awsRestjson1_serializeDocumentAttributeCondition(v *types.AttributeCondition, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.ComparisonOperator != nil { + ok := object.Key("ComparisonOperator") + ok.String(*v.ComparisonOperator) + } + + if v.MatchCriteria != nil { + ok := object.Key("MatchCriteria") + if err := awsRestjson1_serializeDocumentMatchCriteria(v.MatchCriteria, ok); err != nil { + return err + } + } + + if v.Name != nil { + ok := object.Key("Name") + ok.String(*v.Name) + } + + if v.ProficiencyLevel != nil { + ok := object.Key("ProficiencyLevel") + switch { + case math.IsNaN(float64(*v.ProficiencyLevel)): + ok.String("NaN") + + case math.IsInf(float64(*v.ProficiencyLevel), 1): + ok.String("Infinity") + + case math.IsInf(float64(*v.ProficiencyLevel), -1): + ok.String("-Infinity") + + default: + ok.Float(*v.ProficiencyLevel) + + } + } + + if v.Value != nil { + ok := object.Key("Value") + ok.String(*v.Value) + } + + return nil +} + func awsRestjson1_serializeDocumentAttributeOrConditionList(v []types.AttributeAndCondition, value smithyjson.Value) error { array := value.Array() defer array.Close() @@ -24658,6 +24737,47 @@ func awsRestjson1_serializeDocumentEventBridgeActionDefinition(v *types.EventBri return nil } +func awsRestjson1_serializeDocumentExpression(v *types.Expression, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.AndExpression != nil { + ok := object.Key("AndExpression") + if err := awsRestjson1_serializeDocumentExpressions(v.AndExpression, ok); err != nil { + return err + } + } + + if v.AttributeCondition != nil { + ok := object.Key("AttributeCondition") + if err := awsRestjson1_serializeDocumentAttributeCondition(v.AttributeCondition, ok); err != nil { + return err + } + } + + if v.OrExpression != nil { + ok := object.Key("OrExpression") + if err := awsRestjson1_serializeDocumentExpressions(v.OrExpression, ok); err != nil { + return err + } + } + + return nil +} + +func awsRestjson1_serializeDocumentExpressions(v []types.Expression, value smithyjson.Value) error { + array := value.Array() + defer array.Close() + + for i := range v { + av := array.Value() + if err := awsRestjson1_serializeDocumentExpression(&v[i], av); err != nil { + return err + } + } + return nil +} + func awsRestjson1_serializeDocumentFieldValue(v *types.FieldValue, value smithyjson.Value) error { object := value.Object() defer object.Close() @@ -25296,6 +25416,20 @@ func awsRestjson1_serializeDocumentListCondition(v *types.ListCondition, value s return nil } +func awsRestjson1_serializeDocumentMatchCriteria(v *types.MatchCriteria, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.AgentsCriteria != nil { + ok := object.Key("AgentsCriteria") + if err := awsRestjson1_serializeDocumentAgentsCriteria(v.AgentsCriteria, ok); err != nil { + return err + } + } + + return nil +} + func awsRestjson1_serializeDocumentMediaConcurrencies(v []types.MediaConcurrency, value smithyjson.Value) error { array := value.Array() defer array.Close() @@ -26138,6 +26272,66 @@ func awsRestjson1_serializeDocumentResourceTypeList(v []string, value smithyjson return nil } +func awsRestjson1_serializeDocumentRoutingCriteriaInput(v *types.RoutingCriteriaInput, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.Steps != nil { + ok := object.Key("Steps") + if err := awsRestjson1_serializeDocumentRoutingCriteriaInputSteps(v.Steps, ok); err != nil { + return err + } + } + + return nil +} + +func awsRestjson1_serializeDocumentRoutingCriteriaInputStep(v *types.RoutingCriteriaInputStep, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.Expiry != nil { + ok := object.Key("Expiry") + if err := awsRestjson1_serializeDocumentRoutingCriteriaInputStepExpiry(v.Expiry, ok); err != nil { + return err + } + } + + if v.Expression != nil { + ok := object.Key("Expression") + if err := awsRestjson1_serializeDocumentExpression(v.Expression, ok); err != nil { + return err + } + } + + return nil +} + +func awsRestjson1_serializeDocumentRoutingCriteriaInputStepExpiry(v *types.RoutingCriteriaInputStepExpiry, value smithyjson.Value) error { + object := value.Object() + defer object.Close() + + if v.DurationInSeconds != nil { + ok := object.Key("DurationInSeconds") + ok.Integer(*v.DurationInSeconds) + } + + return nil +} + +func awsRestjson1_serializeDocumentRoutingCriteriaInputSteps(v []types.RoutingCriteriaInputStep, value smithyjson.Value) error { + array := value.Array() + defer array.Close() + + for i := range v { + av := array.Value() + if err := awsRestjson1_serializeDocumentRoutingCriteriaInputStep(&v[i], av); err != nil { + return err + } + } + return nil +} + func awsRestjson1_serializeDocumentRoutingExpressions(v []string, value smithyjson.Value) error { array := value.Array() defer array.Close() diff --git a/service/connect/types/types.go b/service/connect/types/types.go index df7c39fadb2..976b67798ad 100644 --- a/service/connect/types/types.go +++ b/service/connect/types/types.go @@ -132,12 +132,12 @@ type AgentQualityMetrics struct { noSmithyDocumentSerde } -// Can be used to define a list of preferred agents to target the contact within -// the queue. Note that agents must have the queue in their routing profile in -// order to be offered the contact. +// Can be used to define a list of preferred agents to target the contact to +// within the queue.
 Note that agents must have the queue in their routing profile +// in order to be offered the
 contact. type AgentsCriteria struct { - // An object to specify a list of agents, by Agent ID. + // An object to specify a list of agents, by user ID. AgentIds []string noSmithyDocumentSerde @@ -3293,10 +3293,10 @@ type ListPhoneNumbersSummary struct { noSmithyDocumentSerde } -// An object to define AgentsCriteria . +// An object to define AgentsCriteria. type MatchCriteria struct { - // An object to define AgentIds . + // An object to define agentIds. AgentsCriteria *AgentsCriteria noSmithyDocumentSerde @@ -4762,6 +4762,42 @@ type RoutingCriteria struct { noSmithyDocumentSerde } +// An object to define the RoutingCriteria. +type RoutingCriteriaInput struct { + + // When Amazon Connect does not find an available agent meeting the requirements + // in a step for
 a given step duration, the routing criteria will move on to the + // next step sequentially until a
 join is completed with an agent. When all steps + // are exhausted, the contact will be offered to any agent in the queue. + Steps []RoutingCriteriaInputStep + + noSmithyDocumentSerde +} + +// Step defines the list of agents to be routed or route based on the agent +// requirements such as ProficiencyLevel, Name, or Value. +type RoutingCriteriaInputStep struct { + + // An object to specify the expiration of a routing step. + Expiry *RoutingCriteriaInputStepExpiry + + // A tagged union to specify expression for a routing step. + Expression *Expression + + noSmithyDocumentSerde +} + +// Specify whether this routing criteria step should apply for only a limited +// amount of time,
 or if it should never expire. +type RoutingCriteriaInputStepExpiry struct { + + // The number of seconds that the contact will be routed only to agents matching + // this routing
 step, if expiry was configured for this routing step. + DurationInSeconds *int32 + + noSmithyDocumentSerde +} + // Contains information about a routing profile. type RoutingProfile struct { diff --git a/service/ssm/api_op_CreatePatchBaseline.go b/service/ssm/api_op_CreatePatchBaseline.go index c9bfea3a321..88cd48a4332 100644 --- a/service/ssm/api_op_CreatePatchBaseline.go +++ b/service/ssm/api_op_CreatePatchBaseline.go @@ -82,16 +82,23 @@ type CreatePatchBaselineInput struct { // The action for Patch Manager to take on patches included in the RejectedPackages // list. // - // - ALLOW_AS_DEPENDENCY : A package in the Rejected patches list is installed - // only if it is a dependency of another package. It is considered compliant with - // the patch baseline, and its status is reported as InstalledOther . This is the - // default action if no option is specified. + // ALLOW_AS_DEPENDENCY Linux and macOS: A package in the rejected patches list is + // installed only if it is a dependency of another package. It is considered + // compliant with the patch baseline, and its status is reported as INSTALLED_OTHER + // . This is the default action if no option is specified. // - // - BLOCK: Packages in the Rejected patches list, and packages that include - // them as dependencies, aren't installed by Patch Manager under any circumstances. - // If a package was installed before it was added to the Rejected patches list, or - // is installed outside of Patch Manager afterward, it's considered noncompliant - // with the patch baseline and its status is reported as InstalledRejected. + // Windows Server: Windows Server doesn't support the concept of package + // dependencies. If a package in the rejected patches list and already installed on + // the node, its status is reported as INSTALLED_OTHER . Any package not already + // installed on the node is skipped. This is the default action if no option is + // specified. + // + // BLOCK All OSs: Packages in the rejected patches list, and packages that + // include them as dependencies, aren't installed by Patch Manager under any + // circumstances. If a package was installed before it was added to the rejected + // patches list, or is installed outside of Patch Manager afterward, it's + // considered noncompliant with the patch baseline and its status is reported as + // INSTALLED_REJECTED . RejectedPatchesAction types.PatchAction // Information about the patches to use to update the managed nodes, including diff --git a/service/ssm/api_op_DescribeInstanceInformation.go b/service/ssm/api_op_DescribeInstanceInformation.go index abaa087d5a4..1449c1a14bb 100644 --- a/service/ssm/api_op_DescribeInstanceInformation.go +++ b/service/ssm/api_op_DescribeInstanceInformation.go @@ -21,9 +21,9 @@ import ( // all your managed nodes. If you specify a node ID that isn't valid or a node that // you don't own, you receive an error. // -// The IamRole field returned for this API operation is the Identity and Access -// Management (IAM) role assigned to on-premises managed nodes. This operation does -// not return the IAM role for EC2 instances. +// The IamRole field returned for this API operation is the role assigned to an +// Amazon EC2 instance configured with a Systems Manager Quick Setup host +// management configuration or the role assigned to an on-premises managed node. func (c *Client) DescribeInstanceInformation(ctx context.Context, params *DescribeInstanceInformationInput, optFns ...func(*Options)) (*DescribeInstanceInformationOutput, error) { if params == nil { params = &DescribeInstanceInformationInput{} diff --git a/service/ssm/api_op_DescribePatchProperties.go b/service/ssm/api_op_DescribePatchProperties.go index ee437784a14..0c549b2bb71 100644 --- a/service/ssm/api_op_DescribePatchProperties.go +++ b/service/ssm/api_op_DescribePatchProperties.go @@ -23,6 +23,8 @@ import ( // // AMAZON_LINUX_2 Valid properties: PRODUCT | CLASSIFICATION | SEVERITY // +// AMAZON_LINUX_2023 Valid properties: PRODUCT | CLASSIFICATION | SEVERITY +// // CENTOS Valid properties: PRODUCT | CLASSIFICATION | SEVERITY // // DEBIAN Valid properties: PRODUCT | PRIORITY diff --git a/service/ssm/api_op_GetCommandInvocation.go b/service/ssm/api_op_GetCommandInvocation.go index b24decbc445..21db09f641e 100644 --- a/service/ssm/api_op_GetCommandInvocation.go +++ b/service/ssm/api_op_GetCommandInvocation.go @@ -17,7 +17,11 @@ import ( ) // Returns detailed information about command execution for an invocation or -// plugin. +// plugin. The Run Command API follows an eventual consistency model, due to the +// distributed nature of the system supporting the API. This means that the result +// of an API command you run that affects your resources might not be immediately +// visible to all subsequent commands you run. You should keep this in mind when +// you carry out an API command that immediately follows a previous API command. // // GetCommandInvocation only gives the execution status of a plugin in a document. // To get the command execution status on a specific managed node, use ListCommandInvocations. To get diff --git a/service/ssm/api_op_GetMaintenanceWindowTask.go b/service/ssm/api_op_GetMaintenanceWindowTask.go index f4393e17e1a..3fa362d8bb3 100644 --- a/service/ssm/api_op_GetMaintenanceWindowTask.go +++ b/service/ssm/api_op_GetMaintenanceWindowTask.go @@ -99,9 +99,19 @@ type GetMaintenanceWindowTaskOutput struct { // priority. Tasks that have the same priority are scheduled in parallel. Priority int32 - // The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) - // service role to use to publish Amazon Simple Notification Service (Amazon SNS) - // notifications for maintenance window Run Command tasks. + // The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services + // Systems Manager to assume when running a maintenance window task. If you do not + // specify a service role ARN, Systems Manager uses a service-linked role in your + // account. If no appropriate service-linked role for Systems Manager exists in + // your account, it is created when you run RegisterTaskWithMaintenanceWindow . + // + // However, for an improved security posture, we strongly recommend creating a + // custom policy and custom service role for running your maintenance window tasks. + // The policy can be crafted to provide only the permissions needed for your + // particular maintenance window tasks. For more information, see [Setting up maintenance windows]in the in the + // Amazon Web Services Systems Manager User Guide. + // + // [Setting up maintenance windows]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html ServiceRoleArn *string // The targets where the task should run. diff --git a/service/ssm/api_op_UpdateMaintenanceWindowTask.go b/service/ssm/api_op_UpdateMaintenanceWindowTask.go index cc4bf467ef6..ba53633d638 100644 --- a/service/ssm/api_op_UpdateMaintenanceWindowTask.go +++ b/service/ssm/api_op_UpdateMaintenanceWindowTask.go @@ -244,9 +244,19 @@ type UpdateMaintenanceWindowTaskOutput struct { // The updated priority value. Priority int32 - // The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) - // service role to use to publish Amazon Simple Notification Service (Amazon SNS) - // notifications for maintenance window Run Command tasks. + // The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services + // Systems Manager to assume when running a maintenance window task. If you do not + // specify a service role ARN, Systems Manager uses a service-linked role in your + // account. If no appropriate service-linked role for Systems Manager exists in + // your account, it is created when you run RegisterTaskWithMaintenanceWindow . + // + // However, for an improved security posture, we strongly recommend creating a + // custom policy and custom service role for running your maintenance window tasks. + // The policy can be crafted to provide only the permissions needed for your + // particular maintenance window tasks. For more information, see [Setting up maintenance windows]in the in the + // Amazon Web Services Systems Manager User Guide. + // + // [Setting up maintenance windows]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html ServiceRoleArn *string // The updated target values. diff --git a/service/ssm/api_op_UpdatePatchBaseline.go b/service/ssm/api_op_UpdatePatchBaseline.go index c20af0d7254..f97a9b45192 100644 --- a/service/ssm/api_op_UpdatePatchBaseline.go +++ b/service/ssm/api_op_UpdatePatchBaseline.go @@ -78,16 +78,23 @@ type UpdatePatchBaselineInput struct { // The action for Patch Manager to take on patches included in the RejectedPackages // list. // - // - ALLOW_AS_DEPENDENCY : A package in the Rejected patches list is installed - // only if it is a dependency of another package. It is considered compliant with - // the patch baseline, and its status is reported as InstalledOther . This is the - // default action if no option is specified. + // ALLOW_AS_DEPENDENCY Linux and macOS: A package in the rejected patches list is + // installed only if it is a dependency of another package. It is considered + // compliant with the patch baseline, and its status is reported as INSTALLED_OTHER + // . This is the default action if no option is specified. // - // - BLOCK: Packages in the Rejected patches list, and packages that include - // them as dependencies, aren't installed by Patch Manager under any circumstances. - // If a package was installed before it was added to the Rejected patches list, or - // is installed outside of Patch Manager afterward, it's considered noncompliant - // with the patch baseline and its status is reported as InstalledRejected. + // Windows Server: Windows Server doesn't support the concept of package + // dependencies. If a package in the rejected patches list and already installed on + // the node, its status is reported as INSTALLED_OTHER . Any package not already + // installed on the node is skipped. This is the default action if no option is + // specified. + // + // BLOCK All OSs: Packages in the rejected patches list, and packages that + // include them as dependencies, aren't installed by Patch Manager under any + // circumstances. If a package was installed before it was added to the rejected + // patches list, or is installed outside of Patch Manager afterward, it's + // considered noncompliant with the patch baseline and its status is reported as + // INSTALLED_REJECTED . RejectedPatchesAction types.PatchAction // If True, then all fields that are required by the CreatePatchBaseline operation are also required diff --git a/service/ssm/types/types.go b/service/ssm/types/types.go index 4bc962a92fe..7da3ad4c16b 100644 --- a/service/ssm/types/types.go +++ b/service/ssm/types/types.go @@ -2397,12 +2397,15 @@ type InstanceInformation struct { // The IP address of the managed node. IPAddress *string - // The Identity and Access Management (IAM) role assigned to the on-premises - // Systems Manager managed node. This call doesn't return the IAM role for Amazon - // Elastic Compute Cloud (Amazon EC2) instances. To retrieve the IAM role for an - // EC2 instance, use the Amazon EC2 DescribeInstances operation. For information, - // see [DescribeInstances]in the Amazon EC2 API Reference or [describe-instances] in the Amazon Web Services CLI Command - // Reference. + // The role assigned to an Amazon EC2 instance configured with a Systems Manager + // Quick Setup host management configuration or the role assigned to an on-premises + // managed node. + // + // This call doesn't return the IAM role for unmanaged Amazon EC2 instances + // (instances not configured for Systems Manager). To retrieve the role for an + // unmanaged instance, use the Amazon EC2 DescribeInstances operation. For + // information, see [DescribeInstances]in the Amazon EC2 API Reference or [describe-instances] in the Amazon Web Services + // CLI Command Reference. // // [DescribeInstances]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html // [describe-instances]: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html @@ -2725,7 +2728,7 @@ type InstanceProperty struct { // The version of SSM Agent running on your managed node. AgentVersion *string - // The CPU architecture of the node. For example, x86_64. + // The CPU architecture of the node. For example, x86_64 . Architecture *string // Status information about the aggregated associations. @@ -3438,9 +3441,19 @@ type MaintenanceWindowRunCommandParameters struct { // The parameters for the RUN_COMMAND task execution. Parameters map[string][]string - // The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) - // service role to use to publish Amazon Simple Notification Service (Amazon SNS) - // notifications for maintenance window Run Command tasks. + // The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services + // Systems Manager to assume when running a maintenance window task. If you do not + // specify a service role ARN, Systems Manager uses a service-linked role in your + // account. If no appropriate service-linked role for Systems Manager exists in + // your account, it is created when you run RegisterTaskWithMaintenanceWindow . + // + // However, for an improved security posture, we strongly recommend creating a + // custom policy and custom service role for running your maintenance window tasks. + // The policy can be crafted to provide only the permissions needed for your + // particular maintenance window tasks. For more information, see [Setting up maintenance windows]in the in the + // Amazon Web Services Systems Manager User Guide. + // + // [Setting up maintenance windows]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html ServiceRoleArn *string // If this time is reached and the command hasn't already started running, it @@ -3571,9 +3584,19 @@ type MaintenanceWindowTask struct { // parallel. Priority int32 - // The Amazon Resource Name (ARN) of the Identity and Access Management (IAM) - // service role to use to publish Amazon Simple Notification Service (Amazon SNS) - // notifications for maintenance window Run Command tasks. + // The Amazon Resource Name (ARN) of the IAM service role for Amazon Web Services + // Systems Manager to assume when running a maintenance window task. If you do not + // specify a service role ARN, Systems Manager uses a service-linked role in your + // account. If no appropriate service-linked role for Systems Manager exists in + // your account, it is created when you run RegisterTaskWithMaintenanceWindow . + // + // However, for an improved security posture, we strongly recommend creating a + // custom policy and custom service role for running your maintenance window tasks. + // The policy can be crafted to provide only the permissions needed for your + // particular maintenance window tasks. For more information, see [Setting up maintenance windows]in the in the + // Amazon Web Services Systems Manager User Guide. + // + // [Setting up maintenance windows]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html ServiceRoleArn *string // The targets (either managed nodes or tags). Managed nodes are specified using @@ -4539,9 +4562,9 @@ type PatchBaselineIdentity struct { // The name of the patch baseline. BaselineName *string - // Whether this is the default baseline. Amazon Web Services Systems Manager - // supports creating multiple default patch baselines. For example, you can create - // a default patch baseline for each operating system. + // Indicates whether this is the default baseline. Amazon Web Services Systems + // Manager supports creating multiple default patch baselines. For example, you can + // create a default patch baseline for each operating system. DefaultBaseline bool // Defines the operating system the patch baseline applies to. The default value @@ -4694,15 +4717,23 @@ type PatchRule struct { // The number of days after the release date of each patch matched by the rule // that the patch is marked as approved in the patch baseline. For example, a value - // of 7 means that patches are approved seven days after they are released. Not - // supported on Debian Server or Ubuntu Server. + // of 7 means that patches are approved seven days after they are released. + // + // This parameter is marked as not required, but your request must include a value + // for either ApproveAfterDays or ApproveUntilDate . + // + // Not supported for Debian Server or Ubuntu Server. ApproveAfterDays *int32 // The cutoff date for auto approval of released patches. Any patches released on - // or before this date are installed automatically. Not supported on Debian Server - // or Ubuntu Server. + // or before this date are installed automatically. // // Enter dates in the format YYYY-MM-DD . For example, 2021-12-31 . + // + // This parameter is marked as not required, but your request must include a value + // for either ApproveUntilDate or ApproveAfterDays . + // + // Not supported for Debian Server or Ubuntu Server. ApproveUntilDate *string // A compliance severity level for all approved patches in a patch baseline.