Spec-Zone.ru › AWS CLI v2

[ aws . directconnect ]

allocate-hosted-connection

Описание

Создаёт подключение по схеме хостинг на указанном межсетевом соединении или группе агрегированных каналов (LAG) межсетевых соединений.

Назначает номер VLAN и определённый объём пропускной способности (полосы пропускания) для использования подключением по схеме хостинг на указанном межсетевом соединении или группе агрегированных каналов (LAG) межсетевых соединений. Amazon Web Services контролирует подключение по схеме хостинг на указанный объём пропускной способности, а также Партнёр Direct Connect должен контролировать подключение по схеме хостинг на указанный объём пропускной способности.

Примечание

Предназначено только для использования Партнёрами Direct Connect.

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

Синтаксис

  allocate-hosted-connection
--connection-id <value>
--owner-account <value>
--bandwidth <value>
--connection-name <value>
--vlan <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]

Параметры

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

Идентификатор межсетевого соединения или LAG.

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

Идентификатор идентификатора учётной записи Amazon Web Services клиента для подключения.

--bandwidth (строка)

Пропускная способность подключения. Возможные значения: 50 Мбит/с, 100 Мбит/с, 200 Мбит/с, 300 Мбит/с, 400 Мбит/с, 500 Мбит/с, 1 Гбит/с, 2 Гбит/с, 5 Гбит/с, 10 Гбит/с и 25 Гбит/с. Обратите внимание, что только те Партнёры Direct Connect, которые выполнили определённые требования, могут создавать подключение по схеме хостинг со скоростью 1 Гбит/с, 2 Гбит/с, 5 Гбит/с, 10 Гбит/с или 25 Гбит/с.

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

Имя подключения по схеме хостинг.

--vlan (целое число)

Выделенный VLAN, предоставленный подключению по схеме хостинг.

--tags (список)

Теги, связанные с подключением.

(структура)

Информация о теге.

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

Ключ.

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

Значение.

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

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.

Для создания подключения по схеме хостинг к межсетевому соединению

Следующий пример allocate-hosted-connection создаёт подключение по схеме хостинг к указанному межсетевому соединению.

aws directconnect allocate-hosted-connection \
    --bandwidth 500Mbps \
    --connection-name mydcinterconnect \
    --owner-account 123456789012
    -connection-id dxcon-fgktov66
    -vlan 101

Вывод:

{
    "partnerName": "TIVIT",
    "vlan": 101,
    "ownerAccount": "123456789012",
    "connectionId": "dxcon-ffzc51m1",
    "connectionState": "ordering",
    "bandwidth": "500Mbps",
    "location": "TIVIT",
    "connectionName": "mydcinterconnect",
    "region": "sa-east-1"
}

Вывод

ownerAccount -> (строка)

Идентификатор учетной записи Amazon Web Services, которая владеет подключением.

connectionId -> (строка)

Идентификатор подключения.

connectionName -> (строка)

Название подключения.

connectionState -> (строка)

Состояние подключения. Возможные значения:

  • ordering : Начальное состояние подключение, предоставленного на межсетевом соединении. Подключение остается в состоянии заказа до тех пор, пока владелец подключение не подтвердит или отклонит заказ.
  • requested : Начальное состояние стандартного подключения. Подключение остается в состоянии запроса до тех пор, пока письмо об авторизации (LOA) не будет отправлено клиенту.
  • pending : Подключение одобрено и находится в процессе инициализации.
  • available : Сеть подключена и подключение готово к использованию.
  • down : Сеть отключена.
  • deleting : Подключение удаляется.
  • deleted : Подключение удалено.
  • rejected : Подключение в состоянии ordering переходит в состояние rejected, если оно удалено клиентом.
  • unknown : Состояние подключения недоступно.

region -> (строка)

Регион Amazon Web Services, в котором расположено подключение.

location -> (строка)

Расположение подключения.

bandwidth -> (строка)

Пропускная способность подключения.

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

Идентификатор VLAN.

partnerName -> (строка)

Название поставщика услуг Direct Connect, связанного с подключением.

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

Время последнего вызова DescribeLoa для этого подключения.

lagId -> (строка)

Идентификатор LAG.

awsDevice -> (строка)

Точка подключения Direct Connect, на которой физическое подключение завершается.

jumboFrameCapable -> (булево)

Указывает, поддерживаются ли увеличенные кадр.

awsDeviceV2 -> (строка)

Точка подключения Direct Connect, на которой завершается физическое подключение.

awsLogicalDeviceId -> (строка)

Точка подключения Direct Connect, на которой завершается логическое подключение. Это устройство может отличаться от устройства, на котором завершается физическое подключение.

hasLogicalRedundancy -> (строка)

Указывает, поддерживает ли подключение дополнительный BGP-пир в том же семействе адресов (IPv4/IPv6).

tags -> (список)

Теги, связанные с подключением.

(структура)

Информация о теге.

key -> (строка)

Ключ.

value -> (строка)

Значение.

providerName -> (строка)

Название поставщика услуг, связанного с подключением.

macSecCapable -> (булево)

Указывает, поддерживает ли подключение MAC Security (MACsec).

portEncryptionStatus -> (строка)

Статус MAC Security (MACsec) порта подключения.

Допустимые значения: Encryption Up , означающее, что существует активное имя ключа подключения, или Encryption Down.

encryptionMode -> (строка)

Режим шифрования MAC Security (MACsec).

Допустимые значения: no_encrypt , should_encrypt и must_encrypt.

macSecKeys -> (список)

Ключи безопасности MAC Security (MACsec), связанные с подключением.

(структура)

Информация о секретном ключе MAC Security (MACsec).

secretARN -> (строка)

Amazon Resource Name (ARN) секретного ключа MAC Security (MACsec).

ckn -> (строка)

Имя ключа подключения (CKN) для секретного ключа MAC Security.

state -> (строка)

Состояние секретного ключа MAC Security (MACsec).

Возможные значения:

  • associating : Секретный ключ MAC Security (MACsec) проходит проверку и еще не связан с подключением или LAG.
  • associated : Секретный ключ MAC Security (MACsec) проверен и связан с подключением или LAG.
  • disassociating : Секретный ключ MAC Security (MACsec) отсоединяется от подключения или LAG.
  • disassociated : Секретный ключ MAC Security (MACsec) больше не связан с подключением или LAG.

startOn -> (строка)

Дата, когда секретный ключ MAC Security (MACsec) вступает в силу. Значение отображается в формате UTC.

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

Spec-Zone.ru

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