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

# gvc

> cpln gvc — Manage Global Virtual Clouds (GVCs) that define multi-cloud deployment environments.

Manage global virtual clouds

For a detailed overview, please visit the [gvc's](/reference/gvc) reference page.

```none theme={null}
cpln gvc [SUBCOMMAND]
```

```text theme={null}
Commands:
  cpln gvc access-report <ref>         Show the access report for the referenced global virtual cloud
  cpln gvc add-location <ref>          Add one or more locations to the referenced global virtual cloud
  cpln gvc audit [ref]                 Retrieve audit trail events for the referenced global virtual cloud
  cpln gvc clone <ref>                 Create a clone of the referenced global virtual cloud; this will only duplicate its spec.  [aliases: copy]
  cpln gvc create                      Create a new global virtual cloud
  cpln gvc delete <ref...>             Delete GVCs by name
  cpln gvc delete-all-workloads <ref>  Delete all workloads for the referenced global virtual cloud
  cpln gvc edit <ref>                  Edit the referenced global virtual cloud, as YAML, within an editor
  cpln gvc eventlog <ref>              Show the event log of the referenced global virtual cloud  [aliases: log]
  cpln gvc get [ref...]                Retrieve one or more referenced global virtual clouds
  cpln gvc patch <ref>                 Update the referenced global virtual cloud's metadata using an input file
  cpln gvc permissions                 Show the grantable permissions for a global virtual cloud object type
  cpln gvc query                       Find all the global virtual clouds based on the given query
  cpln gvc remove-location <ref>       Remove one or more locations from the referenced global virtual cloud
  cpln gvc tag <ref...>                Manage the tags belonging to one or more referenced global virtual clouds
  cpln gvc update <ref>                Update properties of the referenced global virtual cloud

Options:
  --help  Show help  [boolean]
```

***

#### gvc access-report

Show the access report for the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc access-report <ref> [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Display the user / service account / group permissions for the 'demo-gvc' global virtual cloud within the 'demo-cpln-organization' organization

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc access-report demo-gvc --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +----------------------+--------------------------------------------------------+--------+
    |PERMISSION            |PRINCIPAL                                               |GRANTED |
    |----------------------|--------------------------------------------------------|--------|
    |configureLoadBalancer |/org/demo-cpln-organization/group/superusers            |manage  |
    |configureLoadBalancer |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    |create                |/org/demo-cpln-organization/group/superusers            |manage  |
    |create                |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    |delete                |/org/demo-cpln-organization/group/superusers            |manage  |
    |delete                |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    |edit                  |/org/demo-cpln-organization/group/superusers            |manage  |
    |edit                  |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    |manage                |/org/demo-cpln-organization/group/superusers            |manage  |
    |manage                |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    |view                  |/org/demo-cpln-organization/group/viewers               |view    |
    |view                  |/org/demo-cpln-organization/group/superusers            |manage  |
    |view                  |/org/demo-cpln-organization/serviceaccount/controlplane |manage  |
    +----------------------+--------------------------------------------------------+--------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc add-location

Add one or more locations to the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc add-location <ref...> --location {aws-eu-central-1|aws-us-west-2|azure-eastus2|gcp-us-east1} [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Command options:
    --location  Location to add  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <Note>
    The gvc, named 'demo-gvc', in the examples below was already created with 'aws-eu-central-1' as one of its locations.
  </Note>

  * Add one location to a global virtual cloud

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc add-location demo-gvc --location aws-us-west-2 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Add multiple locations to a global virtual cloud

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc add-location demo-gvc --location aws-us-west-2 --location gcp-us-east1 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    |         |            |              |              |       |gcp-us-east1     |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc audit

Retrieve audit trail events for the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc audit [ref] [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.

  Command options:
    --subject  Filter by subject (serviceaccount name or user email)  [string]
    --context  Audit context name (the 'cpln' context displays Control Plane actions)  [string] [default: "cpln"]
    --since    Relative lookback window from now (e.g., 1h, 24h, 7d). Mutually exclusive with --from/--to  [string] [default: "7d"]
    --from     Start time for audit events (ISO 8601 format or relative duration, e.g., 2025-10-23T07:00:00Z, 7d, 1h). Cannot be used with --since  [string]
    --to       End time for audit events (ISO 8601 format or relative duration, e.g., 2025-10-23T07:00:00Z, 1d, 30m)  [string]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

***

#### gvc clone

Create a clone of the referenced global virtual cloud; this will only duplicate its spec.

**Usage**

```none theme={null}
cpln gvc clone <ref> --name CLONE_NAME [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Command options:
    --name         Set the name for the clone  [required]
    --description  Optional description, defaults to the name if not set
    --tag          Attach tags (e.g., --tag drink=water)

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc clone demo-gvc --name demo-gvc-clone --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+------------------+--------+--------------+-------+-----------------+--------------+
    |NAME           |DESCRIPTION       |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------------|------------------|--------|--------------|-------|-----------------|--------------|
    |demo-gvc-clone |Clone of demo-gvc |Now     |4cd9jzycr84r6 |       |aws-eu-central-1 |drink="water" |
    |               |                  |        |              |       |aws-us-west-2    |              |
    |               |                  |        |              |       |gcp-us-east1     |              |
    +---------------+------------------+--------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc create

Create a new global virtual cloud

**Usage**

```none theme={null}
cpln gvc create --name GVC_NAME --location {aws-eu-central-1|aws-us-west-2|azure-eastus2|gcp-us-east1} [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Command options:
    --name                 Name of the new global virtual cloud  [required]
    --description, --desc  Optional description, defaults to the name if not set
    --location             One or more locations to associate with this new global virtual cloud  [required]
    --env                  Environment variables in KEY=VALUE format
    --tag                  Attach tags (e.g., --tag drink=water)

  Query spec options:
    --query-match     Query filter type  [choices: "all", "none", "any"] [default: "all"]
    --query-property  Property to query
    --query-tag       Tag to query
    --query-rel       Relation to query

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Options">
  * `name`
    * Minimum Length: 3
    * Maximum Length: 64
    * Only lowercase characters
    * Must begin with a character
    * Allowed special characters: -
</Accordion>

<Accordion title="Example">
  * Create an new GVC with a single location

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc create --name demo-gvc --location aws-eu-central-1 --desc demo-gvc --tag drink=water --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |Now     |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    +---------+------------+--------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc delete

Delete GVCs by name

**Usage**

```none theme={null}
cpln gvc delete <ref...> [OPTIONS]
```

<Warning>
  Deleting a gvc will remove all associated resources (workloads, etc.)
</Warning>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  One or more resource references. Usually it is the name of the resource.  [array] [required] [default: []]

  Command options:
    --force  Bypass warnings and/or safety checks  [boolean]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Delete a gvc

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc delete demo-gvc-delete-1 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    If the delete was successful, a new command prompt will be shown.
    ```
  </CodeGroup>

  * Delete multiple gvcs

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc delete demo-gvc-delete-1 demo-gvc-delete-2 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    If the delete was successful, a new command prompt will be shown.
    ```
  </CodeGroup>
</Accordion>

***

#### gvc delete-all-workloads

Delete all workloads for the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc delete-all-workloads <ref> [OPTIONS]
```

<Warning>
  Deleting all the associated workloads will remove all associated resources (containers, etc.)
</Warning>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Delete all workloads

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc delete-all-workloads demo-gvc-with-workloads --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +------------+------------+------------------------+------+--------+-----------------------------------------------------------+-----+
    |NAME        |DESCRIPTION |GVC                     |READY |CREATED |ENDPOINT                                                   |TAGS |
    |------------|------------|------------------------|------|--------|-----------------------------------------------------------|-----|
    |workload-01 |workload-01 |demo-gvc-with-workloads |      |Now     |https://workload-01-gbk7360b8014a.geta3p46gfrsp.t.cpln.app |     |
    |workload-02 |workload-02 |demo-gvc-with-workloads |      |Now     |https://workload-02-gbk7360b8014a.geta3p46gfrsp.t.cpln.app |     |
    +------------+------------+------------------------+------+--------+-----------------------------------------------------------+-----+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc edit

Edit the referenced global virtual cloud, as YAML, within an editor

**Usage**

```none theme={null}
cpln gvc edit <ref> [OPTIONS]
```

<Note>
  The default editor can be set by using the EDITOR environment variable.
</Note>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Command options:
    --replace, -r  Replace instead of patch/merge  [boolean] [default: false]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc edit demo-gvc --org demo-cpln-organization
    ```

    ```text Output theme={null}
    Your default editor will be launched.

    Once any modifications are saved, the updates will be sent to the API.
    ```
  </CodeGroup>
</Accordion>

***

#### gvc eventlog

Show the event log of the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc eventlog <ref> [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc eventlog demo-gvc --org demo-cpln-organization
    ```

    ```text Output theme={null}
    The event log for the referenced gvc will be shown.
    ```
  </CodeGroup>
</Accordion>

***

#### gvc get

Retrieve one or more referenced global virtual clouds

**Usage**

```none theme={null}
cpln gvc get [ref...] [OPTIONS]
```

<Note>
  An empty reference will return all references
</Note>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  One or more resource references. Usually it is the name of the resource.  [array] [default: []]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Get all gvcs

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc get --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +------------------------+------------------------+--------------+--------------+-------+-----------------+--------------+
    |NAME                    |DESCRIPTION             |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |------------------------|------------------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc                |demo-gvc                |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |                        |                        |              |              |       |aws-us-west-2    |              |
    |                        |                        |              |              |       |gcp-us-east1     |              |
    |demo-gvc-get-1          |demo-gvc-get-1          |Now           |my99wkdkdpdka |       |aws-eu-central-1 |              |
    |demo-gvc-get-2          |demo-gvc-get-2          |Now           |jn06ygppyrqtt |       |aws-eu-central-1 |              |
    |demo-gvc-identity       |demo-gvc-identity       |4 minutes ago |n3rttpnb7vrym |       |aws-eu-central-1 |              |
    |demo-gvc-with-workloads |demo-gvc-with-workloads |Now           |gbk7360b8014a |       |aws-eu-central-1 |              |
    |demo-gvc-workload       |demo-gvc-workload       |4 minutes ago |jdjx75ayrp1ke |       |aws-eu-central-1 |              |
    +------------------------+------------------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Get one gvc

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc get demo-gvc-get-1 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |---------------|---------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-get-1 |demo-gvc-get-1 |Now     |my99wkdkdpdka |       |aws-eu-central-1 |     |
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>

  * Get multiple gvcs

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc get demo-gvc-get-1 demo-gvc-get-2 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |---------------|---------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-get-1 |demo-gvc-get-1 |Now     |my99wkdkdpdka |       |aws-eu-central-1 |     |
    |demo-gvc-get-2 |demo-gvc-get-2 |Now     |jn06ygppyrqtt |       |aws-eu-central-1 |     |
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc patch

Update the referenced global virtual cloud's metadata using an input file

**Usage**

```none theme={null}
cpln gvc patch <ref> --file FILE_NAME [OPTIONS]
```

<Note>
  Running this command with the option **`--file -`** sets the input to stdin. The input is required to be a valid JSON or YAML string (e.g., `{"description": "My new description"}` or `description: My new description`). To complete the update, press Control-D (or Control-Z if you are using Windows).
</Note>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Command options:
    --file, -f  File to load the patch from. Use `--file -` to enable input from stdin.  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc patch demo-gvc --file update.json --org demo-cpln-organization
    ```

    ```text Output theme={null}
    The changes within the JSON file will be performed against the referenced gvc.
    ```
  </CodeGroup>
</Accordion>

***

#### gvc permissions

Show the grantable permissions for a global virtual cloud object type

**Usage**

```none theme={null}
cpln gvc permissions [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc permissions --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +----------------------+---------------------------+----------------------------------------------------------+
    |NAME                  |DESCRIPTION                |IMPLIES                                                   |
    |----------------------|---------------------------|----------------------------------------------------------|
    |configureLoadBalancer |Principal can configure LB |                                                          |
    |create                |Create new gvcs            |                                                          |
    |delete                |Delete existing gvcs       |                                                          |
    |edit                  |Modify existing gvcs       |view                                                      |
    |manage                |Full access                |configureLoadBalancer, create, delete, edit, manage, view |
    |view                  |Read-only access           |                                                          |
    +----------------------+---------------------------+----------------------------------------------------------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc query

Find all the global virtual clouds based on the given query

**Usage**

```none theme={null}
cpln gvc query QUERY_OPTIONS [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Query options:
    --match             Query filter type  [choices: "all", "none", "any"] [default: "all"]
    --property, --prop  Property to query
    --tag               Tag to query
    --rel               Relation to query

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <Note>
    Use the `--match` option to display **all**, **none**, or **any** of the results based on a given property or tag
  </Note>

  * Search for a gvc based on the name property

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc query --match any --prop name=demo-gvc --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    |         |            |              |              |       |gcp-us-east1     |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Search for a gvc based on the description property

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc query --match any --prop description="demo-gvc" --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    |         |            |              |              |       |gcp-us-east1     |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Search for a gvc based on a tag

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc query --match any --tag drink=water --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    |         |            |              |              |       |gcp-us-east1     |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Search for a gvc based on a property and tag

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc query --match any --prop description="demo-gvc" --tag drink=water --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    |NAME     |DESCRIPTION |CREATED       |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------|------------|--------------|--------------|-------|-----------------|--------------|
    |demo-gvc |demo-gvc    |4 minutes ago |xm35gdrqcxs4r |       |aws-eu-central-1 |drink="water" |
    |         |            |              |              |       |aws-us-west-2    |              |
    |         |            |              |              |       |gcp-us-east1     |              |
    +---------+------------+--------------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc remove-location

Remove one or more locations from the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc remove-location <ref...> --location {aws-eu-central-1|aws-us-west-2|azure-eastus2|gcp-us-east1} [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Command options:
    --location  Location to remove  [required]

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  <Note>
    The gvc, named 'demo-gvc-with-locations', in the examples below was already created with four locations. A gvc must have at least one location.
  </Note>

  * Remove one location from a global virtual cloud

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc remove-location demo-gvc-with-locations --location azure-eastus2 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +------------------------+------------------------+--------+--------------+-------+-----------------+-----+
    |NAME                    |DESCRIPTION             |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |------------------------|------------------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-with-locations |demo-gvc-with-locations |Now     |h015zhrqkdaq2 |       |aws-eu-central-1 |     |
    |                        |                        |        |              |       |aws-us-west-2    |     |
    |                        |                        |        |              |       |gcp-us-east1     |     |
    +------------------------+------------------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>

  * Remove multiple locations from a global virtual cloud

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc remove-location demo-gvc-with-locations --location aws-us-west-2 --location aws-eu-central-1 --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +------------------------+------------------------+--------+--------------+-------+-------------+-----+
    |NAME                    |DESCRIPTION             |CREATED |ALIAS         |DOMAIN |LOCATIONS    |TAGS |
    |------------------------|------------------------|--------|--------------|-------|-------------|-----|
    |demo-gvc-with-locations |demo-gvc-with-locations |Now     |h015zhrqkdaq2 |       |gcp-us-east1 |     |
    +------------------------+------------------------+--------+--------------+-------+-------------+-----+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc tag

Manage the tags belonging to one or more referenced global virtual clouds

**Usage**

```none theme={null}
cpln gvc tag <ref...> --tag KEY=VALUE [OPTIONS]
```

<Note>
  Built-in tags, which begin with cpln/\*, can't be modified.
</Note>

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  One or more resource references. Usually it is the name of the resource.  [array] [required] [default: []]

  Command options:
    --tag         Attach tags (e.g., --tag drink=water)
    --remove-tag  Remove tags (e.g., --remove-tag tagname)

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Example">
  * Add a tag to a gvc

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 --tag drink=water --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+--------------+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS          |
    |---------------|---------------|--------|--------------|-------|-----------------|--------------|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |drink="water" |
    +---------------+---------------+--------+--------------+-------+-----------------+--------------+
    ```
  </CodeGroup>

  * Update same tag (after running the example above)

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 --tag drink=coffee --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+---------------+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS           |
    |---------------|---------------|--------|--------------|-------|-----------------|---------------|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |drink="coffee" |
    +---------------+---------------+--------+--------------+-------+-----------------+---------------+
    ```
  </CodeGroup>

  * Remove tag (after running the example above)

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 --remove drink --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |---------------|---------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |     |
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>

  * Add same tag to multiple gvcs

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 demo-gvc-tag-2 --tag multiple-gvcs=true --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+---------------------+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS                 |
    |---------------|---------------|--------|--------------|-------|-----------------|---------------------|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |multiple-gvcs="true" |
    |demo-gvc-tag-2 |demo-gvc-tag-2 |Now     |gss9y149jdtbr |       |aws-eu-central-1 |multiple-gvcs="true" |
    +---------------+---------------+--------+--------------+-------+-----------------+---------------------+
    ```
  </CodeGroup>

  * Update same tag on multiple gvcs (after running the example above)

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 demo-gvc-tag-2 --tag multiple-gvcs=demo-gvc --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+-------------------------+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS                     |
    |---------------|---------------|--------|--------------|-------|-----------------|-------------------------|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |multiple-gvcs="demo-gvc" |
    |demo-gvc-tag-2 |demo-gvc-tag-2 |Now     |gss9y149jdtbr |       |aws-eu-central-1 |multiple-gvcs="demo-gvc" |
    +---------------+---------------+--------+--------------+-------+-----------------+-------------------------+
    ```
  </CodeGroup>

  * Remove same tag from multiple gvcs (after running the example above)

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc tag demo-gvc-tag-1 demo-gvc-tag-2 --remove multiple-gvcs --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    |NAME           |DESCRIPTION    |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |---------------|---------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-tag-1 |demo-gvc-tag-1 |Now     |4zqnz1z5ryhmg |       |aws-eu-central-1 |     |
    |demo-gvc-tag-2 |demo-gvc-tag-2 |Now     |gss9y149jdtbr |       |aws-eu-central-1 |     |
    +---------------+---------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>
</Accordion>

***

#### gvc update

Update properties of the referenced global virtual cloud

**Usage**

```none theme={null}
cpln gvc update <ref> --set UPDATE_PROPERTY [OPTIONS]
```

<Accordion title="Reference">
  ```text theme={null}
  Positionals:
    ref  The resource reference. Usually it is the name of the resource.  [required]

  Update Properties:
    --set    Update the following properties (e.g., --set description="Updated Description"):

             description                           string
             tags.<key>                            string
             spec.pullSecretLinks                  string[]
             spec.staticPlacement.locationLinks    string[]
             spec.tracing.sampling                 number
             spec.tracing.lightstep.endpoint       string
             spec.tracing.lightstep.credentials    string[]
             spec.env.<name>.value                 string

             Arrays can be appended to, replaced, or removed using the `+=`, `=`, or `-=` operators, respectively.
    --unset  Unset a property (same paths as --set, e.g., --unset description)

  Context options:
    --profile  Override the profile. The default profile can be set using the `cpln profile set-default` command or by setting the CPLN_PROFILE environment variable
    --org      Override the organization. The default organization can be set in your profile by using the `cpln profile update` command

  Format options:
    --output, -o  Set the output format  [choices: "text", "json", "yaml", "json-slim", "yaml-slim", "tf", "crd", "names"]
    --color       Colorize the output  [boolean] [default: true]
    --ts          Timestamp format if the output format is text (e.g., --output=text)  [choices: "iso", "local", "age"]
    --max         Maximum number of records to show. A value less than 1 will return all records.  [number] [default: 50]

  Request options:
    --token         Override the authorization token
    --endpoint      Override the API URL
    --insecure, -k  Ignore TLS errors  [boolean]

  Debug options:
    --verbose, -v  Enable verbose output to stderr  [boolean] [default: false]
    --debug, -d    Show all HTTP communications  [boolean] [default: false]

  Options:
    --help  Show help  [boolean]
  ```

  [Common Options Reference](/cli-reference/using-cli/common-options)
</Accordion>

<Accordion title="Options">
  * The `--set` option allows the modification of the following global virtual cloud properties:
    * `description`
      * Description of the global virtual cloud
      * Type: string
    * `tags`
      * Tags (key=value) associated with the global virtual cloud
      * Type: string
    * `spec.pullSecretLinks`
      * Array of pull secret links belonging to the global virtual cloud
      * Type: string\[]
    * `spec.domain`
      * The domain linked to this global virtual cloud
      * Type: string
    * `spec.staticPlacement.locationLinks`
      * Array of location links belonging to the global virtual cloud
      * Type: string\[]
</Accordion>

<Accordion title="Example">
  * For the examples below, the initial gvc is configured as:

  ```
  +----------------+----------------+--------+--------------+-------+-----------------+-----+
  |NAME            |DESCRIPTION     |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
  |----------------|----------------|--------|--------------|-------|-----------------|-----|
  |demo-gvc-update |demo-gvc-update |Now     |yaxkyn1t4gd3e |       |aws-eu-central-1 |     |
  +----------------+----------------+--------+--------------+-------+-----------------+-----+
  ```

  * Update a gvc's description

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc update demo-gvc-update --set description="new description" --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +----------------+----------------+--------+--------------+-------+-----------------+-----+
    |NAME            |DESCRIPTION     |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS |
    |----------------|----------------|--------|--------------|-------|-----------------|-----|
    |demo-gvc-update |new description |Now     |yaxkyn1t4gd3e |       |aws-eu-central-1 |     |
    +----------------+----------------+--------+--------------+-------+-----------------+-----+
    ```
  </CodeGroup>

  * Update a gvc's tag

  <CodeGroup>
    ```bash Command theme={null}
    cpln gvc update demo-gvc-update --set tags.demo-key=demo-value --org demo-cpln-organization
    ```

    ```text Output theme={null}
    +----------------+----------------+--------+--------------+-------+-----------------+----------------------+
    |NAME            |DESCRIPTION     |CREATED |ALIAS         |DOMAIN |LOCATIONS        |TAGS                  |
    |----------------|----------------|--------|--------------|-------|-----------------|----------------------|
    |demo-gvc-update |new description |Now     |yaxkyn1t4gd3e |       |aws-eu-central-1 |demo-key="demo-value" |
    +----------------+----------------+--------+--------------+-------+-----------------+----------------------+
    ```
  </CodeGroup>
</Accordion>

***