add ssm examples and docs

Author: ChrisdeR

examples/tencentcloud-ssm/main.tf

@@ -0,0 +1,36 @@
+provider "tencentcloud" {
+  region = "ap-guangzhou"
+}
+
+resource "tencentcloud_ssm_secret" "foo" {
+  secret_name = "test"
+  description = "test secret"
+  recovery_window_in_days = 0
+  is_enabled = true
+
+  init_secret {
+    version_id = "v1"
+    secret_string = "123456"
+  }
+
+  tags = {
+    test-tag = "test"
+  }
+}
+
+resource "tencentcloud_ssm_secret_version" "v2" {
+  secret_name = tencentcloud_ssm_secret.foo.secret_name
+  version_id = "v2"
+  secret_binary = "MTIzMTIzMTIzMTIzMTIzQQ=="
+}
+
+data "tencentcloud_ssm_secrets" "secret_list" {
+  secret_name = tencentcloud_ssm_secret.foo.secret_name
+  order_type = 1
+  state = 1
+}
+
+data "tencentcloud_ssm_secret_versions" "secret_version_list" {
+  secret_name = tencentcloud_ssm_secret_version.v2.secret_name
+  version_id = tencentcloud_ssm_secret_version.v2.version_id
+}

examples/tencentcloud-ssm/version.tf

@@ -0,0 +1,3 @@
+terraform {
+  required_version = ">= 0.12"
+}

tencentcloud/data_source_tc_ssm_secret_versions.go

