#[non_exhaustive]pub struct GetMaintenanceWindowTaskOutput {Show 16 fields
pub window_id: Option<String>,
pub window_task_id: Option<String>,
pub targets: Option<Vec<Target>>,
pub task_arn: Option<String>,
pub service_role_arn: Option<String>,
pub task_type: Option<MaintenanceWindowTaskType>,
pub task_parameters: Option<HashMap<String, MaintenanceWindowTaskParameterValueExpression>>,
pub task_invocation_parameters: Option<MaintenanceWindowTaskInvocationParameters>,
pub priority: i32,
pub max_concurrency: Option<String>,
pub max_errors: Option<String>,
pub logging_info: Option<LoggingInfo>,
pub name: Option<String>,
pub description: Option<String>,
pub cutoff_behavior: Option<MaintenanceWindowTaskCutoffBehavior>,
pub alarm_configuration: Option<AlarmConfiguration>,
/* private fields */
}
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.window_id: Option<String>
The retrieved maintenance window ID.
window_task_id: Option<String>
The retrieved maintenance window task ID.
targets: Option<Vec<Target>>
The targets where the task should run.
task_arn: Option<String>
The resource that the task used during execution. For RUN_COMMAND
and AUTOMATION
task types, the value of TaskArn
is the SSM document name/ARN. For LAMBDA
tasks, the value is the function name/ARN. For STEP_FUNCTIONS
tasks, the value is the state machine ARN.
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.
task_type: Option<MaintenanceWindowTaskType>
The type of task to run.
task_parameters: Option<HashMap<String, MaintenanceWindowTaskParameterValueExpression>>
The parameters to pass to the task when it runs.
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
.
task_invocation_parameters: Option<MaintenanceWindowTaskInvocationParameters>
The parameters to pass to the task when it runs.
priority: i32
The priority of the task when it runs. The lower the number, the higher the priority. Tasks that have the same priority are scheduled in parallel.
max_concurrency: Option<String>
The maximum number of targets allowed to run this task in parallel.
For maintenance window tasks without a target specified, you can't supply a value for this option. Instead, the system inserts a placeholder value of 1
, which may be reported in the response to this command. This value doesn't affect the running of your task and can be ignored.
max_errors: Option<String>
The maximum number of errors allowed before the task stops being scheduled.
For maintenance window tasks without a target specified, you can't supply a value for this option. Instead, the system inserts a placeholder value of 1
, which may be reported in the response to this command. This value doesn't affect the running of your task and can be ignored.
logging_info: Option<LoggingInfo>
The location in Amazon Simple Storage Service (Amazon S3) where the task results are logged.
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
.
name: Option<String>
The retrieved task name.
description: Option<String>
The retrieved task description.
cutoff_behavior: Option<MaintenanceWindowTaskCutoffBehavior>
The action to take on tasks when the maintenance window cutoff time is reached. CONTINUE_TASK
means that tasks continue to run. For Automation, Lambda, Step Functions tasks, CANCEL_TASK
means that currently running task invocations continue, but no new task invocations are started. For Run Command tasks, CANCEL_TASK
means the system attempts to stop the task by sending a CancelCommand
operation.
alarm_configuration: Option<AlarmConfiguration>
The details for the CloudWatch alarm you applied to your maintenance window task.
Implementations§
Source§impl GetMaintenanceWindowTaskOutput
impl GetMaintenanceWindowTaskOutput
Sourcepub fn window_task_id(&self) -> Option<&str>
pub fn window_task_id(&self) -> Option<&str>
The retrieved maintenance window task ID.
Sourcepub fn targets(&self) -> &[Target]
pub fn targets(&self) -> &[Target]
The targets where the task should run.
If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .targets.is_none()
.
Sourcepub fn task_arn(&self) -> Option<&str>
pub fn task_arn(&self) -> Option<&str>
The resource that the task used during execution. For RUN_COMMAND
and AUTOMATION
task types, the value of TaskArn
is the SSM document name/ARN. For LAMBDA
tasks, the value is the function name/ARN. For STEP_FUNCTIONS
tasks, the value is the state machine ARN.
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 task_type(&self) -> Option<&MaintenanceWindowTaskType>
pub fn task_type(&self) -> Option<&MaintenanceWindowTaskType>
The type of task to run.
Sourcepub fn task_parameters(
&self,
) -> Option<&HashMap<String, MaintenanceWindowTaskParameterValueExpression>>
pub fn task_parameters( &self, ) -> Option<&HashMap<String, MaintenanceWindowTaskParameterValueExpression>>
The parameters to pass to the task when it runs.
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
.
Sourcepub fn task_invocation_parameters(
&self,
) -> Option<&MaintenanceWindowTaskInvocationParameters>
pub fn task_invocation_parameters( &self, ) -> Option<&MaintenanceWindowTaskInvocationParameters>
The parameters to pass to the task when it runs.
Sourcepub fn priority(&self) -> i32
pub fn priority(&self) -> i32
The priority of the task when it runs. The lower the number, the higher the priority. Tasks that have the same priority are scheduled in parallel.
Sourcepub fn max_concurrency(&self) -> Option<&str>
pub fn max_concurrency(&self) -> Option<&str>
The maximum number of targets allowed to run this task in parallel.
For maintenance window tasks without a target specified, you can't supply a value for this option. Instead, the system inserts a placeholder value of 1
, which may be reported in the response to this command. This value doesn't affect the running of your task and can be ignored.
Sourcepub fn max_errors(&self) -> Option<&str>
pub fn max_errors(&self) -> Option<&str>
The maximum number of errors allowed before the task stops being scheduled.
For maintenance window tasks without a target specified, you can't supply a value for this option. Instead, the system inserts a placeholder value of 1
, which may be reported in the response to this command. This value doesn't affect the running of your task and can be ignored.
Sourcepub fn logging_info(&self) -> Option<&LoggingInfo>
pub fn logging_info(&self) -> Option<&LoggingInfo>
The location in Amazon Simple Storage Service (Amazon S3) where the task results are logged.
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
.
Sourcepub fn description(&self) -> Option<&str>
pub fn description(&self) -> Option<&str>
The retrieved task description.
Sourcepub fn cutoff_behavior(&self) -> Option<&MaintenanceWindowTaskCutoffBehavior>
pub fn cutoff_behavior(&self) -> Option<&MaintenanceWindowTaskCutoffBehavior>
The action to take on tasks when the maintenance window cutoff time is reached. CONTINUE_TASK
means that tasks continue to run. For Automation, Lambda, Step Functions tasks, CANCEL_TASK
means that currently running task invocations continue, but no new task invocations are started. For Run Command tasks, CANCEL_TASK
means the system attempts to stop the task by sending a CancelCommand
operation.
Sourcepub fn alarm_configuration(&self) -> Option<&AlarmConfiguration>
pub fn alarm_configuration(&self) -> Option<&AlarmConfiguration>
The details for the CloudWatch alarm you applied to your maintenance window task.
Source§impl GetMaintenanceWindowTaskOutput
impl GetMaintenanceWindowTaskOutput
Sourcepub fn builder() -> GetMaintenanceWindowTaskOutputBuilder
pub fn builder() -> GetMaintenanceWindowTaskOutputBuilder
Creates a new builder-style object to manufacture GetMaintenanceWindowTaskOutput
.
Trait Implementations§
Source§impl Clone for GetMaintenanceWindowTaskOutput
impl Clone for GetMaintenanceWindowTaskOutput
Source§fn clone(&self) -> GetMaintenanceWindowTaskOutput
fn clone(&self) -> GetMaintenanceWindowTaskOutput
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl PartialEq for GetMaintenanceWindowTaskOutput
impl PartialEq for GetMaintenanceWindowTaskOutput
Source§fn eq(&self, other: &GetMaintenanceWindowTaskOutput) -> bool
fn eq(&self, other: &GetMaintenanceWindowTaskOutput) -> bool
self
and other
values to be equal, and is used by ==
.Source§impl RequestId for GetMaintenanceWindowTaskOutput
impl RequestId for GetMaintenanceWindowTaskOutput
Source§fn request_id(&self) -> Option<&str>
fn request_id(&self) -> Option<&str>
None
if the service could not be reached.impl StructuralPartialEq for GetMaintenanceWindowTaskOutput
Auto Trait Implementations§
impl Freeze for GetMaintenanceWindowTaskOutput
impl RefUnwindSafe for GetMaintenanceWindowTaskOutput
impl Send for GetMaintenanceWindowTaskOutput
impl Sync for GetMaintenanceWindowTaskOutput
impl Unpin for GetMaintenanceWindowTaskOutput
impl UnwindSafe for GetMaintenanceWindowTaskOutput
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);