Skip to content

Commit 266797d

Browse files
committed
doc updates
1 parent 02ebc75 commit 266797d

File tree

316 files changed

+6519
-5516
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

316 files changed

+6519
-5516
lines changed

docs/github-docs/index.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,20 +13,22 @@ custom_edit_url: null
1313
image: /img/providers/github/stackql-github-provider-featured-image.png
1414
id: github-doc
1515
slug: /providers/github
16-
1716
---
17+
18+
import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';
19+
1820
Web-based version-control and collaboration.
1921

20-
:::info Provider Summary (v23.09.00175)
22+
:::info Provider Summary (v24.04.00227)
2123

2224
<div class="row">
2325
<div class="providerDocColumn">
2426
<span>total services:&nbsp;<b>31</b></span><br />
25-
<span>total methods:&nbsp;<b>883</b></span><br />
27+
<span>total methods:&nbsp;<b>885</b></span><br />
2628
</div>
2729
<div class="providerDocColumn">
28-
<span>total resources:&nbsp;<b>278</b></span><br />
29-
<span>total selectable resources:&nbsp;<b>273</b></span><br />
30+
<span>total resources:&nbsp;<b>281</b></span><br />
31+
<span>total selectable resources:&nbsp;<b>276</b></span><br />
3032
</div>
3133
</div>
3234

@@ -49,8 +51,8 @@ REGISTRY PULL github;
4951

5052
The following system environment variables are used for authentication by default:
5153

