Interface OpsItem.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<OpsItem.Builder,
,OpsItem> SdkBuilder<OpsItem.Builder,
,OpsItem> SdkPojo
- Enclosing class:
OpsItem
-
Method Summary
Modifier and TypeMethodDescriptionactualEndTime
(Instant actualEndTime) The time a runbook workflow ended.actualStartTime
(Instant actualStartTime) The time a runbook workflow started.An OpsItem category.The ARN of the Amazon Web Services account that created the OpsItem.createdTime
(Instant createdTime) The date and time the OpsItem was created.description
(String description) The OpsItem description.lastModifiedBy
(String lastModifiedBy) The ARN of the Amazon Web Services account that last updated the OpsItem.lastModifiedTime
(Instant lastModifiedTime) The date and time the OpsItem was last updated.notifications
(Collection<OpsItemNotification> notifications) The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.notifications
(Consumer<OpsItemNotification.Builder>... notifications) The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.notifications
(OpsItemNotification... notifications) The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.operationalData
(Map<String, OpsItemDataValue> operationalData) Operational data is custom data that provides useful reference details about the OpsItem.opsItemArn
(String opsItemArn) The OpsItem Amazon Resource Name (ARN).The ID of the OpsItem.opsItemType
(String opsItemType) The type of OpsItem.plannedEndTime
(Instant plannedEndTime) The time specified in a change request for a runbook workflow to end.plannedStartTime
(Instant plannedStartTime) The time specified in a change request for a runbook workflow to start.The importance of this OpsItem in relation to other OpsItems in the system.relatedOpsItems
(Collection<RelatedOpsItem> relatedOpsItems) One or more OpsItems that share something in common with the current OpsItem.relatedOpsItems
(Consumer<RelatedOpsItem.Builder>... relatedOpsItems) One or more OpsItems that share something in common with the current OpsItem.relatedOpsItems
(RelatedOpsItem... relatedOpsItems) One or more OpsItems that share something in common with the current OpsItem.The severity of the OpsItem.The origin of the OpsItem, such as Amazon EC2 or Systems Manager.The OpsItem status.status
(OpsItemStatus status) The OpsItem status.A short heading that describes the nature of the OpsItem and the impacted resource.The version of this OpsItem.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
createdBy
The ARN of the Amazon Web Services account that created the OpsItem.
- Parameters:
createdBy
- The ARN of the Amazon Web Services account that created the OpsItem.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
opsItemType
The type of OpsItem. Systems Manager supports the following types of OpsItems:
-
/aws/issue
This type of OpsItem is used for default OpsItems created by OpsCenter.
-
/aws/changerequest
This type of OpsItem is used by Change Manager for reviewing and approving or rejecting change requests.
-
/aws/insight
This type of OpsItem is used by OpsCenter for aggregating and reporting on duplicate OpsItems.
- Parameters:
opsItemType
- The type of OpsItem. Systems Manager supports the following types of OpsItems:-
/aws/issue
This type of OpsItem is used for default OpsItems created by OpsCenter.
-
/aws/changerequest
This type of OpsItem is used by Change Manager for reviewing and approving or rejecting change requests.
-
/aws/insight
This type of OpsItem is used by OpsCenter for aggregating and reporting on duplicate OpsItems.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
-
createdTime
The date and time the OpsItem was created.
- Parameters:
createdTime
- The date and time the OpsItem was created.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
The OpsItem description.
- Parameters:
description
- The OpsItem description.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastModifiedBy
The ARN of the Amazon Web Services account that last updated the OpsItem.
- Parameters:
lastModifiedBy
- The ARN of the Amazon Web Services account that last updated the OpsItem.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
lastModifiedTime
The date and time the OpsItem was last updated.
- Parameters:
lastModifiedTime
- The date and time the OpsItem was last updated.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
notifications
The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.
- Parameters:
notifications
- The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
notifications
The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.
- Parameters:
notifications
- The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
notifications
The Amazon Resource Name (ARN) of an Amazon Simple Notification Service (Amazon SNS) topic where notifications are sent when this OpsItem is edited or changed.
This is a convenience method that creates an instance of theOpsItemNotification.Builder
avoiding the need to create one manually viaOpsItemNotification.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tonotifications(List<OpsItemNotification>)
.- Parameters:
notifications
- a consumer that will call methods onOpsItemNotification.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
priority
The importance of this OpsItem in relation to other OpsItems in the system.
- Parameters:
priority
- The importance of this OpsItem in relation to other OpsItems in the system.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The OpsItem status. For more information, see Editing OpsItem details in the Amazon Web Services Systems Manager User Guide.
- Parameters:
status
- The OpsItem status. For more information, see Editing OpsItem details in the Amazon Web Services Systems Manager User Guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
status
The OpsItem status. For more information, see Editing OpsItem details in the Amazon Web Services Systems Manager User Guide.
- Parameters:
status
- The OpsItem status. For more information, see Editing OpsItem details in the Amazon Web Services Systems Manager User Guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
opsItemId
The ID of the OpsItem.
- Parameters:
opsItemId
- The ID of the OpsItem.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
version
The version of this OpsItem. Each time the OpsItem is edited the version number increments by one.
- Parameters:
version
- The version of this OpsItem. Each time the OpsItem is edited the version number increments by one.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
title
A short heading that describes the nature of the OpsItem and the impacted resource.
- Parameters:
title
- A short heading that describes the nature of the OpsItem and the impacted resource.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
source
The origin of the OpsItem, such as Amazon EC2 or Systems Manager. The impacted resource is a subset of source.
- Parameters:
source
- The origin of the OpsItem, such as Amazon EC2 or Systems Manager. The impacted resource is a subset of source.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
operationalData
Operational data is custom data that provides useful reference details about the OpsItem. For example, you can specify log files, error strings, license keys, troubleshooting tips, or other relevant data. You enter operational data as key-value pairs. The key has a maximum length of 128 characters. The value has a maximum size of 20 KB.
Operational data keys can't begin with the following:
amazon
,aws
,amzn
,ssm
,/amazon
,/aws
,/amzn
,/ssm
.You can choose to make the data searchable by other users in the account or you can restrict search access. Searchable data means that all users with access to the OpsItem Overview page (as provided by the DescribeOpsItems API operation) can view and search on the specified data. Operational data that isn't searchable is only viewable by users who have access to the OpsItem (as provided by the GetOpsItem API operation).
Use the
/aws/resources
key in OperationalData to specify a related resource in the request. Use the/aws/automations
key in OperationalData to associate an Automation runbook with the OpsItem. To view Amazon Web Services CLI example commands that use these keys, see Creating OpsItems manually in the Amazon Web Services Systems Manager User Guide.- Parameters:
operationalData
- Operational data is custom data that provides useful reference details about the OpsItem. For example, you can specify log files, error strings, license keys, troubleshooting tips, or other relevant data. You enter operational data as key-value pairs. The key has a maximum length of 128 characters. The value has a maximum size of 20 KB.Operational data keys can't begin with the following:
amazon
,aws
,amzn
,ssm
,/amazon
,/aws
,/amzn
,/ssm
.You can choose to make the data searchable by other users in the account or you can restrict search access. Searchable data means that all users with access to the OpsItem Overview page (as provided by the DescribeOpsItems API operation) can view and search on the specified data. Operational data that isn't searchable is only viewable by users who have access to the OpsItem (as provided by the GetOpsItem API operation).
Use the
/aws/resources
key in OperationalData to specify a related resource in the request. Use the/aws/automations
key in OperationalData to associate an Automation runbook with the OpsItem. To view Amazon Web Services CLI example commands that use these keys, see Creating OpsItems manually in the Amazon Web Services Systems Manager User Guide.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
category
An OpsItem category. Category options include: Availability, Cost, Performance, Recovery, Security.
- Parameters:
category
- An OpsItem category. Category options include: Availability, Cost, Performance, Recovery, Security.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
severity
The severity of the OpsItem. Severity options range from 1 to 4.
- Parameters:
severity
- The severity of the OpsItem. Severity options range from 1 to 4.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
actualStartTime
The time a runbook workflow started. Currently reported only for the OpsItem type
/aws/changerequest
.- Parameters:
actualStartTime
- The time a runbook workflow started. Currently reported only for the OpsItem type/aws/changerequest
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
actualEndTime
The time a runbook workflow ended. Currently reported only for the OpsItem type
/aws/changerequest
.- Parameters:
actualEndTime
- The time a runbook workflow ended. Currently reported only for the OpsItem type/aws/changerequest
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
plannedStartTime
The time specified in a change request for a runbook workflow to start. Currently supported only for the OpsItem type
/aws/changerequest
.- Parameters:
plannedStartTime
- The time specified in a change request for a runbook workflow to start. Currently supported only for the OpsItem type/aws/changerequest
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
plannedEndTime
The time specified in a change request for a runbook workflow to end. Currently supported only for the OpsItem type
/aws/changerequest
.- Parameters:
plannedEndTime
- The time specified in a change request for a runbook workflow to end. Currently supported only for the OpsItem type/aws/changerequest
.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
opsItemArn
The OpsItem Amazon Resource Name (ARN).
- Parameters:
opsItemArn
- The OpsItem Amazon Resource Name (ARN).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-