From fc2b5acf231fec90d4c5696c52e467e043c9647c Mon Sep 17 00:00:00 2001 From: Ilya Torbin Date: Tue, 28 Jul 2026 23:31:48 +0300 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D1=8B=20AWS=20CLI=20=D0=B8=20API=20=D0=BD=D0=B0=20=D1=81?= =?UTF-8?q?=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86=D1=83=20=D1=81=20=D0=B8?= =?UTF-8?q?=D0=BD=D1=84=D0=BE=D1=80=D0=BC=D0=B0=D1=86=D0=B8=D0=B5=D0=B9=20?= =?UTF-8?q?=D0=BE=20=D0=B1=D0=B0=D0=BA=D0=B5=D1=82=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Страница «Получение информации и статистики о бакете» показывала только консоль управления и yc storage bucket, хотя оба раздела полностью поддержаны в API. В раздел про информацию о бакете добавил: * AWS CLI: head-bucket как проверка существования бакета и прав доступа, со ссылкой на коды ответов S3 API; * API: методы Bucket/get, BucketService/Get и headBucket, пример запроса curl и разбор параметра view. Значения VIEW_BASIC, VIEW_ACL и VIEW_FULL отличаются составом ответа, и по одному только справочнику неочевидно, что acl, cors, websiteSettings, lifecycleRules и tags в базовом ответе не приходят. В раздел про статистику добавил вкладку API с методами Bucket/getStats и BucketService/GetStats, примером запроса и описанием полей usedSize, storageClassUsedSizes и storageClassCounters. --- ru/storage/operations/buckets/get-info.md | 62 +++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/ru/storage/operations/buckets/get-info.md b/ru/storage/operations/buckets/get-info.md index e975e5206ec..1c8f8713240 100644 --- a/ru/storage/operations/buckets/get-info.md +++ b/ru/storage/operations/buckets/get-info.md @@ -66,6 +66,50 @@ description: Следуя данной инструкции, вы сможете redirect_all_requests: {} ``` +- AWS CLI {#aws-cli} + + 1. Если у вас еще нет AWS CLI, [установите и сконфигурируйте его](../../tools/aws-cli.md). + 1. Проверьте, что бакет существует и доступен вам: + + ```bash + aws s3api head-bucket \ + --bucket <имя_бакета> \ + --endpoint-url=https://{{ s3-storage-host }} + ``` + + Где: + + * `--bucket` — имя бакета. + * `--endpoint-url` — эндпоинт {{ objstorage-name }}. + + Если бакета нет или прав на него не хватает, команда завершится ошибкой. Перечень возможных ответов приведен в разделе [{#T}](../../s3/api-ref/response-codes.md). + + Отдельные настройки бакета возвращают методы S3 API — например, `get-bucket-versioning` для [версионирования](../../concepts/versioning.md) и `get-bucket-encryption` для [шифрования](../../concepts/encryption.md). + +- API {#api} + + Чтобы получить информацию о [бакете](../../concepts/bucket.md), воспользуйтесь методом REST API [get](../../api-ref/Bucket/get.md) для ресурса [Bucket](../../api-ref/Bucket/index.md), вызовом gRPC API [BucketService/Get](../../api-ref/grpc/Bucket/get.md) или методом S3 API [headBucket](../../s3/api-ref/bucket/getmeta.md). + + Объем возвращаемых данных задается параметром `view`: + + * `VIEW_BASIC` — основные сведения о бакете. В ответе не будет полей `acl`, `cors`, `websiteSettings`, `lifecycleRules` и `tags`. + * `VIEW_ACL` — основные сведения и [ACL](../../concepts/acl.md) бакета. + * `VIEW_FULL` — полные сведения о бакете. + + Доступ к каждому из значений определяется [ролями {{ iam-short-name }}](../../security/index.md), а также [ACL](../../concepts/acl.md) и [политикой доступа](../../concepts/policy.md) бакета. + + **Пример вызова REST API** + + ```bash + export IAM_TOKEN="" + curl \ + --request GET \ + --header "Authorization: Bearer $IAM_TOKEN" \ + --url 'https://storage.{{ api-host }}/storage/v1/buckets/<имя_бакета>?view=VIEW_FULL' + ``` + + Где `IAM_TOKEN` — [IAM-токен](../../../iam/concepts/authorization/iam-token.md). + {% endlist %} ## Получить статистику бакета {#get-statistics} @@ -135,4 +179,22 @@ description: Следуя данной инструкции, вы сможете updated_at: "2023-08-02T04:05:44.564924Z" ``` +- API {#api} + + Чтобы получить статистику бакета, воспользуйтесь методом REST API [getStats](../../api-ref/Bucket/getStats.md) для ресурса [Bucket](../../api-ref/Bucket/index.md) или вызовом gRPC API [BucketService/GetStats](../../api-ref/grpc/Bucket/getStats.md). + + **Пример вызова REST API** + + ```bash + export IAM_TOKEN="" + curl \ + --request GET \ + --header "Authorization: Bearer $IAM_TOKEN" \ + --url 'https://storage.{{ api-host }}/storage/v1/buckets/<имя_бакета>:getStats' + ``` + + Где `IAM_TOKEN` — [IAM-токен](../../../iam/concepts/authorization/iam-token.md). + + В ответе возвращается общий занятый объем — поле `usedSize`, распределение объема по [классам хранилища](../../concepts/storage-class.md) — поле `storageClassUsedSizes`, и количество объектов в каждом классе — поле `storageClassCounters`. + {% endlist %}