Skip to content

Commit

Permalink
Merge pull request #164 from stackql/feature/doc-updates
Browse files Browse the repository at this point in the history
aws doc updates
  • Loading branch information
jeffreyaven authored May 17, 2024
2 parents 96f94ba + 468fe01 commit 94aefc5
Show file tree
Hide file tree
Showing 370 changed files with 5,260 additions and 3,493 deletions.
13 changes: 7 additions & 6 deletions docs/aws-docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,16 +22,16 @@ import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';

Cloud services from AWS.

:::info Provider Summary (v24.05.00230)
:::info Provider Summary (v24.05.00232)

<div class="row">
<div class="providerDocColumn">
<span>total services:&nbsp;<b>220</b></span><br />
<span>total methods:&nbsp;<b>7,597</b></span><br />
<span>total services:&nbsp;<b>221</b></span><br />
<span>total methods:&nbsp;<b>7,620</b></span><br />
</div>
<div class="providerDocColumn">
<span>total resources:&nbsp;<b>2,269</b></span><br />
<span>total selectable resources:&nbsp;<b>2,161</b></span><br />
<span>total resources:&nbsp;<b>2,277</b></span><br />
<span>total selectable resources:&nbsp;<b>2,170</b></span><br />
</div>
</div>

Expand Down Expand Up @@ -205,9 +205,9 @@ This parameter must be supplied to the `WHERE` clause of each `SELECT` statement
<a href="/providers/aws/iotanalytics/">iotanalytics</a><br />
<a href="/providers/aws/iotcoredeviceadvisor/">iotcoredeviceadvisor</a><br />
<a href="/providers/aws/iotevents/">iotevents</a><br />
<a href="/providers/aws/iotfleethub/">iotfleethub</a><br />
</div>
<div class="providerDocColumn">
<a href="/providers/aws/iotfleethub/">iotfleethub</a><br />
<a href="/providers/aws/iotfleetwise/">iotfleetwise</a><br />
<a href="/providers/aws/iotsitewise/">iotsitewise</a><br />
<a href="/providers/aws/iottwinmaker/">iottwinmaker</a><br />
Expand Down Expand Up @@ -275,6 +275,7 @@ This parameter must be supplied to the `WHERE` clause of each `SELECT` statement
<a href="/providers/aws/robomaker/">robomaker</a><br />
<a href="/providers/aws/rolesanywhere/">rolesanywhere</a><br />
<a href="/providers/aws/route53/">route53</a><br />
<a href="/providers/aws/route53_api/">route53_api</a><br />
<a href="/providers/aws/route53recoverycontrol/">route53recoverycontrol</a><br />
<a href="/providers/aws/route53recoveryreadiness/">route53recoveryreadiness</a><br />
<a href="/providers/aws/route53resolver/">route53resolver</a><br />
Expand Down
41 changes: 22 additions & 19 deletions docs/aws-docs/providers/aws/cloudhsm/backups/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,35 +14,38 @@ description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---



import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';




## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>backups</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Id</b></td><td><code>aws.cloudhsm.backups</code></td></tr>
<tr><td><b>Id</b></td><td><CopyableCode code="aws.cloudhsm.backups" /></td></tr>
</tbody></table>

