{"id":21377712,"url":"https://github.com/quobject/aws-cli-js","last_synced_at":"2025-07-23T19:02:06.198Z","repository":{"id":1632853,"uuid":"43616723","full_name":"Quobject/aws-cli-js","owner":"Quobject","description":"A node.js wrapper for the aws command line interface","archived":false,"fork":false,"pushed_at":"2023-03-04T02:46:23.000Z","size":1228,"stargazers_count":43,"open_issues_count":8,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-14T06:16:39.623Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Quobject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-10-03T22:08:14.000Z","updated_at":"2023-07-04T07:07:56.000Z","dependencies_parsed_at":"2023-07-11T03:46:37.711Z","dependency_job_id":null,"html_url":"https://github.com/Quobject/aws-cli-js","commit_stats":{"total_commits":27,"total_committers":7,"mean_commits":3.857142857142857,"dds":0.4814814814814815,"last_synced_commit":"657e0cd5177d5ad4669bf72b2f2a17b03938f81e"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/Quobject/aws-cli-js","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quobject%2Faws-cli-js","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quobject%2Faws-cli-js/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quobject%2Faws-cli-js/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quobject%2Faws-cli-js/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Quobject","download_url":"https://codeload.github.com/Quobject/aws-cli-js/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quobject%2Faws-cli-js/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266737566,"owners_count":23976388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T09:23:25.435Z","updated_at":"2025-07-23T19:02:06.133Z","avatar_url":"https://github.com/Quobject.png","language":"TypeScript","readme":"# aws-cli-js\r\nA node.js wrapper for the [aws-cli](http://aws.amazon.com/documentation/cli/) command line interface\r\n\r\n[![NPM version][npm-image]][npm-url]\r\n[![NPM downloads][downloads-image]][downloads-url]\r\n\r\n## Installation\r\n\r\n### Warning\r\n\r\nCode uses exec = child_process.exec; https://github.com/Quobject/docker-cli-js/issues/22\r\n\r\n\r\n### Step 1: Prerequisites\r\n\r\nThe aws command line interface must be installed and accessible in the path\r\n\r\n### Step 2: Installation\r\n    \r\n    npm install aws-cli-js\r\n    \r\nThen:\r\n\r\n```js\r\nvar awsCli = require('aws-cli-js');\r\nvar Options = awsCli.Options;\r\nvar Aws = awsCli.Aws;\r\n```\r\n\r\n## Usage\r\n\r\nWith promise\r\n\r\n```js\r\nvar options = new Options(\r\n  /* accessKey    */ 'your key',\r\n  /* secretKey    */ 'your key2',\r\n  /* sessionToken */ 'your token',\r\n  /* currentWorkingDirectory */ null,\r\n  /* cliPath */ 'aws'\r\n);\r\n\r\nvar aws = new Aws(options);\r\n\r\naws.command('iam list-users').then(function (data) {\r\n  console.log('data = ', data); \r\n});\r\n\r\n//data = {\r\n//  command: 'aws iam list-users ',\r\n//  raw: '{\\\\n    \\\\\"Users\\\\\": [\\\\n        {\\\\n            \\\\\"UserName\\\\\": \\\\\"developer\\\\\", \\\\n            \\\\\"PasswordLastUsed\\\\\": \\\\\"2015-10-03T17:58:49Z\\\\\", \\\\n            \\\\\"CreateDate\\\\\": \\\\\"2015-06-03T07:37:25Z\\\\\", \\\\n            \\\\\"UserId\\\\\": \\\\\"AIDAJBXXXXXXXXXXXXXXXXX\\\\\", \\\\n            \\\\\"Path\\\\\": \\\\\"/\\\\\", \\\\n            \\\\\"Arn\\\\\": \\\\\"arn:aws:iam::03XXXXXXXXX:user/developer\\\\\"\\\\n        }\\\\n    ]\\\\n}\\\\n',\r\n//  object:\r\n//   {\r\n//     Users:\r\n//      [{\r\n//        UserName: 'developer',\r\n//        PasswordLastUsed: '2015-10-03T17:58:49Z',\r\n//        CreateDate: '2015-06-03T07:37:25Z',\r\n//        UserId: 'AIDAJBXXXXXXXXXXXXXXXXX',\r\n//        Path: '/',\r\n//        Arn: 'arn:aws:iam::03XXXXXXXXX:user/developer'\r\n//      }]\r\n//   }\r\n//}\r\n\r\n```\r\n\r\nWith callback:\r\n\r\n```js\r\n\r\naws.command('iam list-users', function (err, data) {\r\n  console.log('data = ', data);\r\n});\r\n\r\n//data = {\r\n//  command: 'aws iam list-users ',\r\n//  raw: '[\"{\\\\n    \\\\\"Users\\\\\": [\\\\n        {\\\\n            \\\\\"UserName\\\\\": \\\\\"developer\\\\\", \\\\n            \\\\\"PasswordLastUsed\\\\\": \\\\\"2015-10-03T17:58:49Z\\\\\", \\\\n            \\\\\"CreateDate\\\\\": \\\\\"2015-06-03T07:37:25Z\\\\\", \\\\n            \\\\\"UserId\\\\\": \\\\\"AIDAJBXXXXXXXXXXXXXXXXX\\\\\", \\\\n            \\\\\"Path\\\\\": \\\\\"/\\\\\", \\\\n            \\\\\"Arn\\\\\": \\\\\"arn:aws:iam::03XXXXXXXXX:user/developer\\\\\"\\\\n        }\\\\n    ]\\\\n}\\\\n\",\"\"]',\r\n//  object:\r\n//   {\r\n//     Users:\r\n//      [{\r\n//        UserName: 'developer',\r\n//        PasswordLastUsed: '2015-10-03T17:58:49Z',\r\n//        CreateDate: '2015-06-03T07:37:25Z',\r\n//        UserId: 'AIDAJBXXXXXXXXXXXXXXXXX',\r\n//        Path: '/',\r\n//        Arn: 'arn:aws:iam::03XXXXXXXXX:user/developer'\r\n//      }]\r\n//   }\r\n//}\r\n\r\n```\r\n\r\nTypescript\r\n\r\n```js\r\nimport { Aws, Options } from 'aws-cli-js';\r\n\r\nconst options = new Options(\r\n  /* accessKey    */ 'your key',\r\n  /* secretKey    */ 'your key2',\r\n  /* sessionToken */ 'your token',\r\n  /* currentWorkingDirectory */ null\r\n);\r\n\r\n\r\nconst aws = new Aws(options);\r\n\r\nreturn aws.command('iam list-users').then(function (data) {\r\n  console.log('data = ', data);\r\n});\r\n```\r\n\r\n\r\n\r\n* describe-instances\r\n\r\n```js\r\nawsCli.command('ec2 describe-instances --instance-ids i-789b3ba7').then(function (data) {\r\n  console.log('data = ', data); \r\n});\r\n\r\n\r\n//data =  { command: 'aws ec2 describe-instances --instance-ids i-789b3ba7 ',\r\n//  raw: '{\\\\n    \\\\\"Reservations\\\\\": [\\\\n        {\\\\n            \\\\\"OwnerId\\\\\": \\\\\"031641171132\\\\\", \\\\n            \\\\\"ReservationId\\\\\": \\\\\"r-a48ad878\\\\\", \\\\n            \\\\\"Groups\\\\\": [], \\\\n            \\\\\"Instances\\\\\": [\\\\n                {\\\\n\r\n//          \\\\\"Monitoring\\\\\": {\\\\n                        \\\\\"State\\\\\": \\\\\"disabled\\\\\"\\\\n                    }, \\\\n\r\n//     \\\\\"PublicDnsName\\\\\": \\\\\"ec2-52-64-166-221.ap-southeast-2.compute.amazonaws.com\\\\\", \\\\n                    \\\\\"State\\\\\": {\\\\n\r\n// ...\r\n\r\n```\r\n\r\n## License\r\n\r\nMIT\r\n\r\n[npm-image]: https://img.shields.io/npm/v/aws-cli-js.svg?style=flat\r\n[npm-url]: https://npmjs.org/package/aws-cli-js\r\n[downloads-image]: https://img.shields.io/npm/dm/aws-cli-js.svg?style=flat\r\n[downloads-url]: https://npmjs.org/package/aws-cli-js\r\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquobject%2Faws-cli-js","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquobject%2Faws-cli-js","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquobject%2Faws-cli-js/lists"}