Merge pull request #289 from volterraedge/13Dec24Release

13 dec 2024 release

docs/resources/volterra_active_alert_policies.md

@@ -1,6 +1,7 @@
 ---
 
-page_title: "Volterra: active_alert_policies"
+page_title: "Volterra: active_alert_policies" 
+
 description: "The active_alert_policies allows setting of Active Alert Policies for a namespace on Volterra SaaS"
 
 ---

docs/resources/volterra_active_network_policies.md

@@ -1,6 +1,7 @@
 ---
 
-page_title: "Volterra: active_network_policies"
+page_title: "Volterra: active_network_policies" 
+
 description: "The active_network_policies allows setting of Active Network Policies for a namespace on Volterra SaaS"
 
 ---

docs/resources/volterra_active_service_policies.md

@@ -1,6 +1,7 @@
 ---
 
-page_title: "Volterra: active_service_policies"
+page_title: "Volterra: active_service_policies" 
+
 description: "The active_service_policies allows setting of Active Service Policies for a namespace on Volterra SaaS"
 
 ---

docs/resources/volterra_advertise_policy.md

@@ -1,9 +1,9 @@
 ---
 
 page_title: "Volterra: advertise_policy"
-description: "The advertise_policy allows CRUD of Advertise Policy resource on Volterra SaaS"
 
----
+description: "The advertise_policy allows CRUD of Advertise Policy resource on Volterra SaaS"
+---------------------------------------------------------------------------------------------
 
 Resource volterra_advertise_policy
 ==================================

docs/resources/volterra_alert_policy.md

@@ -1,9 +1,9 @@
 ---
 
 page_title: "Volterra: alert_policy"
-description: "The alert_policy allows CRUD of Alert Policy resource on Volterra SaaS"
 
----
+description: "The alert_policy allows CRUD of Alert Policy resource on Volterra SaaS"
+-------------------------------------------------------------------------------------
 
 Resource volterra_alert_policy
 ==============================