## Fields
| Name | Datatype | Description |
|:-----|:---------|:------------|
| `BackupId` | `string` | The identifier (ID) of the backup. |
| `BackupState` | `string` | The state of the backup. |
| `ClusterId` | `string` | The identifier (ID) of the cluster that was backed up. |
| `CopyTimestamp` | `string` | The date and time when the backup was copied from a source backup. |
| `CreateTimestamp` | `string` | The date and time when the backup was created. |
| `DeleteTimestamp` | `string` | The date and time when the backup will be permanently deleted. |
| `NeverExpires` | `boolean` | Specifies whether the service should exempt a backup from the retention policy for the cluster. &lt;code&gt;True&lt;/code&gt; exempts a backup from the retention policy. &lt;code&gt;False&lt;/code&gt; means the service applies the backup retention policy defined at the cluster. |
| `SourceBackup` | `string` | The identifier (ID) of the source backup from which the new backup was copied. |
| `SourceCluster` | `string` | The identifier (ID) of the cluster containing the source backup from which the new backup was copied. |
| `SourceRegion` | `string` | The AWS Region that contains the source backup from which the new backup was copied. |
| `TagList` | `array` | The list of tags for the backup. |
| <CopyableCode code="BackupId" /> | `string` | The identifier (ID) of the backup. |
| <CopyableCode code="BackupState" /> | `string` | The state of the backup. |
| <CopyableCode code="ClusterId" /> | `string` | The identifier (ID) of the cluster that was backed up. |
| <CopyableCode code="CopyTimestamp" /> | `string` | The date and time when the backup was copied from a source backup. |
| <CopyableCode code="CreateTimestamp" /> | `string` | The date and time when the backup was created. |
| <CopyableCode code="DeleteTimestamp" /> | `string` | The date and time when the backup will be permanently deleted. |
| <CopyableCode code="NeverExpires" /> | `boolean` | Specifies whether the service should exempt a backup from the retention policy for the cluster. &lt;code&gt;True&lt;/code&gt; exempts a backup from the retention policy. &lt;code&gt;False&lt;/code&gt; means the service applies the backup retention policy defined at the cluster. |
| <CopyableCode code="SourceBackup" /> | `string` | The identifier (ID) of the source backup from which the new backup was copied. |
| <CopyableCode code="SourceCluster" /> | `string` | The identifier (ID) of the cluster containing the source backup from which the new backup was copied. |
| <CopyableCode code="SourceRegion" /> | `string` | The AWS Region that contains the source backup from which the new backup was copied. |
| <CopyableCode code="TagList" /> | `array` | The list of tags for the backup. |
## Methods
| Name | Accessible by | Required Params | Description |
|:-----|:--------------|:----------------|:------------|
| `describe_backups` | `SELECT` | `region` | &lt;p&gt;Gets information about backups of AWS CloudHSM clusters.&lt;/p&gt; &lt;p&gt;This is a paginated operation, which means that each response might contain only a subset of all the backups. When the response contains only a subset of backups, it includes a &lt;code&gt;NextToken&lt;/code&gt; value. Use this value in a subsequent &lt;code&gt;DescribeBackups&lt;/code&gt; request to get more backups. When you receive a response with no &lt;code&gt;NextToken&lt;/code&gt; (or an empty or null value), that means there are no more backups to get.&lt;/p&gt; |
| `delete_backup` | `DELETE` | `X-Amz-Target, data__BackupId, region` | Deletes a specified AWS CloudHSM backup. A backup can be restored up to 7 days after the DeleteBackup request is made. For more information on restoring a backup, see &lt;a&gt;RestoreBackup&lt;/a&gt;. |
| `copy_backup_to_region` | `EXEC` | `X-Amz-Target, data__BackupId, data__DestinationRegion, region` | Copy an AWS CloudHSM cluster backup to a different region. |
| `modify_backup_attributes` | `EXEC` | `X-Amz-Target, data__BackupId, data__NeverExpires, region` | Modifies attributes for AWS CloudHSM backup. |
| `restore_backup` | `EXEC` | `X-Amz-Target, data__BackupId, region` | Restores a specified AWS CloudHSM backup that is in the &lt;code&gt;PENDING_DELETION&lt;/code&gt; state. For mor information on deleting a backup, see &lt;a&gt;DeleteBackup&lt;/a&gt;. |
| <CopyableCode code="describe_backups" /> | `SELECT` | <CopyableCode code="region" /> | &lt;p&gt;Gets information about backups of AWS CloudHSM clusters.&lt;/p&gt; &lt;p&gt;This is a paginated operation, which means that each response might contain only a subset of all the backups. When the response contains only a subset of backups, it includes a &lt;code&gt;NextToken&lt;/code&gt; value. Use this value in a subsequent &lt;code&gt;DescribeBackups&lt;/code&gt; request to get more backups. When you receive a response with no &lt;code&gt;NextToken&lt;/code&gt; (or an empty or null value), that means there are no more backups to get.&lt;/p&gt; |
| <CopyableCode code="delete_backup" /> | `DELETE` | <CopyableCode code="X-Amz-Target, data__BackupId, region" /> | Deletes a specified AWS CloudHSM backup. A backup can be restored up to 7 days after the DeleteBackup request is made. For more information on restoring a backup, see &lt;a&gt;RestoreBackup&lt;/a&gt;. |
| <CopyableCode code="copy_backup_to_region" /> | `EXEC` | <CopyableCode code="X-Amz-Target, data__BackupId, data__DestinationRegion, region" /> | Copy an AWS CloudHSM cluster backup to a different region. |
| <CopyableCode code="modify_backup_attributes" /> | `EXEC` | <CopyableCode code="X-Amz-Target, data__BackupId, data__NeverExpires, region" /> | Modifies attributes for AWS CloudHSM backup. |
| <CopyableCode code="restore_backup" /> | `EXEC` | <CopyableCode code="X-Amz-Target, data__BackupId, region" /> | Restores a specified AWS CloudHSM backup that is in the &lt;code&gt;PENDING_DELETION&lt;/code&gt; state. For mor information on deleting a backup, see &lt;a&gt;DeleteBackup&lt;/a&gt;. |
49 changes: 26 additions & 23 deletions docs/aws-docs/providers/aws/cloudhsm/clusters/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,39 +14,42 @@ description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---



