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

#  

# `prefect gcl`

```command theme={null}
prefect gcl [OPTIONS] COMMAND [ARGS]...
```

<Info>
  Manage global concurrency limits.
</Info>

## `prefect gcl ls`

```command theme={null}
prefect gcl ls [OPTIONS]
```

<Info>
  List all global concurrency limits.
</Info>

<AccordionGroup>
  <Accordion title="Options" defaultOpen>
    <ResponseField name="--output">
      Specify an output format. Currently supports: json
    </ResponseField>
  </Accordion>
</AccordionGroup>

## `prefect gcl inspect`

```command theme={null}
prefect gcl inspect [OPTIONS] NAME
```

<Info>
  Inspect a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>

  <Accordion title="Options" defaultOpen>
    <ResponseField name="--output">
      Specify an output format. Currently supports: json
    </ResponseField>

    <ResponseField name="--file">
      Path to .json file to write the global concurrency limit output to.
    </ResponseField>
  </Accordion>
</AccordionGroup>

## `prefect gcl delete`

```command theme={null}
prefect gcl delete [OPTIONS] NAME
```

<Info>
  Delete a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>
</AccordionGroup>

## `prefect gcl enable`

```command theme={null}
prefect gcl enable [OPTIONS] NAME
```

<Info>
  Enable a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>
</AccordionGroup>

## `prefect gcl disable`

```command theme={null}
prefect gcl disable [OPTIONS] NAME
```

<Info>
  Disable a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>
</AccordionGroup>

## `prefect gcl update`

```command theme={null}
prefect gcl update [OPTIONS] NAME
```

<Info>
  Update a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>

  <Accordion title="Options" defaultOpen>
    <ResponseField name="--enable">
      Enable the global concurrency limit.
    </ResponseField>

    <ResponseField name="--disable">
      Disable the global concurrency limit.
    </ResponseField>

    <ResponseField name="--limit">
      The limit of the global concurrency limit.
    </ResponseField>

    <ResponseField name="--active-slots">
      The number of active slots.
    </ResponseField>

    <ResponseField name="--slot-decay-per-second">
      The slot decay per second.
    </ResponseField>
  </Accordion>
</AccordionGroup>

<Note>
  **Example:**

  ```bash theme={null}
  $ prefect global-concurrency-limit update my-gcl --limit 10
  $ prefect gcl update my-gcl --active-slots 5
  $ prefect gcl update my-gcl --slot-decay-per-second 0.5
  $ prefect gcl update my-gcl --enable
  $ prefect gcl update my-gcl --disable --limit 5
  ```
</Note>

## `prefect gcl create`

```command theme={null}
prefect gcl create [OPTIONS] NAME
```

<Info>
  Create a global concurrency limit.
</Info>

<AccordionGroup>
  <Accordion title="Arguments" defaultOpen>
    <ResponseField name="NAME" type="string" required />
  </Accordion>

  <Accordion title="Options" defaultOpen>
    <ResponseField name="--limit">
      The limit of the global concurrency limit.
    </ResponseField>

    <ResponseField name="--disable">
      Create an inactive global concurrency limit.
    </ResponseField>

    <ResponseField name="--active-slots">
      The number of active slots.
    </ResponseField>

    <ResponseField name="--slot-decay-per-second">
      The slot decay per second.
    </ResponseField>
  </Accordion>
</AccordionGroup>

<Note>
  **Example:**

  ```bash theme={null}
  $ prefect global-concurrency-limit create my-gcl --limit 10
  $ prefect gcl create my-gcl --limit 5 --active-slots 3
  $ prefect gcl create my-gcl --limit 5 --active-slots 3 --slot-decay-per-second 0.5
  $ prefect gcl create my-gcl --limit 5 --disable
  ```
</Note>