> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aviatrix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud Account

> This section provides the purpose, elements, and actions performed on the Cloud Account pages.

This section provides the purpose, elements, and actions performed on the
**Cloud Account** pages.

## Purpose

The **Cloud Accounts** page displays and manages all cloud accounts configured
in Aviatrix CoPilot, including AWS, Azure, GCP, OCI, and Alibaba Cloud accounts,
with their audit status and RBAC group assignments.

## Elements

![Cloud Account: Accounts](https://docs.aviatrix.com/images/reference/ui/cloud-resources/cloud-account-accounts-8.2.png)

* **+ Cloud Account button**: Button to add a new cloud account.
* **Actions menu**: Bulk actions for the selected cloud accounts: **Audit
  Account** (audit all selected accounts) and **Update IAM Policy** (enabled
  only when at least one selected account is an AWS account).
* **Audit Settings button**: Opens a dialog to configure the **Email
  Notification** and **Background Audit** toggles for account auditing.
* **Cloud Accounts table**: Shows a list of all configured cloud accounts from
  all cloud providers (AWS, Azure, GCP, OCI, and Alibaba Cloud).
* **Account Name link**: Opens a detail panel for the cloud account.
* **Row actions menu** (kebab icon): Opens **Edit** (not available for the Self
  Managed / Aviatrix account type), **Delete**, and **Actions** (a submenu with
  **Audit Account**, and **Update IAM Policy** if the account is an AWS
  account).
* **Filter button**: Button to show or hide filter options.
* **Columns button**: Button to select which columns to display in the table.
* **Download button**: Button to download cloud account data.
* **Search box**: Search box for filtering cloud accounts in the table.
* **Refresh button**: Button to refresh the cloud accounts table data.

## Actions

> [accordion] Manage Cloud Accounts
>
> > [accordion] View Cloud Accounts
> >
> > To view cloud accounts:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. The Cloud Accounts page appears with the Cloud Accounts table listing all configured accounts.
> > 3. Optionally, use **Search**, **Filter**, or **Columns** to customize the view.
> > 4. Optionally, click **Download** to download data or **Refresh** to refresh the table.
> >
> > The table shows Account Name, Cloud, Account Number/ID, RBAC Group, Audit
> > Status, and Last Audit Time.
> >
> > ### Parameter Details
> >
> > | CoPilot Parameter Name | Description |
> > | - | - |
> > | Account Name | Displays the name of the cloud account added to the platform. |
> > | Cloud | Displays the cloud provider associated with the account. |
> > | Account Number / ID | Displays the unique account number or identifier assigned by the cloud provider. |
> > | RBAC Group | Displays the role-based access control group assigned to the account. |
> > | Audit Status | Displays the current audit status of the cloud account. |
> > | Last Audit Time | Displays the date and time when the account was last audited. |
>
> > [accordion] Add Cloud Account
> >
> > To add a new cloud account:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. Click **+ Cloud Account**.\
> >    The Connect Cloud Account dialog appears.
> > 3. Enter **Account Name**.
> > 4. Select the **Cloud Type**: **AWS** (Standard, GovCloud, or China), **Azure** (Global, GovCloud, or China), **GCP**, **OCI**, or **Alibaba Cloud**.
> > 5. Complete the credential fields shown for the selected cloud type (see Parameter Details).
> > 6. Optionally, assign the account to one or more groups in **Add to RBAC Groups**.
> > 7. Click **Save** to add the account or **Cancel** to close without saving.
> >
> > The new cloud account appears in the Cloud Accounts table.
> >
> > > [!NOTE]
> > >
> > > For AWS, if prompted, confirm that the CloudFormation script to establish
> > > trust with the primary access account has been run.
> >
> > ### Parameter Details
> >
> > | CoPilot Parameter Name | Description |
> > | - | - |
> > | Account Name | Enter a unique name for the cloud account. |
> > | Cloud Type | Select AWS, AWS GovCloud, AWS China, Azure, Azure GovCloud, Azure China, GCP, OCI, or Alibaba Cloud. |
> > | IAM Role-Based (AWS only) | Turn on to authenticate using an IAM role instead of an access key. |
> > | AWS Account Number (AWS only) | Enter the AWS account number. |
> > | AWS App Role ARN (AWS only) | Enter the IAM role ARN used for cross-account access (optional, shown when IAM Role-Based is on). |
> > | AWS EC2 Role ARN (AWS only) | Enter the EC2 instance role ARN (optional, shown when IAM Role-Based is on). |
> > | AWS Access Key ID (AWS only) | Enter the access key ID (shown when IAM Role-Based is off). |
> > | AWS Secret Key (AWS only) | Enter the secret access key (shown when IAM Role-Based is off). |
> > | ARM Subscription ID (Azure only) | Enter the Azure subscription ID. |
> > | Directory ID (Azure only) | Enter the Azure Active Directory (tenant) ID. |
> > | Application ID (Azure only) | Enter the Azure application (client) ID. |
> > | Application Key (Azure only) | Enter the Azure application (client) secret key. |
> > | GCP Project ID (GCP only) | Optionally enter the GCP project ID. |
> > | GCP Project Credentials (GCP only) | Upload the GCP service account credentials JSON file. |
> > | OCI Tenancy ID (OCI only) | Enter the OCI tenancy OCID. |
> > | OCI User ID (OCI only) | Enter the OCI user OCID. |
> > | OCI Compartment ID (OCI only) | Enter the OCI compartment OCID. |
> > | OCI API Private Key File (OCI only) | Upload the OCI API signing private key file. |
> > | Alibaba Account ID (Alibaba only) | Enter the Alibaba Cloud account ID. |
> > | Access Key (Alibaba only) | Enter the Alibaba Cloud access key. |
> > | Secret Access Key (Alibaba only) | Enter the Alibaba Cloud secret access key. |
> > | Add to RBAC Groups | Optionally assign the account to one or more RBAC groups. |
>
> > [accordion] Edit Cloud Account
> >
> > To edit an existing cloud account:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. Locate the account in the Cloud Accounts table, open its row actions menu, and select **Edit**.\
> >    The Edit Cloud Account dialog appears with **Cloud Type** and **Account Name** shown as read-only, and the credential fields for that cloud type (see the Add Cloud Account Parameter Details) pre-filled with the account's current values.
> > 3. Update the credential fields as needed.
> > 4. Click **Save** to apply changes or **Cancel** to discard.
> >
> > Changes are applied to the cloud account.
> >
> > > [!NOTE]
> > >
> > > The cloud type and account name cannot be changed after the account is
> > > created.
>
> > [accordion] Delete Cloud Account
> >
> > To delete a cloud account:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. Locate the account in the Cloud Accounts table, open its row actions menu, and select **Delete**.
> > 3. Confirm the deletion.
> >
> > The cloud account is removed from CoPilot.

> [accordion] Audit and Maintain Cloud Accounts
>
> > [accordion] Audit a Cloud Account
> >
> > To audit one or more cloud accounts:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. To audit a single account, locate it in the Cloud Accounts table, open its row actions menu, then select **Actions** > **Audit Account**. To audit multiple accounts, select their rows and click the toolbar's **Actions** > **Audit Account**.
> >
> > An Audit Report dialog shows the audit Status, Comment, and Timestamp for a
> > single-account audit. For a multi-account audit, a task notification appears;
> > monitor the audit progress and results on **Monitor** > **Notifications** >
> > **Tasks**. The account's Audit Status and Last Audit Time in the table are
> > updated when the audit completes.
> >
> > > [!NOTE]
> > >
> > > **Audit Account** checks connectivity and configuration health for an account
> > > that is already saved. It replaces the previous **Test Connection** action,
> > > which validated credentials before saving a new or edited account.
>
> > [accordion] Configure Audit Settings
> >
> > To configure account audit settings:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. Click **Audit Settings**.\
> >    The Audit Settings dialog appears with **Email Notification** and **Background Audit** toggles.
> > 3. Turn **Email Notification** or **Background Audit** **On** or **Off** as needed.
> > 4. Click **Save**.
> >
> > The updated audit settings apply to all cloud accounts.
>
> > [accordion] Update IAM Policy for an AWS Account
> >
> > To update the IAM policy for one or more AWS cloud accounts:
> >
> > 1. Go to **Cloud Resources** > **Cloud Account**.
> > 2. To update a single AWS account, locate it in the Cloud Accounts table, open its row actions menu, then select **Actions** > **Update IAM Policy**. To update multiple AWS accounts, select their rows and click the toolbar's **Actions** > **Update IAM Policy**.
> > 3. Review the IAM policy details in the dialog and confirm.
> >
> > A notification appears when updating the IAM policy is in progress. This option
> > is available only for AWS accounts.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.