Spec-Zone.ru › AWS CLI v2

[ aws . s3control ]

create-storage-lens-group

Описание

Создает новую группу S3 Storage Lens и связывает ее с указанным идентификатором учетной записи Amazon Web Services. Группа S3 Storage Lens представляет собой настраиваемую группировку объектов, основанную на префиксе, суффиксе, тегах объекта, размере объекта, возрасте объекта или комбинации этих фильтров. Для каждой созданной вами группы Storage Lens вы также можете необязательно добавить теги ресурсов Amazon Web Services. Дополнительную информацию о группах S3 Storage Lens см. в разделе Работа с группами S3 Storage Lens .

Для использования этой операции необходимо иметь разрешение на выполнение действия s3:CreateStorageLensGroup. Если вы пытаетесь создать группу Storage Lens с тегами ресурсов Amazon Web Services, вам также необходимо разрешение на выполнение действия s3:TagResource. Дополнительную информацию о требуемых разрешениях для групп Storage Lens см. в разделе Установка разрешений учетной записи для использования групп S3 Storage Lens .

Сведения об ошибках групп Storage Lens см. в разделе Список кодов ошибок Amazon S3 Storage Lens .

См. также: Документация API AWS

Синтаксис

  create-storage-lens-group
--account-id <value>
--storage-lens-group <value>
[--tags <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]

Параметры

--account-id (строка)

Идентификатор учетной записи Amazon Web Services, из которой создается и с которой связывается группа Storage Lens.

--storage-lens-group (структура)

Настройка группы Storage Lens.

Name -> (строка)

Содержит имя группы Storage Lens.

Filter -> (структура)

Устанавливает критерии для данных группы Storage Lens, которые отображаются. Для нескольких условий фильтрации используется логический оператор AND или OR.

MatchAnyPrefix -> (список)

Содержит список префиксов. Необходимо указать как минимум один префикс. Разрешается до 10 префиксов.

(строка)

MatchAnySuffix -> (список)

Содержит список суффиксов. Необходимо указать как минимум один суффикс. Разрешается до 10 суффиксов.

(строка)

MatchAnyTag -> (список)

Содержит список тегов объектов S3. Необходимо указать как минимум один тег объекта. Разрешается до 10 тегов объектов.

(структура)

Контейнер для пары имя-значение.

Key -> (строка)

Ключ тега

Value -> (строка)

Значение тега

MatchObjectAge -> (структура)

Содержит DaysGreaterThan и DaysLessThan для определения диапазона возраста объектов (минимальное и максимальное количество дней).

DaysGreaterThan -> (целое число)

Указывает максимальный возраст объекта в днях. Должно быть положительным целым числом, большим, чем минимальный возраст объекта, и не превышать 2 147 483 647.

DaysLessThan -> (целое число)

Указывает минимальный возраст объекта в днях. Значение должно быть положительным целым числом, больше 0 и не превышать 2 147 483 647.

MatchObjectSize -> (структура)

Содержит BytesGreaterThan и BytesLessThan для определения диапазона размеров объектов (минимальное и максимальное количество байт).

BytesGreaterThan -> (длинное целое число)

Указывает минимальный размер объекта в байтах. Значение должно быть положительным числом, большим 0 и меньшим 5 ТБ.

BytesLessThan -> (длинное целое число)

Указывает максимальный размер объекта в байтах. Значение должно быть положительным числом, большим минимального размера объекта и меньшим 5 ТБ.

And -> (структура)

Логический оператор, который позволяет объединять несколько условий фильтрации для более сложных сравнений данных группы Storage Lens. Объекты должны соответствовать всем перечисленным условиям фильтрации, объединенным логическим оператором And. Разрешается только по одному условию фильтрации каждого типа.

MatchAnyPrefix -> (список)

Содержит список префиксов. Необходимо указать как минимум один префикс. Разрешается до 10 префиксов.

(строка)

MatchAnySuffix -> (список)

Содержит список суффиксов. Необходимо указать как минимум один суффикс. Разрешается до 10 суффиксов.

(строка)

MatchAnyTag -> (список)

Содержит список тегов объектов. Необходимо указать как минимум один тег объекта. Разрешается до 10 тегов объектов.

(структура)

Контейнер для пары имя-значение.

Key -> (строка)

Ключ тега

Value -> (строка)

Значение тега

MatchObjectAge -> (структура)

Содержит DaysGreaterThan и DaysLessThan для определения диапазона возраста объектов (минимальное и максимальное количество дней).

DaysGreaterThan -> (целое число)

Указывает максимальный возраст объекта в днях. Должно быть положительным целым числом, большим, чем минимальный возраст объекта, и не превышать 2 147 483 647.

DaysLessThan -> (целое число)

Указывает минимальный возраст объекта в днях. Значение должно быть положительным целым числом, больше 0 и не превышать 2 147 483 647.

MatchObjectSize -> (структура)

Содержит BytesGreaterThan и BytesLessThan для определения диапазона размеров объектов (минимальное и максимальное количество байт).

