pulumi-aws-native 1.38.0a1761718100__py3-none-any.whl → 1.38.0a1761750358__py3-none-any.whl

pulumi_aws_native/amazonmq/broker.py

@@ -46,36 +46,34 @@ class BrokerArgs:
                  users: Optional[pulumi.Input[Sequence[pulumi.Input['BrokerUserArgs']]]] = None):
         """
         The set of arguments for constructing a Broker resource.
-        :param pulumi.Input[Union['BrokerDeploymentMode', _builtins.str]] deployment_mode: The deployment mode of the broker. Available values:
-               
-               - `SINGLE_INSTANCE`
-               - `ACTIVE_STANDBY_MULTI_AZ`
-               - `CLUSTER_MULTI_AZ`
-        :param pulumi.Input[Union['BrokerEngineType', _builtins.str]] engine_type: The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
-        :param pulumi.Input[_builtins.str] host_instance_type: The broker's instance type.
-        :param pulumi.Input[_builtins.bool] publicly_accessible: Enables connections from applications outside of the VPC that hosts the broker's subnets.
+        :param pulumi.Input[Union['BrokerDeploymentMode', _builtins.str]] deployment_mode: Required. The broker's deployment mode.
+        :param pulumi.Input[Union['BrokerEngineType', _builtins.str]] engine_type: Required. The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
+        :param pulumi.Input[_builtins.str] host_instance_type: Required. The broker's instance type.
+        :param pulumi.Input[_builtins.bool] publicly_accessible: Enables connections from applications outside of the VPC that hosts the broker's subnets. Set to `false` by default, if no value is provided.
         :param pulumi.Input[_builtins.str] authentication_strategy: Optional. The authentication strategy used to secure the broker. The default is `SIMPLE` .
-        :param pulumi.Input[_builtins.bool] auto_minor_version_upgrade: Enables automatic upgrades to new minor versions for brokers, as new broker engine 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.
-        :param pulumi.Input[_builtins.str] broker_name: The name of the broker. This value must be unique in your AWS 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.
+        :param pulumi.Input[_builtins.bool] auto_minor_version_upgrade: 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.
+        :param pulumi.Input[_builtins.str] broker_name: Required. The broker's name. This value must be unique in your AWS 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 AWS services, including C CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
+               > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker names. Broker names are accessible to other AWS services, including CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
         :param pulumi.Input['BrokerConfigurationIdArgs'] configuration: The intended configuration (ID and revision) to be set when creating or updating.
                This property is write-only so that applications of a ConfigurationAssociation do not cause drift.
         :param pulumi.Input[Union['BrokerDataReplicationMode', _builtins.str]] data_replication_mode: Defines whether this broker is a part of a data replication pair.
         :param pulumi.Input[_builtins.str] data_replication_primary_broker_arn: The ARN of the primary broker that is used to replicate data from in a data replication pair when creating a replica.
                This field is only used at creation-time. Changes to it subsequently are ignored by CloudFormation.
                Information on the current primary is available on the DataReplicationMetadata object returned by the API.
-        :param pulumi.Input['BrokerEncryptionOptionsArgs'] encryption_options: Encryption options for the broker. Does not apply to RabbitMQ brokers.
+        :param pulumi.Input['BrokerEncryptionOptionsArgs'] encryption_options: Encryption options for the broker.
         :param pulumi.Input[_builtins.str] engine_version: The version specified to use. See also EngineVersionCurrent.
         :param pulumi.Input['BrokerLdapServerMetadataArgs'] ldap_server_metadata: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker. Does not apply to RabbitMQ brokers.
         :param pulumi.Input['BrokerLogListArgs'] logs: Enables Amazon CloudWatch logging for brokers.
-        :param pulumi.Input['BrokerMaintenanceWindowArgs'] maintenance_window_start_time: The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
+        :param pulumi.Input['BrokerMaintenanceWindowArgs'] maintenance_window_start_time: The parameters that determine the WeeklyStartTime.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] security_groups: The list of rules (1 minimum, 125 maximum) that authorize connections to brokers.
         :param pulumi.Input[Union['BrokerStorageType', _builtins.str]] storage_type: The broker's storage type.
-        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] subnet_ids: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment (ACTIVEMQ) requires two subnets. A CLUSTER_MULTI_AZ deployment (RABBITMQ) has no subnet requirements when deployed with public accessibility, deployment without public accessibility requires at least one subnet.
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] subnet_ids: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ Amazon MQ for ActiveMQ deployment requires two subnets. A CLUSTER_MULTI_AZ Amazon MQ for RabbitMQ deployment has no subnet requirements when deployed with public accessibility. Deployment without public accessibility requires at least one subnet.
                
-               > If you specify subnets in a shared VPC for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC enpoints in VPCs that are not owned by your AWS account .
-        :param pulumi.Input[Sequence[pulumi.Input['_root_inputs.TagArgs']]] tags: An array of key-value pairs. For more information, see [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *Billing and Cost Management User Guide* .
+               > If you specify subnets in a [shared VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html) for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC endpoints in VPCs that are not owned by your AWS account .
+        :param pulumi.Input[Sequence[pulumi.Input['_root_inputs.TagArgs']]] tags: Create tags when creating the broker.
         :param pulumi.Input[Sequence[pulumi.Input['BrokerUserArgs']]] users: Users to configure on the broker. 
                For RabbitMQ, this should be one user, created when the broker is created, and changes thereafter are ignored.
                For ActiveMQ, changes to anything but Password are detected and will trigger an update,
@@ -122,11 +120,7 @@ class BrokerArgs:
     @pulumi.getter(name="deploymentMode")
     def deployment_mode(self) -> pulumi.Input[Union['BrokerDeploymentMode', _builtins.str]]:
         """
