[ 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 (строка)
--owner-account (строка)
--bandwidth (строка)
--connection-name (строка)
--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 -> (строка)
connectionId -> (строка)
connectionName -> (строка)
connectionState -> (строка)
Состояние подключения. Возможные значения:
-
ordering: Начальное состояние подключение, предоставленного на межсетевом соединении. Подключение остается в состоянии заказа до тех пор, пока владелец подключение не подтвердит или отклонит заказ. -
requested: Начальное состояние стандартного подключения. Подключение остается в состоянии запроса до тех пор, пока письмо об авторизации (LOA) не будет отправлено клиенту. -
pending: Подключение одобрено и находится в процессе инициализации. -
available: Сеть подключена и подключение готово к использованию. -
down: Сеть отключена. -
deleting: Подключение удаляется. -
deleted: Подключение удалено. -
rejected: Подключение в состоянииorderingпереходит в состояниеrejected, если оно удалено клиентом. -
unknown: Состояние подключения недоступно.
region -> (строка)
location -> (строка)
bandwidth -> (строка)
vlan -> (целое число)
partnerName -> (строка)
loaIssueTime -> (метка времени)
lagId -> (строка)
awsDevice -> (строка)
jumboFrameCapable -> (булево)
awsDeviceV2 -> (строка)
awsLogicalDeviceId -> (строка)
hasLogicalRedundancy -> (строка)
tags -> (список)
Теги, связанные с подключением.
(структура)
Информация о теге.
key -> (строка)
value -> (строка)
providerName -> (строка)
macSecCapable -> (булево)
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 -> (строка)
ckn -> (строка)
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 -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.