@@ -1,3 +1,14 @@
+/*
+Use this data source to query detailed information of SSM secret version
+Example Usage
+```hcl
+
+data "tencentcloud_ssm_secret_versions" "foo" {
+  secret_name = "test"
+  version_id = "v1"
+}
+```
+*/
 package tencentcloud
 
 import (

tencentcloud/data_source_tc_ssm_secrets.go

@@ -1,3 +1,15 @@
+/*
+Use this data source to query detailed information of SSM secret
+Example Usage
+```hcl
+
+data "tencentcloud_ssm_secrets" "foo" {
+  secret_name = "test"
+  order_type = 1
+  state = 1
+}
+```
+*/
 package tencentcloud
 
 import (

tencentcloud/provider.go

@@ -412,6 +412,15 @@ SSL Certificates
     tencentcloud_ssl_certificate
     tencentcloud_ssl_pay_certificate
 
+SSM
+  Data Source
+    tencentcloud_ssm_secrets
+	tencentcloud_ssm_secret_versions
+
+  Resource
+    tencentcloud_ssm_secret
+    tencentcloud_ssm_secret_version
+
 TcaplusDB
   Data Source
     tencentcloud_tcaplus_clusters

tencentcloud/resource_tc_ssm_secret.go

@@ -1,3 +1,29 @@
+/*
+Provide a resource to create a SSM secret.
+Example Usage
+```hcl
+resource "tencentcloud_ssm_secret" "foo" {
+  secret_name = "test"
+  description = "test secret"
+  recovery_window_in_days = 0
+  is_enabled = true
+
+  init_secret {
+    version_id = "v1"
+    secret_string = "123456"
+  }
+
+  tags = {
+    test-tag = "test"
+  }
+}
+```
+Import
+SSM secret can be imported using the secretName, e.g.
+```
+$ terraform import tencentcloud_ssm_secret.foo test
+```
+*/
 package tencentcloud
 
 import (

tencentcloud/resource_tc_ssm_secret_version.go

@@ -1,3 +1,35 @@
+/*
+Provide a resource to create a SSM secret version.
+Example Usage
+```hcl
+resource "tencentcloud_ssm_secret" "foo" {
+  secret_name = "test"
+  description = "test secret"
+  recovery_window_in_days = 0
+  is_enabled = true
+
+  init_secret {
+    version_id = "v1"
+    secret_string = "123456"
+  }
+
+  tags = {
+    test-tag = "test"
+  }
+}
+
+resource "tencentcloud_ssm_secret_version" "v2" {
+  secret_name = tencentcloud_ssm_secret.foo.secret_name
+  version_id = "v2"
+  secret_binary = "MTIzMTIzMTIzMTIzMTIzQQ=="
+}
+```
+Import
+SSM secret version can be imported using the secretName#versionId, e.g.
+```
+$ terraform import tencentcloud_ssm_secret_version.v2 test#v2
+```
+*/
 package tencentcloud
 
 import (

website/docs/d/ssm_secret_versions.html.markdown

@@ -0,0 +1,40 @@
+---
+subcategory: "SSM"
+layout: "tencentcloud"
+page_title: "TencentCloud: tencentcloud_ssm_secret_versions"
+sidebar_current: "docs-tencentcloud-datasource-ssm_secret_versions"
+description: |-
+  Use this data source to query detailed information of SSM secret version
+---
+
+# tencentcloud_ssm_secret_versions
+
+Use this data source to query detailed information of SSM secret version
+
+## Example Usage
+
+```hcl
+data "tencentcloud_ssm_secret_versions" "foo" {
+  secret_name = "test"
+  version_id  = "v1"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `secret_name` - (Required) Secret name used to filter result.
+* `result_output_file` - (Optional) Used to save results.
+* `version_id` - (Optional) VersionId used to filter result.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `secret_version_list` - A list of SSM secret versions.
+  * `secret_binary` - The base64-encoded binary secret.
+  * `secret_string` - The string text of secret.
+  * `version_id` - Version of secret.
+
+

website/docs/d/ssm_secrets.html.markdown

@@ -0,0 +1,47 @@
+---
+subcategory: "SSM"
+layout: "tencentcloud"
+page_title: "TencentCloud: tencentcloud_ssm_secrets"
+sidebar_current: "docs-tencentcloud-datasource-ssm_secrets"
+description: |-
+  Use this data source to query detailed information of SSM secret
+---
+
+# tencentcloud_ssm_secrets
+
+Use this data source to query detailed information of SSM secret
+
+## Example Usage
+
+```hcl
+data "tencentcloud_ssm_secrets" "foo" {
+  secret_name = "test"
+  order_type  = 1
+  state       = 1
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `order_type` - (Optional) The order to sort the create time of secret. `0` - desc, `1` - asc. Default value is `0`.
+* `result_output_file` - (Optional) Used to save results.
+* `secret_name` - (Optional) Secret name used to filter result.
+* `state` - (Optional) Filter by state of secret. `0` - all secrets are queried, `1` - only Enabled secrets are queried, `2` - only Disabled secrets are queried, `3` - only PendingDelete secrets are queried.
+* `tags` - (Optional) Tags to filter secret.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `secret_list` - A list of SSM secrets.
+  * `create_time` - Create time of secret.
+  * `create_uin` - Uin of Creator.
+  * `delete_time` - Delete time of CMK.
+  * `description` - Description of secret.
+  * `kms_key_id` - KMS keyId used to encrypt secret.
+  * `secret_name` - Name of secret.
+  * `status` - Status of secret.
+
+

website/docs/r/ssm_secret.html.markdown

@@ -0,0 +1,66 @@
+---
+subcategory: "SSM"
+layout: "tencentcloud"
+page_title: "TencentCloud: tencentcloud_ssm_secret"
+sidebar_current: "docs-tencentcloud-resource-ssm_secret"
+description: |-
+  Provide a resource to create a SSM secret.
+---
+
+# tencentcloud_ssm_secret
+
+Provide a resource to create a SSM secret.
+
+## Example Usage
+
+```hcl
+resource "tencentcloud_ssm_secret" "foo" {
+  secret_name             = "test"
+  description             = "test secret"
+  recovery_window_in_days = 0
+  is_enabled              = true
+
+  init_secret {
+    version_id    = "v1"
+    secret_string = "123456"
+  }
+
+  tags = {
+    test-tag = "test"
+  }
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `init_secret` - (Required) The secret of initial version.
+* `secret_name` - (Required, ForceNew) Name of secret which cannot be repeated in the same region. The maximum length is 128 bytes. The name can only contain English letters, numbers, underscore and hyphen '-'. The first character must be a letter or number.
+* `description` - (Optional) Description of secret. The maximum is 2048 bytes.
+* `is_enabled` - (Optional) Specify whether to enable secret. Default value is `true`.
+* `kms_key_id` - (Optional, ForceNew) KMS keyId used to encrypt secret. If it is empty, it means that the CMK created by SSM for you by default is used for encryption. You can also specify the KMS CMK created by yourself in the same region for encryption.
+* `recovery_window_in_days` - (Optional) Specify the scheduled deletion date. Default value is `0` that means to delete immediately. 1-30 means the number of days reserved, completely deleted after this date.
+* `tags` - (Optional) Tags of secret.
+
+The `init_secret` object supports the following:
+
+* `version_id` - (Required) Version of secret. The maximum length is 64 bytes. The version_id can only contain English letters, numbers, underscore and hyphen '-'. The first character must be a letter or number.
+* `secret_binary` - (Optional) The base64-encoded binary secret. secret_binary and secret_string must be set only one, and the maximum support is 4096 bytes. When secret status is `Disabled`, this field will not update anymore.
+* `secret_string` - (Optional) The string text of secret. secret_binary and secret_string must be set only one, and the maximum support is 4096 bytes. When secret status is `Disabled`, this field will not update anymore.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `id` - ID of the resource.
+* `status` - Status of secret.
+
+
+## Import
+
+SSM secret can be imported using the secretName, e.g.
+```
+$ terraform import tencentcloud_ssm_secret.foo test
+```
+