-        The deployment mode of the broker. Available values:
-
-        - `SINGLE_INSTANCE`
-        - `ACTIVE_STANDBY_MULTI_AZ`
-        - `CLUSTER_MULTI_AZ`
+        Required. The broker's deployment mode.
         """
         return pulumi.get(self, "deployment_mode")
 
@@ -138,7 +132,7 @@ class BrokerArgs:
     @pulumi.getter(name="engineType")
     def engine_type(self) -> pulumi.Input[Union['BrokerEngineType', _builtins.str]]:
         """
-        The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
+        Required. The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
         """
         return pulumi.get(self, "engine_type")
 
@@ -150,7 +144,7 @@ class BrokerArgs:
     @pulumi.getter(name="hostInstanceType")
     def host_instance_type(self) -> pulumi.Input[_builtins.str]:
         """
-        The broker's instance type.
+        Required. The broker's instance type.
         """
         return pulumi.get(self, "host_instance_type")
 
@@ -162,7 +156,7 @@ class BrokerArgs:
     @pulumi.getter(name="publiclyAccessible")
     def publicly_accessible(self) -> pulumi.Input[_builtins.bool]:
         """
-        Enables connections from applications outside of the VPC that hosts the broker's subnets.
+        Enables connections from applications outside of the VPC that hosts the broker's subnets. Set to `false` by default, if no value is provided.
         """
         return pulumi.get(self, "publicly_accessible")
 
@@ -186,7 +180,9 @@ class BrokerArgs:
     @pulumi.getter(name="autoMinorVersionUpgrade")
     def auto_minor_version_upgrade(self) -> Optional[pulumi.Input[_builtins.bool]]:
         """
-        Enables automatic upgrades to new minor versions for brokers, as new broker engine 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. 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.
         """
         return pulumi.get(self, "auto_minor_version_upgrade")
 
@@ -198,9 +194,9 @@ class BrokerArgs:
     @pulumi.getter(name="brokerName")
     def broker_name(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        The name of the broker. This value must be unique in your AWS 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.
+        Required. The broker's name. This value must be unique in your AWS 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 AWS services, including C CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
+        > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker names. Broker names are accessible to other AWS services, including CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
         """
         return pulumi.get(self, "broker_name")
 
@@ -251,7 +247,7 @@ class BrokerArgs:
     @pulumi.getter(name="encryptionOptions")
     def encryption_options(self) -> Optional[pulumi.Input['BrokerEncryptionOptionsArgs']]:
         """
-        Encryption options for the broker. Does not apply to RabbitMQ brokers.
+        Encryption options for the broker.
         """
         return pulumi.get(self, "encryption_options")
 
@@ -299,7 +295,7 @@ class BrokerArgs:
     @pulumi.getter(name="maintenanceWindowStartTime")
     def maintenance_window_start_time(self) -> Optional[pulumi.Input['BrokerMaintenanceWindowArgs']]:
         """
-        The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
+        The parameters that determine the WeeklyStartTime.
         """
         return pulumi.get(self, "maintenance_window_start_time")
 
