Skip to content

Commit

Permalink
Merge pull request #138 from stackql/feature/doc-updates
Browse files Browse the repository at this point in the history
Feature/doc updates
  • Loading branch information
jeffreyaven authored May 2, 2024
2 parents df78d1b + 2c55465 commit 0403b7e
Show file tree
Hide file tree
Showing 4,761 changed files with 203,702 additions and 157,650 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
2 changes: 1 addition & 1 deletion .github/workflows/build-docs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ jobs:
if [ $PROVIDER == "root" ]; then
echo "adding vanity url redirects to _redirects file.."
touch ./build/_redirects
array=( aws awscc azure azure-extras azure-isv azure-stack digitalocean firebase github google googleadmin k8s linode netlify okta sumologic vercel godaddy pagerduty homebrew datadog )
array=( aws azure azure-extras azure-isv azure-stack digitalocean firebase github google googleadmin k8s linode netlify okta sumologic vercel godaddy pagerduty homebrew datadog )
for i in "${array[@]}"
do
echo "adding redirects for $i"
Expand Down
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,6 @@ This repository contains documentation for StackQL providers, which is published
| Netlify Deploy Datadog | [![Netlify Status](https://api.netlify.com/api/v1/badges/9e76122d-09bd-4938-a50f-3b4196e94f0c/deploy-status)](https://app.netlify.com/sites/stackql-datadog-docs/deploys) | [datadog-docs.stackql.io](https://datadog-docs.stackql.io)<br/>[datadog.stackql.io](https://datadog.stackql.io) |
| Netlify Deploy Azure ISV | [![Netlify Status](https://api.netlify.com/api/v1/badges/35fc840c-0494-462f-9b3f-cbd3418a3c78/deploy-status)](https://app.netlify.com/sites/stackql-azure-isv-docs/deploys) | [azure-isv-docs.stackql.io](https://azure-isv-docs.stackql.io)<br/>[azure-isv.stackql.io](https://azure-isv.stackql.io) |
| Netlify Deploy Azure Stack | [![Netlify Status](https://api.netlify.com/api/v1/badges/53abcb20-0194-41dd-b466-4d933cfffcad/deploy-status)](https://app.netlify.com/sites/stackql-azure-stack-docs/deploys) | [azure-stack-docs.stackql.io](https://azure-stack-docs.stackql.io)<br/>[azure-stack.stackql.io](https://azure-stack.stackql.io) |
| Netlify Deploy AWS Cloud Control | [![Netlify Status](https://api.netlify.com/api/v1/badges/b214d7f4-4c43-43b5-a584-19d2d18902f1/deploy-status)](https://app.netlify.com/sites/stackql-awscc-docs/deploys) | [awscc-docs.stackql.io](https://awscc-docs.stackql.io)<br/>[awscc.stackql.io](https://awscc.stackql.io) |


## Adding Docs for a New Provider
Expand Down
3 changes: 1 addition & 2 deletions ci-scripts/get-providers-to-deploy.js
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@ const isMatchRegex = (path) => regex.test(path);
const rootName = 'root'
const allProviders = [
'aws',
'awscc',
'azure',
'azure_extras',
'azure_isv',
Expand Down Expand Up @@ -53,7 +52,7 @@ module.exports = async ({ github, context, core, pathOutput }) => {

// if(!(diff.startsWith('.github')) || !(diff.startsWith('scripts'))) globalChange = true;

globalChange = false;
globalChange = true;

}).filter(Boolean)

Expand Down
380 changes: 296 additions & 84 deletions docs/aws-docs/index.md

Large diffs are not rendered by default.

104 changes: 104 additions & 0 deletions docs/aws-docs/providers/aws/accessanalyzer/analyzer/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
title: analyzer
hide_title: false
hide_table_of_contents: false
keywords:
- analyzer
- accessanalyzer
- aws
- stackql
- infrastructure-as-code
- configuration-as-data
- cloud inventory
description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---
Gets an individual <code>analyzer</code> resource

## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>analyzer</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Description</b></td><td>The AWS::AccessAnalyzer::Analyzer type specifies an analyzer of the user's account</td></tr>
<tr><td><b>Id</b></td><td><code>aws.accessanalyzer.analyzer</code></td></tr>
</tbody></table>

## Fields
<table><tbody>
<tr><th>Name</th><th>Datatype</th><th>Description</th></tr>
<tr><td><code>analyzer_name</code></td><td><code>string</code></td><td>Analyzer name</td></tr>
<tr><td><code>archive_rules</code></td><td><code>array</code></td><td></td></tr>
<tr><td><code>arn</code></td><td><code>string</code></td><td>Amazon Resource Name (ARN) of the analyzer</td></tr>
<tr><td><code>tags</code></td><td><code>array</code></td><td>An array of key-value pairs to apply to this resource.</td></tr>
<tr><td><code>type</code></td><td><code>string</code></td><td>The type of the analyzer, must be one of ACCOUNT, ORGANIZATION, ACCOUNT_UNUSED_ACCESS or ORGANIZATION_UNUSED_ACCESS</td></tr>
<tr><td><code>analyzer_configuration</code></td><td><code>object</code></td><td>The configuration for the analyzer</td></tr>
<tr><td><code>region</code></td><td><code>string</code></td><td>AWS region.</td></tr>

</tbody></table>

## Methods

<table><tbody>
<tr>
<th>Name</th>
<th>Accessible by</th>
<th>Required Params</th>
</tr>
<tr>
<td><code>update_resource</code></td>
<td><code>UPDATE</code></td>
<td><code>data__Identifier, data__PatchDocument, region</code></td>
</tr>
<tr>
<td><code>delete_resource</code></td>
<td><code>DELETE</code></td>
<td><code>data__Identifier, region</code></td>
</tr>
<tr>
<td><code>get_resource</code></td>
<td><code>SELECT</code></td>
<td><code>data__Identifier, region</code></td>
</tr>
</tbody></table>

## `SELECT` Example
```sql
SELECT
region,
analyzer_name,
archive_rules,
arn,
tags,
type,
analyzer_configuration
FROM aws.accessanalyzer.analyzer
WHERE data__Identifier = '<Arn>';
```

## Permissions

To operate on the <code>analyzer</code> resource, the following permissions are required:

### Read
```json
access-analyzer:ListAnalyzers,
access-analyzer:GetAnalyzer,
access-analyzer:ListArchiveRules
```

### Update
```json
access-analyzer:CreateArchiveRule,
access-analyzer:DeleteArchiveRule,
access-analyzer:ListAnalyzers,
access-analyzer:TagResource,
access-analyzer:UntagResource,
access-analyzer:UpdateArchiveRule
```

### Delete
```json
access-analyzer:DeleteAnalyzer
```

81 changes: 81 additions & 0 deletions docs/aws-docs/providers/aws/accessanalyzer/analyzers/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
---
title: analyzers
hide_title: false
hide_table_of_contents: false
keywords:
- analyzers
- accessanalyzer
- aws
- stackql
- infrastructure-as-code
- configuration-as-data
- cloud inventory
description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---
Retrieves a list of <code>analyzers</code> in a region

## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>analyzers</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Description</b></td><td>The AWS::AccessAnalyzer::Analyzer type specifies an analyzer of the user's account</td></tr>
<tr><td><b>Id</b></td><td><code>aws.accessanalyzer.analyzers</code></td></tr>
</tbody></table>

## Fields
<table><tbody>
<tr><th>Name</th><th>Datatype</th><th>Description</th></tr>
<tr><td><code>arn</code></td><td><code>string</code></td><td>Amazon Resource Name (ARN) of the analyzer</td></tr>
<tr><td><code>region</code></td><td><code>string</code></td><td>AWS region.</td></tr>

</tbody></table>

## Methods

<table><tbody>
<tr>
<th>Name</th>
<th>Accessible by</th>
<th>Required Params</th>
</tr>
<tr>
<td><code>create_resource</code></td>
<td><code>INSERT</code></td>
<td><code>data__DesiredState, region</code></td>
</tr>
<tr>
<td><code>list_resource</code></td>
<td><code>SELECT</code></td>
<td><code>region</code></td>
</tr>
</tbody></table>

## `SELECT` Example
```sql
SELECT
region,
arn
FROM aws.accessanalyzer.analyzers
WHERE region = 'us-east-1'
```

## Permissions

To operate on the <code>analyzers</code> resource, the following permissions are required:

### Create
```json
access-analyzer:CreateAnalyzer,
access-analyzer:TagResource,
iam:CreateServiceLinkedRole,
organizations:ListAWSServiceAccessForOrganization,
organizations:ListDelegatedAdministrators
```

### List
```json
access-analyzer:ListAnalyzers
```

39 changes: 39 additions & 0 deletions docs/aws-docs/providers/aws/accessanalyzer/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: accessanalyzer
hide_title: false
hide_table_of_contents: false
keywords:
- accessanalyzer
- aws
- stackql
- infrastructure-as-code
- configuration-as-data
- cloud inventory
description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---

The accessanalyzer service documentation.

:::info Service Summary

<div class="row">
<div class="providerDocColumn">
<span>total resources:&nbsp;<b>2</b></span><br />
<span>total selectable resources:&nbsp;<b>2</b></span><br />
<span>total methods:&nbsp;<b>2</b></span><br />
</div>
</div>

:::

## Resources
<div class="row">
<div class="providerDocColumn">
<a href="/providers/aws/accessanalyzer/analyzer/">analyzer</a>
</div>
<div class="providerDocColumn">
<a href="/providers/aws/accessanalyzer/analyzers/">analyzers</a>
</div>
</div>
98 changes: 98 additions & 0 deletions docs/aws-docs/providers/aws/acmpca/certificate/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
---
title: certificate
hide_title: false
hide_table_of_contents: false
keywords:
- certificate
- acmpca
- aws
- stackql
- infrastructure-as-code
- configuration-as-data
- cloud inventory
description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---
Gets an individual <code>certificate</code> resource

## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>certificate</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Description</b></td><td>The ``AWS::ACMPCA::Certificate`` resource is used to issue a certificate using your private certificate authority. For more information, see the &#91;IssueCertificate&#93;(https:&#x2F;&#x2F;docs.aws.amazon.com&#x2F;privateca&#x2F;latest&#x2F;APIReference&#x2F;API_IssueCertificate.html) action.</td></tr>
<tr><td><b>Id</b></td><td><code>aws.acmpca.certificate</code></td></tr>
</tbody></table>

## Fields
<table><tbody>
<tr><th>Name</th><th>Datatype</th><th>Description</th></tr>
<tr><td><code>api_passthrough</code></td><td><code>object</code></td><td>Specifies X.509 certificate information to be included in the issued certificate. An ``APIPassthrough`` or ``APICSRPassthrough`` template variant must be selected, or else this parameter is ignored.</td></tr>
<tr><td><code>certificate_authority_arn</code></td><td><code>string</code></td><td>The Amazon Resource Name (ARN) for the private CA issues the certificate.</td></tr>
<tr><td><code>certificate_signing_request</code></td><td><code>string</code></td><td>The certificate signing request (CSR) for the certificate.</td></tr>
<tr><td><code>signing_algorithm</code></td><td><code>string</code></td><td>The name of the algorithm that will be used to sign the certificate to be issued. &lt;br&#x2F;&gt; This parameter should not be confused with the ``SigningAlgorithm`` parameter used to sign a CSR in the ``CreateCertificateAuthority`` action.&lt;br&#x2F;&gt; The specified signing algorithm family (RSA or ECDSA) must match the algorithm family of the CA's secret key.</td></tr>
<tr><td><code>template_arn</code></td><td><code>string</code></td><td>Specifies a custom configuration template to use when issuing a certificate. If this parameter is not provided, PCAshort defaults to the ``EndEntityCertificate&#x2F;V1`` template. For more information about PCAshort templates, see &#91;Using Templates&#93;(https:&#x2F;&#x2F;docs.aws.amazon.com&#x2F;privateca&#x2F;latest&#x2F;userguide&#x2F;UsingTemplates.html).</td></tr>
<tr><td><code>validity</code></td><td><code>object</code></td><td>The period of time during which the certificate will be valid.</td></tr>
<tr><td><code>validity_not_before</code></td><td><code>object</code></td><td>Information describing the start of the validity period of the certificate. This parameter sets the “Not Before" date for the certificate.&lt;br&#x2F;&gt; By default, when issuing a certificate, PCAshort sets the "Not Before" date to the issuance time minus 60 minutes. This compensates for clock inconsistencies across computer systems. The ``ValidityNotBefore`` parameter can be used to customize the “Not Before” value. &lt;br&#x2F;&gt; Unlike the ``Validity`` parameter, the ``ValidityNotBefore`` parameter is optional.&lt;br&#x2F;&gt; The ``ValidityNotBefore`` value is expressed as an explicit date and time, using the ``Validity`` type value ``ABSOLUTE``.</td></tr>
<tr><td><code>certificate</code></td><td><code>string</code></td><td></td></tr>
<tr><td><code>arn</code></td><td><code>string</code></td><td></td></tr>
<tr><td><code>region</code></td><td><code>string</code></td><td>AWS region.</td></tr>

</tbody></table>

## Methods

<table><tbody>
<tr>
<th>Name</th>
<th>Accessible by</th>
<th>Required Params</th>
</tr>
<tr>
<td><code>update_resource</code></td>
<td><code>UPDATE</code></td>
<td><code>data__Identifier, data__PatchDocument, region</code></td>
</tr>
<tr>
<td><code>delete_resource</code></td>
<td><code>DELETE</code></td>
<td><code>data__Identifier, region</code></td>
</tr>
<tr>
<td><code>get_resource</code></td>
<td><code>SELECT</code></td>
<td><code>data__Identifier, region</code></td>
</tr>
</tbody></table>

## `SELECT` Example
```sql
SELECT
region,
api_passthrough,
certificate_authority_arn,
certificate_signing_request,
signing_algorithm,
template_arn,
validity,
validity_not_before,
certificate,
arn
FROM aws.acmpca.certificate
WHERE data__Identifier = '<Arn>|<CertificateAuthorityArn>';
```

## Permissions

To operate on the <code>certificate</code> resource, the following permissions are required:

### Read
```json
acm-pca:GetCertificate
```

### Delete
```json
acm-pca:GetCertificate
```

Loading

0 comments on commit 0403b7e

Please sign in to comment.