> ## 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.

<Tabs>
  <Tab title="View Cloud Accounts">
    ## Purpose

    The **Cloud Accounts** page displays and manages all cloud accounts configured
    in Aviatrix CoPilot, including AWS, Azure, GCP, and OCI accounts, with their
    connection status, credentials, and associated resources.

    ## Elements

    <Frame>
      <img
        src={
  "/images/reference/ui/cloud-resources/cloud-account-accounts.png"
}
        alt="Cloud Account: Accounts"
        width="100%"
      />
    </Frame>

    * **+ Cloud Account button**: Button to add a new cloud account.
    * **Cloud Accounts table**: Shows a list of all configured cloud accounts from
      all cloud providers (AWS, Azure, GCP, OCI).
    * **Edit button**: Button to modify an existing cloud account configuration.
    * **Delete button**: Button to remove a cloud account.
    * **Test Connection button**: Button to test the connection to a cloud account.
    * **Show filters button**: Button to show or hide filter options.
    * **Select columns button**: Button to select which columns to display in the
      table.
    * **Export button**: Button to export 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

    <AccordionGroup>
      <Accordion title="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**, **Show filters**, or **Select columns** to customize the view.
        4. Optionally, click **Export** to export 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>

      <Accordion title="Add Cloud Account">
        To add a new cloud account:

        1. Go to **Cloud Resources** > **Cloud Account**.
        2. Click **+ Cloud Account**.
        3. In the Connect Cloud Account dialog, select **Cloud Type**, enter **Account Name** and **Account ID**, and choose **Access Method**.
        4. Enter credentials in the **Credentials** section (varies by cloud type and access method).
        5. Optionally, click **Test Connection** to verify credentials before saving.
        6. Click **Save** to add the account or **Cancel** to close without saving.

        The new cloud account appears in the Cloud Accounts table.
      </Accordion>

      <Accordion title="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 and click the **Edit** button.
        3. In the Edit Cloud Account dialog, update **Account Name**, **Access Method**, or **Credentials** as needed.
        4. Optionally, click **Test Connection** to verify the updated connection.
        5. Click **Save** to apply changes or **Cancel** to discard.

        Changes are applied to the cloud account.
      </Accordion>

      <Accordion title="Delete Cloud Account">
        To delete a cloud account:

        1. Go to **Cloud Resources** > **Cloud Account**.
        2. Locate the account in the Cloud Accounts table and click the **Delete** button.
        3. Confirm the deletion.

        The cloud account is removed from CoPilot.
      </Accordion>

      <Accordion title="Test Cloud Account Connection">
        To test the connection to a cloud account:

        1. Go to **Cloud Resources** > **Cloud Account**.
        2. Locate the account in the Cloud Accounts table and click the **Test Connection** button.

        The connection test result is displayed.
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Connect Cloud Account">
    ## Purpose

    The **Connect Cloud Account** dialog configures a new cloud account connection
    for AWS, Azure, GCP, or OCI by providing the necessary credentials and account
    information.

    ## Elements

    <Frame>
      <img
        src={
  "/images/reference/ui/cloud-resources/cloud-account-add.png"
}
        alt="Cloud Account: Add Cloud Account"
        width="100%"
      />
    </Frame>

    * **Cloud Type dropdown**: Dropdown to select the cloud provider (AWS, Azure,
      GCP, OCI).
    * **Account Name field**: Text field to enter a unique name for the cloud
      account.
    * **Account ID field**: Text field to enter the cloud account ID, subscription
      ID, or project ID.
    * **Access Method dropdown**: Dropdown to select the access method (varies by
      cloud provider).
    * **Credentials section**: Section to enter credentials based on the selected
      cloud type and access method.
    * **Test Connection button**: Button to test the cloud account connection before
      saving.
    * **Save button**: Button to save and add the cloud account.
    * **Cancel button**: Button to cancel the cloud account addition.

    ## Actions

    <AccordionGroup>
      <Accordion title="Connect Cloud Account">
        To connect a new cloud account:

        1. Go to **Cloud Resources** > **Cloud Account** and click **+ Cloud Account** to open the Connect Cloud Account dialog.
        2. Select **Cloud Type** (AWS, Azure, GCP, or OCI).
        3. Enter **Account Name** and **Account ID** (subscription ID or project ID as applicable).
        4. Select **Access Method** and complete the **Credentials** section (IAM Role ARN, Access Keys, Service Principal, Service Account Key, or OCI credentials as applicable).
        5. Optionally, click **Test Connection** to verify credentials.
        6. Click **Save** to add the account or **Cancel** to close.

        The cloud account is added and appears on the Cloud Accounts page.

        ### Parameter Details

        | CoPilot Parameter Name | Description                                                                                                         |
        | ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
        | Cloud Type             | Select the cloud provider (AWS, Azure, GCP, OCI).                                                                   |
        | Account Name           | Enter a unique name for the cloud account.                                                                          |
        | Account ID             | Enter the cloud account identifier (AWS Account ID, Azure Subscription ID, GCP Project ID, or OCI Tenancy OCID).    |
        | Access Method          | Select the access method (IAM Role/Access Key for AWS, Service Principal for Azure, Service Account for GCP, etc.). |
        | IAM Role ARN           | Enter the IAM role ARN (for AWS with IAM Role access method).                                                       |
        | External ID            | Enter the external ID (for AWS with IAM Role access method, optional).                                              |
        | Access Key ID          | Enter the access key ID (for AWS with Access Key access method).                                                    |
        | Secret Access Key      | Enter the secret access key (for AWS with Access Key access method).                                                |
        | Tenant ID              | Enter the Azure Active Directory tenant ID (for Azure).                                                             |
        | Application ID         | Enter the Azure application (client) ID (for Azure).                                                                |
        | Application Key        | Enter the Azure application key (for Azure).                                                                        |
        | Service Account Email  | Enter the GCP service account email (for GCP).                                                                      |
        | Service Account Key    | Upload or paste the GCP service account key JSON (for GCP).                                                         |
        | User OCID              | Enter the OCI user OCID (for OCI).                                                                                  |
        | API Key                | Enter the OCI API key (for OCI).                                                                                    |
        | Test Connection        | Test the connection to verify credentials before saving.                                                            |
        | Save                   | Save and add the cloud account to CoPilot.                                                                          |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Edit Cloud Account">
    ## Purpose

    The **Edit Cloud Account** dialog modifies the configuration of an existing
    cloud account, including updating credentials, changing access methods, or
    modifying account information.

    ## Elements

    <Frame>
      <img
        src={
  "/images/reference/ui/cloud-resources/cloud-account-edit.png"
}
        alt="Cloud Account: Edit Cloud Account"
        width="100%"
      />
    </Frame>

    * **Cloud Type field**: Read-only field showing the cloud provider type.
    * **Account Name field**: Text field to modify the cloud account name.
    * **Account ID field**: Read-only field showing the cloud account ID (may be
      editable for some cloud types).
    * **Access Method dropdown**: Dropdown to view or change the access method.
    * **Credentials section**: Section to update credentials based on the cloud type
      and access method.
    * **Test Connection button**: Button to test the updated cloud account
      connection.
    * **Save button**: Button to save the changes to the cloud account.
    * **Cancel button**: Button to cancel the changes.

    ## Actions

    <AccordionGroup>
      <Accordion title="Edit Cloud Account">
        To edit a cloud account:

        1. Go to **Cloud Resources** > **Cloud Account**.
        2. Locate the account in the Cloud Accounts table and click the **Edit** button to open the Edit Cloud Account dialog.
        3. Update **Account Name**, **Access Method**, or **Credentials** as needed (**Cloud Type** and **Account ID** may be read-only).
        4. Optionally, click **Test Connection** to verify the connection.
        5. Click **Save** to apply changes or **Cancel** to discard.

        The cloud account configuration is updated.

        ### Parameter Details

        | CoPilot Parameter Name | Description                                                                                                                                          |
        | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
        | Cloud Type             | View the cloud provider type (read-only).                                                                                                            |
        | Account Name           | Modify the name of the cloud account.                                                                                                                |
        | Account ID             | View or modify the cloud account identifier (may be read-only depending on cloud type).                                                              |
        | Access Method          | View or change the access method (if modification is allowed).                                                                                       |
        | Credentials            | Update the credentials based on the selected cloud type and access method (IAM Role ARN, Access Keys, Service Principal, Service Account Key, etc.). |
        | Test Connection        | Test the connection with updated credentials.                                                                                                        |
        | Save                   | Save the changes made to the cloud account.                                                                                                          |
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>