@@ -335,9 +331,9 @@ class BrokerArgs:
     @pulumi.getter(name="subnetIds")
     def subnet_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[_builtins.str]]]]:
         """
-        The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment (ACTIVEMQ) requires two subnets. A CLUSTER_MULTI_AZ deployment (RABBITMQ) has no subnet requirements when deployed with public accessibility, deployment without public accessibility requires at least one subnet.
+        The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ Amazon MQ for ActiveMQ deployment requires two subnets. A CLUSTER_MULTI_AZ Amazon MQ for RabbitMQ deployment has no subnet requirements when deployed with public accessibility. Deployment without public accessibility requires at least one subnet.
 
-        > If you specify subnets in a shared VPC for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC enpoints in VPCs that are not owned by your AWS account .
+        > If you specify subnets in a [shared VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html) for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC endpoints in VPCs that are not owned by your AWS account .
         """
         return pulumi.get(self, "subnet_ids")
 
@@ -349,7 +345,7 @@ class BrokerArgs:
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['_root_inputs.TagArgs']]]]:
         """
-        An array of key-value pairs. For more information, see [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *Billing and Cost Management User Guide* .
+        Create tags when creating the broker.
         """
         return pulumi.get(self, "tags")
 
@@ -552,35 +548,33 @@ class Broker(pulumi.CustomResource):
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[_builtins.str] authentication_strategy: Optional. The authentication strategy used to secure the broker. The default is `SIMPLE` .
-        :param pulumi.Input[_builtins.bool] auto_minor_version_upgrade: Enables automatic upgrades to new minor versions for brokers, as new broker engine 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.
-        :param pulumi.Input[_builtins.str] broker_name: The name of the broker. This value must be unique in your AWS 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.
+        :param pulumi.Input[_builtins.bool] auto_minor_version_upgrade: 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.
+        :param pulumi.Input[_builtins.str] broker_name: Required. The broker's name. This value must be unique in your AWS 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 AWS services, including C CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
+               > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker names. Broker names are accessible to other AWS services, including CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
         :param pulumi.Input[Union['BrokerConfigurationIdArgs', 'BrokerConfigurationIdArgsDict']] configuration: The intended configuration (ID and revision) to be set when creating or updating.
                This property is write-only so that applications of a ConfigurationAssociation do not cause drift.
         :param pulumi.Input[Union['BrokerDataReplicationMode', _builtins.str]] data_replication_mode: Defines whether this broker is a part of a data replication pair.
         :param pulumi.Input[_builtins.str] data_replication_primary_broker_arn: The ARN of the primary broker that is used to replicate data from in a data replication pair when creating a replica.
                This field is only used at creation-time. Changes to it subsequently are ignored by CloudFormation.
                Information on the current primary is available on the DataReplicationMetadata object returned by the API.
-        :param pulumi.Input[Union['BrokerDeploymentMode', _builtins.str]] deployment_mode: The deployment mode of the broker. Available values:
-               
-               - `SINGLE_INSTANCE`
-               - `ACTIVE_STANDBY_MULTI_AZ`
-               - `CLUSTER_MULTI_AZ`
-        :param pulumi.Input[Union['BrokerEncryptionOptionsArgs', 'BrokerEncryptionOptionsArgsDict']] encryption_options: Encryption options for the broker. Does not apply to RabbitMQ brokers.
-        :param pulumi.Input[Union['BrokerEngineType', _builtins.str]] engine_type: The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
+        :param pulumi.Input[Union['BrokerDeploymentMode', _builtins.str]] deployment_mode: Required. The broker's deployment mode.
+        :param pulumi.Input[Union['BrokerEncryptionOptionsArgs', 'BrokerEncryptionOptionsArgsDict']] encryption_options: Encryption options for the broker.
+        :param pulumi.Input[Union['BrokerEngineType', _builtins.str]] engine_type: Required. The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
         :param pulumi.Input[_builtins.str] engine_version: The version specified to use. See also EngineVersionCurrent.
-        :param pulumi.Input[_builtins.str] host_instance_type: The broker's instance type.
+        :param pulumi.Input[_builtins.str] host_instance_type: Required. The broker's instance type.
         :param pulumi.Input[Union['BrokerLdapServerMetadataArgs', 'BrokerLdapServerMetadataArgsDict']] ldap_server_metadata: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker. Does not apply to RabbitMQ brokers.
         :param pulumi.Input[Union['BrokerLogListArgs', 'BrokerLogListArgsDict']] logs: Enables Amazon CloudWatch logging for brokers.
