Привязка, замена и отвязка сервисного аккаунта

Привяжите сервисный аккаунт к виртуальной машине, чтобы безопасно получать и автоматически обновлять токены из метаданных ВМ.

Подробнее о привязке сервисного аккаунта и работе с его токеном читайте в практическом руководстве.

Привязать сервисный аккаунт к виртуальной машине

Веб-консоль
MWS CLI

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Виртуальные машины и выберите нужную виртуальную машину.
На вкладке Основное перейдите к редактированию сервисного аккаунта.
Выберите сервисный аккаунт или создайте новый.
Нажмите кнопку Сохранить.

Заменить сервисный аккаунт виртуальной машины

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Виртуальные машины и выберите нужную виртуальную машину.
На вкладке Основное перейдите к редактированию сервисного аккаунта.
Выберите другой сервисный аккаунт и нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя нового сервисного аккаунта.
Узнайте имя ВМ:
bash
```
1
mws compute vm list
```

Выполните команду:

1
mws compute vm update <имя ВМ> --service-account <имя сервисного аккаунта>

1
kind: compute/v1/virtualMachine
2
metadata:
3
    createTime: "2025-09-04T10:19:43Z"
4
    displayName: <имя ВМ>
5
    etag: e3af2e7d18f45ab58924d3cf9055e0cc
6
    id: projects/<имя проекта>/virtualMachines/<имя ВМ>
7
    name: <имя ВМ>
8
spec:
9
    hardware:
10
        power: ON
11
    network:
12
        networkInterfaces:
13
            - addresses:
14
                - address:
15
                    spec:
16
                        subnet: networks/<имя сети>/subnets/<имя подсети>
17
                oneToOneNat:
18
                    external:
19
                        address:
20
                            spec: {}
21
            name: nic0
22
            primary: true
23
    os:
24
        metadata: {}
25
    serviceAccount: iam/projects/<имя проекта>/serviceAccounts/<имя нового сервисного аккаунта>
26
...

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.
Узнайте имя нового сервисного аккаунта.

Узнайте имя ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>?updateOnly=true \
2
-H "Authorization: Bearer <токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
    "spec": {
6
        "serviceAccount": "iam/projects/<имя проекта>/serviceAccounts/<имя нового сервисного аккаунта>"
7
    }
8
}'

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>",
5
        "name": "<имя ВМ>",
6
        "displayName": "<имя ВМ>",
7
        "createTime": "2025-09-04T10:19:437651Z",
8
        "updateTime": "2025-09-04T10:25:14.583406Z",
9
        "etag": "e3af2e7d18f45ab58924d3cf9055e0cc"
10
    },
11
    "spec": {
12
        "zone": "ru-central1-a",
13
        "vmType": "vmTypes/gen-2-8",
14
        "hardware": {
15
            "power": "ON"
16
        },
17
        "os": {
18
            "metadata": {}
19
        },
20
        "network": {
21
            "networkInterfaces": [
22
                {
23
                    "name": "<имя сетевого интерфейса>",
24
                    "primary": true,
25
                    "addresses": [
26
                        {
27
                            "address": {
28
                                "spec": {
29
                                    "subnet": "networks/<имя сети>/subnets/<имя подсети>"
30
                                }
31
                            },
32
                            "oneToOneNat": {
33
                                "external": {
34
                                    "address": {
35
                                        "spec": {
36
                                            "version": "IPV4"
37
                                        }
38
                                    }
39
                                }
40
                            }
41
                        }
42
                    ]
43
                }
44
            ]
45
        }
46
    },
47
    ...
48
}

Отвязать сервисный аккаунт от виртуальной машины

Веб-консоль
MWS CLI
API

В веб-консоли выберите нужный проект.
В списке сервисов выберите Compute → Виртуальные машины и выберите нужную виртуальную машину.
На вкладке Основное перейдите к редактированию сервисного аккаунта.
Удалите сервисный аккаунт, нажав на значок x рядом с его именем.
Нажмите кнопку Сохранить.

Если у вас нет утилиты MWS CLI:
1. Установите утилиту.
2. Инициализируйте профиль.
Узнайте имя ВМ:
bash
```
1
mws compute vm list
```

Выполните команду:

1
mws compute vm update <имя ВМ> --service-account null

1
kind: compute/v1/virtualMachine
2
metadata:
3
    createTime: "2025-09-04T10:19:43Z"
4
    displayName: <имя ВМ>
5
    etag: e3af2e7d18f45ab58924d3cf9055e0cc
6
    id: projects/<имя проекта>/virtualMachines/<имя ВМ>
7
    name: <имя ВМ>
8
spec:
9
    hardware:
10
        power: ON
11
    network:
12
        networkInterfaces:
13
            - addresses:
14
                - address:
15
                    spec:
16
                        subnet: networks/<имя сети>/subnets/<имя подсети>
17
                oneToOneNat:
18
                    external:
19
                        address:
20
                            spec: {}
21
            name: nic0
22
            primary: true
23
    os:
24
        metadata: {}
25
    storage:
26
        disks: {}
27
    vmType: vmTypes/gen-2-8
28
    zone: ru-central1-a
29
status: {}

Убедитесь, что у вас есть IAM-токен для авторизации запроса. Если нет, получите его.

Узнайте имя ВМ:

1
curl -X GET https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines \
2
  -H "Authorization: Bearer <IAM-токен>"

Выполните запрос:

1
curl -X POST https://compute.mwsapis.ru/compute/v1/projects/<имя проекта>/virtualMachines/<имя ВМ>?updateOnly=true \
2
-H "Authorization: Bearer <токен>" \
3
-H "Content-Type: application/json" \
4
-d '{
5
    "spec": {
6
        "serviceAccount": null
7
    }
8
}'

1
{
2
    "kind": "compute/v1/virtualMachine",
3
    "metadata": {
4
        "id": "projects/<имя проекта>/virtualMachines/<имя ВМ>",
5
        "name": "<имя ВМ>",
6
        "displayName": "<имя ВМ>",
7
        "createTime": "2025-09-04T10:19:437651Z",
8
        "updateTime": "2025-09-04T10:25:14.583406Z",
9
        "etag": "e3af2e7d18f45ab58924d3cf9055e0cc"
10
    },
11
    "spec": {
12
        "zone": "ru-central1-a",
13
        "vmType": "vmTypes/gen-2-8",
14
        "hardware": {
15
            "power": "ON"
16
        },
17
        "os": {
18
            "metadata": {}
19
        },
20
        "network": {
21
            "networkInterfaces": [
22
                {
23
                    "name": "<имя сетевого интерфейса>",
24
                    "primary": true,
25
                    "addresses": [
26
                        {
27
                            "address": {
28
                                "spec": {
29
                                    "subnet": "networks/<имя сети>/subnets/<имя подсети>"
30
                                }
31
                            },
32
                            "oneToOneNat": {
33
                                "external": {
34
                                    "address": {
35
                                        "spec": {
36
                                            "version": "IPV4"
37
                                        }
38
                                    }
39
                                }
40
                            }
41
                        }
42
                    ]
43
                }
44
            ]
45
        }
46
    },
47
    ...
48
}