# Manage a space

After a space has been created, you can edit the [managed resources](#add-a-new-space-access-scope), [membership](#manage-members), and [name](#rename-a-space).

***

### Add a new space access scope

Follow these steps to add an access scope to an existing space:

1. On the [**Spaces Management**](https://app.apono.io/spaces) page, click <img src="https://1094436629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv6MBfUGvblSdAz31yJXm%2Fuploads%2Fgit-blob-3a3d063ed9ae2352a93c4de436aa89148cded8d4%2Funknown%20(1).png?alt=media" alt="" data-size="line"> (pencil icon) on the space tile. The **Edit Space** page opens.

{% hint style="success" %}
You can also click **Space Settings** at the top right of the screen to access the **Spaces Management** page.
{% endhint %}

2. Click **Next**.
3. In the **Space Access scope** pane, filter the resources by one or several of the following filters.

{% hint style="success" %}
To create complex queries, click **AQL** to build a query in the code box.

The[ Apono Query Language](https://docs.apono.io/docs/inventory/apono-query-language) enables you to extend your query capabilities beyond the standard options available with the UI.
{% endhint %}

<details>

<summary>Integration</summary>

Follow these steps to filter by integration:

1. Click the **Integration** dropdown menu.
2. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
3. (Optional) In the **Search** field, enter a value to filter the list of integrations.
4. Select one or several integrations. Only the values meeting the criteria will be shown.
5. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Type</summary>

Follow these steps to filter by resource type:

1. Click the **Resource Type** dropdown menu.
2. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
3. (Optional) In the **Search** field, enter a value to filter the list of resource types.
4. Select one or several resource types. Only the values meeting the criteria will be shown.
5. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Status</summary>

Follow these steps to filter by resource status:

1. Click the **Resource Status** dropdown menu.
2. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
3. (Optional) In the **Search** field, enter a value to filter the list of resource statuses.
4. Select one or several resource statuses. Only the values meeting the criteria will be shown.
5. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Name</summary>

Follow these steps to filter by resource name:

1. Click the **More Filters** dropdown menu.
2. Select **Resource Name**.
3. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
   * **Contains (a\*b)**
   * **Does not contain (!a\*b)**
   * **Starts with (\*b)**
   * **Ends with (a\*)**
4. (Optional) In the **Search** field, enter a value to filter the list of resource names.
5. (**Equals**, **Not Equals** only) Select one or several resource names. Only the values meeting the criteria will be shown.
6. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Path</summary>

Follow these steps to filter by resource path:

1. Click the **More Filters** dropdown menu.
2. Select **Resource Path**.
3. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
   * **Contains (a\*b)**
   * **Does not contain (!a\*b)**
   * **Starts with (\*b)**
   * **Ends with (a\*)**
4. (Optional) In the **Search** field, enter a value to filter the list of resource paths.
5. Select one or several resource paths. Only the values meeting the criteria will be shown.
6. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Tag</summary>

Follow these steps to filter by resource tag:

1. Click the **More Filters** dropdown menu.
2. Select **Resource Tag**.
3. (Optional) In the **Search** field, enter a value to filter the list of resource names.
4. Click the resource name.
5. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
   * **Contains (a\*b)**
   * **Does not contain (!a\*b)**
   * **Starts with (\*b)**
   * **Ends with (a\*)**
6. (Optional) In the **Search** field, enter a value to filter the list of resource tags.
7. (**Equals**, **Not Equals** only) Select one or several resource tags. Only the values meeting the criteria will be shown.
8. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Permission Name</summary>

Follow these steps to filter by permission name:

1. Click the **More Filters** dropdown menu.
2. Select **Permission Name**.
3. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
   * **Contains (a\*b)**
   * **Does not contain (!a\*b)**
   * **Starts with (\*b)**
   * **Ends with (a\*)**
4. (Optional) In the **Search** field, enter a value to filter the list of resource names
5. (**Equals**, **Not Equals** only) Select one or several permission names. Only the values meeting the criteria will be shown.
6. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Resource Risk Level</summary>

Follow these steps to filter by resource risk level:

1. Click the **More Filters** dropdown menu.
2. Select **Resource Risk Level**.
3. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
4. Select one or several resource risk level. Only the values meeting the criteria will be shown.
5. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Permission Risk Level</summary>

Follow these steps to filter by permission risk level:

1. Click the **More Filters** dropdown menu.
2. Select **Permission Risk Level**.
3. From the dropdown menu, select the [comparative logic](#comparative-logic):
   * **Equals (=)**
   * **Not Equals (!=)**
4. Select one or several pemission risk level. Only the values meeting the criteria will be shown.
5. Click the top or outside of the dropdown menu to close it.

</details>

<details>

<summary>Comparative Logic</summary>

<table><thead><tr><th width="180">Logic</th><th>Description</th></tr></thead><tbody><tr><td><strong>Equals (=)</strong></td><td><p>Checks if values are the same</p><p><strong>Examples</strong>:</p><ul><li><strong>Resource Type</strong> equals <strong>DynamoDB Table</strong></li><li><strong>Resource Status</strong> equals <strong>ACTIVE</strong></li></ul><p>After filtering by this value, you can select the exact resources to include in your filtered query.</p></td></tr><tr><td><strong>Not Equals (!=)</strong></td><td><p>Checks if values are different</p><p><strong>Examples</strong>:</p><ul><li><strong>Integration</strong> does not equal <strong>AWS Playground</strong></li><li><strong>Resource Type</strong> does not equal <strong>S3 Bucket</strong></li></ul><p>After filtering by this value, you can select the exact resources to include in your filtered query.</p></td></tr><tr><td><strong>Contains (a*b)</strong></td><td><p>Checks if a value contains another value as a substring or pattern</p><p><strong>Examples</strong>:</p><ul><li><strong>Resource Name</strong> contains <em>playground</em></li><li><strong>Resource Tag</strong> contains <em>true</em></li></ul></td></tr><tr><td><strong>Does not contain (!a*b)</strong></td><td><p>Checks if a value does NOT contain another value as a substring or pattern</p><p><strong>Examples</strong>:</p><ul><li><strong>Resource Name</strong> does not contain <em>production</em></li><li><strong>Permission Name</strong> does not contain <em>admin</em></li></ul></td></tr><tr><td><strong>Starts with (*b)</strong></td><td><p>Checks if a value begins with a specific value or pattern</p><p><strong>Examples</strong>:</p><ul><li><strong>Resource Name</strong> starts with <em>aws</em></li><li><strong>Resource Tag</strong> for a <strong>region</strong> starts with <em>eu</em></li></ul></td></tr><tr><td><strong>Ends with (a*)</strong></td><td><p>Checks if a value ends with a specific value or pattern</p><p><strong>Examples</strong>:</p><ul><li><strong>Resource Name</strong> ends with <em>terraform-state</em></li><li><strong>Resource Tag</strong> for an <strong>env</strong> ends with <em>dev</em></li></ul></td></tr></tbody></table>

</details>

2. Click **+**. The **Create Space Access Scope** pop-up window appears.
3. Enter a **Space Access Scope Name**.
4. Click **Create Space Access Scope**.
5. (Optional) Repeat steps **1-4** to create an additional space access scope.
6. Select one or more space access scopes.

{% hint style="info" %}
When multiple space access scopes are selected, they are combined with `OR` logic. The space will include all resources matching any selected scope.

Global account access scopes cannot be used to define a space’s inventory.
{% endhint %}

7. Click **Update Space with X scopes**.

***

### Manage members

{% hint style="info" %}
Only Admin and Space Owner users can manage space membership.
{% endhint %}

#### Add a member

Follow these steps to add a member to an existing space:

1. On the [**Spaces Management**](https://app.apono.io/spaces) page, click <img src="https://1094436629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv6MBfUGvblSdAz31yJXm%2Fuploads%2Fgit-blob-3a3d063ed9ae2352a93c4de436aa89148cded8d4%2Funknown%20(1).png?alt=media" alt="" data-size="line"> (pencil icon) on the space tile. The **Edit Space** page opens.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>You can also click <strong>Space Settings</strong> at the top right of the screen to access the <strong>Spaces Management</strong> page.</p></div>
2. Click **Invite User**. The **Select Space Members** pop-up window appears.
3. In the **User** field, select one or more users to assign to a role.
4. Select a **Role** option.

<table><thead><tr><th width="236.9609375">Role</th><th>Description</th></tr></thead><tbody><tr><td><strong>Space Owner</strong></td><td><p>Can perform the following tasks:</p><ul><li>Add and remove users from a space</li><li>Manage access objects within a space</li></ul></td></tr><tr><td><strong>Space Manager</strong></td><td><p>Can perform the following task:</p><ul><li>Manage access objects within a space</li></ul></td></tr></tbody></table>

4. Click **Done**. The selected users and roles appear in the summary pane.
5. Click **Save Changes**. The pop-up window closes.
6. Click **Next**.
7. Click **Update Space with X Scopes**. The **Spaces Management** page appears with updates made to the space tile.

#### Remove a member

Follow these steps to remove a member:

1. On the [**Spaces Management**](https://app.apono.io/spaces) page, click <img src="https://1094436629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv6MBfUGvblSdAz31yJXm%2Fuploads%2Fgit-blob-3a3d063ed9ae2352a93c4de436aa89148cded8d4%2Funknown%20(1).png?alt=media" alt="" data-size="line"> (pencil icon) on the space tile. The **Edit Space** page opens.

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>You can also click <strong>Space Settings</strong> at the top right of the screen to access the <strong>Spaces Management</strong> page.</p></div>
2. Under **Space Members**, click <img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAkCAYAAACaJFpUAAAEo0lEQVR4AYRWvU4jSRCucYqPc4R0iy0d8TrlLyDaS/ckxDNAhvchlnuAM8+wJoGcV4AEr+RLSMytkFgTEeBL8OH9vqru6u6x0Y6qqr/66q+nZ0aaxry4XjMPGJIRCTrvIMUUvcXP5w3Jr3klc/eBK3dK4LwDjee1ShQGUUgxEPMkb4GRRUlyUGmSKCDNz3lg0EHQGVIMhB+CcSkZrw87K6OoqfMLCSLFwOw8UR1lLre3tzIcDuXr8EbXm69DXYfgbqBD8MwpjieW19ZyYFWL6g4quby8lMFgIIMvZ7qeDb7oOgB3Bh0MzjSnXk3fTwUOsQ58fHyUq6urJXqt3PPzM9IhviEHwj2xEXOKHtdXco2eVPKcwSodOB6P5eLi4g09l6enJ0yjoDWEyBVdIJrjPc7RC3rOnljJj8d3WqIDu92u9Ho9VbLd99E/lt7xJ+UtDvyJeeS5Bj0Oaw88+yCHPXn3PeAe+G73PV17aVZWVqTdbqty4Eoz+h1pd8ivS4zruh55xtqyrjnE4EOfFfTkS9tus7Yj9PnZ6B3WT4lDqYlnKhkoSDYCcuGR0kEIi1mA8NLGqDE6MKdIR8352cuL3N/fy/S/aWgkMp1OlXuZvWiJ5ZtVAsbGm4VrR0pgigDES4AjP5lMpN/vy2j0j1Gwo9FIucn3CbzlYr3MMqOhT5JIFQGIzwFW2u+Jnkfp/EQXcxv15xE7LKbGyE9WFEJCku9Yv1eSDX0dUgY51Zi6JKTxtwxvINYWOYHESwME8S3ErDBJQ5Erz99ZrUU+pDj8LMEhBkZctvZKdokp3L7jCLii1oRO2pbXAkAYzAbSNUWtAdrceQszjxqa6mOCn/aHQgio+mehh+M7DPVGMpsaCgl5CpYDC6GvfJgUBysXzMId5kmxd6i3EjY2JBWw5aDKgEUU01BJIZELdGGgpG1KvBbKUA/BScSIeJX4xQw6XLEhQuiSgWBVUjN1YZwBgICZYygWCvtypeY4bMXyJXuGeVLFqqDOO0AgYU91gLBiGKRBQJgFyAYi7m+HxtWIbZA4HUsgRS+GFNQNAugJQcAsAAaCJ1D1t4MJiwPIMi8vsQ2BLUhxWnB5CKBRRGLH8GSiizyUJcm3oiwTYrISflbqaSjkNJSBA1GYTGK8wIPKuFdsOrFh2+hDCSU2EM7Crmtdmr80ZXt7W9bW1rwlMblms6kc+uoaJlkHPibtjxASbCCwWFjKCxmBaLV+lYODA9nY2AiMyO/A5FqtlnLoq2vRykmEgDHQmpoFCQEPS8aQPZGILWRRWAgYl5prfEZioDUyK7K6uir/fvsm/7++WrKeT4yCYjHcKvLAYFVCSGazmdzd3Umn0zE+y8FA5dzs7OzIw8OD/PX5RP9X+v1T+Rv/Mv2op33nnUOMOadYyX0+OZHJ5LtsbW1pX9ucQnyHtgY7lw9/fJD9/X357d07O0lEdIPcPrCTimECnzddR+3Hj3/K5uYmEijagcAGhhr0qvC8K9nd3ZXDw0Oxv2b7qz7WP2hi/H3z75rKP+4l/NHRkezt7UkDPzA6JTN6pFUkHEQCW4HQ01DA9Kl847kmrSVg+ylm6AcAAAD//5ikkPQAAAAGSURBVAMA768n8mMsAQgAAAAASUVORK5CYII=" alt="" data-size="line"> (trash icon) next to the member's name.
3. Click **Next**.
4. Click **Update Space with X Scopes**. The **Spaces Management** page appears with updates made to the space tile.

***

### Rename a space

Follow these steps to rename a space:

1. On the [**Spaces Management**](https://app.apono.io/spaces) page, click <img src="https://1094436629-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv6MBfUGvblSdAz31yJXm%2Fuploads%2Fgit-blob-3a3d063ed9ae2352a93c4de436aa89148cded8d4%2Funknown%20(1).png?alt=media" alt="" data-size="line"> (pencil icon) on the space tile. The **Edit Space** page opens.

{% hint style="success" %}
You can also click **Space Settings** at the top right of the screen to access the **Spaces Management** page.
{% endhint %}

2. Enter a new **Space name**. The name should be unique and reflect the environment or group that will own it.
3. Click **Next**.
4. Click **Update Space with X Scopes**. The **Spaces Management** page appears with updates made to the space tile.