-        :param pulumi.Input[Union['BrokerMaintenanceWindowArgs', 'BrokerMaintenanceWindowArgsDict']] maintenance_window_start_time: The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
-        :param pulumi.Input[_builtins.bool] publicly_accessible: Enables connections from applications outside of the VPC that hosts the broker's subnets.
+        :param pulumi.Input[Union['BrokerMaintenanceWindowArgs', 'BrokerMaintenanceWindowArgsDict']] maintenance_window_start_time: The parameters that determine the WeeklyStartTime.
+        :param pulumi.Input[_builtins.bool] publicly_accessible: Enables connections from applications outside of the VPC that hosts the broker's subnets. Set to `false` by default, if no value is provided.
         :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] security_groups: The list of rules (1 minimum, 125 maximum) that authorize connections to brokers.
         :param pulumi.Input[Union['BrokerStorageType', _builtins.str]] storage_type: The broker's storage type.
-        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] subnet_ids: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment (ACTIVEMQ) requires two subnets. A CLUSTER_MULTI_AZ deployment (RABBITMQ) has no subnet requirements when deployed with public accessibility, deployment without public accessibility requires at least one subnet.
+        :param pulumi.Input[Sequence[pulumi.Input[_builtins.str]]] subnet_ids: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ Amazon MQ for ActiveMQ deployment requires two subnets. A CLUSTER_MULTI_AZ Amazon MQ for RabbitMQ deployment has no subnet requirements when deployed with public accessibility. Deployment without public accessibility requires at least one subnet.
                
-               > If you specify subnets in a shared VPC for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC enpoints in VPCs that are not owned by your AWS account .
-        :param pulumi.Input[Sequence[pulumi.Input[Union['_root_inputs.TagArgs', '_root_inputs.TagArgsDict']]]] tags: An array of key-value pairs. For more information, see [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *Billing and Cost Management User Guide* .
+               > If you specify subnets in a [shared VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html) for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC endpoints in VPCs that are not owned by your AWS account .
+        :param pulumi.Input[Sequence[pulumi.Input[Union['_root_inputs.TagArgs', '_root_inputs.TagArgsDict']]]] tags: Create tags when creating the broker.
         :param pulumi.Input[Sequence[pulumi.Input[Union['BrokerUserArgs', 'BrokerUserArgsDict']]]] users: Users to configure on the broker. 
                For RabbitMQ, this should be one user, created when the broker is created, and changes thereafter are ignored.
                For ActiveMQ, changes to anything but Password are detected and will trigger an update,
@@ -915,25 +909,24 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="autoMinorVersionUpgrade")
     def auto_minor_version_upgrade(self) -> pulumi.Output[Optional[_builtins.bool]]:
         """
-        Enables automatic upgrades to new minor versions for brokers, as new broker engine 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. 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.
         """
         return pulumi.get(self, "auto_minor_version_upgrade")
 
     @_builtins.property
     @pulumi.getter(name="awsId")
     def aws_id(self) -> pulumi.Output[_builtins.str]:
-        """
-        Required. The unique ID that Amazon MQ generates for the configuration.
-        """
         return pulumi.get(self, "aws_id")
 
     @_builtins.property
     @pulumi.getter(name="brokerName")
     def broker_name(self) -> pulumi.Output[_builtins.str]:
         """
-        The name of the broker. This value must be unique in your AWS 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.
+        Required. The broker's name. This value must be unique in your AWS 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 AWS services, including C CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
+        > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker names. Broker names are accessible to other AWS services, including CloudWatch Logs . Broker names are not intended to be used for private or sensitive data.
         """
         return pulumi.get(self, "broker_name")
 
@@ -989,11 +982,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="deploymentMode")
     def deployment_mode(self) -> pulumi.Output[_builtins.str]:
         """
-        The deployment mode of the broker. Available values:
-
-        - `SINGLE_INSTANCE`
-        - `ACTIVE_STANDBY_MULTI_AZ`
-        - `CLUSTER_MULTI_AZ`
+        Required. The broker's deployment mode.
         """
         return pulumi.get(self, "deployment_mode")
 
@@ -1001,7 +990,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="encryptionOptions")
     def encryption_options(self) -> pulumi.Output[Optional['outputs.BrokerEncryptionOptions']]:
         """
-        Encryption options for the broker. Does not apply to RabbitMQ brokers.
+        Encryption options for the broker.
         """
         return pulumi.get(self, "encryption_options")
 
@@ -1009,7 +998,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="engineType")
     def engine_type(self) -> pulumi.Output[_builtins.str]:
         """
-        The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
+        Required. The type of broker engine. Currently, Amazon MQ supports `ACTIVEMQ` and `RABBITMQ` .
         """
         return pulumi.get(self, "engine_type")
 