@@ -33,31 +33,7 @@ resource "volterra_alert_policy" "example" {
 
     // One of the arguments from this list "alertname alertname_regex any custom group severity" can be set
 
-    custom {
-      alertlabel {
-        // One of the arguments from this list "exact_match regex_match" must be set
-
-        exact_match = "Major"
-      }
-
-      alertname {
-        // One of the arguments from this list "exact_match regex_match" must be set
-
-        exact_match = "Major"
-      }
-
-      group {
-        // One of the arguments from this list "exact_match regex_match" must be set
-
-        exact_match = "Major"
-      }
-
-      severity {
-        // One of the arguments from this list "exact_match regex_match" must be set
-
-        regex_match = "Major|Critical"
-      }
-    }
+    any = true
     notification_parameters {
       // One of the arguments from this list "custom default individual ves_io_group" must be set
 

docs/resources/volterra_alert_receiver.md

@@ -1,9 +1,9 @@
 ---
 
 page_title: "Volterra: alert_receiver"
-description: "The alert_receiver allows CRUD of Alert Receiver resource on Volterra SaaS"
 
----
+description: "The alert_receiver allows CRUD of Alert Receiver resource on Volterra SaaS"
+-----------------------------------------------------------------------------------------
 
 Resource volterra_alert_receiver
 ================================
@@ -38,12 +38,8 @@ resource "volterra_alert_receiver" "example" {
 
       // One of the arguments from this list "blindfold_secret_info clear_secret_info vault_secret_info wingman_secret_info" must be set
 
-      blindfold_secret_info {
-        decryption_provider = "value"
-
-        location = "string:///U2VjcmV0SW5mb3JtYXRpb24="
-
-        store_provider = "value"
+      wingman_secret_info {
+        name = "ChargeBack-API-Key"
       }
     }
   }

docs/resources/volterra_allowed_tenant.md

@@ -1,6 +1,7 @@
 ---
 
-page_title: "Volterra: allowed_tenant"
+page_title: "Volterra: allowed_tenant" 
+
 description: "The allowed_tenant allows CRUD of Allowed Tenant resource on Volterra SaaS"
 
 ---

docs/resources/volterra_api_crawler.md

@@ -0,0 +1,162 @@
+---
+
+page_title: "Volterra: api_crawler"
+
+description: "The api_crawler allows CRUD of Api Crawler resource on Volterra SaaS"
+-----------------------------------------------------------------------------------
+
+Resource volterra_api_crawler
+=============================
+
+The Api Crawler allows CRUD of Api Crawler resource on Volterra SaaS
+
+~> **Note:** Please refer to [Api Crawler API docs](https://docs.cloud.f5.com/docs-v2/api/api-crawler) to learn more
+
+Example Usage
+-------------
+
+```hcl
+resource "volterra_api_crawler" "example" {
+  name      = "acmecorp-web"
+  namespace = "staging"
+
+  domains {
+    domain = "domain"
+
+    simple_login {
+      password {
+        blindfold_secret_info_internal {
+          decryption_provider = "value"
+
+          location = "string:///U2VjcmV0SW5mb3JtYXRpb24="
+
+          store_provider = "value"
+        }
+
+        secret_encoding_type = "secret_encoding_type"
+
+        // One of the arguments from this list "blindfold_secret_info clear_secret_info vault_secret_info wingman_secret_info" must be set
+
+        blindfold_secret_info {
+          decryption_provider = "value"
+
+          location = "string:///U2VjcmV0SW5mb3JtYXRpb24="
+
+          store_provider = "value"
+        }
+      }
+
+      user = "user"
+    }
+  }
+}
+
+```
+
+Argument Reference
+------------------
+
+### Metadata Argument Reference
+
+`annotations` - (Optional) queryable and should be preserved when modifying objects. (`String`).
+
+`description` - (Optional) Human readable description for the object (`String`).
+
+`disable` - (Optional) A value of true will administratively disable the object (`Bool`).
+
+`labels` - (Optional) by selector expression (`String`).
+
+`name` - (Required) The value of name has to follow DNS-1035 format. (`String`).
+
+`namespace` - (Optional) Must be a DNS_LABEL format. For a namespace object itself, namespace value will be "" (`String`).
+
+### Spec Argument Reference
+
+`domains` - (Required) API Crawler Configuration. See [Domains ](#domains) below for details.
+
+### Domains
+
+API Crawler Configuration.
+
+`domain` - (Required) Select the domain to execute API Crawling with given credentials. (`String`).
+
+`simple_login` - (Required) Username and Password to assign credentials for the selected domain to crawl. See [Domains Simple Login ](#domains-simple-login) below for details.
+
+### Domains Simple Login
+
+Username and Password to assign credentials for the selected domain to crawl.
+
+`password` - (Required) x-displayName: "Password". See [Simple Login Password ](#simple-login-password) below for details.
+
+`user` - (Required) x-displayName: "User" (`String`).
+
+### Password Blindfold Secret Info Internal
+
+Blindfold Secret Internal is used for the putting re-encrypted blindfold secret.
+
+`decryption_provider` - (Optional) Name of the Secret Management Access object that contains information about the backend Secret Management service. (`String`).
+
+`location` - (Required) Or it could be a path if the store provider is an http/https location (`String`).
+
+`store_provider` - (Optional) This field needs to be provided only if the url scheme is not string:/// (`String`).
+
+### Secret Info Oneof Blindfold Secret Info
+
+Blindfold Secret is used for the secrets managed by F5XC Secret Management Service.
+
+`decryption_provider` - (Optional) Name of the Secret Management Access object that contains information about the backend Secret Management service. (`String`).
+
+`location` - (Required) Or it could be a path if the store provider is an http/https location (`String`).
+
+`store_provider` - (Optional) This field needs to be provided only if the url scheme is not string:/// (`String`).
+
+### Secret Info Oneof Clear Secret Info
+
+Clear Secret is used for the secrets that are not encrypted.
+
+`provider` - (Optional) This field needs to be provided only if the url scheme is not string:/// (`String`).
+
+`url` - (Required) When asked for this secret, caller will get Secret bytes after Base64 decoding. (`String`).
+
+### Secret Info Oneof Vault Secret Info
+
+Vault Secret is used for the secrets managed by Hashicorp Vault.
+
+`key` - (Optional) If not provided entire secret will be returned. (`String`).
+
+`location` - (Required) Path to secret in Vault. (`String`).
+
+`provider` - (Required) Name of the Secret Management Access object that contains information about the backend Vault. (`String`).
+
+`secret_encoding` - (Optional) This field defines the encoding type of the secret BEFORE the secret is put into Hashicorp Vault. (`String`).
+
+`version` - (Optional) If not provided latest version will be returned. (`Int`).
+
+### Secret Info Oneof Wingman Secret Info
+
+Secret is given as bootstrap secret in F5XC Security Sidecar.
+
+`name` - (Required) Name of the secret. (`String`).
+
+### Simple Login Password
+
+x-displayName: "Password".
+
+`blindfold_secret_info_internal` - (Optional) Blindfold Secret Internal is used for the putting re-encrypted blindfold secret. See [Password Blindfold Secret Info Internal ](#password-blindfold-secret-info-internal) below for details.(Deprecated)
+
+`secret_encoding_type` - (Optional) e.g. if a secret is base64 encoded and then put into vault. (`String`).(Deprecated)
+
+###### One of the arguments from this list "blindfold_secret_info, clear_secret_info, vault_secret_info, wingman_secret_info" must be set
+
+`blindfold_secret_info` - (Optional) Blindfold Secret is used for the secrets managed by F5XC Secret Management Service. See [Secret Info Oneof Blindfold Secret Info ](#secret-info-oneof-blindfold-secret-info) below for details.
+
+`clear_secret_info` - (Optional) Clear Secret is used for the secrets that are not encrypted. See [Secret Info Oneof Clear Secret Info ](#secret-info-oneof-clear-secret-info) below for details.
+
+`vault_secret_info` - (Optional) Vault Secret is used for the secrets managed by Hashicorp Vault. See [Secret Info Oneof Vault Secret Info ](#secret-info-oneof-vault-secret-info) below for details.(Deprecated)
+
+`wingman_secret_info` - (Optional) Secret is given as bootstrap secret in F5XC Security Sidecar. See [Secret Info Oneof Wingman Secret Info ](#secret-info-oneof-wingman-secret-info) below for details.(Deprecated)
+
+Attribute Reference
+-------------------
+
+-	`id` - This is the id of the configured api_crawler.

docs/resources/volterra_api_credential.md

@@ -1,6 +1,7 @@
 ---
 
-page_title: "Volterra: volterra_api_credential"
+page_title: "Volterra: volterra_api_credential" 
+
 description: "The volterra_api_credential allows creation of api_credential object on Volterra SaaS"
 
 ---
@@ -25,6 +26,7 @@ Example Usage
 
 ```hcl
 resource "volterra_api_credential" "example" {
+  created_at = timestamp()
   name      = "api-cred-example"
   api_credential_type = "KUBE_CONFIG"
   virtual_k8s_namespace = "ns1"
@@ -40,6 +42,8 @@ Argument Reference
 
 `name` - (Required) The value of name has to follow DNS-1035 format. (`String`).
 
+`created_at` - (Required) This field has been introduced to deal with renewing an expired credential. Valid values are `timestamp()` or a UTC timestamp string in RFC 3339 format. (`String`).
+
 `api_credential_type` - (Required) Types of API credential given. Valid values are `API_CERTIFICATE`, `KUBE_CONFIG`, `API_TOKEN` (`String`).
 
 `virtual_k8s_namespace` - (Optional) Namespace of virtual_k8s cluster. Applicable when `api_credential_type` is `KUBE_CONFIG` (`String`).
@@ -50,6 +54,8 @@ Argument Reference
 
 `expiry_days` - (Optional) Number of days after which the certificate will be expired (`Int`).
 
+`automatic_approval_api_token` - (Optional) A value of true will renew an expired user's credential. Renewal is only supported for the credential type API_TOKEN.(`Bool`\)
+
 Attribute Reference
 -------------------
 

docs/resources/volterra_api_definition.md

@@ -1,9 +1,9 @@
 ---
 
 page_title: "Volterra: api_definition"
-description: "The api_definition allows CRUD of Api Definition resource on Volterra SaaS"
 
----
+description: "The api_definition allows CRUD of Api Definition resource on Volterra SaaS"
+-----------------------------------------------------------------------------------------
 
 Resource volterra_api_definition
 ================================

docs/resources/volterra_api_discovery.md

@@ -0,0 +1,58 @@
+---
+
+page_title: "Volterra: api_discovery"
+
+description: "The api_discovery allows CRUD of Api Discovery resource on Volterra SaaS"
+---------------------------------------------------------------------------------------
+
+Resource volterra_api_discovery
+===============================
+
+The Api Discovery allows CRUD of Api Discovery resource on Volterra SaaS
+
+~> **Note:** Please refer to [Api Discovery API docs](https://docs.cloud.f5.com/docs-v2/api/api-discovery) to learn more
+
+Example Usage
+-------------
+
+```hcl
+resource "volterra_api_discovery" "example" {
+  name      = "acmecorp-web"
+  namespace = "staging"
+}
+
+```
+
+Argument Reference
+------------------
+
+### Metadata Argument Reference
+
+`annotations` - (Optional) queryable and should be preserved when modifying objects. (`String`).
+
+`description` - (Optional) Human readable description for the object (`String`).
+
+`disable` - (Optional) A value of true will administratively disable the object (`Bool`).
+
+`labels` - (Optional) by selector expression (`String`).
+
+`name` - (Required) The value of name has to follow DNS-1035 format. (`String`).
+
+`namespace` - (Optional) Must be a DNS_LABEL format. For a namespace object itself, namespace value will be "" (`String`).
+
+### Spec Argument Reference
+
+`custom_auth_types` - (Optional) Select your custom authentication types to be detected in the API discovery. See [Custom Auth Types ](#custom-auth-types) below for details.
+
+### Custom Auth Types
+
+Select your custom authentication types to be detected in the API discovery.
+
+`parameter_name` - (Required) The authentication parameter name. (`String`).
+
+`parameter_type` - (Required) x-displayName: "Parameter Type" (`String`).
+
+Attribute Reference
+-------------------
+
+-	`id` - This is the id of the configured api_discovery.