Spec-Zone.ru › AWS CLI v2

[ aws . mediastore ]

создать-контейнер

Описание

Создаёт хранилище для объектов. Контейнер аналогичен ведру в службе Amazon S3.

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

Синтаксис

  create-container
--container-name <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]

Параметры

--container-name (строка)

Имя контейнера. Имя должно содержать от 1 до 255 символов. Имена контейнеров должны быть уникальными для вашей учётной записи AWS в определённом регионе. Например, вы можете создать контейнер с именем movies в каждом регионе, если у вас нет существующего контейнера с таким же именем.

--tags (список)

Массив пар ключ:значение, которые вы определяете. Эти значения могут быть любыми. Как правило, ключ тега представляет категорию (например, «среда»), а значение тега — конкретное значение в этой категории (например, «тест», «разработка» или «производство»). Вы можете добавить до 50 тегов к каждому контейнеру. Дополнительную информацию о тегах, включая соглашения об именовании и использовании, см. в разделе Тегирование ресурсов в MediaStore.

(структура)

Набор тегов, связанных с контейнером. Каждый тег состоит из пары ключ:значение, которые вы можете определить. Как правило, ключ тега представляет категорию (например, «среда»), а значение тега — конкретное значение в этой категории (например, «тест», «разработка» или «производство»). Вы можете добавить до 50 тегов к каждому контейнеру. Дополнительную информацию о тегах, включая соглашения об именовании и использовании, см. в разделе Тегирование ресурсов в MediaStore.

Ключ -> (строка)

Часть пары ключ:значение, определяющей тег. Вы можете использовать ключ тега для описания категории информации, например, «клиент». Ключи тегов чувствительны к регистру.

Значение -> (строка)

Часть пары ключ:значение, определяющей тег. Вы можете использовать значение тега для описания конкретного значения в категории, например, «компанияА» или «компанияБ». Значения тегов чувствительны к регистру.

Сокращённый синтаксис:

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 (логическое значение)

Включить отладочную регистрацию.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • 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.

Для создания контейнера

Следующий create-container пример создаёт новый пустой контейнер.

aws mediastore create-container --container-name ExampleContainer

Вывод:

{
    "Container": {
        "AccessLoggingEnabled": false,
        "CreationTime": 1563557265,
        "Name": "ExampleContainer",
        "Status": "CREATING",
        "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer"
    }
}

Дополнительную информацию см. в разделе Создание контейнера в руководстве пользователя AWS Elemental MediaStore.

Вывод

Контейнер -> (структура)

ContainerARN: Amazon Resource Name (ARN) недавно созданного контейнера. ARN имеет следующий формат: arn:aws:<регион>:<учётная запись владельца контейнера>:container/<имя контейнера>. Например: arn:aws:mediastore:us-west-2:111122223333:container/movies

ContainerName: Имя контейнера, указанное в запросе.

CreationTime: Отметка времени Unix.

Status: Статус создания или удаления контейнера. Статус может быть одним из следующих: CREATING , ACTIVE или DELETING. Пока служба создаёт контейнер, статус — CREATING. Когда доступен конечная точка, статус изменяется на ACTIVE.

Возвращаемое значение не включает конечную точку контейнера. Для выполнения последующих запросов необходимо получить это значение с помощью DescribeContainer или ListContainers.

Endpoint -> (строка)

Конечная точка DNS контейнера. Используйте конечную точку для идентификации конкретного контейнера при отправке запросов к плоскости данных. Служба присваивает это значение при создании контейнера. После присвоения значение не меняется.

CreationTime -> (отметка времени)

Отметка времени Unix.

ARN -> (строка)

Amazon Resource Name (ARN) контейнера. ARN имеет следующий формат:

arn:aws:<регион>:<учётная запись владельца контейнера>:container/<имя контейнера>

Например: arn:aws:mediastore:us-west-2:111122223333:container/movies

Name -> (строка)

Имя контейнера.

Status -> (строка)

Статус создания или удаления контейнера. Статус может быть одним из следующих: CREATING , ACTIVE или DELETING. Пока служба создаёт контейнер, статус — CREATING. Когда конечная точка доступна, статус изменяется на ACTIVE.

AccessLoggingEnabled -> (логическое значение)

Состояние ведения журнала доступа в контейнере. По умолчанию это значение равно false, что означает, что AWS Elemental MediaStore не отправляет журналы доступа в Amazon CloudWatch Logs. При включении ведения журнала доступа в контейнере MediaStore изменяет это значение на true, что означает, что служба отправляет журналы доступа к объектам, хранящимся в этом контейнере, в CloudWatch Logs.

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

Spec-Zone.ru

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