Update Broker
mq_update_broker | R Documentation |
Adds a pending configuration change to a broker¶
Description¶
Adds a pending configuration change to a broker.
Usage¶
mq_update_broker(AuthenticationStrategy, AutoMinorVersionUpgrade,
BrokerId, Configuration, EngineVersion, HostInstanceType,
LdapServerMetadata, Logs, MaintenanceWindowStartTime, SecurityGroups,
DataReplicationMode)
Arguments¶
AuthenticationStrategy
Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
AutoMinorVersionUpgrade
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.
BrokerId
[required] The unique ID that Amazon MQ generates for the broker.
Configuration
A list of information about the configuration.
EngineVersion
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.
HostInstanceType
The broker's host instance type to upgrade to. For a list of supported instance types, see Broker instance types.
LdapServerMetadata
Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker. Does not apply to RabbitMQ brokers.
Logs
Enables Amazon CloudWatch logging for brokers.
MaintenanceWindowStartTime
The parameters that determine the WeeklyStartTime.
SecurityGroups
The list of security groups (1 minimum, 5 maximum) that authorizes connections to brokers.
DataReplicationMode
Defines whether this broker is a part of a data replication pair.
Value¶
A list with the following syntax:
list(
AuthenticationStrategy = "SIMPLE"|"LDAP",
AutoMinorVersionUpgrade = TRUE|FALSE,
BrokerId = "string",
Configuration = list(
Id = "string",
Revision = 123
),
EngineVersion = "string",
HostInstanceType = "string",
LdapServerMetadata = list(
Hosts = list(
"string"
),
RoleBase = "string",
RoleName = "string",
RoleSearchMatching = "string",
RoleSearchSubtree = TRUE|FALSE,
ServiceAccountUsername = "string",
UserBase = "string",
UserRoleName = "string",
UserSearchMatching = "string",
UserSearchSubtree = TRUE|FALSE
),
Logs = list(
Audit = TRUE|FALSE,
General = TRUE|FALSE
),
MaintenanceWindowStartTime = list(
DayOfWeek = "MONDAY"|"TUESDAY"|"WEDNESDAY"|"THURSDAY"|"FRIDAY"|"SATURDAY"|"SUNDAY",
TimeOfDay = "string",
TimeZone = "string"
),
SecurityGroups = list(
"string"
),
DataReplicationMetadata = list(
DataReplicationCounterpart = list(
BrokerId = "string",
Region = "string"
),
DataReplicationRole = "string"
),
DataReplicationMode = "NONE"|"CRDR",
PendingDataReplicationMetadata = list(
DataReplicationCounterpart = list(
BrokerId = "string",
Region = "string"
),
DataReplicationRole = "string"
),
PendingDataReplicationMode = "NONE"|"CRDR"
)
Request syntax¶
svc$update_broker(
AuthenticationStrategy = "SIMPLE"|"LDAP",
AutoMinorVersionUpgrade = TRUE|FALSE,
BrokerId = "string",
Configuration = list(
Id = "string",
Revision = 123
),
EngineVersion = "string",
HostInstanceType = "string",
LdapServerMetadata = list(
Hosts = list(
"string"
),
RoleBase = "string",
RoleName = "string",
RoleSearchMatching = "string",
RoleSearchSubtree = TRUE|FALSE,
ServiceAccountPassword = "string",
ServiceAccountUsername = "string",
UserBase = "string",
UserRoleName = "string",
UserSearchMatching = "string",
UserSearchSubtree = TRUE|FALSE
),
Logs = list(
Audit = TRUE|FALSE,
General = TRUE|FALSE
),
MaintenanceWindowStartTime = list(
DayOfWeek = "MONDAY"|"TUESDAY"|"WEDNESDAY"|"THURSDAY"|"FRIDAY"|"SATURDAY"|"SUNDAY",
TimeOfDay = "string",
TimeZone = "string"
),
SecurityGroups = list(
"string"
),
DataReplicationMode = "NONE"|"CRDR"
)