1. In the terminal, check the Go version using this command:

   go version
   

   If Go is not installed, select the appropriate installation option from the Go website.

2. Clone the repository containing the Yandex Cloud SDK examples for Go:

   git clone https://github.com/yandex-cloud-examples/yc-sdk-quickstart-go.git
   

3. Go to your cloned repository and install the dependencies:

   cd yc-sdk-quickstart-go && go tidy
   

1. In the terminal, check the Python version using this command for Linux and macOS:

   python3 --version
   

   or Windows:

   python --version
   

   If Python is not installed, select the appropriate installation option from the Python website.

2. Clone the repository containing the Yandex Cloud SDK examples for Python:

   git clone https://github.com/yandex-cloud-examples/yc-sdk-quickstart-python.git
   

3. Go to your cloned repository and install the dependencies:

   cd yc-sdk-quickstart-python && pip install yandexcloud
   

1. In the terminal, check the Java version using this command:

   java --version
   

   If Java is not installed, select the appropriate installation option from the Oracle website.

2. Additionally, install Apache Maven to build your project.

3. Clone the repository containing the Yandex Cloud SDK examples for Java:

   git clone https://github.com/yandex-cloud-examples/yc-sdk-quickstart-java.git
   

4. Got to your cloned repository:

   cd yc-sdk-quickstart-java
   

Open the config.json file. It already contains a basic VM configuration, but you can customize it:

{
    "folder_id": "<folder_ID>",
    "username": "user",
    "resources": {
        "image": {
            "family": "ubuntu-2204-lts",
            "folder_family_id": "standard-images"
        },
        "name": "computer",
        "resources_spec": {
            "memory": 2147483648,
            "cores": 2
        },
        "boot_disk_spec": {
            "auto_delete": true,
            "disk_spec": {
                "type_id": "network-hdd",
                "size": 10737418240
            }
        },
        "zone_id": "ru-central1-d",
        "platform_id": "standard-v3",
        "subnet_id": "<subnet_ID>"
    },
    "metadata": {
        "ssh-keys": "USERNAME:SSH_PUBLIC_KEY",
        "user-data": "#cloud-config\n    datasource:\n      Ec2:\n        strict_id: false\n    users:\n      - name: USERNAME\n        sudo: 'ALL=(ALL) NOPASSWD:ALL'\n        shell: /bin/bash\n        ssh_authorized_keys:\n          - SSH_PUBLIC_KEY"
    },
    "labels": {
        "yc-sdk": "yes"
    }
}

Where:

• folder_id: Folder ID.
• username: VM username.
• family: Image family ID.
• folder_family_id: ID of the folder the images are in; for public images, standard-images.
• name: VM name.
• memory: RAM size, in bytes.
• cores: Number of vCPUs.
• auto_delete: Delete the disk together with the VM.
• type_id: VM disk type.
• size: Disk size, in bytes.
• zone_id: Availability zone you want to put the VM in.
• platform_id: Platform ID.
• subnet_id: Subnet ID.
• metadata: VM metadata.
• labels: VM label.

Open the config.json file. It already contains a basic VM configuration, but you can customize it:

{
    "folder_id": "<folder_ID>",
    "username": "user",
    "resources": {
        "image": {
            "family": "ubuntu-2204-lts",
            "folder_family_id": "standard-images"
        },
        "name": "computer",
        "resources_spec": {
            "memory": 2147483648,
            "cores": 2
        },
        "boot_disk_spec": {
            "auto_delete": true,
            "disk_spec": {
                "type_id": "network-hdd",
                "size": 10737418240
            }
        },
        "zone_id": "ru-central1-d",
        "platform_id": "standard-v3",
        "subnet_id": "<subnet_ID>"
    },
    "metadata": {
        "ssh-keys": "USERNAME:SSH_PUBLIC_KEY",
        "user-data": "#cloud-config\n    datasource:\n      Ec2:\n        strict_id: false\n    users:\n      - name: USERNAME\n        sudo: 'ALL=(ALL) NOPASSWD:ALL'\n        shell: /bin/bash\n        ssh_authorized_keys:\n          - SSH_PUBLIC_KEY"
    },
    "labels": {
        "yc-sdk": "yes"
    }
}

Where:

• folder_id: Folder ID.
• username: VM username.
• family: Image family ID.
• folder_family_id: ID of the folder the images are in; for public images, standard-images.
• name: VM name.
• memory: RAM size, in bytes.
• cores: Number of vCPUs.
• auto_delete: Delete the disk together with the VM.
• type_id: VM disk type.
• size: Disk size, in bytes.
• zone_id: Availability zone you want to put the VM in.
• platform_id: Platform ID.
• subnet_id: Subnet ID.
• metadata: VM metadata.
• labels: VM label.

Open the config.json file in the src/main/resources/config directory. It already has a basic VM configuration installed, and you need to specify folder_id and subnet_id. You can also set your custom parameters for other fields:

{
    "folder_id": "<folder_ID>",
    "username": "user",
    "resources": {
        "image": {
            "family": "ubuntu-2204-lts",
            "folder_family_id": "standard-images"
        },
        "name": "computer",
        "resources_spec": {
            "memory": 2147483648,
            "cores": 2
        },
        "boot_disk_spec": {
            "auto_delete": true,
            "disk_spec": {
                "type_id": "network-hdd",
                "size": 10737418240
            }
        },
        "zone_id": "ru-central1-d",
        "platform_id": "standard-v3",
        "subnet_id": "<subnet_ID>"
    },
    "metadata": {
        "ssh-keys": "USERNAME:SSH_PUBLIC_KEY",
        "user-data": "#cloud-config\n    datasource:\n      Ec2:\n        strict_id: false\n    users:\n      - name: USERNAME\n        sudo: 'ALL=(ALL) NOPASSWD:ALL'\n        shell: /bin/bash\n        ssh_authorized_keys:\n          - SSH_PUBLIC_KEY"
    },
    "labels": {
        "yc-sdk": "yes"
    }
}