@@ -1033,7 +1022,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="hostInstanceType")
     def host_instance_type(self) -> pulumi.Output[_builtins.str]:
         """
-        The broker's instance type.
+        Required. The broker's instance type.
         """
         return pulumi.get(self, "host_instance_type")
 
@@ -1067,7 +1056,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="maintenanceWindowStartTime")
     def maintenance_window_start_time(self) -> pulumi.Output[Optional['outputs.BrokerMaintenanceWindow']]:
         """
-        The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
+        The parameters that determine the WeeklyStartTime.
         """
         return pulumi.get(self, "maintenance_window_start_time")
 
@@ -1095,7 +1084,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="publiclyAccessible")
     def publicly_accessible(self) -> pulumi.Output[_builtins.bool]:
         """
-        Enables connections from applications outside of the VPC that hosts the broker's subnets.
+        Enables connections from applications outside of the VPC that hosts the broker's subnets. Set to `false` by default, if no value is provided.
         """
         return pulumi.get(self, "publicly_accessible")
 
@@ -1129,9 +1118,9 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter(name="subnetIds")
     def subnet_ids(self) -> pulumi.Output[Optional[Sequence[_builtins.str]]]:
         """
-        The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment (ACTIVEMQ) requires two subnets. A CLUSTER_MULTI_AZ deployment (RABBITMQ) has no subnet requirements when deployed with public accessibility, deployment without public accessibility requires at least one subnet.
+        The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ Amazon MQ for ActiveMQ deployment requires two subnets. A CLUSTER_MULTI_AZ Amazon MQ for RabbitMQ deployment has no subnet requirements when deployed with public accessibility. Deployment without public accessibility requires at least one subnet.
 
-        > If you specify subnets in a shared VPC for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC enpoints in VPCs that are not owned by your AWS account .
+        > If you specify subnets in a [shared VPC](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-sharing.html) for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account . Amazon MQ will not be able to create VPC endpoints in VPCs that are not owned by your AWS account .
         """
         return pulumi.get(self, "subnet_ids")
 
@@ -1139,7 +1128,7 @@ class Broker(pulumi.CustomResource):
     @pulumi.getter
     def tags(self) -> pulumi.Output[Optional[Sequence['_root_outputs.Tag']]]:
         """
-        An array of key-value pairs. For more information, see [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *Billing and Cost Management User Guide* .
+        Create tags when creating the broker.
         """
         return pulumi.get(self, "tags")
 

pulumi_aws_native/amazonmq/get_broker.py

@@ -112,7 +112,9 @@ class GetBrokerResult:
     @pulumi.getter(name="autoMinorVersionUpgrade")
     def auto_minor_version_upgrade(self) -> Optional[_builtins.bool]:
         """
-        Enables automatic upgrades to new minor versions for brokers, as new broker engine 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. 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.
         """
         return pulumi.get(self, "auto_minor_version_upgrade")
 
@@ -157,16 +159,13 @@ class GetBrokerResult:
     @pulumi.getter(name="hostInstanceType")
     def host_instance_type(self) -> Optional[_builtins.str]:
         """
-        The broker's instance type.
+        Required. The broker's instance type.
         """
         return pulumi.get(self, "host_instance_type")
 
     @_builtins.property
     @pulumi.getter
     def id(self) -> Optional[_builtins.str]:
-        """
-        Required. The unique ID that Amazon MQ generates for the configuration.
-        """
         return pulumi.get(self, "id")
 
     @_builtins.property
@@ -199,7 +198,7 @@ class GetBrokerResult:
     @pulumi.getter(name="maintenanceWindowStartTime")
     def maintenance_window_start_time(self) -> Optional['outputs.BrokerMaintenanceWindow']:
         """
-        The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
+        The parameters that determine the WeeklyStartTime.
         """
         return pulumi.get(self, "maintenance_window_start_time")
 
@@ -245,7 +244,7 @@ class GetBrokerResult:
     @pulumi.getter
     def tags(self) -> Optional[Sequence['_root_outputs.Tag']]:
         """
-        An array of key-value pairs. For more information, see [Using Cost Allocation Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) in the *Billing and Cost Management User Guide* .
+        Create tags when creating the broker.
         """
         return pulumi.get(self, "tags")
 