import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';




## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>clusters</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Id</b></td><td><code>aws.cloudhsm.clusters</code></td></tr>
<tr><td><b>Id</b></td><td><CopyableCode code="aws.cloudhsm.clusters" /></td></tr>
</tbody></table>

## Fields
| Name | Datatype | Description |
|:-----|:---------|:------------|
| `BackupPolicy` | `string` | The cluster's backup policy. |
| `BackupRetentionPolicy` | `object` | A policy that defines the number of days to retain backups. |
| `Certificates` | `object` | Contains one or more certificates or a certificate signing request (CSR). |
| `ClusterId` | `string` | The cluster's identifier (ID). |
| `CreateTimestamp` | `string` | The date and time when the cluster was created. |
| `HsmType` | `string` | The type of HSM that the cluster contains. |
| `Hsms` | `array` | Contains information about the HSMs in the cluster. |
| `PreCoPassword` | `string` | The default password for the cluster's Pre-Crypto Officer (PRECO) user. |
| `SecurityGroup` | `string` | The identifier (ID) of the cluster's security group. |
| `SourceBackupId` | `string` | The identifier (ID) of the backup used to create the cluster. This value exists only when the cluster was created from a backup. |
| `State` | `string` | The cluster's state. |
| `StateMessage` | `string` | A description of the cluster's state. |
| `SubnetMapping` | `object` | A map from availability zone to the cluster’s subnet in that availability zone. |
| `TagList` | `array` | The list of tags for the cluster. |
| `VpcId` | `string` | The identifier (ID) of the virtual private cloud (VPC) that contains the cluster. |
| <CopyableCode code="BackupPolicy" /> | `string` | The cluster's backup policy. |
| <CopyableCode code="BackupRetentionPolicy" /> | `object` | A policy that defines the number of days to retain backups. |
| <CopyableCode code="Certificates" /> | `object` | Contains one or more certificates or a certificate signing request (CSR). |
| <CopyableCode code="ClusterId" /> | `string` | The cluster's identifier (ID). |
| <CopyableCode code="CreateTimestamp" /> | `string` | The date and time when the cluster was created. |
| <CopyableCode code="HsmType" /> | `string` | The type of HSM that the cluster contains. |
| <CopyableCode code="Hsms" /> | `array` | Contains information about the HSMs in the cluster. |
| <CopyableCode code="PreCoPassword" /> | `string` | The default password for the cluster's Pre-Crypto Officer (PRECO) user. |
| <CopyableCode code="SecurityGroup" /> | `string` | The identifier (ID) of the cluster's security group. |
| <CopyableCode code="SourceBackupId" /> | `string` | The identifier (ID) of the backup used to create the cluster. This value exists only when the cluster was created from a backup. |
| <CopyableCode code="State" /> | `string` | The cluster's state. |
| <CopyableCode code="StateMessage" /> | `string` | A description of the cluster's state. |
| <CopyableCode code="SubnetMapping" /> | `object` | A map from availability zone to the cluster’s subnet in that availability zone. |
| <CopyableCode code="TagList" /> | `array` | The list of tags for the cluster. |
| <CopyableCode code="VpcId" /> | `string` | The identifier (ID) of the virtual private cloud (VPC) that contains the cluster. |
## Methods
| Name | Accessible by | Required Params | Description |
|:-----|:--------------|:----------------|:------------|
| `describe_clusters` | `SELECT` | `region` | &lt;p&gt;Gets information about AWS CloudHSM clusters.&lt;/p&gt; &lt;p&gt;This is a paginated operation, which means that each response might contain only a subset of all the clusters. When the response contains only a subset of clusters, it includes a &lt;code&gt;NextToken&lt;/code&gt; value. Use this value in a subsequent &lt;code&gt;DescribeClusters&lt;/code&gt; request to get more clusters. When you receive a response with no &lt;code&gt;NextToken&lt;/code&gt; (or an empty or null value), that means there are no more clusters to get.&lt;/p&gt; |
| `create_cluster` | `INSERT` | `X-Amz-Target, data__HsmType, data__SubnetIds, region` | Creates a new AWS CloudHSM cluster. |
| `delete_cluster` | `DELETE` | `X-Amz-Target, data__ClusterId, region` | Deletes the specified AWS CloudHSM cluster. Before you can delete a cluster, you must delete all HSMs in the cluster. To see if the cluster contains any HSMs, use &lt;a&gt;DescribeClusters&lt;/a&gt;. To delete an HSM, use &lt;a&gt;DeleteHsm&lt;/a&gt;. |
| `initialize_cluster` | `EXEC` | `X-Amz-Target, data__ClusterId, data__SignedCert, data__TrustAnchor, region` | Claims an AWS CloudHSM cluster by submitting the cluster certificate issued by your issuing certificate authority (CA) and the CA's root certificate. Before you can claim a cluster, you must sign the cluster's certificate signing request (CSR) with your issuing CA. To get the cluster's CSR, use &lt;a&gt;DescribeClusters&lt;/a&gt;. |
| `modify_cluster` | `EXEC` | `X-Amz-Target, data__BackupRetentionPolicy, data__ClusterId, region` | Modifies AWS CloudHSM cluster. |
| <CopyableCode code="describe_clusters" /> | `SELECT` | <CopyableCode code="region" /> | &lt;p&gt;Gets information about AWS CloudHSM clusters.&lt;/p&gt; &lt;p&gt;This is a paginated operation, which means that each response might contain only a subset of all the clusters. When the response contains only a subset of clusters, it includes a &lt;code&gt;NextToken&lt;/code&gt; value. Use this value in a subsequent &lt;code&gt;DescribeClusters&lt;/code&gt; request to get more clusters. When you receive a response with no &lt;code&gt;NextToken&lt;/code&gt; (or an empty or null value), that means there are no more clusters to get.&lt;/p&gt; |
| <CopyableCode code="create_cluster" /> | `INSERT` | <CopyableCode code="X-Amz-Target, data__HsmType, data__SubnetIds, region" /> | Creates a new AWS CloudHSM cluster. |
| <CopyableCode code="delete_cluster" /> | `DELETE` | <CopyableCode code="X-Amz-Target, data__ClusterId, region" /> | Deletes the specified AWS CloudHSM cluster. Before you can delete a cluster, you must delete all HSMs in the cluster. To see if the cluster contains any HSMs, use &lt;a&gt;DescribeClusters&lt;/a&gt;. To delete an HSM, use &lt;a&gt;DeleteHsm&lt;/a&gt;. |
| <CopyableCode code="initialize_cluster" /> | `EXEC` | <CopyableCode code="X-Amz-Target, data__ClusterId, data__SignedCert, data__TrustAnchor, region" /> | Claims an AWS CloudHSM cluster by submitting the cluster certificate issued by your issuing certificate authority (CA) and the CA's root certificate. Before you can claim a cluster, you must sign the cluster's certificate signing request (CSR) with your issuing CA. To get the cluster's CSR, use &lt;a&gt;DescribeClusters&lt;/a&gt;. |
| <CopyableCode code="modify_cluster" /> | `EXEC` | <CopyableCode code="X-Amz-Target, data__BackupRetentionPolicy, data__ClusterId, region" /> | Modifies AWS CloudHSM cluster. |
13 changes: 8 additions & 5 deletions docs/aws-docs/providers/aws/cloudhsm/hsm/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,23 @@ description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---