Where:

• folder_id: Folder ID.
• username: VM username.
• family: Image family ID.
• folder_family_id: ID of the folder the images are in; for public images, standard-images.
• name: VM name.
• memory: RAM size, in bytes.
• cores: Number of vCPUs.
• auto_delete: Delete the disk together with the VM.
• type_id: VM disk type.
• size: Disk size, in bytes.
• zone_id: Availability zone you want to put the VM in.
• platform_id: Platform ID.
• subnet_id: Subnet ID.
• metadata: VM metadata.
• labels: VM label.

Run the main.go file using this command:

IAM_TOKEN=$(yc iam create-token) \
SSH_PUBLIC_KEY_PATH=./key.pub \
go run main.go

Where:

• IAM_TOKEN: IAM token you get with the help of the Yandex Cloud CLI.
• SSH_PUBLIC_KEY_PATH: Path to the file with the public SSH key.

Once you start creating a VM, you will see this text in the terminal:

Running Yandex.Cloud operation. ID: fv4qfujd49fc********

Where ID is the VM create operation ID.

Use the API or Yandex Cloud CLI for operation status monitoring.

Once your new VM is created, you will see the following mesage:

Created with id fv4qfujd49fc********

Where id is the VM ID.

Run the script.py file using this command:

IAM_TOKEN=$(yc iam create-token) \
SSH_PUBLIC_KEY_PATH=./key.pub \
python script.py

Where:

• IAM_TOKEN: IAM token you get with the help of the Yandex Cloud CLI.
• SSH_PUBLIC_KEY_PATH: Path to the file with the public SSH key.

The script runs in stages:

• Running the script to create a VM. If the script finds no data format errors, you will see the following message:

  INFO:yandexcloud._channels:Using endpoints from configuration, IAM iam.api.cloud.yandex.net:443, compute compute.api.cloud.yandex.net:443
  INFO:yandexcloud._channels:Using endpoints from configuration, IAM iam.api.cloud.yandex.net:443, compute compute.api.cloud.yandex.net:443
  INFO:root:Creating initiated
  

• Sending data to the server for validation. If all data is correct, you will see the following message:

  INFO:root:Running Yandex.Cloud operation. ID: fv45g3nfq0bn********. Description: Create instance. Created at: 2024-12-19 15:52:59. Created by: ajeutahec4**********. Meta: instance_id: "fv4bi87d50**********".
  INFO:yandexcloud._channels:Using endpoints from configuration, IAM iam.api.cloud.yandex.net:443, operation operation.api.cloud.yandex.net:443
  

  Where ID is the VM create operation ID.

  Use the API or Yandex Cloud CLI for operation status monitoring.

• Operation result. After creating a VM, you will get its details:

  INFO:root:Done Yandex.Cloud operation. ID: fv45g3nfq0bn********. Response: id: "fv42jgaq946dm8ibkjl6"
  folder_id: "b1g5hnqtug**********"
  created_at {
      seconds: 1734614895
  }
  name: "computer"
  zone_id: "ru-central1-d"
  platform_id: "standard-v3"
  resources {
      memory: 2147483648
      cores: 2
      core_fraction: 100
  }
  status: RUNNING
  metadata_options {
      gce_http_endpoint: ENABLED
      aws_v1_http_endpoint: ENABLED
      gce_http_token: ENABLED
      aws_v1_http_token: DISABLED
  }
  boot_disk {
      mode: READ_WRITE
      device_name: "fv4sd8kkspslntd0dpvn"
      auto_delete: true
      disk_id: "fv4sd8kkspslntd0dpvn"
  }
  network_interfaces {
      index: "0"
      mac_address: "d0:0d:29:c1:5a:49"
      subnet_id: "fl8b5ou7m8sihjbftcfk"
      primary_v4_address {
          address: "192.168.0.3"
          one_to_one_nat {
          address: "51.250.34.207"
          ip_version: IPV4
          }
      }
  }
  serial_port_settings {
      ssh_authorization: OS_LOGIN
  }
  gpu_settings {}
  fqdn: "fv42jgaq946dm8ibkjl6.auto.internal"
  scheduling_policy {}
  network_settings {
      type: STANDARD
  }
  placement_policy {}
  hardware_generation {
      legacy_features {
          pci_topology: PCI_TOPOLOGY_V1
      }
  }.
  WARNING: All log messages before absl::InitializeLog() is called are written to STDERR
  E0000 00:00:1734614936.026768 4332467 init.cc:229] grpc_wait_for_shutdown_with_timeout() timed out.
  

1. Build your project using this command:

   mvn clean package
   

2. In the root directory of the project, run the code using this command:

   IAM_TOKEN=$(yc iam create-token) \
   SSH_PUBLIC_KEY_PATH=key.pub \
   java -jar target/java-sdk-examples-2.6.4-jar-with-dependencies.jar  
   

   Where:

   • IAM_TOKEN: IAM token you get with the help of the Yandex Cloud CLI.
   • SSH_PUBLIC_KEY_PATH: Path to the file with the public SSH key.

   Once you start creating a VM, you will see this text in the terminal:

   Running Yandex.Cloud operation. ID: fv4qfujd49fc********
   

   Where ID is the VM create operation ID.

   Use the API or Yandex Cloud CLI for operation status monitoring.

   Once your new VM is created, you will see the following mesage:

   Created with id fv4qfujd49fc********
   

   Where id is the VM ID.