From 8c6b66ae1f5e215458040514e7aad76425eb91b1 Mon Sep 17 00:00:00 2001 From: awstools Date: Thu, 27 Jun 2024 18:14:01 +0000 Subject: [PATCH] feat(client-mq): This release makes the EngineVersion field optional for both broker and configuration and uses the latest available version by default. The AutoMinorVersionUpgrade field is also now optional for broker creation and defaults to 'true'. --- .../src/commands/CreateBrokerCommand.ts | 4 +- .../commands/CreateConfigurationCommand.ts | 2 +- clients/client-mq/src/models/models_0.ts | 30 +++++++-------- codegen/sdk-codegen/aws-models/mq.json | 37 ++++++++----------- 4 files changed, 34 insertions(+), 39 deletions(-) diff --git a/clients/client-mq/src/commands/CreateBrokerCommand.ts b/clients/client-mq/src/commands/CreateBrokerCommand.ts index 6ec9b5c669aa..a99137756aad 100644 --- a/clients/client-mq/src/commands/CreateBrokerCommand.ts +++ b/clients/client-mq/src/commands/CreateBrokerCommand.ts @@ -37,7 +37,7 @@ export interface CreateBrokerCommandOutput extends CreateBrokerResponse, __Metad * const client = new MqClient(config); * const input = { // CreateBrokerRequest * AuthenticationStrategy: "SIMPLE" || "LDAP", - * AutoMinorVersionUpgrade: true || false, // required + * AutoMinorVersionUpgrade: true || false, * BrokerName: "STRING_VALUE", // required * Configuration: { // ConfigurationId * Id: "STRING_VALUE", // required @@ -50,7 +50,7 @@ export interface CreateBrokerCommandOutput extends CreateBrokerResponse, __Metad * UseAwsOwnedKey: true || false, // required * }, * EngineType: "ACTIVEMQ" || "RABBITMQ", // required - * EngineVersion: "STRING_VALUE", // required + * EngineVersion: "STRING_VALUE", * HostInstanceType: "STRING_VALUE", // required * LdapServerMetadata: { // LdapServerMetadataInput * Hosts: [ // __listOf__string // required diff --git a/clients/client-mq/src/commands/CreateConfigurationCommand.ts b/clients/client-mq/src/commands/CreateConfigurationCommand.ts index e7091c07ee45..da90eb597d47 100644 --- a/clients/client-mq/src/commands/CreateConfigurationCommand.ts +++ b/clients/client-mq/src/commands/CreateConfigurationCommand.ts @@ -38,7 +38,7 @@ export interface CreateConfigurationCommandOutput extends CreateConfigurationRes * const input = { // CreateConfigurationRequest * AuthenticationStrategy: "SIMPLE" || "LDAP", * EngineType: "ACTIVEMQ" || "RABBITMQ", // required - * EngineVersion: "STRING_VALUE", // required + * EngineVersion: "STRING_VALUE", * Name: "STRING_VALUE", // required * Tags: { // __mapOf__string * "": "STRING_VALUE", diff --git a/clients/client-mq/src/models/models_0.ts b/clients/client-mq/src/models/models_0.ts index 5ae9ebee6272..1fe1edd3524a 100644 --- a/clients/client-mq/src/models/models_0.ts +++ b/clients/client-mq/src/models/models_0.ts @@ -319,7 +319,7 @@ export interface Configuration { EngineType: EngineType | undefined; /** - *

Required. The broker engine's version. For a list of supported engine versions, see, Supported engines.

+ *

The broker engine version. Defaults to the latest available version for the specified broker engine type. For a list of supported engine versions, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ EngineVersion: string | undefined; @@ -747,10 +747,10 @@ export interface CreateBrokerRequest { AuthenticationStrategy?: AuthenticationStrategy; /** - *

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot. Set to true by default, if no value is specified.

+ *

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot. Set to true by default, if no value is specified.

Must be set to true for ActiveMQ brokers version 5.18 and above and for RabbitMQ brokers version 3.13 and above.

 * @public */ - AutoMinorVersionUpgrade: boolean | undefined; + AutoMinorVersionUpgrade?: boolean; /** *

Required. The broker's name. This value must be unique in your Amazon Web Services account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain white spaces, brackets, wildcard characters, or special characters.

Do not add personally identifiable information (PII) or other confidential or sensitive information in broker names. Broker names are accessible to other Amazon Web Services services, including CloudWatch Logs. Broker names are not intended to be used for private or sensitive data.

 @@ -789,10 +789,10 @@ export interface CreateBrokerRequest { EngineType: EngineType | undefined; /** - *

Required. The broker engine's version. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version. Defaults to the latest available version for the specified broker engine type. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ - EngineVersion: string | undefined; + EngineVersion?: string; /** *

Required. The broker's instance type.

@@ -1001,10 +1001,10 @@ export interface CreateConfigurationRequest { EngineType: EngineType | undefined; /** - *

Required. The broker engine's version. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version. Defaults to the latest available version for the specified broker engine type. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ - EngineVersion: string | undefined; + EngineVersion?: string; /** *

Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long.

@@ -1407,7 +1407,7 @@ export interface DescribeBrokerResponse { AuthenticationStrategy?: AuthenticationStrategy; /** - *

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.

+ *

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

* @public */ AutoMinorVersionUpgrade?: boolean; @@ -1473,7 +1473,7 @@ export interface DescribeBrokerResponse { EngineType?: EngineType; /** - *

The broker engine's version. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ EngineVersion?: string; @@ -1509,7 +1509,7 @@ export interface DescribeBrokerResponse { PendingAuthenticationStrategy?: AuthenticationStrategy; /** - *

The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version to upgrade to. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ PendingEngineVersion?: string; @@ -1743,7 +1743,7 @@ export interface DescribeConfigurationResponse { EngineType?: EngineType; /** - *

Required. The broker engine's version. For a list of supported engine versions, see, Supported engines.

+ *

The broker engine version. Defaults to the latest available version for the specified broker engine type. For a list of supported engine versions, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ EngineVersion?: string; @@ -2172,7 +2172,7 @@ export interface UpdateBrokerRequest { AuthenticationStrategy?: AuthenticationStrategy; /** - *

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.

+ *

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

Must be set to true for ActiveMQ brokers version 5.18 and above and for RabbitMQ brokers version 3.13 and above.

 * @public */ AutoMinorVersionUpgrade?: boolean; @@ -2190,7 +2190,7 @@ export interface UpdateBrokerRequest { Configuration?: ConfigurationId; /** - *

The broker engine version. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

When upgrading to ActiveMQ version 5.18 and above or RabbitMQ version 3.13 and above, you must have autoMinorVersionUpgrade set to true for the broker.

 * @public */ EngineVersion?: string; @@ -2243,7 +2243,7 @@ export interface UpdateBrokerResponse { AuthenticationStrategy?: AuthenticationStrategy; /** - *

The new boolean value that specifies whether broker engines automatically upgrade to new minor versions as new versions are released and supported by Amazon MQ.

+ *

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

* @public */ AutoMinorVersionUpgrade?: boolean; @@ -2261,7 +2261,7 @@ export interface UpdateBrokerResponse { Configuration?: ConfigurationId; /** - *

The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.

+ *

The broker engine version to upgrade to. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

* @public */ EngineVersion?: string; diff --git a/codegen/sdk-codegen/aws-models/mq.json b/codegen/sdk-codegen/aws-models/mq.json index 1dbb5e84b62e..2a7bffbc4d45 100644 --- a/codegen/sdk-codegen/aws-models/mq.json +++ b/codegen/sdk-codegen/aws-models/mq.json @@ -427,7 +427,7 @@ "target": "com.amazonaws.mq#__string", "traits": { "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

Required. The broker engine's version. For a list of supported engine versions, see, Supported engines.

", + "smithy.api#documentation": "

The broker engine version. Defaults to the latest available version for the specified broker engine type. For a list of supported engine versions, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", "smithy.api#jsonName": "engineVersion", "smithy.api#required": {} } @@ -628,10 +628,8 @@ "AutoMinorVersionUpgrade": { "target": "com.amazonaws.mq#__boolean", "traits": { - "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot. Set to true by default, if no value is specified.

", - "smithy.api#jsonName": "autoMinorVersionUpgrade", - "smithy.api#required": {} + "smithy.api#documentation": "

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot. Set to true by default, if no value is specified.

Must be set to true for ActiveMQ brokers version 5.18 and above and for RabbitMQ brokers version 3.13 and above.

", + "smithy.api#jsonName": "autoMinorVersionUpgrade" } }, "BrokerName": { @@ -686,10 +684,8 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

Required. The broker engine's version. For a list of supported engine versions, see Supported engines.

", - "smithy.api#jsonName": "engineVersion", - "smithy.api#required": {} + "smithy.api#documentation": "

The broker engine version. Defaults to the latest available version for the specified broker engine type. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", + "smithy.api#jsonName": "engineVersion" } }, "HostInstanceType": { @@ -863,10 +859,8 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

Required. The broker engine's version. For a list of supported engine versions, see Supported engines.

", - "smithy.api#jsonName": "engineVersion", - "smithy.api#required": {} + "smithy.api#documentation": "

The broker engine version. Defaults to the latest available version for the specified broker engine type. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", + "smithy.api#jsonName": "engineVersion" } }, "Name": { @@ -1668,7 +1662,7 @@ "AutoMinorVersionUpgrade": { "target": "com.amazonaws.mq#__boolean", "traits": { - "smithy.api#documentation": "

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.

", + "smithy.api#documentation": "

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

", "smithy.api#jsonName": "autoMinorVersionUpgrade" } }, @@ -1745,7 +1739,7 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#documentation": "

The broker engine's version. For a list of supported engine versions, see Supported engines.

", + "smithy.api#documentation": "

The broker engine version. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", "smithy.api#jsonName": "engineVersion" } }, @@ -1787,7 +1781,7 @@ "PendingEngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#documentation": "

The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.

", + "smithy.api#documentation": "

The broker engine version to upgrade to. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", "smithy.api#jsonName": "pendingEngineVersion" } }, @@ -1975,7 +1969,7 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#documentation": "

Required. The broker engine's version. For a list of supported engine versions, see, Supported engines.

", + "smithy.api#documentation": "

The broker engine version. Defaults to the latest available version for the specified broker engine type. For a list of supported engine versions, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", "smithy.api#jsonName": "engineVersion" } }, @@ -3315,7 +3309,7 @@ "AutoMinorVersionUpgrade": { "target": "com.amazonaws.mq#__boolean", "traits": { - "smithy.api#documentation": "

Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.

", + "smithy.api#documentation": "

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

Must be set to true for ActiveMQ brokers version 5.18 and above and for RabbitMQ brokers version 3.13 and above.

", "smithy.api#jsonName": "autoMinorVersionUpgrade" } }, @@ -3337,7 +3331,7 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#documentation": "

The broker engine version. For a list of supported engine versions, see Supported engines.

", + "smithy.api#documentation": "

The broker engine version. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

When upgrading to ActiveMQ version 5.18 and above or RabbitMQ version 3.13 and above, you must have autoMinorVersionUpgrade set to true for the broker.

", "smithy.api#jsonName": "engineVersion" } }, @@ -3402,7 +3396,7 @@ "AutoMinorVersionUpgrade": { "target": "com.amazonaws.mq#__boolean", "traits": { - "smithy.api#documentation": "

The new boolean value that specifies whether broker engines automatically upgrade to new minor versions as new versions are released and supported by Amazon MQ.

", + "smithy.api#documentation": "

Enables automatic upgrades to new patch versions for brokers as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window or after a manual broker reboot.

", "smithy.api#jsonName": "autoMinorVersionUpgrade" } }, @@ -3423,7 +3417,7 @@ "EngineVersion": { "target": "com.amazonaws.mq#__string", "traits": { - "smithy.api#documentation": "

The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.

", + "smithy.api#documentation": "

The broker engine version to upgrade to. For more information, see the ActiveMQ version management and the RabbitMQ version management sections in the Amazon MQ Developer Guide.

", "smithy.api#jsonName": "engineVersion" } }, @@ -4050,6 +4044,7 @@ "name": "mq" }, "aws.protocols#restJson1": {}, + "smithy.api#auth": ["aws.auth#sigv4"], "smithy.api#documentation": "

Amazon MQ is a managed message broker service for Apache ActiveMQ and RabbitMQ that makes it easy to set up and operate message brokers in the cloud. A message broker allows software applications and components to communicate using various programming languages, operating systems, and formal messaging protocols.

", "smithy.api#title": "AmazonMQ", "smithy.rules#endpointRuleSet": {