BytesGreaterThan -> (длинное целое число)

Указывает минимальный размер объекта в байтах. Значение должно быть положительным числом, большим 0 и меньшим 5 ТБ.

BytesLessThan -> (длинное целое число)

Указывает максимальный размер объекта в байтах. Значение должно быть положительным числом, большим минимального размера объекта и меньшим 5 ТБ.

Or -> (структура)

Одиночный логический оператор, который позволяет объединять несколько условий фильтрации. Объекты могут соответствовать любому из перечисленных условий фильтрации, объединенных логическим оператором Or. Разрешается только по одному условию фильтрации каждого типа.

MatchAnyPrefix -> (список)

Фильтры объектов, которые соответствуют любому из указанных префиксов.

(строка)

MatchAnySuffix -> (список)

Фильтры объектов, которые соответствуют любому из указанных суффиксов.

(строка)

MatchAnyTag -> (список)

Фильтры объектов, которые соответствуют любым из указанных тегов объектов S3.

(структура)

Контейнер для пары имя-значение.

Key -> (строка)

Ключ тега

Value -> (строка)

Значение тега

MatchObjectAge -> (структура)

Фильтры объектов, которые соответствуют указанному диапазону возраста объектов.

DaysGreaterThan -> (целое число)

Указывает максимальный возраст объекта в днях. Должно быть положительным целым числом, большим, чем минимальный возраст объекта, и не превышать 2 147 483 647.

DaysLessThan -> (целое число)

Указывает минимальный возраст объекта в днях. Значение должно быть положительным целым числом, больше 0 и не превышать 2 147 483 647.

MatchObjectSize -> (структура)

Фильтры объектов, которые соответствуют указанному диапазону размеров объектов.

BytesGreaterThan -> (длинное целое число)

Указывает минимальный размер объекта в байтах. Значение должно быть положительным числом, большим 0 и меньшим 5 ТБ.

BytesLessThan -> (длинное целое число)

Указывает максимальный размер объекта в байтах. Значение должно быть положительным числом, большим минимального размера объекта и меньшим 5 ТБ.

StorageLensGroupArn -> (строка)

Содержит Amazon Resource Name (ARN) группы Storage Lens. Это свойство является только для чтения.

Синтаксис JSON:

{
  "Name": "string",
  "Filter": {
    "MatchAnyPrefix": ["string", ...],
    "MatchAnySuffix": ["string", ...],
    "MatchAnyTag": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ],
    "MatchObjectAge": {
      "DaysGreaterThan": integer,
      "DaysLessThan": integer
    },
    "MatchObjectSize": {
      "BytesGreaterThan": long,
      "BytesLessThan": long
    },
    "And": {
      "MatchAnyPrefix": ["string", ...],
      "MatchAnySuffix": ["string", ...],
      "MatchAnyTag": [
        {
          "Key": "string",
          "Value": "string"
        }
        ...
      ],
      "MatchObjectAge": {
        "DaysGreaterThan": integer,
        "DaysLessThan": integer
      },
      "MatchObjectSize": {
        "BytesGreaterThan": long,
        "BytesLessThan": long
      }
    },
    "Or": {
      "MatchAnyPrefix": ["string", ...],
      "MatchAnySuffix": ["string", ...],
      "MatchAnyTag": [
        {
          "Key": "string",
          "Value": "string"
        }
        ...
      ],
      "MatchObjectAge": {
        "DaysGreaterThan": integer,
        "DaysLessThan": integer
      },
      "MatchObjectSize": {
        "BytesGreaterThan": long,
        "BytesLessThan": long
      }
    }
  },
  "StorageLensGroupArn": "string"
}

--tags (список)

Теги ресурсов Amazon Web Services, которые вы добавляете к своей группе Storage Lens. Этот параметр является необязательным.

(структура)

Тег ресурса Amazon Web Services, связанный с вашим ресурсом S3. Вы можете добавлять теги к новым объектам при их загрузке или добавлять теги объектов к существующим объектам.

Примечание

Данная операция поддерживается только для групп S3 Storage Lens и для S3 Access Grants. Тегируемым ресурсом может быть группа S3 Storage Lens или экземпляр S3 Access Grants, зарегистрированное расположение или предоставление.

Key -> (строка)

Ключ пары ключ-значение тега, добавленного к вашему ресурсу Amazon Web Services. Ключ тега может содержать до 128 символов Юникода и чувствителен к регистру. Созданные системой теги, начинающиеся с aws:, не поддерживаются.

Value -> (строка)

Значение пары ключ-значение тега, добавленного к вашему ресурсу Amazon Web Services. Значение тега может содержать до 256 символов Юникода и чувствительно к регистру.

Краткое синтаксическое представление:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--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 (boolean)

Включить отладочную запись журнала.

--endpoint-url (string)

Переопределить адрес по умолчанию команды указанным адресом.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.

--ca-bundle (string)

Файл с пакетом сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (boolean)

Отключить вывод с помощью кли-пагера.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API