@@ -292,9 +291,6 @@ def get_broker(id: Optional[_builtins.str] = None,
                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetBrokerResult:
     """
     Resource type definition for AWS::AmazonMQ::Broker
-
-
-    :param _builtins.str id: Required. The unique ID that Amazon MQ generates for the configuration.
     """
     __args__ = dict()
     __args__['id'] = id
@@ -326,9 +322,6 @@ def get_broker_output(id: Optional[pulumi.Input[_builtins.str]] = None,
                       opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetBrokerResult]:
     """
     Resource type definition for AWS::AmazonMQ::Broker
-
-
-    :param _builtins.str id: Required. The unique ID that Amazon MQ generates for the configuration.
     """
     __args__ = dict()
     __args__['id'] = id

pulumi_aws_native/amazonmq/outputs.py

@@ -30,7 +30,7 @@ class BrokerConfigurationId(dict):
                  id: _builtins.str,
                  revision: _builtins.int):
         """
-        :param _builtins.str id: The unique ID that Amazon MQ generates for the configuration.
+        :param _builtins.str id: Required. The unique ID that Amazon MQ generates for the configuration.
         :param _builtins.int revision: The revision number of the configuration.
         """
         pulumi.set(__self__, "id", id)
@@ -40,7 +40,7 @@ class BrokerConfigurationId(dict):
     @pulumi.getter
     def id(self) -> _builtins.str:
         """
-        The unique ID that Amazon MQ generates for the configuration.
+        Required. The unique ID that Amazon MQ generates for the configuration.
         """
         return pulumi.get(self, "id")
 
@@ -157,19 +157,6 @@ class BrokerLdapServerMetadata(dict):
                  service_account_password: Optional[_builtins.str] = None,
                  user_role_name: Optional[_builtins.str] = None,
                  user_search_subtree: Optional[_builtins.bool] = None):
-        """
-        :param Sequence[_builtins.str] hosts: Specifies the location of the LDAP server such as AWS Directory Service for Microsoft Active Directory . Optional failover server.
-        :param _builtins.str role_base: The distinguished name of the node in the directory information tree (DIT) to search for roles or groups. For example, `ou=group` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        :param _builtins.str role_search_matching: The LDAP search filter used to find roles within the roleBase. The distinguished name of the user matched by userSearchMatching is substituted into the `{0}` placeholder in the search filter. The client's username is substituted into the `{1}` placeholder. For example, if you set this option to `(member=uid={1})` for the user janedoe, the search filter becomes `(member=uid=janedoe)` after string substitution. It matches all role entries that have a member attribute equal to `uid=janedoe` under the subtree selected by the `RoleBases` .
-        :param _builtins.str service_account_username: Service account username. A service account is an account in your LDAP server that has access to initiate a connection. For example, `cn=admin` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        :param _builtins.str user_base: Select a particular subtree of the directory information tree (DIT) to search for user entries. The subtree is specified by a DN, which specifies the base node of the subtree. For example, by setting this option to `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` , the search for user entries is restricted to the subtree beneath `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        :param _builtins.str user_search_matching: The LDAP search filter used to find users within the `userBase` . The client's username is substituted into the `{0}` placeholder in the search filter. For example, if this option is set to `(uid={0})` and the received username is `janedoe` , the search filter becomes `(uid=janedoe)` after string substitution. It will result in matching an entry like `uid=janedoe` , `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        :param _builtins.str role_name: The group name attribute in a role entry whose value is the name of that role. For example, you can specify `cn` for a group entry's common name. If authentication succeeds, then the user is assigned the the value of the `cn` attribute for each role entry that they are a member of.
-        :param _builtins.bool role_search_subtree: The directory search scope for the role. If set to true, scope is to search the entire subtree.
-        :param _builtins.str service_account_password: Service account password. A service account is an account in your LDAP server that has access to initiate a connection. For example, `cn=admin` , `dc=corp` , `dc=example` , `dc=com` .
-        :param _builtins.str user_role_name: The name of the LDAP attribute in the user's directory entry for the user's group membership. In some cases, user roles may be identified by the value of an attribute in the user's directory entry. The `UserRoleName` option allows you to provide the name of this attribute.
-        :param _builtins.bool user_search_subtree: The directory search scope for the user. If set to true, scope is to search the entire subtree.
-        """
         pulumi.set(__self__, "hosts", hosts)
         pulumi.set(__self__, "role_base", role_base)
         pulumi.set(__self__, "role_search_matching", role_search_matching)
@@ -190,89 +177,56 @@ class BrokerLdapServerMetadata(dict):
     @_builtins.property
     @pulumi.getter
     def hosts(self) -> Sequence[_builtins.str]:
-        """
-        Specifies the location of the LDAP server such as AWS Directory Service for Microsoft Active Directory . Optional failover server.
-        """
         return pulumi.get(self, "hosts")
 
     @_builtins.property
     @pulumi.getter(name="roleBase")
     def role_base(self) -> _builtins.str:
