SSMClient#
Auto-generated documentation for SSM type annotations stubs module mypy-boto3-ssm.
SSMClient#
Type annotations and code completion for boto3.client("ssm")
.
boto3 documentation
# SSMClient usage example
from boto3.session import Session
from mypy_boto3_ssm.client import SSMClient
def get_ssm_client() -> SSMClient:
return Session().client("ssm")
Exceptions#
boto3
client exceptions are generated in runtime.
This class provides code completion for boto3.client("ssm").exceptions
structure.
# Exceptions.exceptions usage example
client = boto3.client("ssm")
try:
do_something(client)
except (
client.exceptions.AlreadyExistsException,
client.exceptions.AssociatedInstances,
client.exceptions.AssociationAlreadyExists,
client.exceptions.AssociationDoesNotExist,
client.exceptions.AssociationExecutionDoesNotExist,
client.exceptions.AssociationLimitExceeded,
client.exceptions.AssociationVersionLimitExceeded,
client.exceptions.AutomationDefinitionNotApprovedException,
client.exceptions.AutomationDefinitionNotFoundException,
client.exceptions.AutomationDefinitionVersionNotFoundException,
client.exceptions.AutomationExecutionLimitExceededException,
client.exceptions.AutomationExecutionNotFoundException,
client.exceptions.AutomationStepNotFoundException,
client.exceptions.ClientError,
client.exceptions.ComplianceTypeCountLimitExceededException,
client.exceptions.CustomSchemaCountLimitExceededException,
client.exceptions.DocumentAlreadyExists,
client.exceptions.DocumentLimitExceeded,
client.exceptions.DocumentPermissionLimit,
client.exceptions.DocumentVersionLimitExceeded,
client.exceptions.DoesNotExistException,
client.exceptions.DuplicateDocumentContent,
client.exceptions.DuplicateDocumentVersionName,
client.exceptions.DuplicateInstanceId,
client.exceptions.FeatureNotAvailableException,
client.exceptions.HierarchyLevelLimitExceededException,
client.exceptions.HierarchyTypeMismatchException,
client.exceptions.IdempotentParameterMismatch,
client.exceptions.IncompatiblePolicyException,
client.exceptions.InternalServerError,
client.exceptions.InvalidActivation,
client.exceptions.InvalidActivationId,
client.exceptions.InvalidAggregatorException,
client.exceptions.InvalidAllowedPatternException,
client.exceptions.InvalidAssociation,
client.exceptions.InvalidAssociationVersion,
client.exceptions.InvalidAutomationExecutionParametersException,
client.exceptions.InvalidAutomationSignalException,
client.exceptions.InvalidAutomationStatusUpdateException,
client.exceptions.InvalidCommandId,
client.exceptions.InvalidDeleteInventoryParametersException,
client.exceptions.InvalidDeletionIdException,
client.exceptions.InvalidDocument,
client.exceptions.InvalidDocumentContent,
client.exceptions.InvalidDocumentOperation,
client.exceptions.InvalidDocumentSchemaVersion,
client.exceptions.InvalidDocumentType,
client.exceptions.InvalidDocumentVersion,
client.exceptions.InvalidFilter,
client.exceptions.InvalidFilterKey,
client.exceptions.InvalidFilterOption,
client.exceptions.InvalidFilterValue,
client.exceptions.InvalidInstanceId,
client.exceptions.InvalidInstanceInformationFilterValue,
client.exceptions.InvalidInventoryGroupException,
client.exceptions.InvalidInventoryItemContextException,
client.exceptions.InvalidInventoryRequestException,
client.exceptions.InvalidItemContentException,
client.exceptions.InvalidKeyId,
client.exceptions.InvalidNextToken,
client.exceptions.InvalidNotificationConfig,
client.exceptions.InvalidOptionException,
client.exceptions.InvalidOutputFolder,
client.exceptions.InvalidOutputLocation,
client.exceptions.InvalidParameters,
client.exceptions.InvalidPermissionType,
client.exceptions.InvalidPluginName,
client.exceptions.InvalidPolicyAttributeException,
client.exceptions.InvalidPolicyTypeException,
client.exceptions.InvalidResourceId,
client.exceptions.InvalidResourceType,
client.exceptions.InvalidResultAttributeException,
client.exceptions.InvalidRole,
client.exceptions.InvalidSchedule,
client.exceptions.InvalidTag,
client.exceptions.InvalidTarget,
client.exceptions.InvalidTargetMaps,
client.exceptions.InvalidTypeNameException,
client.exceptions.InvalidUpdate,
client.exceptions.InvocationDoesNotExist,
client.exceptions.ItemContentMismatchException,
client.exceptions.ItemSizeLimitExceededException,
client.exceptions.MaxDocumentSizeExceeded,
client.exceptions.OpsItemAccessDeniedException,
client.exceptions.OpsItemAlreadyExistsException,
client.exceptions.OpsItemInvalidParameterException,
client.exceptions.OpsItemLimitExceededException,
client.exceptions.OpsItemNotFoundException,
client.exceptions.OpsItemRelatedItemAlreadyExistsException,
client.exceptions.OpsItemRelatedItemAssociationNotFoundException,
client.exceptions.OpsMetadataAlreadyExistsException,
client.exceptions.OpsMetadataInvalidArgumentException,
client.exceptions.OpsMetadataKeyLimitExceededException,
client.exceptions.OpsMetadataLimitExceededException,
client.exceptions.OpsMetadataNotFoundException,
client.exceptions.OpsMetadataTooManyUpdatesException,
client.exceptions.ParameterAlreadyExists,
client.exceptions.ParameterLimitExceeded,
client.exceptions.ParameterMaxVersionLimitExceeded,
client.exceptions.ParameterNotFound,
client.exceptions.ParameterPatternMismatchException,
client.exceptions.ParameterVersionLabelLimitExceeded,
client.exceptions.ParameterVersionNotFound,
client.exceptions.PoliciesLimitExceededException,
client.exceptions.ResourceDataSyncAlreadyExistsException,
client.exceptions.ResourceDataSyncConflictException,
client.exceptions.ResourceDataSyncCountExceededException,
client.exceptions.ResourceDataSyncInvalidConfigurationException,
client.exceptions.ResourceDataSyncNotFoundException,
client.exceptions.ResourceInUseException,
client.exceptions.ResourceLimitExceededException,
client.exceptions.ResourcePolicyConflictException,
client.exceptions.ResourcePolicyInvalidParameterException,
client.exceptions.ResourcePolicyLimitExceededException,
client.exceptions.ServiceSettingNotFound,
client.exceptions.StatusUnchanged,
client.exceptions.SubTypeCountLimitExceededException,
client.exceptions.TargetInUseException,
client.exceptions.TargetNotConnected,
client.exceptions.TooManyTagsError,
client.exceptions.TooManyUpdates,
client.exceptions.TotalSizeLimitExceededException,
client.exceptions.UnsupportedCalendarException,
client.exceptions.UnsupportedFeatureRequiredException,
client.exceptions.UnsupportedInventoryItemContextException,
client.exceptions.UnsupportedInventorySchemaVersionException,
client.exceptions.UnsupportedOperatingSystem,
client.exceptions.UnsupportedParameterType,
client.exceptions.UnsupportedPlatformType,
) as e:
print(e)
# Exceptions.exceptions type checking example
from mypy_boto3_ssm.client import Exceptions
def handle_error(exc: Exceptions.AlreadyExistsException) -> None:
...
Methods#
add_tags_to_resource#
Adds or overwrites one or more tags for the specified resource.
Type annotations and code completion for boto3.client("ssm").add_tags_to_resource
method.
boto3 documentation
# add_tags_to_resource method definition
def add_tags_to_resource(
self,
*,
ResourceType: ResourceTypeForTaggingType, # (1)
ResourceId: str,
Tags: Sequence[TagTypeDef], # (2)
) -> Dict[str, Any]:
...
- See ResourceTypeForTaggingType
- See TagTypeDef
# add_tags_to_resource method usage example with argument unpacking
kwargs: AddTagsToResourceRequestRequestTypeDef = { # (1)
"ResourceType": ...,
"ResourceId": ...,
"Tags": ...,
}
parent.add_tags_to_resource(**kwargs)
associate_ops_item_related_item#
Associates a related item to a Systems Manager OpsCenter OpsItem.
Type annotations and code completion for boto3.client("ssm").associate_ops_item_related_item
method.
boto3 documentation
# associate_ops_item_related_item method definition
def associate_ops_item_related_item(
self,
*,
OpsItemId: str,
AssociationType: str,
ResourceType: str,
ResourceUri: str,
) -> AssociateOpsItemRelatedItemResponseTypeDef: # (1)
...
# associate_ops_item_related_item method usage example with argument unpacking
kwargs: AssociateOpsItemRelatedItemRequestRequestTypeDef = { # (1)
"OpsItemId": ...,
"AssociationType": ...,
"ResourceType": ...,
"ResourceUri": ...,
}
parent.associate_ops_item_related_item(**kwargs)
can_paginate#
Check if an operation can be paginated.
Type annotations and code completion for boto3.client("ssm").can_paginate
method.
boto3 documentation
# can_paginate method definition
def can_paginate(
self,
operation_name: str,
) -> bool:
...
cancel_command#
Attempts to cancel the command specified by the Command ID.
Type annotations and code completion for boto3.client("ssm").cancel_command
method.
boto3 documentation
# cancel_command method definition
def cancel_command(
self,
*,
CommandId: str,
InstanceIds: Sequence[str] = ...,
) -> Dict[str, Any]:
...
# cancel_command method usage example with argument unpacking
kwargs: CancelCommandRequestRequestTypeDef = { # (1)
"CommandId": ...,
}
parent.cancel_command(**kwargs)
cancel_maintenance_window_execution#
Stops a maintenance window execution that is already in progress and cancels any tasks in the window that haven't already starting running.
Type annotations and code completion for boto3.client("ssm").cancel_maintenance_window_execution
method.
boto3 documentation
# cancel_maintenance_window_execution method definition
def cancel_maintenance_window_execution(
self,
*,
WindowExecutionId: str,
) -> CancelMaintenanceWindowExecutionResultTypeDef: # (1)
...
# cancel_maintenance_window_execution method usage example with argument unpacking
kwargs: CancelMaintenanceWindowExecutionRequestRequestTypeDef = { # (1)
"WindowExecutionId": ...,
}
parent.cancel_maintenance_window_execution(**kwargs)
close#
Closes underlying endpoint connections.
Type annotations and code completion for boto3.client("ssm").close
method.
boto3 documentation
# close method definition
def close(
self,
) -> None:
...
create_activation#
Generates an activation code and activation ID you can use to register your on- premises servers, edge devices, or virtual machine (VM) with Amazon Web Services Systems Manager.
Type annotations and code completion for boto3.client("ssm").create_activation
method.
boto3 documentation
# create_activation method definition
def create_activation(
self,
*,
IamRole: str,
Description: str = ...,
DefaultInstanceName: str = ...,
RegistrationLimit: int = ...,
ExpirationDate: Union[datetime, str] = ...,
Tags: Sequence[TagTypeDef] = ..., # (1)
RegistrationMetadata: Sequence[RegistrationMetadataItemTypeDef] = ..., # (2)
) -> CreateActivationResultTypeDef: # (3)
...
# create_activation method usage example with argument unpacking
kwargs: CreateActivationRequestRequestTypeDef = { # (1)
"IamRole": ...,
}
parent.create_activation(**kwargs)
create_association#
A State Manager association defines the state that you want to maintain on your managed nodes.
Type annotations and code completion for boto3.client("ssm").create_association
method.
boto3 documentation
# create_association method definition
def create_association(
self,
*,
Name: str,
DocumentVersion: str = ...,
InstanceId: str = ...,
Parameters: Mapping[str, Sequence[str]] = ...,
Targets: Sequence[TargetTypeDef] = ..., # (1)
ScheduleExpression: str = ...,
OutputLocation: InstanceAssociationOutputLocationTypeDef = ..., # (2)
AssociationName: str = ...,
AutomationTargetParameterName: str = ...,
MaxErrors: str = ...,
MaxConcurrency: str = ...,
ComplianceSeverity: AssociationComplianceSeverityType = ..., # (3)
SyncCompliance: AssociationSyncComplianceType = ..., # (4)
ApplyOnlyAtCronInterval: bool = ...,
CalendarNames: Sequence[str] = ...,
TargetLocations: Sequence[TargetLocationTypeDef] = ..., # (5)
ScheduleOffset: int = ...,
TargetMaps: Sequence[Mapping[str, Sequence[str]]] = ...,
Tags: Sequence[TagTypeDef] = ..., # (6)
AlarmConfiguration: AlarmConfigurationTypeDef = ..., # (7)
) -> CreateAssociationResultTypeDef: # (8)
...
- See TargetTypeDef
- See InstanceAssociationOutputLocationTypeDef
- See AssociationComplianceSeverityType
- See AssociationSyncComplianceType
- See TargetLocationTypeDef
- See TagTypeDef
- See AlarmConfigurationTypeDef
- See CreateAssociationResultTypeDef
# create_association method usage example with argument unpacking
kwargs: CreateAssociationRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.create_association(**kwargs)
create_association_batch#
Associates the specified Amazon Web Services Systems Manager document (SSM document) with the specified managed nodes or targets.
Type annotations and code completion for boto3.client("ssm").create_association_batch
method.
boto3 documentation
# create_association_batch method definition
def create_association_batch(
self,
*,
Entries: Sequence[CreateAssociationBatchRequestEntryTypeDef], # (1)
) -> CreateAssociationBatchResultTypeDef: # (2)
...
# create_association_batch method usage example with argument unpacking
kwargs: CreateAssociationBatchRequestRequestTypeDef = { # (1)
"Entries": ...,
}
parent.create_association_batch(**kwargs)
create_document#
Creates a Amazon Web Services Systems Manager (SSM document).
Type annotations and code completion for boto3.client("ssm").create_document
method.
boto3 documentation
# create_document method definition
def create_document(
self,
*,
Content: str,
Name: str,
Requires: Sequence[DocumentRequiresTypeDef] = ..., # (1)
Attachments: Sequence[AttachmentsSourceTypeDef] = ..., # (2)
DisplayName: str = ...,
VersionName: str = ...,
DocumentType: DocumentTypeType = ..., # (3)
DocumentFormat: DocumentFormatType = ..., # (4)
TargetType: str = ...,
Tags: Sequence[TagTypeDef] = ..., # (5)
) -> CreateDocumentResultTypeDef: # (6)
...
- See DocumentRequiresTypeDef
- See AttachmentsSourceTypeDef
- See DocumentTypeType
- See DocumentFormatType
- See TagTypeDef
- See CreateDocumentResultTypeDef
# create_document method usage example with argument unpacking
kwargs: CreateDocumentRequestRequestTypeDef = { # (1)
"Content": ...,
"Name": ...,
}
parent.create_document(**kwargs)
create_maintenance_window#
Creates a new maintenance window.
Type annotations and code completion for boto3.client("ssm").create_maintenance_window
method.
boto3 documentation
# create_maintenance_window method definition
def create_maintenance_window(
self,
*,
Name: str,
Schedule: str,
Duration: int,
Cutoff: int,
AllowUnassociatedTargets: bool,
Description: str = ...,
StartDate: str = ...,
EndDate: str = ...,
ScheduleTimezone: str = ...,
ScheduleOffset: int = ...,
ClientToken: str = ...,
Tags: Sequence[TagTypeDef] = ..., # (1)
) -> CreateMaintenanceWindowResultTypeDef: # (2)
...
# create_maintenance_window method usage example with argument unpacking
kwargs: CreateMaintenanceWindowRequestRequestTypeDef = { # (1)
"Name": ...,
"Schedule": ...,
"Duration": ...,
"Cutoff": ...,
"AllowUnassociatedTargets": ...,
}
parent.create_maintenance_window(**kwargs)
create_ops_item#
Creates a new OpsItem.
Type annotations and code completion for boto3.client("ssm").create_ops_item
method.
boto3 documentation
# create_ops_item method definition
def create_ops_item(
self,
*,
Description: str,
Source: str,
Title: str,
OpsItemType: str = ...,
OperationalData: Mapping[str, OpsItemDataValueTypeDef] = ..., # (1)
Notifications: Sequence[OpsItemNotificationTypeDef] = ..., # (2)
Priority: int = ...,
RelatedOpsItems: Sequence[RelatedOpsItemTypeDef] = ..., # (3)
Tags: Sequence[TagTypeDef] = ..., # (4)
Category: str = ...,
Severity: str = ...,
ActualStartTime: Union[datetime, str] = ...,
ActualEndTime: Union[datetime, str] = ...,
PlannedStartTime: Union[datetime, str] = ...,
PlannedEndTime: Union[datetime, str] = ...,
AccountId: str = ...,
) -> CreateOpsItemResponseTypeDef: # (5)
...
- See OpsItemDataValueTypeDef
- See OpsItemNotificationTypeDef
- See RelatedOpsItemTypeDef
- See TagTypeDef
- See CreateOpsItemResponseTypeDef
# create_ops_item method usage example with argument unpacking
kwargs: CreateOpsItemRequestRequestTypeDef = { # (1)
"Description": ...,
"Source": ...,
"Title": ...,
}
parent.create_ops_item(**kwargs)
create_ops_metadata#
If you create a new application in Application Manager, Amazon Web Services Systems Manager calls this API operation to specify information about the new application, including the application type.
Type annotations and code completion for boto3.client("ssm").create_ops_metadata
method.
boto3 documentation
# create_ops_metadata method definition
def create_ops_metadata(
self,
*,
ResourceId: str,
Metadata: Mapping[str, MetadataValueTypeDef] = ..., # (1)
Tags: Sequence[TagTypeDef] = ..., # (2)
) -> CreateOpsMetadataResultTypeDef: # (3)
...
# create_ops_metadata method usage example with argument unpacking
kwargs: CreateOpsMetadataRequestRequestTypeDef = { # (1)
"ResourceId": ...,
}
parent.create_ops_metadata(**kwargs)
create_patch_baseline#
Creates a patch baseline.
Type annotations and code completion for boto3.client("ssm").create_patch_baseline
method.
boto3 documentation
# create_patch_baseline method definition
def create_patch_baseline(
self,
*,
Name: str,
OperatingSystem: OperatingSystemType = ..., # (1)
GlobalFilters: PatchFilterGroupTypeDef = ..., # (2)
ApprovalRules: PatchRuleGroupTypeDef = ..., # (3)
ApprovedPatches: Sequence[str] = ...,
ApprovedPatchesComplianceLevel: PatchComplianceLevelType = ..., # (4)
ApprovedPatchesEnableNonSecurity: bool = ...,
RejectedPatches: Sequence[str] = ...,
RejectedPatchesAction: PatchActionType = ..., # (5)
Description: str = ...,
Sources: Sequence[PatchSourceTypeDef] = ..., # (6)
ClientToken: str = ...,
Tags: Sequence[TagTypeDef] = ..., # (7)
) -> CreatePatchBaselineResultTypeDef: # (8)
...
- See OperatingSystemType
- See PatchFilterGroupTypeDef
- See PatchRuleGroupTypeDef
- See PatchComplianceLevelType
- See PatchActionType
- See PatchSourceTypeDef
- See TagTypeDef
- See CreatePatchBaselineResultTypeDef
# create_patch_baseline method usage example with argument unpacking
kwargs: CreatePatchBaselineRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.create_patch_baseline(**kwargs)
create_resource_data_sync#
A resource data sync helps you view data from multiple sources in a single location.
Type annotations and code completion for boto3.client("ssm").create_resource_data_sync
method.
boto3 documentation
# create_resource_data_sync method definition
def create_resource_data_sync(
self,
*,
SyncName: str,
S3Destination: ResourceDataSyncS3DestinationTypeDef = ..., # (1)
SyncType: str = ...,
SyncSource: ResourceDataSyncSourceTypeDef = ..., # (2)
) -> Dict[str, Any]:
...
# create_resource_data_sync method usage example with argument unpacking
kwargs: CreateResourceDataSyncRequestRequestTypeDef = { # (1)
"SyncName": ...,
}
parent.create_resource_data_sync(**kwargs)
delete_activation#
Deletes an activation.
Type annotations and code completion for boto3.client("ssm").delete_activation
method.
boto3 documentation
# delete_activation method definition
def delete_activation(
self,
*,
ActivationId: str,
) -> Dict[str, Any]:
...
# delete_activation method usage example with argument unpacking
kwargs: DeleteActivationRequestRequestTypeDef = { # (1)
"ActivationId": ...,
}
parent.delete_activation(**kwargs)
delete_association#
Disassociates the specified Amazon Web Services Systems Manager document (SSM document) from the specified managed node.
Type annotations and code completion for boto3.client("ssm").delete_association
method.
boto3 documentation
# delete_association method definition
def delete_association(
self,
*,
Name: str = ...,
InstanceId: str = ...,
AssociationId: str = ...,
) -> Dict[str, Any]:
...
# delete_association method usage example with argument unpacking
kwargs: DeleteAssociationRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_association(**kwargs)
delete_document#
Deletes the Amazon Web Services Systems Manager document (SSM document) and all managed node associations to the document.
Type annotations and code completion for boto3.client("ssm").delete_document
method.
boto3 documentation
# delete_document method definition
def delete_document(
self,
*,
Name: str,
DocumentVersion: str = ...,
VersionName: str = ...,
Force: bool = ...,
) -> Dict[str, Any]:
...
# delete_document method usage example with argument unpacking
kwargs: DeleteDocumentRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_document(**kwargs)
delete_inventory#
Delete a custom inventory type or the data associated with a custom Inventory type.
Type annotations and code completion for boto3.client("ssm").delete_inventory
method.
boto3 documentation
# delete_inventory method definition
def delete_inventory(
self,
*,
TypeName: str,
SchemaDeleteOption: InventorySchemaDeleteOptionType = ..., # (1)
DryRun: bool = ...,
ClientToken: str = ...,
) -> DeleteInventoryResultTypeDef: # (2)
...
# delete_inventory method usage example with argument unpacking
kwargs: DeleteInventoryRequestRequestTypeDef = { # (1)
"TypeName": ...,
}
parent.delete_inventory(**kwargs)
delete_maintenance_window#
Deletes a maintenance window.
Type annotations and code completion for boto3.client("ssm").delete_maintenance_window
method.
boto3 documentation
# delete_maintenance_window method definition
def delete_maintenance_window(
self,
*,
WindowId: str,
) -> DeleteMaintenanceWindowResultTypeDef: # (1)
...
# delete_maintenance_window method usage example with argument unpacking
kwargs: DeleteMaintenanceWindowRequestRequestTypeDef = { # (1)
"WindowId": ...,
}
parent.delete_maintenance_window(**kwargs)
delete_ops_metadata#
Delete OpsMetadata related to an application.
Type annotations and code completion for boto3.client("ssm").delete_ops_metadata
method.
boto3 documentation
# delete_ops_metadata method definition
def delete_ops_metadata(
self,
*,
OpsMetadataArn: str,
) -> Dict[str, Any]:
...
# delete_ops_metadata method usage example with argument unpacking
kwargs: DeleteOpsMetadataRequestRequestTypeDef = { # (1)
"OpsMetadataArn": ...,
}
parent.delete_ops_metadata(**kwargs)
delete_parameter#
Delete a parameter from the system.
Type annotations and code completion for boto3.client("ssm").delete_parameter
method.
boto3 documentation
# delete_parameter method definition
def delete_parameter(
self,
*,
Name: str,
) -> Dict[str, Any]:
...
# delete_parameter method usage example with argument unpacking
kwargs: DeleteParameterRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.delete_parameter(**kwargs)
delete_parameters#
Delete a list of parameters.
Type annotations and code completion for boto3.client("ssm").delete_parameters
method.
boto3 documentation
# delete_parameters method definition
def delete_parameters(
self,
*,
Names: Sequence[str],
) -> DeleteParametersResultTypeDef: # (1)
...
# delete_parameters method usage example with argument unpacking
kwargs: DeleteParametersRequestRequestTypeDef = { # (1)
"Names": ...,
}
parent.delete_parameters(**kwargs)
delete_patch_baseline#
Deletes a patch baseline.
Type annotations and code completion for boto3.client("ssm").delete_patch_baseline
method.
boto3 documentation
# delete_patch_baseline method definition
def delete_patch_baseline(
self,
*,
BaselineId: str,
) -> DeletePatchBaselineResultTypeDef: # (1)
...
# delete_patch_baseline method usage example with argument unpacking
kwargs: DeletePatchBaselineRequestRequestTypeDef = { # (1)
"BaselineId": ...,
}
parent.delete_patch_baseline(**kwargs)
delete_resource_data_sync#
Deletes a resource data sync configuration.
Type annotations and code completion for boto3.client("ssm").delete_resource_data_sync
method.
boto3 documentation
# delete_resource_data_sync method definition
def delete_resource_data_sync(
self,
*,
SyncName: str,
SyncType: str = ...,
) -> Dict[str, Any]:
...
# delete_resource_data_sync method usage example with argument unpacking
kwargs: DeleteResourceDataSyncRequestRequestTypeDef = { # (1)
"SyncName": ...,
}
parent.delete_resource_data_sync(**kwargs)
delete_resource_policy#
Deletes a Systems Manager resource policy.
Type annotations and code completion for boto3.client("ssm").delete_resource_policy
method.
boto3 documentation
# delete_resource_policy method definition
def delete_resource_policy(
self,
*,
ResourceArn: str,
PolicyId: str,
PolicyHash: str,
) -> Dict[str, Any]:
...
# delete_resource_policy method usage example with argument unpacking
kwargs: DeleteResourcePolicyRequestRequestTypeDef = { # (1)
"ResourceArn": ...,
"PolicyId": ...,
"PolicyHash": ...,
}
parent.delete_resource_policy(**kwargs)
deregister_managed_instance#
Removes the server or virtual machine from the list of registered servers.
Type annotations and code completion for boto3.client("ssm").deregister_managed_instance
method.
boto3 documentation
# deregister_managed_instance method definition
def deregister_managed_instance(
self,
*,
InstanceId: str,
) -> Dict[str, Any]:
...
# deregister_managed_instance method usage example with argument unpacking
kwargs: DeregisterManagedInstanceRequestRequestTypeDef = { # (1)
"InstanceId": ...,
}
parent.deregister_managed_instance(**kwargs)
deregister_patch_baseline_for_patch_group#
Removes a patch group from a patch baseline.
Type annotations and code completion for boto3.client("ssm").deregister_patch_baseline_for_patch_group
method.
boto3 documentation
# deregister_patch_baseline_for_patch_group method definition
def deregister_patch_baseline_for_patch_group(
self,
*,
BaselineId: str,
PatchGroup: str,
) -> DeregisterPatchBaselineForPatchGroupResultTypeDef: # (1)
...
# deregister_patch_baseline_for_patch_group method usage example with argument unpacking
kwargs: DeregisterPatchBaselineForPatchGroupRequestRequestTypeDef = { # (1)
"BaselineId": ...,
"PatchGroup": ...,
}
parent.deregister_patch_baseline_for_patch_group(**kwargs)
deregister_target_from_maintenance_window#
Removes a target from a maintenance window.
Type annotations and code completion for boto3.client("ssm").deregister_target_from_maintenance_window
method.
boto3 documentation
# deregister_target_from_maintenance_window method definition
def deregister_target_from_maintenance_window(
self,
*,
WindowId: str,
WindowTargetId: str,
Safe: bool = ...,
) -> DeregisterTargetFromMaintenanceWindowResultTypeDef: # (1)
...
# deregister_target_from_maintenance_window method usage example with argument unpacking
kwargs: DeregisterTargetFromMaintenanceWindowRequestRequestTypeDef = { # (1)
"WindowId": ...,
"WindowTargetId": ...,
}
parent.deregister_target_from_maintenance_window(**kwargs)
deregister_task_from_maintenance_window#
Removes a task from a maintenance window.
Type annotations and code completion for boto3.client("ssm").deregister_task_from_maintenance_window
method.
boto3 documentation
# deregister_task_from_maintenance_window method definition
def deregister_task_from_maintenance_window(
self,
*,
WindowId: str,
WindowTaskId: str,
) -> DeregisterTaskFromMaintenanceWindowResultTypeDef: # (1)
...
# deregister_task_from_maintenance_window method usage example with argument unpacking
kwargs: DeregisterTaskFromMaintenanceWindowRequestRequestTypeDef = { # (1)
"WindowId": ...,
"WindowTaskId": ...,
}
parent.deregister_task_from_maintenance_window(**kwargs)
describe_activations#
Describes details about the activation, such as the date and time the activation was created, its expiration date, the Identity and Access Management (IAM) role assigned to the managed nodes in the activation, and the number of nodes registered by using this activation.
Type annotations and code completion for boto3.client("ssm").describe_activations
method.
boto3 documentation
# describe_activations method definition
def describe_activations(
self,
*,
Filters: Sequence[DescribeActivationsFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeActivationsResultTypeDef: # (2)
...
# describe_activations method usage example with argument unpacking
kwargs: DescribeActivationsRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.describe_activations(**kwargs)
describe_association#
Describes the association for the specified target or managed node.
Type annotations and code completion for boto3.client("ssm").describe_association
method.
boto3 documentation
# describe_association method definition
def describe_association(
self,
*,
Name: str = ...,
InstanceId: str = ...,
AssociationId: str = ...,
AssociationVersion: str = ...,
) -> DescribeAssociationResultTypeDef: # (1)
...
# describe_association method usage example with argument unpacking
kwargs: DescribeAssociationRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.describe_association(**kwargs)
describe_association_execution_targets#
Views information about a specific execution of a specific association.
Type annotations and code completion for boto3.client("ssm").describe_association_execution_targets
method.
boto3 documentation
# describe_association_execution_targets method definition
def describe_association_execution_targets(
self,
*,
AssociationId: str,
ExecutionId: str,
Filters: Sequence[AssociationExecutionTargetsFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeAssociationExecutionTargetsResultTypeDef: # (2)
...
# describe_association_execution_targets method usage example with argument unpacking
kwargs: DescribeAssociationExecutionTargetsRequestRequestTypeDef = { # (1)
"AssociationId": ...,
"ExecutionId": ...,
}
parent.describe_association_execution_targets(**kwargs)
describe_association_executions#
Views all executions for a specific association ID.
Type annotations and code completion for boto3.client("ssm").describe_association_executions
method.
boto3 documentation
# describe_association_executions method definition
def describe_association_executions(
self,
*,
AssociationId: str,
Filters: Sequence[AssociationExecutionFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeAssociationExecutionsResultTypeDef: # (2)
...
# describe_association_executions method usage example with argument unpacking
kwargs: DescribeAssociationExecutionsRequestRequestTypeDef = { # (1)
"AssociationId": ...,
}
parent.describe_association_executions(**kwargs)
describe_automation_executions#
Provides details about all active and terminated Automation executions.
Type annotations and code completion for boto3.client("ssm").describe_automation_executions
method.
boto3 documentation
# describe_automation_executions method definition
def describe_automation_executions(
self,
*,
Filters: Sequence[AutomationExecutionFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeAutomationExecutionsResultTypeDef: # (2)
...
# describe_automation_executions method usage example with argument unpacking
kwargs: DescribeAutomationExecutionsRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.describe_automation_executions(**kwargs)
describe_automation_step_executions#
Information about all active and terminated step executions in an Automation workflow.
Type annotations and code completion for boto3.client("ssm").describe_automation_step_executions
method.
boto3 documentation
# describe_automation_step_executions method definition
def describe_automation_step_executions(
self,
*,
AutomationExecutionId: str,
Filters: Sequence[StepExecutionFilterTypeDef] = ..., # (1)
NextToken: str = ...,
MaxResults: int = ...,
ReverseOrder: bool = ...,
) -> DescribeAutomationStepExecutionsResultTypeDef: # (2)
...
# describe_automation_step_executions method usage example with argument unpacking
kwargs: DescribeAutomationStepExecutionsRequestRequestTypeDef = { # (1)
"AutomationExecutionId": ...,
}
parent.describe_automation_step_executions(**kwargs)
describe_available_patches#
Lists all patches eligible to be included in a patch baseline.
Type annotations and code completion for boto3.client("ssm").describe_available_patches
method.
boto3 documentation
# describe_available_patches method definition
def describe_available_patches(
self,
*,
Filters: Sequence[PatchOrchestratorFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeAvailablePatchesResultTypeDef: # (2)
...
# describe_available_patches method usage example with argument unpacking
kwargs: DescribeAvailablePatchesRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.describe_available_patches(**kwargs)
describe_document#
Describes the specified Amazon Web Services Systems Manager document (SSM document).
Type annotations and code completion for boto3.client("ssm").describe_document
method.
boto3 documentation
# describe_document method definition
def describe_document(
self,
*,
Name: str,
DocumentVersion: str = ...,
VersionName: str = ...,
) -> DescribeDocumentResultTypeDef: # (1)
...
# describe_document method usage example with argument unpacking
kwargs: DescribeDocumentRequestRequestTypeDef = { # (1)
"Name": ...,
}
parent.describe_document(**kwargs)
describe_document_permission#
Describes the permissions for a Amazon Web Services Systems Manager document (SSM document).
Type annotations and code completion for boto3.client("ssm").describe_document_permission
method.
boto3 documentation
# describe_document_permission method definition
def describe_document_permission(
self,
*,
Name: str,
PermissionType: DocumentPermissionTypeType, # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeDocumentPermissionResponseTypeDef: # (2)
...
# describe_document_permission method usage example with argument unpacking
kwargs: DescribeDocumentPermissionRequestRequestTypeDef = { # (1)
"Name": ...,
"PermissionType": ...,
}
parent.describe_document_permission(**kwargs)
describe_effective_instance_associations#
All associations for the managed node(s).
Type annotations and code completion for boto3.client("ssm").describe_effective_instance_associations
method.
boto3 documentation
# describe_effective_instance_associations method definition
def describe_effective_instance_associations(
self,
*,
InstanceId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeEffectiveInstanceAssociationsResultTypeDef: # (1)
...
# describe_effective_instance_associations method usage example with argument unpacking
kwargs: DescribeEffectiveInstanceAssociationsRequestRequestTypeDef = { # (1)
"InstanceId": ...,
}
parent.describe_effective_instance_associations(**kwargs)
describe_effective_patches_for_patch_baseline#
Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline.
Type annotations and code completion for boto3.client("ssm").describe_effective_patches_for_patch_baseline
method.
boto3 documentation
# describe_effective_patches_for_patch_baseline method definition
def describe_effective_patches_for_patch_baseline(
self,
*,
BaselineId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeEffectivePatchesForPatchBaselineResultTypeDef: # (1)
...
# describe_effective_patches_for_patch_baseline method usage example with argument unpacking
kwargs: DescribeEffectivePatchesForPatchBaselineRequestRequestTypeDef = { # (1)
"BaselineId": ...,
}
parent.describe_effective_patches_for_patch_baseline(**kwargs)
describe_instance_associations_status#
The status of the associations for the managed node(s).
Type annotations and code completion for boto3.client("ssm").describe_instance_associations_status
method.
boto3 documentation
# describe_instance_associations_status method definition
def describe_instance_associations_status(
self,
*,
InstanceId: str,
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeInstanceAssociationsStatusResultTypeDef: # (1)
...
# describe_instance_associations_status method usage example with argument unpacking
kwargs: DescribeInstanceAssociationsStatusRequestRequestTypeDef = { # (1)
"InstanceId": ...,
}
parent.describe_instance_associations_status(**kwargs)
describe_instance_information#
Describes one or more of your managed nodes, including information about the operating system platform, the version of SSM Agent installed on the managed node, node status, and so on.
Type annotations and code completion for boto3.client("ssm").describe_instance_information
method.
boto3 documentation
# describe_instance_information method definition
def describe_instance_information(
self,
*,
InstanceInformationFilterList: Sequence[InstanceInformationFilterTypeDef] = ..., # (1)
Filters: Sequence[InstanceInformationStringFilterTypeDef] = ..., # (2)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeInstanceInformationResultTypeDef: # (3)
...
- See InstanceInformationFilterTypeDef
- See InstanceInformationStringFilterTypeDef
- See DescribeInstanceInformationResultTypeDef
# describe_instance_information method usage example with argument unpacking
kwargs: DescribeInstanceInformationRequestRequestTypeDef = { # (1)
"InstanceInformationFilterList": ...,
}
parent.describe_instance_information(**kwargs)
describe_instance_patch_states#
Retrieves the high-level patch state of one or more managed nodes.
Type annotations and code completion for boto3.client("ssm").describe_instance_patch_states
method.
boto3 documentation
# describe_instance_patch_states method definition
def describe_instance_patch_states(
self,
*,
InstanceIds: Sequence[str],
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeInstancePatchStatesResultTypeDef: # (1)
...
# describe_instance_patch_states method usage example with argument unpacking
kwargs: DescribeInstancePatchStatesRequestRequestTypeDef = { # (1)
"InstanceIds": ...,
}
parent.describe_instance_patch_states(**kwargs)
describe_instance_patch_states_for_patch_group#
Retrieves the high-level patch state for the managed nodes in the specified patch group.
Type annotations and code completion for boto3.client("ssm").describe_instance_patch_states_for_patch_group
method.
boto3 documentation
# describe_instance_patch_states_for_patch_group method definition
def describe_instance_patch_states_for_patch_group(
self,
*,
PatchGroup: str,
Filters: Sequence[InstancePatchStateFilterTypeDef] = ..., # (1)
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeInstancePatchStatesForPatchGroupResultTypeDef: # (2)
...
# describe_instance_patch_states_for_patch_group method usage example with argument unpacking
kwargs: DescribeInstancePatchStatesForPatchGroupRequestRequestTypeDef = { # (1)
"PatchGroup": ...,
}
parent.describe_instance_patch_states_for_patch_group(**kwargs)
describe_instance_patches#
Retrieves information about the patches on the specified managed node and their state relative to the patch baseline being used for the node.
Type annotations and code completion for boto3.client("ssm").describe_instance_patches
method.
boto3 documentation
# describe_instance_patches method definition
def describe_instance_patches(
self,
*,
InstanceId: str,
Filters: Sequence[PatchOrchestratorFilterTypeDef] = ..., # (1)
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeInstancePatchesResultTypeDef: # (2)
...
# describe_instance_patches method usage example with argument unpacking
kwargs: DescribeInstancePatchesRequestRequestTypeDef = { # (1)
"InstanceId": ...,
}
parent.describe_instance_patches(**kwargs)
describe_inventory_deletions#
Describes a specific delete inventory operation.
Type annotations and code completion for boto3.client("ssm").describe_inventory_deletions
method.
boto3 documentation
# describe_inventory_deletions method definition
def describe_inventory_deletions(
self,
*,
DeletionId: str = ...,
NextToken: str = ...,
MaxResults: int = ...,
) -> DescribeInventoryDeletionsResultTypeDef: # (1)
...
# describe_inventory_deletions method usage example with argument unpacking
kwargs: DescribeInventoryDeletionsRequestRequestTypeDef = { # (1)
"DeletionId": ...,
}
parent.describe_inventory_deletions(**kwargs)
describe_maintenance_window_execution_task_invocations#
Retrieves the individual task executions (one per target) for a particular task run as part of a maintenance window execution.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_execution_task_invocations
method.
boto3 documentation
# describe_maintenance_window_execution_task_invocations method definition
def describe_maintenance_window_execution_task_invocations(
self,
*,
WindowExecutionId: str,
TaskId: str,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowExecutionTaskInvocationsResultTypeDef: # (2)
...
- See MaintenanceWindowFilterTypeDef
- See DescribeMaintenanceWindowExecutionTaskInvocationsResultTypeDef
# describe_maintenance_window_execution_task_invocations method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowExecutionTaskInvocationsRequestRequestTypeDef = { # (1)
"WindowExecutionId": ...,
"TaskId": ...,
}
parent.describe_maintenance_window_execution_task_invocations(**kwargs)
describe_maintenance_window_execution_tasks#
For a given maintenance window execution, lists the tasks that were run.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_execution_tasks
method.
boto3 documentation
# describe_maintenance_window_execution_tasks method definition
def describe_maintenance_window_execution_tasks(
self,
*,
WindowExecutionId: str,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowExecutionTasksResultTypeDef: # (2)
...
# describe_maintenance_window_execution_tasks method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowExecutionTasksRequestRequestTypeDef = { # (1)
"WindowExecutionId": ...,
}
parent.describe_maintenance_window_execution_tasks(**kwargs)
describe_maintenance_window_executions#
Lists the executions of a maintenance window.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_executions
method.
boto3 documentation
# describe_maintenance_window_executions method definition
def describe_maintenance_window_executions(
self,
*,
WindowId: str,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowExecutionsResultTypeDef: # (2)
...
# describe_maintenance_window_executions method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowExecutionsRequestRequestTypeDef = { # (1)
"WindowId": ...,
}
parent.describe_maintenance_window_executions(**kwargs)
describe_maintenance_window_schedule#
Retrieves information about upcoming executions of a maintenance window.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_schedule
method.
boto3 documentation
# describe_maintenance_window_schedule method definition
def describe_maintenance_window_schedule(
self,
*,
WindowId: str = ...,
Targets: Sequence[TargetTypeDef] = ..., # (1)
ResourceType: MaintenanceWindowResourceTypeType = ..., # (2)
Filters: Sequence[PatchOrchestratorFilterTypeDef] = ..., # (3)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowScheduleResultTypeDef: # (4)
...
- See TargetTypeDef
- See MaintenanceWindowResourceTypeType
- See PatchOrchestratorFilterTypeDef
- See DescribeMaintenanceWindowScheduleResultTypeDef
# describe_maintenance_window_schedule method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowScheduleRequestRequestTypeDef = { # (1)
"WindowId": ...,
}
parent.describe_maintenance_window_schedule(**kwargs)
describe_maintenance_window_targets#
Lists the targets registered with the maintenance window.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_targets
method.
boto3 documentation
# describe_maintenance_window_targets method definition
def describe_maintenance_window_targets(
self,
*,
WindowId: str,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowTargetsResultTypeDef: # (2)
...
# describe_maintenance_window_targets method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowTargetsRequestRequestTypeDef = { # (1)
"WindowId": ...,
}
parent.describe_maintenance_window_targets(**kwargs)
describe_maintenance_window_tasks#
Lists the tasks in a maintenance window.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_window_tasks
method.
boto3 documentation
# describe_maintenance_window_tasks method definition
def describe_maintenance_window_tasks(
self,
*,
WindowId: str,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowTasksResultTypeDef: # (2)
...
# describe_maintenance_window_tasks method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowTasksRequestRequestTypeDef = { # (1)
"WindowId": ...,
}
parent.describe_maintenance_window_tasks(**kwargs)
describe_maintenance_windows#
Retrieves the maintenance windows in an Amazon Web Services account.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_windows
method.
boto3 documentation
# describe_maintenance_windows method definition
def describe_maintenance_windows(
self,
*,
Filters: Sequence[MaintenanceWindowFilterTypeDef] = ..., # (1)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowsResultTypeDef: # (2)
...
# describe_maintenance_windows method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowsRequestRequestTypeDef = { # (1)
"Filters": ...,
}
parent.describe_maintenance_windows(**kwargs)
describe_maintenance_windows_for_target#
Retrieves information about the maintenance window targets or tasks that a managed node is associated with.
Type annotations and code completion for boto3.client("ssm").describe_maintenance_windows_for_target
method.
boto3 documentation
# describe_maintenance_windows_for_target method definition
def describe_maintenance_windows_for_target(
self,
*,
Targets: Sequence[TargetTypeDef], # (1)
ResourceType: MaintenanceWindowResourceTypeType, # (2)
MaxResults: int = ...,
NextToken: str = ...,
) -> DescribeMaintenanceWindowsForTargetResultTypeDef: # (3)
...
- See TargetTypeDef
- See MaintenanceWindowResourceTypeType
- See DescribeMaintenanceWindowsForTargetResultTypeDef
# describe_maintenance_windows_for_target method usage example with argument unpacking
kwargs: DescribeMaintenanceWindowsForTargetRequestRequestTypeDef = { # (1)
"Targets": ...,
"ResourceType": ...,
}
parent.describe_maintenance_windows_for_target(**kwargs)
describe_ops_items#
Query a set of OpsItems.
Type annotations and code completion for boto3.client("ssm").describe_ops_items
method.