chore(example/sms): refactor the task best practice (#7341)

Author: Lance52259

examples/sms/migration-task/README.md

@@ -0,0 +1,85 @@
+# Create a migration task
+
+This example provides best practice code for using Terraform to create a migration task in HuaweiCloud SMS service.
+
+## Prerequisites
+
+* A HuaweiCloud account
+* Terraform installed
+* HuaweiCloud access key and secret key (AK/SK)
+* SMS source server already exists and is registered
+
+## Required Variables
+
+The following variables need to be configured:
+
+### Authentication Variables
+
+* `region_name` - The region where the SMS task is located
+* `access_key` - The access key of the IAM user
+* `secret_key` - The secret key of the IAM user
+
+### Resource Variables
+
+#### Required Variables
+
+* `source_server_name` - The name of the SMS source server
+* `server_template_name` - The name of the SMS server template
+* `migrate_task_type` - The type of the SMS task (e.g., "MIGRATE_FILE" or "MIGRATE_BLOCK")
+* `server_os_type` - The OS type of the server (e.g., "LINUX" or "WINDOWS")
+
+## Usage
+
+* Copy this example script to your `main.tf`.
+
+* Create a `terraform.tfvars` file and fill in the required variables:
+
+  ```hcl
+  region_name = "cn-north-4"
+  access_key  = "your-access-key"
+  secret_key  = "your-secret-key"
+  
+  source_server_name   = "your_source_server_name"
+  server_template_name = "your_server_template_name"
+  migrate_task_type    = "MIGRATE_BLOCK"
+  server_os_type       = "WINDOWS"
+  ```
+
+* Initialize Terraform:
+
+  ```bash
+  $ terraform init
+  ```
+
+* Review the Terraform plan:
+
+  ```bash
+  $ terraform plan
+  ```
+
+* Apply the configuration:
+
+  ```bash
+  $ terraform apply
+  ```
+
+* To clean up the resources:
+
+  ```bash
+  $ terraform destroy
+  ```
+
+## Note
+
+* Make sure to keep your credentials secure and never commit them to version control
+* This example creates an SMS server template and migration task
+* The SMS source server must already exist and be registered in the SMS service
+* The migration task type and OS type are configurable via variables
+* All resources will be created in the specified region
+
+## Requirements
+
+| Name | Version |
+| ---- | ---- |
+| terraform | >= 0.12.0 |
+| huaweicloud | >= 1.37.0 |

examples/sms/migration-task/main.tf

@@ -0,0 +1,17 @@
+data "huaweicloud_availability_zones" "test" {}
+
+data "huaweicloud_sms_source_servers" "test" {
+  name = var.source_server_name
+}
+
+resource "huaweicloud_sms_server_template" "test" {
+  name              = var.server_template_name
+  availability_zone = try(data.huaweicloud_availability_zones.test.names[0], null)
+}
+
+resource "huaweicloud_sms_task" "test" {
+  type             = var.migrate_task_type
+  os_type          = var.server_os_type
+  source_server_id = try(data.huaweicloud_sms_source_servers.test.servers[0].id, null)
+  vm_template_id   = huaweicloud_sms_server_template.test.id
+}

examples/sms/migration-task/providers.tf

@@ -0,0 +1,14 @@
+terraform {
+  required_providers {
+    huaweicloud = {
+      source  = "huaweicloud/huaweicloud"
+      version = ">= 1.37.0"
+    }
+  }
+}
+
+provider "huaweicloud" {
+  region     = var.region_name
+  access_key = var.access_key
+  secret_key = var.secret_key
+}

examples/sms/migration-task/terraform.tfvars

@@ -0,0 +1,4 @@
+source_server_name   = "tf_source_server_name"
+server_template_name = "tf_server_template_name"
+migrate_task_type    = "MIGRATE_BLOCK"
+server_os_type       = "WINDOWS"

examples/sms/migration-task/variables.tf

@@ -0,0 +1,37 @@
+# Variable definitions for authentication
+variable "region_name" {
+  description = "The region where the SMS task is located"
+  type        = string
+}
+
+variable "access_key" {
+  description = "The access key of the IAM user"
+  type        = string
+}
+
+variable "secret_key" {
+  description = "The secret key of the IAM user"
+  type        = string
+}
+
+# Variable definitions for resources/data sources
+variable "source_server_name" {
+  description = "The name of the SMS source server"
+  type        = string
+  default     = null
+}
+
+variable "server_template_name" {
+  description = "The name of the SMS server template"
+  type        = string
+}
+
+variable "migrate_task_type" {
+  description = "The type of the SMS task"
+  type        = string
+}
+
+variable "server_os_type" {
+  description = "The OS type of the server"
+  type        = string
+}