-        """
-        The distinguished name of the node in the directory information tree (DIT) to search for roles or groups. For example, `ou=group` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        """
         return pulumi.get(self, "role_base")
 
     @_builtins.property
     @pulumi.getter(name="roleSearchMatching")
     def role_search_matching(self) -> _builtins.str:
-        """
-        The LDAP search filter used to find roles within the roleBase. The distinguished name of the user matched by userSearchMatching is substituted into the `{0}` placeholder in the search filter. The client's username is substituted into the `{1}` placeholder. For example, if you set this option to `(member=uid={1})` for the user janedoe, the search filter becomes `(member=uid=janedoe)` after string substitution. It matches all role entries that have a member attribute equal to `uid=janedoe` under the subtree selected by the `RoleBases` .
-        """
         return pulumi.get(self, "role_search_matching")
 
     @_builtins.property
     @pulumi.getter(name="serviceAccountUsername")
     def service_account_username(self) -> _builtins.str:
-        """
-        Service account username. A service account is an account in your LDAP server that has access to initiate a connection. For example, `cn=admin` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        """
         return pulumi.get(self, "service_account_username")
 
     @_builtins.property
     @pulumi.getter(name="userBase")
     def user_base(self) -> _builtins.str:
-        """
-        Select a particular subtree of the directory information tree (DIT) to search for user entries. The subtree is specified by a DN, which specifies the base node of the subtree. For example, by setting this option to `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` , the search for user entries is restricted to the subtree beneath `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        """
         return pulumi.get(self, "user_base")
 
     @_builtins.property
     @pulumi.getter(name="userSearchMatching")
     def user_search_matching(self) -> _builtins.str:
-        """
-        The LDAP search filter used to find users within the `userBase` . The client's username is substituted into the `{0}` placeholder in the search filter. For example, if this option is set to `(uid={0})` and the received username is `janedoe` , the search filter becomes `(uid=janedoe)` after string substitution. It will result in matching an entry like `uid=janedoe` , `ou=Users` , `ou=corp` , `dc=corp` , `dc=example` , `dc=com` .
-        """
         return pulumi.get(self, "user_search_matching")
 
     @_builtins.property
     @pulumi.getter(name="roleName")
     def role_name(self) -> Optional[_builtins.str]:
-        """
-        The group name attribute in a role entry whose value is the name of that role. For example, you can specify `cn` for a group entry's common name. If authentication succeeds, then the user is assigned the the value of the `cn` attribute for each role entry that they are a member of.
-        """
         return pulumi.get(self, "role_name")
 
     @_builtins.property
     @pulumi.getter(name="roleSearchSubtree")
     def role_search_subtree(self) -> Optional[_builtins.bool]:
-        """
-        The directory search scope for the role. If set to true, scope is to search the entire subtree.
-        """
         return pulumi.get(self, "role_search_subtree")
 
     @_builtins.property
     @pulumi.getter(name="serviceAccountPassword")
     def service_account_password(self) -> Optional[_builtins.str]:
-        """
-        Service account password. A service account is an account in your LDAP server that has access to initiate a connection. For example, `cn=admin` , `dc=corp` , `dc=example` , `dc=com` .
-        """
         return pulumi.get(self, "service_account_password")
 
     @_builtins.property
     @pulumi.getter(name="userRoleName")
     def user_role_name(self) -> Optional[_builtins.str]:
-        """
-        The name of the LDAP attribute in the user's directory entry for the user's group membership. In some cases, user roles may be identified by the value of an attribute in the user's directory entry. The `UserRoleName` option allows you to provide the name of this attribute.
-        """
         return pulumi.get(self, "user_role_name")
 
     @_builtins.property
     @pulumi.getter(name="userSearchSubtree")
     def user_search_subtree(self) -> Optional[_builtins.bool]:
-        """
-        The directory search scope for the user. If set to true, scope is to search the entire subtree.
-        """
         return pulumi.get(self, "user_search_subtree")
 
 
