Skip to content

Update dynamic infrastructure AWS account commands #3088

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
sathvikkumar-octo wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

Update dynamic infrastructure AWS account commands #3088

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ee99a6f
Update dynamic infrastructure AWS account commands
sathvikkumar-octo Apr 8, 2026
a559ede
Secret key spelling error lol
sathvikkumar-octo Apr 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
52 changes: 40 additions & 12 deletions ...s/docs/infrastructure/deployment-targets/dynamic-infrastructure/aws-accounts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,28 +1,56 @@
---
layout: src/layouts/Default.astro
pubDate: 2023-01-01
modDate: 2023-01-01
title: Create AWS account command
description: New-OctopusAwsAccount allows you to create an AWS account in Octopus from within a running deployment
modDate: 2026-04-08
title: Create AWS account commands
description: New-OctopusAwsAccount and New-OctopusAwsOidcAccount allow you to create AWS accounts in Octopus from within a running deployment
navOrder: 10
---

## AWS account
Command: **_New-OctopusAwsAccount_**

_**New-OctopusAwsAccount** allows you to create an AWS account in Octopus from within a running deployment_
Command: ***New-OctopusAwsAccount***

| Parameters | Value |
|-------------------------------|------------------------------------------------------------------------------------------------------------|
| `-name` | Name for the AWS account |
| `-secretKey` | The AWS secret key to use when authenticating against Amazon Web Services. |
| `-accessKey` | The AWS access key to use when authenticating against Amazon Web Services. |
| `-updateIfExisting` | Will update an existing account with the same name, create if it doesn't exist |
***New-OctopusAwsAccount*** *allows you to create an AWS account in Octopus from within a running deployment*

| Parameters | Value |
| ------------------- | -------------------------------------------------------------------------------- |
| `-name` | Name for the AWS account. |
| `-secretKey` | The AWS secret key to use when authenticating against Amazon Web Services. |
| `-accessKey` | The AWS access key to use when authenticating against Amazon Web Services. |
| `-region` | The AWS region to use for authentication (e.g. `us-east-1`). |
| `-updateIfExisting` | Will update an existing account with the same name, create if it doesn't exist. |

Example:

```powershell
New-OctopusAwsAccount -name "My AWS Account" `
-secretKey "7U4MhdfjgcAk9niwPgXD81pTYY+fIvVsN3m" `
-secretKey "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" `
-accessKey "AKIAVY29QTUTKPJC3R5K" `
-region "us-east-1" `
-updateIfExisting
```

## AWS OIDC account

Command: ***New-OctopusAwsOidcAccount***

***New-OctopusAwsOidcAccount*** *allows you to create an AWS OIDC account in Octopus from within a running deployment*

| Parameters | Value |
| ------------------- | -------------------------------------------------------------------------------- |
| `-name` | Name for the AWS OIDC account. |
| `-roleArn` | The Amazon Resource Name (ARN) of the role to assume. |
| `-sessionDuration` | The duration of the session in seconds. Defaults to `3600`. |
| `-region` | The AWS region to use for authentication (e.g. `us-east-1`). |
| `-updateIfExisting` | Will update an existing account with the same name, create if it doesn't exist. |

Example:

```powershell
New-OctopusAwsOidcAccount -name "My AWS OIDC Account" `
-roleArn "arn:aws:iam::123456789012:role/my-role" `
-sessionDuration "3600" `
-region "ap-southeast-2" `
-updateIfExisting
```
Loading