[Документация Yandex Cloud](../../index.md) > [Yandex Object Storage](../index.md) > Справочник API > [AWS S3 REST](index.md) > Начало работы с S3 API # Начало работы с AWS S3 API в Yandex Object Storage [AWS S3 API](https://docs.aws.amazon.com/AmazonS3/latest/API/Type_API_Reference.html) — это интерфейс взаимодействия с сервисами AWS, совместимый с Yandex Object Storage. С помощью AWS S3 API вы создадите бакет, загрузите в него объект, получите список объектов в бакете, скачаете объект из бакета, удалите объект и удалите бакет. ## Подготовьте облако к работе {#before-you-begin} Зарегистрируйтесь в Yandex Cloud и создайте [платежный аккаунт](../../billing/concepts/billing-account.md): 1. Перейдите в [консоль управления](https://kz.console.yandex.cloud), затем войдите в Yandex Cloud или зарегистрируйтесь. 1. На странице **[Yandex Cloud Billing](https://kz.console.yandex.cloud/billing)** убедитесь, что у вас подключен платежный аккаунт, и он находится в [статусе](../../billing/concepts/billing-account-statuses.md) `ACTIVE` или `TRIAL_ACTIVE`. Если платежного аккаунта нет, [создайте его](../../billing/quickstart/index.md) и [привяжите](../../billing/operations/pin-cloud.md) к нему облако. Если у вас есть активный платежный аккаунт, вы можете создать или выбрать [каталог](../../resource-manager/concepts/resources-hierarchy.md#folder), в котором будет работать ваша инфраструктура, на [странице облака](https://kz.console.yandex.cloud/cloud). [Подробнее об облаках и каталогах](../../resource-manager/concepts/resources-hierarchy.md). ### Создайте сервисный аккаунт и подготовьте данные для аутентификации {#create-static-key} Для аутентификации в [AWS S3 API](api-ref/index.md) вы можете использовать: * [IAM-токен](../../iam/concepts/authorization/iam-token.md); * [статический ключ доступа](../../iam/concepts/authorization/access-key.md); * [временные ключи Security Token Service](../../iam/concepts/authorization/sts.md); * [эфемерные ключи доступа](../../iam/concepts/authorization/ephemeral-keys.md). {% note warning %} Рекомендованным способом аутентификации в AWS S3 API является аутентификация с помощью IAM-токена: этот способ более безопасен и, в отличие от аутентификации с помощью статического ключа, не требует создания [подписи запроса](signing-requests.md). {% endnote %} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} IAM-токен может выпускаться как для пользовательского, так и для сервисного аккаунта, а действия с использованием IAM-токена выполняются от имени того аккаунта, для которого этот IAM-токен был выпущен. При этом выполнять действия с бакетами и объектами безопаснее от имени сервисного аккаунта. 1. [Создайте сервисный аккаунт](../../iam/operations/sa/create.md). 1. [Назначьте](../../iam/operations/sa/assign-role-for-sa.md) сервисному аккаунту [роль](../security/index.md#storage-editor) `storage.editor` на каталог. Это позволит работать от имени этого сервисного аккаунта со всеми бакетами в каталоге. 1. Получите IAM-токен для созданного сервисного аккаунта. Подробнее читайте в инструкции [Получение IAM-токена для сервисного аккаунта](../../iam/operations/iam-token/create-for-sa.md). {% note tip %} Чтобы быстро получить IAM-токен сервисного аккаунта с помощью [Yandex Cloud CLI](../../cli/index.md), вы можете [воспользоваться имперсонацией](../../iam/operations/sa/impersonate-sa.md). {% endnote %} - Аутентификация с помощью статического ключа {#static-key} Статический ключ доступа выпускается только для [сервисного аккаунта](../../iam/concepts/users/service-accounts.md), и все действия с использованием статического ключа выполняются от имени этого сервисного аккаунта. {% note info %} Чтобы использовать AWS S3 API с аутентификацией с помощью статического ключа доступа напрямую, без SDK и приложений, необходимо самостоятельно [подписывать запросы](signing-requests.md). Процесс формирования запроса и подписи вы можете отработать с помощью AWS CLI в [режиме отладки](signing-requests.md#debugging). {% endnote %} 1. [Создайте сервисный аккаунт](../../iam/operations/sa/create.md). 1. [Назначьте](../../iam/operations/sa/assign-role-for-sa.md) сервисному аккаунту [роль](../security/index.md#storage-editor) `storage.editor` на каталог. Это позволит работать от имени этого сервисного аккаунта со всеми бакетами в каталоге. 1. [Создайте статический ключ доступа](../../iam/operations/authentication/manage-access-keys.md#create-access-key). В результате вы получите данные статического ключа доступа. Для аутентификации в Object Storage вам понадобятся: * `key_id` — идентификатор статического ключа доступа; * `secret` — секретный ключ. Сохраните `key_id` и `secret`, так как повторное получение значения ключа будет невозможно. 1. Установите утилиту [curl](https://curl.se/). Начиная с версии [8.3.0](https://curl.se/changes.html) утилита `curl` при работе с AWS S3 API поддерживает автоматическое формирование [строки для подписи](signing-requests.md#string-to-sign-gen), [подпись запроса](signing-requests.md#signing) и подстановку необходимых заголовков. При использовании более ранних версий утилиты `curl` вы можете формировать необходимые заголовки и подписывать запросы вручную. {% endlist %} ## Создайте бакет {#create-bucket} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) создаваемого бакета. 1. Выполните HTTP-запрос: ```bash curl \ --request PUT \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Wed, 14 Jan 2026 08:37:55 GMT < content-type: application/octet-stream < location: /my-sample-bucket < x-amz-request-id: cd6bd702******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) создаваемого бакета. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" DATE_VALUE=`date -R` STRING_TO_SIGN="PUT\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) создаваемого бакета. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request PUT \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Wed, 14 May 2025 20:00:04 GMT < content-type: application/octet-stream < location: /my-sample-bucket < x-amz-request-id: a5cf0b8d******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash curl \ --request PUT \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 07:06:22 GMT < content-type: application/octet-stream < location: /my-sample-bucket < x-amz-request-id: b8c1bd45******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% endlist %} ## Загрузите объект в бакет {#upload-object} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" LOCAL_FILE="<путь_к_локальному_файлу>" OBJECT_PATH="<ключ_объекта>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в который загружается файл. * `LOCAL_FILE` — путь к локальному файлу, который вы хотите загрузить в бакет. Например: `./sample.txt`. * `OBJECT_PATH` — [ключ](../concepts/object.md#key), который будет присвоен объекту в бакете. Например: `new-prefix/sample-object.txt`. 1. Выполните HTTP-запрос: ```bash curl \ --request PUT \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --upload-file "${LOCAL_FILE}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Wed, 14 Jan 2026 10:42:41 GMT < content-type: text/plain < etag: "65a8e27d8879283831b664bd********" < x-amz-request-id: 646150ef******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" LOCAL_FILE="<путь_к_локальному_файлу>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `LOCAL_FILE` — путь к локальному файлу, который вы хотите загрузить в бакет. Например: `./sample.txt`. * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в который загружается файл. * `OBJECT_PATH` — [ключ](../concepts/object.md#key), который будет присвоен объекту в бакете. Например: `new-prefix/sample-object.txt`. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" LOCAL_FILE="<путь_к_локальному_файлу>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" DATE_VALUE=`date -R` STRING_TO_SIGN="PUT\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}/${OBJECT_PATH}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `LOCAL_FILE` — путь к локальному файлу, который вы хотите загрузить в бакет. Например: `./sample.txt`. * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в который загружается файл. * `OBJECT_PATH` — [ключ](../concepts/object.md#key), который будет присвоен объекту в бакете. Например: `new-prefix/sample-object.txt`. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request PUT \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --upload-file "${LOCAL_FILE}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 07:17:46 GMT < content-type: text/plain < etag: "f75a361db63aa4722fb8e083********" < x-amz-request-id: 40afeceb******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ``` curl \ --request PUT \ --upload-file "${LOCAL_FILE}" \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 07:23:08 GMT < content-type: text/plain < etag: "f75a361db63aa4722fb8e083********" < x-amz-request-id: 67ccce91******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% endlist %} ## Получите список объектов в бакете {#list-bucket-objects} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) бакета, список объектов которого требуется получить. 1. Выполните HTTP-запрос: ```bash curl \ --request GET \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}?list-type=2" ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Wed, 14 Jan 2026 11:15:43 GMT < content-type: application/xml; charset=UTF-8 < content-length: 583 < x-amz-request-id: 91e2b09f05f16f54 < * Connection #0 to host storage.yandexcloud.kz left intact 1 my-sample-bucket 1000 false new-prefix/sample-object.txt 2026-01-14T10:42:41.040Z ajeg2b2et02f******** ajeg2b2et02f******** "65a8e27d8879283831b664bd********" 13 STANDARD ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) бакета, список объектов которого требуется получить. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" DATE_VALUE=`date -R` STRING_TO_SIGN="GET\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) бакета, список объектов которого требуется получить. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request GET \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}?list-type=2" ``` Результат: ```xml ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 07:44:41 GMT < content-type: application/xml; charset=UTF-8 < content-length: 569 < x-amz-request-id: cab0999d******** < * Connection #0 to host storage.yandexcloud.kz left intact 1 my-sample-bucket 1000 false text.txt 2025-05-15T07:23:08.030Z ajegtlf2q28a******** ajegtlf2q28a******** "f75a361db63aa4722fb8e083********" 103 STANDARD ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ``` curl \ --request GET \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}?list-type=2" ``` Результат: ```xml ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 08:29:36 GMT < content-type: application/xml; charset=UTF-8 < content-length: 569 < x-amz-request-id: cb4b9a3d******** < * Connection #0 to host storage.yandexcloud.kz left intact 1 my-sample-bucket 1000 false text.txt 2025-05-15T07:23:08.030Z ajegtlf2q28a******** ajegtlf2q28a******** "f75a361db63aa4722fb8e083********" 103 STANDARD ``` {% endcut %} {% endlist %} ## Скачайте объект из бакета {#download-object} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" LOCAL_FILE="<путь_к_локальному_файлу>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в котором находится скачиваемый объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) скачиваемого объекта в бакете. Например: `new-prefix/sample-object.txt`. * `LOCAL_FILE` — путь к локальному файлу, в который вы хотите сохранить скачанный объект. Например: `./sample.txt`. 1. Выполните HTTP-запрос: ```bash curl \ --request GET \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" \ > ${LOCAL_FILE} ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Wed, 14 Jan 2026 11:22:01 GMT < content-type: application/octet-stream < content-length: 13 < accept-ranges: bytes < etag: "65a8e27d8879283831b664bd********" < last-modified: Wed, 14 Jan 2026 10:42:41 GMT < x-amz-request-id: 93c9edaf******** < { [13 bytes data] 100 13 100 13 0 0 69 0 --:--:-- --:--:-- --:--:-- 69 * Connection #0 to host storage.yandexcloud.kz left intact ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" LOCAL_FILE="<путь_к_локальному_файлу>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в котором находится скачиваемый объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) скачиваемого объекта в бакете. Например: `new-prefix/sample-object.txt`. * `LOCAL_FILE` — путь к локальному файлу, в который вы хотите сохранить скачанный объект. Например: `./sample.txt`. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" LOCAL_FILE="<путь_к_локальному_файлу>" DATE_VALUE=`date -R` STRING_TO_SIGN="GET\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}/${OBJECT_PATH}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), в котором находится скачиваемый объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) скачиваемого объекта в бакете. Например: `new-prefix/sample-object.txt`. * `LOCAL_FILE` — путь к локальному файлу, в который вы хотите сохранить скачанный объект. Например: `./sample.txt`. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request GET \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" \ > ${LOCAL_FILE} ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 08:55:19 GMT < content-type: text/plain < content-length: 103 < accept-ranges: bytes < etag: "f75a361db63aa4722fb8e083********" < last-modified: Thu, 15 May 2025 07:23:08 GMT < x-amz-request-id: 1afc3ec9******** < { [103 bytes data] 100 103 100 103 0 0 1925 0 --:--:-- --:--:-- --:--:-- 1943 * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash curl \ --request GET \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" \ > ${LOCAL_FILE} ``` Результат: ```text ... < HTTP/2 200 < server: nginx < date: Thu, 15 May 2025 09:11:12 GMT < content-type: text/plain < content-length: 103 < accept-ranges: bytes < etag: "f75a361db63aa4722fb8e083********" < last-modified: Thu, 15 May 2025 07:23:08 GMT < x-amz-request-id: e86c7119******** < { [103 bytes data] 100 103 100 103 0 0 3433 0 --:--:-- --:--:-- --:--:-- 3433 * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% endlist %} Скачанный объект сохранен в файл, путь к которому задан в переменной `LOCAL_FILE`. ## Удалите объект в бакете {#delete-object} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), из которого удаляется объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) удаляемого объекта в бакете. Например: `new-prefix/sample-object.txt`. 1. Выполните HTTP-запрос: ```bash curl \ --request DELETE \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Wed, 14 Jan 2026 11:26:02 GMT < x-amz-request-id: dba1c5e2******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), из которого удаляется объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) удаляемого объекта в бакете. Например: `new-prefix/sample-object.txt`. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" OBJECT_PATH="<ключ_объекта>" DATE_VALUE=`date -R` STRING_TO_SIGN="DELETE\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}/${OBJECT_PATH}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя бакета](../concepts/bucket.md#naming), из которого удаляется объект. * `OBJECT_PATH` — [ключ](../concepts/object.md#key) удаляемого объекта в бакете. Например: `new-prefix/sample-object.txt`. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request DELETE \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Thu, 15 May 2025 14:24:01 GMT < x-amz-request-id: 7d2f023c******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ``` curl \ --request DELETE \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}/${OBJECT_PATH}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Thu, 15 May 2025 14:30:28 GMT < x-amz-request-id: 7dc0c426******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% endlist %} ## Удалите бакет {#delete-bucket} {% list tabs group=auth_keys %} - Аутентификация с помощью IAM-токена {#iam-token} 1. Задайте переменные, содержащие необходимые данные: ```bash IAM_TOKEN="<содержимое_IAM-токена>" BUCKET_NAME="<имя_бакета>" ``` Где: * `IAM_TOKEN` — тело [полученного ранее](#create-static-key) IAM-токена сервисного аккаунта. * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) удаляемого бакета. Удаляемый бакет не должен содержать объектов. 1. Выполните HTTP-запрос: ```bash curl \ --request DELETE \ --header "Authorization: Bearer ${IAM_TOKEN}" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Wed, 14 Jan 2026 11:27:40 GMT < x-amz-request-id: 2f8de94e******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` - Аутентификация с помощью статического ключа {#static-key} 1. Задайте переменные, содержащие необходимые данные: {% cut "Версия curl 8.3.0 и выше" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) удаляемого бакета. Удаляемый бакет не должен содержать объектов. {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ```bash AWS_KEY_ID="<идентификатор_статического_ключа>" AWS_SECRET_KEY="<секретный_ключ>" BUCKET_NAME="<имя_бакета>" DATE_VALUE=`date -R` STRING_TO_SIGN="DELETE\n\n${CONTENT_TYPE}\n${DATE_VALUE}\n/${BUCKET_NAME}" SIGNATURE=`echo -en ${STRING_TO_SIGN} | openssl sha1 -hmac ${AWS_SECRET_KEY} -binary | base64` ``` Где: * `AWS_KEY_ID` — [идентификатор](../../iam/concepts/authorization/access-key.md#key-id) статического ключа доступа. * `AWS_SECRET_KEY` — [секретный ключ](../../iam/concepts/authorization/access-key.md#private-key). * `BUCKET_NAME` — [имя](../concepts/bucket.md#naming) удаляемого бакета. Удаляемый бакет не должен содержать объектов. {% endcut %} 1. Выполните HTTP-запрос: {% cut "Версия curl 8.3.0 и выше" %} ```bash curl \ --request DELETE \ --user "${AWS_KEY_ID}:${AWS_SECRET_KEY}" \ --aws-sigv4 "aws:amz:kz1:s3" \ --verbose \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Thu, 15 May 2025 14:35:57 GMT < x-amz-request-id: 6a13b7ae******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% cut "Версия curl 8.2.1 и ниже" %} ``` curl \ --request DELETE \ --verbose \ --header "Host: storage.yandexcloud.kz" \ --header "Date: ${DATE_VALUE}" \ --header "Authorization: AWS ${AWS_KEY_ID}:${SIGNATURE}" \ "https://storage.yandexcloud.kz/${BUCKET_NAME}" ``` Результат: ```text ... < HTTP/2 204 < server: nginx < date: Thu, 15 May 2025 14:39:15 GMT < x-amz-request-id: 331b2dc4******** < * Connection #0 to host storage.yandexcloud.kz left intact ``` {% endcut %} {% endlist %} #### Полезные ссылки {#see-also} * [Как пользоваться S3 API](index.md) * [Аутентификация в API Object Storage](../api-ref/authentication.md) * [Подписывание запросов](signing-requests.md) * [Вебинар: как с помощью Cloud CDN и Object Storage разгрузить высоконагруженную инфраструктуру](https://yandex.cloud/ru/events/1489?utm_source=docs&utm_medium=yandex&utm_campaign=infra&utm_content=vebinar&utm_term=cdns3)