@@ -398,11 +352,14 @@ class BrokerUser(dict):
                  groups: Optional[Sequence[_builtins.str]] = None,
                  replication_user: Optional[_builtins.bool] = None):
         """
-        :param _builtins.str password: The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
-        :param _builtins.str username: The username of the broker user. For Amazon MQ for ActiveMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). For Amazon MQ for RabbitMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores (- . _). This value must not contain a tilde (~) character. Amazon MQ prohibts using guest as a valid usename. This value must be 2-100 characters long.
+        :param _builtins.str password: Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
+        :param _builtins.str username: The username of the broker user. The following restrictions apply to broker usernames:
+               
+               - For Amazon MQ for ActiveMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
+               - For Amazon MQ for RabbitMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores (- . _). This value must not contain a tilde (~) character. Amazon MQ prohibts using `guest` as a valid usename. This value must be 2-100 characters long.
                
                > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker usernames. Broker usernames are accessible to other AWS services, including CloudWatch Logs . Broker usernames are not intended to be used for private or sensitive data.
-        :param _builtins.bool console_access: Enables access to the ActiveMQ web console for the ActiveMQ user. Does not apply to RabbitMQ brokers.
+        :param _builtins.bool console_access: Enables access to the ActiveMQ Web Console for the ActiveMQ user. Does not apply to RabbitMQ brokers.
         :param Sequence[_builtins.str] groups: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long. Does not apply to RabbitMQ brokers.
         :param _builtins.bool replication_user: Defines if this user is intended for CRDR replication purposes.
         """
@@ -419,7 +376,7 @@ class BrokerUser(dict):
     @pulumi.getter
     def password(self) -> _builtins.str:
         """
-        The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
+        Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
         """
         return pulumi.get(self, "password")
 
@@ -427,7 +384,10 @@ class BrokerUser(dict):
     @pulumi.getter
     def username(self) -> _builtins.str:
         """
-        The username of the broker user. For Amazon MQ for ActiveMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). For Amazon MQ for RabbitMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores (- . _). This value must not contain a tilde (~) character. Amazon MQ prohibts using guest as a valid usename. This value must be 2-100 characters long.
+        The username of the broker user. The following restrictions apply to broker usernames:
+
+        - For Amazon MQ for ActiveMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
+        - For Amazon MQ for RabbitMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores (- . _). This value must not contain a tilde (~) character. Amazon MQ prohibts using `guest` as a valid usename. This value must be 2-100 characters long.
 
         > Do not add personally identifiable information (PII) or other confidential or sensitive information in broker usernames. Broker usernames are accessible to other AWS services, including CloudWatch Logs . Broker usernames are not intended to be used for private or sensitive data.
         """
@@ -437,7 +397,7 @@ class BrokerUser(dict):
     @pulumi.getter(name="consoleAccess")
     def console_access(self) -> Optional[_builtins.bool]:
         """
-        Enables access to the ActiveMQ web console for the ActiveMQ user. Does not apply to RabbitMQ brokers.
+        Enables access to the ActiveMQ Web Console for the ActiveMQ user. Does not apply to RabbitMQ brokers.
         """
         return pulumi.get(self, "console_access")
 

pulumi_aws_native/batch/_inputs.py

@@ -106,6 +106,8 @@ __all__ = [
     'JobDefinitionRepositoryCredentialsArgsDict',
     'JobDefinitionResourceRequirementArgs',
     'JobDefinitionResourceRequirementArgsDict',
+    'JobDefinitionResourceRetentionPolicyArgs',
+    'JobDefinitionResourceRetentionPolicyArgsDict',
     'JobDefinitionRetryStrategyArgs',
     'JobDefinitionRetryStrategyArgsDict',
     'JobDefinitionRuntimePlatformArgs',
@@ -5682,6 +5684,29 @@ class JobDefinitionResourceRequirementArgs:
         pulumi.set(self, "value", value)
 
 
+if not MYPY:
+    class JobDefinitionResourceRetentionPolicyArgsDict(TypedDict):
+        skip_deregister_on_update: NotRequired[pulumi.Input[_builtins.bool]]
+elif False:
+    JobDefinitionResourceRetentionPolicyArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class JobDefinitionResourceRetentionPolicyArgs:
+    def __init__(__self__, *,
+                 skip_deregister_on_update: Optional[pulumi.Input[_builtins.bool]] = None):
+        if skip_deregister_on_update is not None:
+            pulumi.set(__self__, "skip_deregister_on_update", skip_deregister_on_update)
+
+    @_builtins.property
+    @pulumi.getter(name="skipDeregisterOnUpdate")
+    def skip_deregister_on_update(self) -> Optional[pulumi.Input[_builtins.bool]]:
+        return pulumi.get(self, "skip_deregister_on_update")
+
+    @skip_deregister_on_update.setter
+    def skip_deregister_on_update(self, value: Optional[pulumi.Input[_builtins.bool]]):
+        pulumi.set(self, "skip_deregister_on_update", value)
+
+
 if not MYPY:
     class JobDefinitionRetryStrategyArgsDict(TypedDict):
         attempts: NotRequired[pulumi.Input[_builtins.int]]