Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Identity and Access Management
    • All guides
    • Getting information about subjects
    • Processing secrets that have become publicly available
    • Users
    • User groups
      • Overview
        • Overview
        • Getting an IAM token for a Yandex account
        • Getting an IAM token for a service account
        • Getting an IAM token for a federated account
        • Getting an IAM token for a local user account
        • Revoking an IAM token
      • Managing static access keys
      • Managing API keys
      • Managing authorized keys
      • Creating a temporary access key using Security Token Service
      • Managing ephemeral access keys
  • Secure use of Yandex Cloud
  • Access management
  • Pricing policy
  • Role reference
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes

In this article:

  • Getting an IAM token using the YC CLI
  • Example of using an IAM token obtained via the CLI
  1. Step-by-step guides
  2. Authentication
  3. IAM tokens
  4. Getting an IAM token for a Yandex account
Written by
Yandex Cloud
Updated at November 2, 2026
View in Markdown
  • Getting an IAM token using the YC CLI
  • Example of using an IAM token obtained via the CLI

Note

These methods of getting an IAM token are intended for requests sent by a Yandex user account and are not recommended for automated solutions. If you want to automate your work with the Yandex Cloud API and get IAM tokens in software, see Getting an IAM token for a service account.

Getting an IAM token for a Yandex account

You can get an IAM token for your Yandex account using the CLI. You need to install the YC CLI to do it.

Note

The IAM token lifetime does not exceed 12 hours; however, we recommend requesting a token more often, e.g., every hour.

To have the IAM token reissued automatically, the export IAM_TOKEN=$(yc iam create-token) script can be used.

Getting an IAM token using the YC CLIGetting an IAM token using the YC CLI

CLI

If you do not have the Yandex Cloud CLI yet, install and initialize it.

  1. Authenticate to the CLI as a user.

  2. Get an IAM token:

    yc iam create-token
    

    Result:

    t1.9euelZrLop7Uz8up********
    

    The returned value is an IAM token. You can copy and save it to a file or store it in a variable:

    export IAM_TOKEN=`<IAM_token>`
    

Specify the received IAM token when accessing Yandex Cloud resources via the API. Provide the IAM token in the Authorization header in the following format:

Authorization: Bearer <IAM_token>

If you have saved your IAM token to a variable, use the latter:

Authorization: Bearer ${IAM_TOKEN}

Example of using an IAM token obtained via the CLIExample of using an IAM token obtained via the CLI

Sending a request to get a list of clouds using an IAM token:

Bash
PowerShell
  1. Get an IAM token and write it to the variable:

    export IAM_TOKEN=`yc iam create-token`
    
  2. Send a request to get a list of clouds:

    curl \
      --request GET \
      --header "Authorization: Bearer ${IAM_TOKEN}" \
      https://resource-manager.api.cloud.yandex.net/resource-manager/v1/clouds
    
  3. Result:

    {
    "clouds": [
      {
      "id": "b1gia87mbaom********",
      "createdAt": "2019-08-19T06:15:54Z",
      "name": "my-cloud-1",
      "organizationId": "my-organization"
      },
      {
      "id": "b1gue7m154kt********",
      "createdAt": "2022-08-29T13:27:03Z",
      "name": "my-cloud-2",
      "organizationId": "my-organization"
      }
    ]
    }
    
  1. Get an IAM token and write it to the variable:

    $IAM_TOKEN=yc iam create-token
    
  2. Send a request to get a list of clouds:

    curl.exe ` 
      --request GET ` 
      --header "Authorization: Bearer $IAM_TOKEN" ` 
      https://resource-manager.api.cloud.yandex.net/resource-manager/v1/clouds 
    
  3. Result:

    {
    "clouds": [
      {
      "id": "b1gia87mbaom********",
      "createdAt": "2019-08-19T06:15:54Z",
      "name": "my-cloud-1",
      "organizationId": "my-organization"
      },
      {
      "id": "b1gue7m154kt********",
      "createdAt": "2022-08-29T13:27:03Z",
      "name": "my-cloud-2",
      "organizationId": "my-organization"
      }
    ]
    }
    

Useful linksUseful links

  • Using an IAM token in a Helm chart
  • Revoking an IAM token

Was the article helpful?

Previous
Overview
Next
Getting an IAM token for a service account
© 2026 Direct Cursus Technology L.L.C.