ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / local / jetapps / var / lib / aws / lib / python2.7 / site-packages / awscli / examples / ssm

**To execute a command on one or more remote instances**

This example runs an echo command on a target instance.

Command::

aws ssm send-command --document-name "AWS-RunShellScript" --parameters commands=["echo HelloWorld"] --targets "Key=instanceids,Values=i-1234567890abcdef0" --comment "echo HelloWorld"
  
Output::

{
  "Command": {
      "CommandId": "92853adf-ba41-4cd6-9a88-142d119c083d",
      "DocumentName": "AWS-RunShellScript",
      "DocumentVersion": "",
      "Comment": "echo HelloWorld",
      "ExpiresAfter": 1550181014.717,
      "Parameters": {
          "commands": [
              "echo HelloWorld"
          ]
      },
      "InstanceIds": [
          "i-0f00f008a2dcbefe2"
      ],
      "Targets": [],
      "RequestedDateTime": 1550173814.717,
      "Status": "Pending",
      "StatusDetails": "Pending",
      "OutputS3BucketName": "",
      "OutputS3KeyPrefix": "",
      "MaxConcurrency": "50",
      "MaxErrors": "0",
      "TargetCount": 1,
      "CompletedCount": 0,
      "ErrorCount": 0,
      "DeliveryTimedOutCount": 0,
      "ServiceRole": "",
      "NotificationConfig": {
          "NotificationArn": "",
          "NotificationEvents": [],
          "NotificationType": ""
      },
      "CloudWatchOutputConfig": {
          "CloudWatchLogGroupName": "",
          "CloudWatchOutputEnabled": false
      }
  }
}

**To get IP information about an instance**

This example gets the IP information about an instance.

Command::

aws ssm send-command --instance-ids "i-1234567890abcdef0" --document-name "AWS-RunShellScript" --comment "IP config" --parameters "commands=ifconfig"

**To execute a command on instances using tags**

This example executes a command that targets instances using the tag key "ENV" and the value "Dev".

Command::

aws ssm send-command --targets "Key=tag:ENV,Values=Dev" --document-name "AWS-RunShellScript" --parameters "commands=ifconfig"

**To execute a command that sends SNS Notifications**

This example executes a command that is configured to send SNS notifications for all notification events and the Command notification type.

Command::

aws ssm send-command --instance-ids "i-1234567890abcdef0" --document-name "AWS-RunShellScript" --comment "IP config" --parameters "commands=ifconfig" --service-role-arn "arn:aws:iam::123456789012:role/SNS_Role" --notification-config "NotificationArn=arn:aws:sns:us-east-1:123456789012:SNSTopicName,NotificationEvents=All,NotificationType=Command"

**To execute a command that outputs to S3 and CloudWatch**

This example executes a command that is configured to output command details to an S3 bucket and to a CloudWatch Logs Group.

Command::

aws ssm send-command --instance-ids "i-1234567890abcdef0" --document-name "AWS-RunShellScript" --comment "IP config" --parameters "commands=ifconfig" --output-s3-bucket-name "s3-bucket-name" --output-s3-key-prefix "runcommand" --cloud-watch-output-config "CloudWatchOutputEnabled=true,CloudWatchLogGroupName=CWLGroupName"

**To target multiple instances with different tags**

This example targets two different tag keys and values.

Command::

aws ssm send-command --document-name "AWS-RunPowerShellScript" --parameters commands=["echo helloWorld"] --targets Key=tag:Env,Values=Dev Key=tag:Role,Values=WebServers

**To target multiple instances with the same tag key**

This example targets the same tag key with different values.

Command::

aws ssm send-command --document-name "AWS-RunPowerShellScript" --parameters commands=["echo helloWorld"] --targets Key=tag:Env,Values=Dev,Test