52-
- `STACKQL_GITHUB_USERNAME` - GitHub username (login)
53-
- `STACKQL_GITHUB_PASSWORD` - GitHub Personal Access Token (see [Creating a personal access token](https://docs.github.com/en/[email protected]/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token))
54+
- <CopyableCode code="STACKQL_GITHUB_USERNAME" /> - GitHub username (login)
55+
- <CopyableCode code="STACKQL_GITHUB_PASSWORD" /> - GitHub Personal Access Token (see [Creating a personal access token](https://docs.github.com/en/[email protected]/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token))
5456

5557
These variables are sourced at runtime (from the local machine or as CI variables/secrets).
5658

docs/github-docs/providers/github/actions/allowed_actions/index.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -14,26 +14,29 @@ description: Query, deploy and manage GitHub resources using SQL
1414
custom_edit_url: null
1515
image: /img/providers/github/stackql-github-provider-featured-image.png
1616
---
17-
18-
17+
18+
import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';
19+
20+
21+
1922

2023
## Overview
2124
<table><tbody>
2225
<tr><td><b>Name</b></td><td><code>allowed_actions</code></td></tr>
2326
<tr><td><b>Type</b></td><td>Resource</td></tr>
24-
<tr><td><b>Id</b></td><td><code>github.actions.allowed_actions</code></td></tr>
27+
<tr><td><b>Id</b></td><td><CopyableCode code="github.actions.allowed_actions" /></td></tr>
2528
</tbody></table>
2629

2730
## Fields
2831
| Name | Datatype | Description |
2932
|:-----|:---------|:------------|
30-
| `github_owned_allowed` | `boolean` | Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization. |
31-
| `patterns_allowed` | `array` | Specifies a list of string-matching patterns to allow specific action(s) and reusable workflow(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.<br /><br />**Note**: The `patterns_allowed` setting only applies to public repositories. |
32-
| `verified_allowed` | `boolean` | Whether actions from GitHub Marketplace verified creators are allowed. Set to `true` to allow all actions by GitHub Marketplace verified creators. |
33+
| <CopyableCode code="github_owned_allowed" /> | `boolean` | Whether GitHub-owned actions are allowed. For example, this includes the actions in the `actions` organization. |
34+
| <CopyableCode code="patterns_allowed" /> | `array` | Specifies a list of string-matching patterns to allow specific action(s) and reusable workflow(s). Wildcards, tags, and SHAs are allowed. For example, `monalisa/octocat@*`, `monalisa/octocat@v2`, `monalisa/*`.<br /><br />**Note**: The `patterns_allowed` setting only applies to public repositories. |
35+
| <CopyableCode code="verified_allowed" /> | `boolean` | Whether actions from GitHub Marketplace verified creators are allowed. Set to `true` to allow all actions by GitHub Marketplace verified creators. |
3336
## Methods
3437
| Name | Accessible by | Required Params | Description |
3538
|:-----|:--------------|:----------------|:------------|
36-
| `get_allowed_actions_organization` | `SELECT` | `org` | Gets the selected actions and reusable workflows that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).""<br /><br />You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API. |
37-
| `get_allowed_actions_repository` | `SELECT` | `owner, repo` | Gets the settings for selected actions and reusable workflows that are allowed in a repository. To use this endpoint, the repository policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository)."<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API. |
38-
| `set_allowed_actions_organization` | `EXEC` | `org` | Sets the actions and reusable workflows that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."<br /><br />You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API. |
39-
| `set_allowed_actions_repository` | `EXEC` | `owner, repo` | Sets the actions and reusable workflows that are allowed in a repository. To use this endpoint, the repository permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository)."<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API. |
39+
| <CopyableCode code="get_allowed_actions_organization" /> | `SELECT` | <CopyableCode code="org" /> | Gets the selected actions and reusable workflows that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization).""<br /><br />You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API. |
40+
| <CopyableCode code="get_allowed_actions_repository" /> | `SELECT` | <CopyableCode code="owner, repo" /> | Gets the settings for selected actions and reusable workflows that are allowed in a repository. To use this endpoint, the repository policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository)."<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API. |
41+
| <CopyableCode code="set_allowed_actions_organization" /> | `EXEC` | <CopyableCode code="org" /> | Sets the actions and reusable workflows that are allowed in an organization. To use this endpoint, the organization permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for an organization](#set-github-actions-permissions-for-an-organization)."<br /><br />You must authenticate using an access token with the `admin:org` scope to use this endpoint. GitHub Apps must have the `administration` organization permission to use this API. |
42+
| <CopyableCode code="set_allowed_actions_repository" /> | `EXEC` | <CopyableCode code="owner, repo" /> | Sets the actions and reusable workflows that are allowed in a repository. To use this endpoint, the repository permission policy for `allowed_actions` must be configured to `selected`. For more information, see "[Set GitHub Actions permissions for a repository](#set-github-actions-permissions-for-a-repository)."<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `administration` repository permission to use this API. |

docs/github-docs/providers/github/actions/artifacts/index.md

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -14,35 +14,38 @@ description: Query, deploy and manage GitHub resources using SQL
1414
custom_edit_url: null
1515
image: /img/providers/github/stackql-github-provider-featured-image.png
1616
---
17-
18-
17+
18+
import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';
19+
20+
21+
1922

2023
## Overview
2124
<table><tbody>
2225
<tr><td><b>Name</b></td><td><code>artifacts</code></td></tr>
2326
<tr><td><b>Type</b></td><td>Resource</td></tr>
24-
<tr><td><b>Id</b></td><td><code>github.actions.artifacts</code></td></tr>
27+
<tr><td><b>Id</b></td><td><CopyableCode code="github.actions.artifacts" /></td></tr>
2528
</tbody></table>
2629

2730
## Fields
2831
| Name | Datatype | Description |
2932
|:-----|:---------|:------------|
30-
| `id` | `integer` | |
31-
| `name` | `string` | The name of the artifact. |
32-
| `created_at` | `string` | |
33-
| `updated_at` | `string` | |
34-
| `expired` | `boolean` | Whether or not the artifact has expired. |
35-
| `node_id` | `string` | |
36-
| `archive_download_url` | `string` | |
37-
| `workflow_run` | `object` | |
38-
| `size_in_bytes` | `integer` | The size in bytes of the artifact. |
39-
| `url` | `string` | |
40-
| `expires_at` | `string` | |
33+
| <CopyableCode code="id" /> | `integer` | |
34+
| <CopyableCode code="name" /> | `string` | The name of the artifact. |
35+
| <CopyableCode code="archive_download_url" /> | `string` | |
36+
| <CopyableCode code="created_at" /> | `string` | |
37+
| <CopyableCode code="expired" /> | `boolean` | Whether or not the artifact has expired. |
38+
| <CopyableCode code="expires_at" /> | `string` | |
39+
| <CopyableCode code="node_id" /> | `string` | |
40+
| <CopyableCode code="size_in_bytes" /> | `integer` | The size in bytes of the artifact. |
41+
| <CopyableCode code="updated_at" /> | `string` | |
42+
| <CopyableCode code="url" /> | `string` | |
43+
| <CopyableCode code="workflow_run" /> | `object` | |
4144
## Methods
4245
| Name | Accessible by | Required Params | Description |
4346
|:-----|:--------------|:----------------|:------------|
44-
| `get_artifact` | `SELECT` | `artifact_id, owner, repo` | Gets a specific artifact for a workflow run. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
45-
| `list_artifacts_for_repo` | `SELECT` | `owner, repo` | Lists all artifacts for a repository. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
46-
| `list_workflow_run_artifacts` | `SELECT` | `owner, repo, run_id` | Lists artifacts for a workflow run. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
47-
| `delete_artifact` | `DELETE` | `artifact_id, owner, repo` | Deletes an artifact for a workflow run. You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint. |
48-
| `download_artifact` | `EXEC` | `archive_format, artifact_id, owner, repo` | Gets a redirect URL to download an archive for a repository. This URL expires after 1 minute. Look for `Location:` in<br />the response header to find the URL for the download. The `:archive_format` must be `zip`.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br />GitHub Apps must have the `actions:read` permission to use this endpoint. |
47+
| <CopyableCode code="get_artifact" /> | `SELECT` | <CopyableCode code="artifact_id, owner, repo" /> | Gets a specific artifact for a workflow run. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
48+
| <CopyableCode code="list_artifacts_for_repo" /> | `SELECT` | <CopyableCode code="owner, repo" /> | Lists all artifacts for a repository. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
49+
| <CopyableCode code="list_workflow_run_artifacts" /> | `SELECT` | <CopyableCode code="owner, repo, run_id" /> | Lists artifacts for a workflow run. Anyone with read access to the repository can use this endpoint. If the repository is private you must use an access token with the `repo` scope. GitHub Apps must have the `actions:read` permission to use this endpoint. |
50+
| <CopyableCode code="delete_artifact" /> | `DELETE` | <CopyableCode code="artifact_id, owner, repo" /> | Deletes an artifact for a workflow run. You must authenticate using an access token with the `repo` scope to use this endpoint. GitHub Apps must have the `actions:write` permission to use this endpoint. |
51+
| <CopyableCode code="download_artifact" /> | `EXEC` | <CopyableCode code="archive_format, artifact_id, owner, repo" /> | Gets a redirect URL to download an archive for a repository. This URL expires after 1 minute. Look for `Location:` in<br />the response header to find the URL for the download. The `:archive_format` must be `zip`.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br />GitHub Apps must have the `actions:read` permission to use this endpoint. |

docs/github-docs/providers/github/actions/cache/index.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,24 +14,27 @@ description: Query, deploy and manage GitHub resources using SQL
1414
custom_edit_url: null
1515
image: /img/providers/github/stackql-github-provider-featured-image.png
1616
---
17-
18-
17+
18+
import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';
19+
20+
21+
1922

2023
## Overview
2124
<table><tbody>
2225
<tr><td><b>Name</b></td><td><code>cache</code></td></tr>
2326
<tr><td><b>Type</b></td><td>Resource</td></tr>
24-
<tr><td><b>Id</b></td><td><code>github.actions.cache</code></td></tr>
27+
<tr><td><b>Id</b></td><td><CopyableCode code="github.actions.cache" /></td></tr>
2528
</tbody></table>
2629

2730
## Fields
2831
| Name | Datatype | Description |
2932
|:-----|:---------|:------------|
30-
| `actions_caches` | `array` | Array of caches |
31-
| `total_count` | `integer` | Total number of caches |
33+
| <CopyableCode code="actions_caches" /> | `array` | Array of caches |
34+
| <CopyableCode code="total_count" /> | `integer` | Total number of caches |
3235
## Methods
3336
| Name | Accessible by | Required Params | Description |
3437
|:-----|:--------------|:----------------|:------------|
35-
| `get_actions_cache_list` | `SELECT` | `owner, repo` | Lists the GitHub Actions caches for a repository.<br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br />GitHub Apps must have the `actions:read` permission to use this endpoint. |
36-
| `delete_actions_cache_by_id` | `DELETE` | `cache_id, owner, repo` | Deletes a GitHub Actions cache for a repository, using a cache ID.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br /><br />GitHub Apps must have the `actions:write` permission to use this endpoint. |
37-
| `delete_actions_cache_by_key` | `DELETE` | `key, owner, repo` | Deletes one or more GitHub Actions caches for a repository, using a complete cache key. By default, all caches that match the provided key are deleted, but you can optionally provide a Git ref to restrict deletions to caches that match both the provided key and the Git ref.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br /><br />GitHub Apps must have the `actions:write` permission to use this endpoint. |
38+
| <CopyableCode code="get_actions_cache_list" /> | `SELECT` | <CopyableCode code="owner, repo" /> | Lists the GitHub Actions caches for a repository.<br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br />GitHub Apps must have the `actions:read` permission to use this endpoint. |
39+
| <CopyableCode code="delete_actions_cache_by_id" /> | `DELETE` | <CopyableCode code="cache_id, owner, repo" /> | Deletes a GitHub Actions cache for a repository, using a cache ID.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br /><br />GitHub Apps must have the `actions:write` permission to use this endpoint. |
40+
| <CopyableCode code="delete_actions_cache_by_key" /> | `DELETE` | <CopyableCode code="key, owner, repo" /> | Deletes one or more GitHub Actions caches for a repository, using a complete cache key. By default, all caches that match the provided key are deleted, but you can optionally provide a Git ref to restrict deletions to caches that match both the provided key and the Git ref.<br /><br />You must authenticate using an access token with the `repo` scope to use this endpoint.<br /><br />GitHub Apps must have the `actions:write` permission to use this endpoint. |

0 commit comments

Comments
 (0)