получение конфигурации аналитики ведра
Описание
Примечание
Данная операция не поддерживается для ведер с каталогами.Эта реализация действия GET возвращает конфигурацию аналитики (идентифицируемую идентификатором конфигурации аналитики) из ведра.
Для использования этой операции необходимо иметь разрешения на выполнение действия s3:GetAnalyticsConfiguration. Владелец ведра обладает этим разрешением по умолчанию. Владелец ведра может предоставить это разрешение другим. Дополнительную информацию о разрешениях см. в разделе Разрешения, связанные с операциями с подресурсами ведра, и Управление разрешениями доступа к вашим ресурсам Amazon S3 в Руководстве пользователя Amazon S3.
Дополнительную информацию об аналитических функциях Amazon S3 см. в разделе Amazon S3 Analytics — Анализ по классам хранения в Руководстве пользователя Amazon S3.
Следующие операции связаны с GetBucketAnalyticsConfiguration:
- DeleteBucketAnalyticsConfiguration
- ListBucketAnalyticsConfigurations
- PutBucketAnalyticsConfiguration
См. также: Документация API AWS
Синтаксис
get-bucket-analytics-configuration
--bucket <value>
--id <value>
[--expected-bucket-owner <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--bucket (строка)
--id (строка)
--expected-bucket-owner (строка)
403 Forbidden (доступ запрещён).--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, указанному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Передача произвольных двоичных значений с помощью предоставленного значения JSON невозможна, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если указано без значения или со значением input, выводится пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выводится пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, выполняется валидация входных данных команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включение отладки.
--endpoint-url (строка)
Переопределение стандартного URL команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.
--no-paginate (логическое значение)
Отключение автоматической постраничной навигации. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии данного инструмента.
--color (строка)
Включение/выключение цветного вывода.
- вкл
- выкл
- авто
--no-sign-request (логическое значение)
Отключение подписи запросов. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл сертификата CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое отображается в двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключение пагинатора CLI для вывода.
--cli-auto-prompt (логическое значение)
Автоматическое запрошение параметров CLI.
--no-cli-auto-prompt (логическое значение)
Отключение автоматического запроса параметров CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для извлечения конфигурации аналитики для ведра с определенным идентификатором
Следующий get-bucket-analytics-configuration пример отображает конфигурацию аналитики для указанного ведра и идентификатора.
aws s3api get-bucket-analytics-configuration \
--bucket amzn-s3-demo-bucket \
--id 1
Вывод:
{
"AnalyticsConfiguration": {
"StorageClassAnalysis": {},
"Id": "1"
}
}
Вывод
AnalyticsConfiguration -> (структура)
Конфигурация и любые анализы для фильтра аналитики.
Id -> (строка)
Filter -> (структура)
Фильтр, используемый для описания набора объектов для анализа. Фильтр должен содержать ровно один префикс, один тег или одно соединение (AnalyticsAndOperator). Если фильтр не предоставлен, все объекты будут рассматриваться в любом анализе.
Prefix -> (строка)
Tag -> (структура)
Тег для использования при оценке фильтра аналитики.
Key -> (строка)
Value -> (строка)
And -> (структура)
Соединение (логическое И) предикатов, используемое при оценке фильтра аналитики. Оператор должен иметь как минимум два предиката.
Prefix -> (строка)
Tags -> (список)
Список тегов для использования при оценке предиката И.
(структура)
Контейнер пары имя-значение ключа.
Key -> (строка)
Value -> (строка)
StorageClassAnalysis -> (структура)
Содержит данные, связанные с шаблонами доступа, которые необходимо собирать и предоставлять для анализа компромиссов между различными классами хранения.
DataExport -> (структура)
Указывает, как должны экспортироваться данные, связанные с анализом класса хранения для ведра Amazon S3.
OutputSchemaVersion -> (строка)
V_1.Destination -> (структура)
Место хранения данных для анализа.
S3BucketDestination -> (структура)
Назначение, обозначающее вывод в ведро S3.
Format -> (строка)
BucketAccountId -> (строка)
Идентификатор учётной записи, владеющей целевым ведром S3. Если идентификатор учётной записи не указан, владелец не проверяется перед экспортом данных.
Примечание
Хотя это значение необязательно, мы настоятельно рекомендуем его указать, чтобы предотвратить проблемы, если меняется владение целевым ведром.Bucket -> (строка)
Prefix -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|