# Service Usage CLI reference

Source: `@socra/service-cli@0.1.0`.

This reference includes every command, argument, and option declared by this released package. Defaults and accepted values are included where the package declares them. Command-specific validation and permissions also apply; see the [API reference](/docs/service/reference/api) for resource contracts.

Use `socra service --help`, or append `--help` to any command, to inspect the locally installed version.

## socra service

Manage services and query their usage for projects

| Command | Purpose |
| --- | --- |
| `socra service list` | List enabled services by default, or all available services |
| `socra service enable` | Enable a service on a project |
| `socra service disable` | Disable a service on a project |
| `socra service usage` | Query service usage for a project |

## socra service list

List enabled services by default, or all available services

```text
socra service list [options]
```

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--project` | Value | Target project id |
| `--available` | Presence flag | List available services |
| `--enabled` | Presence flag | List enabled services |
| `--limit` | Value | Page size |
| `--after` | Value | Page cursor |

## socra service enable

Enable a service on a project

```text
socra service enable <service> [options]
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `service` | Yes | Service name |

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--project` | Value | Target project id |

## socra service disable

Disable a service on a project

```text
socra service disable <service> [options]
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `service` | Yes | Service name |

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--project` | Value | Target project id |

## socra service usage

Query service usage for a project

```text
socra service usage <service> [options]
```

### Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `service` | Yes | Service name |

### Options

| Option | Input | Description |
| --- | --- | --- |
| `--project` | Value | Target project id |
| `--metric` | Value | Metric name |
| `--since` | Value | Window start (ISO 8601) |
| `--until` | Value | Window end (ISO 8601) |
| `--interval` | Value | hour or day |

## Next step

Return to the [Service Usage overview](/docs/service).

---

Company: Socra — Multiply Your Judgment
Canonical URL: https://cloud.socra.com/docs/service/reference/cli