import CopyableCode from '@site/src/components/CopyableCode/CopyableCode';




## Overview
<table><tbody>
<tr><td><b>Name</b></td><td><code>hsm</code></td></tr>
<tr><td><b>Type</b></td><td>Resource</td></tr>
<tr><td><b>Id</b></td><td><code>aws.cloudhsm.hsm</code></td></tr>
<tr><td><b>Id</b></td><td><CopyableCode code="aws.cloudhsm.hsm" /></td></tr>
</tbody></table>

## Fields
`SELECT` not supported for this resource, use `SHOW METHODS` to view available operations for the resource and then invoke a supported method using the `EXEC` command
## Methods
| Name | Accessible by | Required Params | Description |
|:-----|:--------------|:----------------|:------------|
| `create_hsm` | `INSERT` | `X-Amz-Target, data__AvailabilityZone, data__ClusterId, region` | Creates a new hardware security module (HSM) in the specified AWS CloudHSM cluster. |
| `delete_hsm` | `DELETE` | `X-Amz-Target, data__ClusterId, region` | Deletes the specified HSM. To specify an HSM, you can use its identifier (ID), the IP address of the HSM's elastic network interface (ENI), or the ID of the HSM's ENI. You need to specify only one of these values. To find these values, use &lt;a&gt;DescribeClusters&lt;/a&gt;. |
| <CopyableCode code="create_hsm" /> | `INSERT` | <CopyableCode code="X-Amz-Target, data__AvailabilityZone, data__ClusterId, region" /> | Creates a new hardware security module (HSM) in the specified AWS CloudHSM cluster. |
| <CopyableCode code="delete_hsm" /> | `DELETE` | <CopyableCode code="X-Amz-Target, data__ClusterId, region" /> | Deletes the specified HSM. To specify an HSM, you can use its identifier (ID), the IP address of the HSM's elastic network interface (ENI), or the ID of the HSM's ENI. You need to specify only one of these values. To find these values, use &lt;a&gt;DescribeClusters&lt;/a&gt;. |
3 changes: 2 additions & 1 deletion docs/aws-docs/providers/aws/cloudhsm/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ description: Query, deploy and manage AWS resources using SQL
custom_edit_url: null
image: /img/providers/aws/stackql-aws-provider-featured-image.png
---

cloudhsm

:::info Service Summary
Expand All @@ -33,7 +34,7 @@ cloudhsm
<tr><td><b>Type</b></td><td>Service</td></tr>
<tr><td><b>Title</b></td><td>cloudhsm</td></tr>
<tr><td><b>Description</b></td><td>cloudhsm</td></tr>
<tr><td><b>Id</b></td><td><code>cloudhsm:v00.00.00000</code></td></tr>
<tr><td><b>Id</b></td><td><code>cloudhsm:v24.05.00232</code></td></tr>
</tbody></table>

## Resources
Expand Down
Loading

0 comments on commit 94aefc5

Please sign in to comment.