#[non_exhaustive]pub struct MaintenanceWindowRunCommandParameters {
pub comment: Option<String>,
pub cloud_watch_output_config: Option<CloudWatchOutputConfig>,
pub document_hash: Option<String>,
pub document_hash_type: Option<DocumentHashType>,
pub document_version: Option<String>,
pub notification_config: Option<NotificationConfig>,
pub output_s3_bucket_name: Option<String>,
pub output_s3_key_prefix: Option<String>,
pub parameters: Option<HashMap<String, Vec<String>>>,
pub service_role_arn: Option<String>,
pub timeout_seconds: Option<i32>,
}
Expand description
The parameters for a RUN_COMMAND
task type.
For information about specifying and updating task parameters, see RegisterTaskWithMaintenanceWindow
and UpdateMaintenanceWindowTask
.
LoggingInfo
has been deprecated. To specify an Amazon Simple Storage Service (Amazon S3) bucket to contain logs, instead use the OutputS3BucketName
and OutputS3KeyPrefix
options in the TaskInvocationParameters
structure. For information about how Amazon Web Services Systems Manager handles these options for the supported maintenance window task types, see MaintenanceWindowTaskInvocationParameters
.
TaskParameters
has been deprecated. To specify parameters to pass to a task when it runs, instead use the Parameters
option in the TaskInvocationParameters
structure. For information about how Systems Manager handles these options for the supported maintenance window task types, see MaintenanceWindowTaskInvocationParameters
.
For RUN_COMMAND
tasks, Systems Manager uses specified values for TaskParameters
and LoggingInfo
only if no values are specified for TaskInvocationParameters
.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. }
syntax; cannot be matched against without a wildcard ..
; and struct update syntax will not work.comment: Option<String>
Information about the commands to run.
cloud_watch_output_config: Option<CloudWatchOutputConfig>
Configuration options for sending command output to Amazon CloudWatch Logs.
document_hash: Option<String>
The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.
document_hash_type: Option<DocumentHashType>
SHA-256 or SHA-1. SHA-1 hashes have been deprecated.
document_version: Option<String>
The Amazon Web Services Systems Manager document (SSM document) version to use in the request. You can specify $DEFAULT
, $LATEST
, or a specific version number. If you run commands by using the Amazon Web Services CLI, then you must escape the first two options by using a backslash. If you specify a version number, then you don't need to use the backslash. For example:
--document-version "\$DEFAULT"
--document-version "\$LATEST"
--document-version "3"
notification_config: Option<NotificationConfig>
Configurations for sending notifications about command status changes on a per-managed node basis.
output_s3_bucket_name: Option<String>
The name of the Amazon Simple Storage Service (Amazon S3) bucket.
output_s3_key_prefix: Option<String>
The S3 bucket subfolder.
parameters: Option<HashMap<String, Vec<String>>>
The parameters for the RUN_COMMAND
task execution.
service_role_arn: Option<String>
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.
timeout_seconds: Option<i32>
If this time is reached and the command hasn't already started running, it doesn't run.
Implementations§
Source§impl MaintenanceWindowRunCommandParameters
impl MaintenanceWindowRunCommandParameters
Sourcepub fn cloud_watch_output_config(&self) -> Option<&CloudWatchOutputConfig>
pub fn cloud_watch_output_config(&self) -> Option<&CloudWatchOutputConfig>
Configuration options for sending command output to Amazon CloudWatch Logs.
Sourcepub fn document_hash(&self) -> Option<&str>
pub fn document_hash(&self) -> Option<&str>
The SHA-256 or SHA-1 hash created by the system when the document was created. SHA-1 hashes have been deprecated.
Sourcepub fn document_hash_type(&self) -> Option<&DocumentHashType>
pub fn document_hash_type(&self) -> Option<&DocumentHashType>
SHA-256 or SHA-1. SHA-1 hashes have been deprecated.
Sourcepub fn document_version(&self) -> Option<&str>
pub fn document_version(&self) -> Option<&str>
The Amazon Web Services Systems Manager document (SSM document) version to use in the request. You can specify $DEFAULT
, $LATEST
, or a specific version number. If you run commands by using the Amazon Web Services CLI, then you must escape the first two options by using a backslash. If you specify a version number, then you don't need to use the backslash. For example:
--document-version "\$DEFAULT"
--document-version "\$LATEST"
--document-version "3"
Sourcepub fn notification_config(&self) -> Option<&NotificationConfig>
pub fn notification_config(&self) -> Option<&NotificationConfig>
Configurations for sending notifications about command status changes on a per-managed node basis.
Sourcepub fn output_s3_bucket_name(&self) -> Option<&str>
pub fn output_s3_bucket_name(&self) -> Option<&str>
The name of the Amazon Simple Storage Service (Amazon S3) bucket.
Sourcepub fn output_s3_key_prefix(&self) -> Option<&str>
pub fn output_s3_key_prefix(&self) -> Option<&str>
The S3 bucket subfolder.
Sourcepub fn parameters(&self) -> Option<&HashMap<String, Vec<String>>>
pub fn parameters(&self) -> Option<&HashMap<String, Vec<String>>>
The parameters for the RUN_COMMAND
task execution.
Sourcepub fn service_role_arn(&self) -> Option<&str>
pub fn service_role_arn(&self) -> Option<&str>
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.
Sourcepub fn timeout_seconds(&self) -> Option<i32>
pub fn timeout_seconds(&self) -> Option<i32>
If this time is reached and the command hasn't already started running, it doesn't run.
Source§impl MaintenanceWindowRunCommandParameters
impl MaintenanceWindowRunCommandParameters
Sourcepub fn builder() -> MaintenanceWindowRunCommandParametersBuilder
pub fn builder() -> MaintenanceWindowRunCommandParametersBuilder
Creates a new builder-style object to manufacture MaintenanceWindowRunCommandParameters
.
Trait Implementations§
Source§impl Clone for MaintenanceWindowRunCommandParameters
impl Clone for MaintenanceWindowRunCommandParameters
Source§fn clone(&self) -> MaintenanceWindowRunCommandParameters
fn clone(&self) -> MaintenanceWindowRunCommandParameters
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl PartialEq for MaintenanceWindowRunCommandParameters
impl PartialEq for MaintenanceWindowRunCommandParameters
Source§fn eq(&self, other: &MaintenanceWindowRunCommandParameters) -> bool
fn eq(&self, other: &MaintenanceWindowRunCommandParameters) -> bool
self
and other
values to be equal, and is used by ==
.impl StructuralPartialEq for MaintenanceWindowRunCommandParameters
Auto Trait Implementations§
impl Freeze for MaintenanceWindowRunCommandParameters
impl RefUnwindSafe for MaintenanceWindowRunCommandParameters
impl Send for MaintenanceWindowRunCommandParameters
impl Sync for MaintenanceWindowRunCommandParameters
impl Unpin for MaintenanceWindowRunCommandParameters
impl UnwindSafe for MaintenanceWindowRunCommandParameters
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);