put-bucket-analytics-configuration

Описание

Устанавливает конфигурацию аналитики для ведра (указанную идентификатором конфигурации аналитики). Вы можете иметь до 1000 конфигураций аналитики на одно ведро.

Вы можете настроить экспорт отчётов анализа по классам хранилища в плоский файл в формате CSV (разделенный запятыми). См. элемент запроса DataExport. Отчёты обновляются ежедневно и основаны на фильтрах объектов, которые вы настраиваете. При выборе экспорта данных вы указываете ведро назначения и необязательный префикс назначения, куда будет записан файл. Вы можете экспортировать данные в ведро назначения в другом аккаунте. Однако ведро назначения должно находиться в той же Регионе, что и ведро, для которого вы настраиваете конфигурацию аналитики. Для получения дополнительной информации см. Amazon S3 Analytics – Анализ по классам хранилища.

Для использования этой операции необходимо иметь разрешения на выполнение действия s3:PutAnalyticsConfiguration. Владелец ведра имеет это разрешение по умолчанию. Владелец ведра может предоставить это разрешение другим. Дополнительную информацию о разрешениях см. в разделе Разрешения, связанные с операциями над подресурсами ведра, и Управление разрешениями доступа к вашим ресурсам Amazon S3.

• • HTTP-ошибка: HTTP 400 Ошибка запроса
  • Код: InvalidArgument
  • Причина: Некорректный аргумент.
• • HTTP-ошибка: HTTP 400 Ошибка запроса
  • Код: TooManyConfigurations
  • Причина: Вы пытаетесь создать новую конфигурацию, но уже достигли лимита в 1000 конфигураций.
• • HTTP-ошибка: HTTP 403 Запрещено
  • Код: AccessDenied
  • Причина: Вы не являетесь владельцем указанного ведра или не имеете разрешения s3:PutAnalyticsConfiguration для настройки конфигурации в ведре.

Следующие операции связаны с PutBucketAnalyticsConfiguration:

• GetBucketAnalyticsConfiguration
• DeleteBucketAnalyticsConfiguration
• ListBucketAnalyticsConfigurations

См. также: AWS API Documentation

Синтаксис

  put-bucket-analytics-configuration
--bucket <value>
--id <value>
--analytics-configuration <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 (строка)

--analytics-configuration (структура)

Синтаксис JSON:

{
  "Id": "string",
  "Filter": {
    "Prefix": "string",
    "Tag": {
      "Key": "string",
      "Value": "string"
    },
    "And": {
      "Prefix": "string",
      "Tags": [
        {
          "Key": "string",
          "Value": "string"
        }
        ...
      ]
    }
  },
  "StorageClassAnalysis": {
    "DataExport": {
      "OutputSchemaVersion": "V_1",
      "Destination": {
        "S3BucketDestination": {
          "Format": "CSV",
          "BucketAccountId": "string",
          "Bucket": "string",
          "Prefix": "string"
        }
      }
    }
  }
}

--expected-bucket-owner (строка)

--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
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить вывод цвета.

• on
• off
• auto

--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.

Примеры

Для настройки конфигурации аналитики для ведра

Следующий put-bucket-analytics-configuration пример настраивает аналитику для указанного ведра.

aws s3api put-bucket-analytics-configuration \
    --bucket amzn-s3-demo-bucket --id 1 \
    --analytics-configuration '{"Id": "1","StorageClassAnalysis": {}}'

Эта команда не выводит ничего.

Вывод

Нет