ssm: Amazon Simple Systems Manager (SSM)

View source: R/ssm_service.R

ssmR Documentation

Amazon Simple Systems Manager (SSM)

Description

Amazon Web Services Systems Manager is the operations hub for your Amazon Web Services applications and resources and a secure end-to-end management solution for hybrid cloud environments that enables safe and secure operations at scale.

This reference is intended to be used with the Amazon Web Services Systems Manager User Guide. To get started, see Setting up Amazon Web Services Systems Manager.

Related resources

Usage

ssm(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

    • endpoint: The complete URL to use for the constructed client.

    • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. ⁠http://s3.amazonaws.com/BUCKET/KEY⁠.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- ssm(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_tags_to_resource Adds or overwrites one or more tags for the specified resource
associate_ops_item_related_item Associates a related item to a Systems Manager OpsCenter OpsItem
cancel_command Attempts to cancel the command specified by the Command ID
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
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
create_association A State Manager association defines the state that you want to maintain on your managed nodes
create_association_batch Associates the specified Amazon Web Services Systems Manager document (SSM document) with the specified managed nodes or targets
create_document Creates a Amazon Web Services Systems Manager (SSM document)
create_maintenance_window Creates a new maintenance window
create_ops_item Creates a new OpsItem
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
create_patch_baseline Creates a patch baseline
create_resource_data_sync A resource data sync helps you view data from multiple sources in a single location
delete_activation Deletes an activation
delete_association Disassociates the specified Amazon Web Services Systems Manager document (SSM document) from the specified managed node
delete_document Deletes the Amazon Web Services Systems Manager document (SSM document) and all managed node associations to the document
delete_inventory Delete a custom inventory type or the data associated with a custom Inventory type
delete_maintenance_window Deletes a maintenance window
delete_ops_metadata Delete OpsMetadata related to an application
delete_parameter Delete a parameter from the system
delete_parameters Delete a list of parameters
delete_patch_baseline Deletes a patch baseline
delete_resource_data_sync Deletes a resource data sync configuration
delete_resource_policy Deletes a Systems Manager resource policy
deregister_managed_instance Removes the server or virtual machine from the list of registered servers
deregister_patch_baseline_for_patch_group Removes a patch group from a patch baseline
deregister_target_from_maintenance_window Removes a target from a maintenance window
deregister_task_from_maintenance_window Removes a task from a maintenance window
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
describe_association Describes the association for the specified target or managed node
describe_association_executions Views all executions for a specific association ID
describe_association_execution_targets Views information about a specific execution of a specific association
describe_automation_executions Provides details about all active and terminated Automation executions
describe_automation_step_executions Information about all active and terminated step executions in an Automation workflow
describe_available_patches Lists all patches eligible to be included in a patch baseline
describe_document Describes the specified Amazon Web Services Systems Manager document (SSM document)
describe_document_permission Describes the permissions for a Amazon Web Services Systems Manager document (SSM document)
describe_effective_instance_associations All associations for the managed node(s)
describe_effective_patches_for_patch_baseline Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline
describe_instance_associations_status The status of the associations for the managed node(s)
describe_instance_information Provides information about one or more of your managed nodes, including the operating system platform, SSM Agent version, association status, and IP address
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
describe_instance_patch_states Retrieves the high-level patch state of one or more managed nodes
describe_instance_patch_states_for_patch_group Retrieves the high-level patch state for the managed nodes in the specified patch group
describe_inventory_deletions Describes a specific delete inventory operation
describe_maintenance_window_executions Lists the executions of a maintenance window
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
describe_maintenance_window_execution_tasks For a given maintenance window execution, lists the tasks that were run
describe_maintenance_windows Retrieves the maintenance windows in an Amazon Web Services account
describe_maintenance_window_schedule Retrieves information about upcoming executions of a maintenance window
describe_maintenance_windows_for_target Retrieves information about the maintenance window targets or tasks that a managed node is associated with
describe_maintenance_window_targets Lists the targets registered with the maintenance window
describe_maintenance_window_tasks Lists the tasks in a maintenance window
describe_ops_items Query a set of OpsItems
describe_parameters Get information about a parameter
describe_patch_baselines Lists the patch baselines in your Amazon Web Services account
describe_patch_groups Lists all patch groups that have been registered with patch baselines
describe_patch_group_state Returns high-level aggregated patch compliance state information for a patch group
describe_patch_properties Lists the properties of available patches organized by product, product family, classification, severity, and other properties of available patches
describe_sessions Retrieves a list of all active sessions (both connected and disconnected) or terminated sessions from the past 30 days
disassociate_ops_item_related_item Deletes the association between an OpsItem and a related item
get_automation_execution Get detailed information about a particular Automation execution
get_calendar_state Gets the state of a Amazon Web Services Systems Manager change calendar at the current time or a specified time
get_command_invocation Returns detailed information about command execution for an invocation or plugin
get_connection_status Retrieves the Session Manager connection status for a managed node to determine whether it is running and ready to receive Session Manager connections
get_default_patch_baseline Retrieves the default patch baseline
get_deployable_patch_snapshot_for_instance Retrieves the current snapshot for the patch baseline the managed node uses
get_document Gets the contents of the specified Amazon Web Services Systems Manager document (SSM document)
get_inventory Query inventory information
get_inventory_schema Return a list of inventory type names for the account, or return a list of attribute names for a specific Inventory item type
get_maintenance_window Retrieves a maintenance window
get_maintenance_window_execution Retrieves details about a specific a maintenance window execution
get_maintenance_window_execution_task Retrieves the details about a specific task run as part of a maintenance window execution
get_maintenance_window_execution_task_invocation Retrieves information about a specific task running on a specific target
get_maintenance_window_task Retrieves the details of a maintenance window task
get_ops_item Get information about an OpsItem by using the ID
get_ops_metadata View operational metadata related to an application in Application Manager
get_ops_summary View a summary of operations metadata (OpsData) based on specified filters and aggregators
get_parameter Get information about a single parameter by specifying the parameter name
get_parameter_history Retrieves the history of all changes to a parameter
get_parameters Get information about one or more parameters by specifying multiple parameter names
get_parameters_by_path Retrieve information about one or more parameters in a specific hierarchy
get_patch_baseline Retrieves information about a patch baseline
get_patch_baseline_for_patch_group Retrieves the patch baseline that should be used for the specified patch group
get_resource_policies Returns an array of the Policy object
get_service_setting ServiceSetting is an account-level setting for an Amazon Web Services service
label_parameter_version A parameter label is a user-defined alias to help you manage different versions of a parameter
list_associations Returns all State Manager associations in the current Amazon Web Services account and Amazon Web Services Region
list_association_versions Retrieves all versions of an association for a specific association ID
list_command_invocations An invocation is copy of a command sent to a specific managed node
list_commands Lists the commands requested by users of the Amazon Web Services account
list_compliance_items For a specified resource ID, this API operation returns a list of compliance statuses for different resource types
list_compliance_summaries Returns a summary count of compliant and non-compliant resources for a compliance type
list_document_metadata_history Information about approval reviews for a version of a change template in Change Manager
list_documents Returns all Systems Manager (SSM) documents in the current Amazon Web Services account and Amazon Web Services Region
list_document_versions List all versions for a document
list_inventory_entries A list of inventory items returned by the request
list_ops_item_events Returns a list of all OpsItem events in the current Amazon Web Services Region and Amazon Web Services account
list_ops_item_related_items Lists all related-item resources associated with a Systems Manager OpsCenter OpsItem
list_ops_metadata Amazon Web Services Systems Manager calls this API operation when displaying all Application Manager OpsMetadata objects or blobs
list_resource_compliance_summaries Returns a resource-level summary count
list_resource_data_sync Lists your resource data sync configurations
list_tags_for_resource Returns a list of the tags assigned to the specified resource
modify_document_permission Shares a Amazon Web Services Systems Manager document (SSM document)publicly or privately
put_compliance_items Registers a compliance type and other compliance details on a designated resource
put_inventory Bulk update custom inventory items on one or more managed nodes
put_parameter Add a parameter to the system
put_resource_policy Creates or updates a Systems Manager resource policy
register_default_patch_baseline Defines the default patch baseline for the relevant operating system
register_patch_baseline_for_patch_group Registers a patch baseline for a patch group
register_target_with_maintenance_window Registers a target with a maintenance window
register_task_with_maintenance_window Adds a new task to a maintenance window
remove_tags_from_resource Removes tag keys from the specified resource
reset_service_setting ServiceSetting is an account-level setting for an Amazon Web Services service
resume_session Reconnects a session to a managed node after it has been disconnected
send_automation_signal Sends a signal to an Automation execution to change the current behavior or status of the execution
send_command Runs commands on one or more managed nodes
start_associations_once Runs an association immediately and only one time
start_automation_execution Initiates execution of an Automation runbook
start_change_request_execution Creates a change request for Change Manager
start_session Initiates a connection to a target (for example, a managed node) for a Session Manager session
stop_automation_execution Stop an Automation that is currently running
terminate_session Permanently ends a session and closes the data connection between the Session Manager client and SSM Agent on the managed node
unlabel_parameter_version Remove a label or labels from a parameter
update_association Updates an association
update_association_status Updates the status of the Amazon Web Services Systems Manager document (SSM document) associated with the specified managed node
update_document Updates one or more values for an SSM document
update_document_default_version Set the default version of a document
update_document_metadata Updates information related to approval reviews for a specific version of a change template in Change Manager
update_maintenance_window Updates an existing maintenance window
update_maintenance_window_target Modifies the target of an existing maintenance window
update_maintenance_window_task Modifies a task assigned to a maintenance window
update_managed_instance_role Changes the Identity and Access Management (IAM) role that is assigned to the on-premises server, edge device, or virtual machines (VM)
update_ops_item Edit or change an OpsItem
update_ops_metadata Amazon Web Services Systems Manager calls this API operation when you edit OpsMetadata in Application Manager
update_patch_baseline Modifies an existing patch baseline
update_resource_data_sync Update a resource data sync
update_service_setting ServiceSetting is an account-level setting for an Amazon Web Services service

Examples

## Not run: 
svc <- ssm()
svc$add_tags_to_resource(
  Foo = 123
)

## End(Not run)


paws.management documentation built on Sept. 12, 2023, 1:06 a.m.