[+] ..
[-] list-compliance-items.rst [edit]
[-] list-command-invocations.rst [edit]
[-] describe-automation-step-executions.rst [edit]
[-] update-service-setting.rst [edit]
[-] get-parameters.rst [edit]
[-] send-automation-signal.rst [edit]
[-] get-service-setting.rst [edit]
[-] describe-maintenance-windows.rst [edit]
[-] create-maintenance-window.rst [edit]
[-] put-parameter.rst [edit]
[-] delete-maintenance-window.rst [edit]
[-] get-maintenance-window-task.rst [edit]
[-] describe-association-execution-targets.rst [edit]
[-] delete-inventory.rst [edit]
[-] describe-patch-baselines.rst [edit]
[-] list-associations.rst [edit]
[-] get-maintenance-window-execution-task-invocation.rst [edit]
[-] get-parameters-by-path.rst [edit]
[-] get-parameter-history.rst [edit]
[-] start-session.rst [edit]
[-] update-maintenance-window-target.rst [edit]
[-] get-default-patch-baseline.rst [edit]
[-] describe-sessions.rst [edit]
[-] put-inventory.rst [edit]
[-] list-document-versions.rst [edit]
[-] describe-instance-patch-states-for-patch-group.rst [edit]
[-] describe-effective-patches-for-patch-baseline.rst [edit]
[-] describe-maintenance-window-execution-tasks.rst [edit]
[-] describe-association.rst [edit]
[-] describe-effective-instance-associations.rst [edit]
[-] describe-document-permission.rst [edit]
[-] delete-association.rst [edit]
[-] update-patch-baseline.rst [edit]
[-] describe-instance-associations-status.rst [edit]
[-] list-resource-data-sync.rst [edit]
[-] describe-maintenance-window-tasks.rst [edit]
[-] describe-document.rst [edit]
[-] register-target-with-maintenance-window.rst [edit]
[-] remove-tags-from-resource.rst [edit]
[-] get-inventory.rst [edit]
[-] delete-document.rst [edit]
[-] list-compliance-summaries.rst [edit]
[-] resume-session.rst [edit]
[-] put-compliance-items.rst [edit]
[-] create-association-batch.rst [edit]
[-] delete-parameters.rst [edit]
[-] delete-activation.rst [edit]
[-] stop-automation-execution.rst [edit]
[-] describe-maintenance-window-targets.rst [edit]
[-] create-association.rst [edit]
[-] update-maintenance-window.rst [edit]
[-] update-document-default-version.rst [edit]
[-] delete-resource-data-sync.rst [edit]
[-] list-inventory-entries.rst [edit]
[-] describe-maintenance-windows-for-target.rst [edit]
[-] describe-maintenance-window-schedule.rst [edit]
[-] create-patch-baseline.rst [edit]
[-] describe-patch-groups.rst [edit]
[-] describe-parameters.rst [edit]
[-] get-parameter.rst [edit]
[-] get-inventory-schema.rst [edit]
[-] start-automation-execution.rst [edit]
[-] cancel-command.rst [edit]
[-] list-tags-for-resource.rst [edit]
[-] get-automation-execution.rst [edit]
[-] get-patch-baseline-for-patch-group.rst [edit]
[-] create-activation.rst [edit]
[-] describe-maintenance-window-executions.rst [edit]
[-] list-documents.rst [edit]
[-] register-task-with-maintenance-window.rst [edit]
[-] deregister-target-from-maintenance-window.rst [edit]
[-] get-deployable-patch-snapshot-for-instance.rst [edit]
[-] describe-association-executions.rst [edit]
[-] describe-activations.rst [edit]
[-] update-association.rst [edit]
[-] terminate-session.rst [edit]
[-] deregister-managed-instance.rst [edit]
[-] create-resource-data-sync.rst [edit]
[-] describe-instance-information.rst [edit]
[-] update-managed-instance-role.rst [edit]
[-] get-document.rst [edit]
[-] list-resource-compliance-summaries.rst [edit]
[-] register-default-patch-baseline.rst [edit]
[-] describe-maintenance-window-execution-task-invocations.rst [edit]
[-] deregister-patch-baseline-for-patch-group.rst [edit]
[-] get-maintenance-window-execution-task.rst [edit]
[-] register-patch-baseline-for-patch-group.rst [edit]
[-] create-document.rst [edit]
[-] update-document.rst [edit]
[-] update-association-status.rst [edit]
[-] list-association-versions.rst [edit]
[-] list-commands.rst [edit]
[-] update-maintenance-window-task.rst [edit]
[-] describe-instance-patch-states.rst [edit]
[-] describe-instance-patches.rst [edit]
[-] label-parameter-version.rst [edit]
[-] describe-inventory-deletions.rst [edit]
[-] describe-automation-executions.rst [edit]
[-] get-command-invocation.rst [edit]
[-] get-maintenance-window-execution.rst [edit]
[-] deregister-task-from-maintenance-window.rst [edit]
[-] start-associations-once.rst [edit]
[-] send-command.rst [edit]
[-] get-patch-baseline.rst [edit]
[-] add-tags-to-resource.rst [edit]
[-] get-maintenance-window.rst [edit]
[-] cancel-maintenance-window-execution.rst [edit]
[-] modify-document-permission.rst [edit]
[-] get-connection-status.rst [edit]
[-] delete-patch-baseline.rst [edit]
[-] delete-parameter.rst [edit]
[-] describe-available-patches.rst [edit]
[-] describe-patch-group-state.rst [edit]