> ## Documentation Index
> Fetch the complete documentation index at: https://prefect-bd373955-codex-docket-background-task-ha.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

#  

# `prefect global-concurrency-limit`

```command theme={null}
prefect global-concurrency-limit [OPTIONS] COMMAND [ARGS]...
```

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

## `prefect global-concurrency-limit ls`

```command theme={null}
prefect global-concurrency-limit 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 global-concurrency-limit inspect`

```command theme={null}
prefect global-concurrency-limit 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 global-concurrency-limit delete`

```command theme={null}
prefect global-concurrency-limit delete [OPTIONS] NAME
```

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

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

## `prefect global-concurrency-limit enable`

```command theme={null}
prefect global-concurrency-limit enable [OPTIONS] NAME
```

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

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

## `prefect global-concurrency-limit disable`

```command theme={null}
prefect global-concurrency-limit disable [OPTIONS] NAME
```

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

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

## `prefect global-concurrency-limit update`

```command theme={null}
prefect global-concurrency-limit 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 global-concurrency-limit create`

```command theme={null}
prefect global-concurrency-limit 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>