put-resource-attributes

Описание

Предоставляет идентификационные данные мигрируемого ресурса, чтобы его можно было связать в репозитории службы обнаружения приложений. Эта связь происходит асинхронно после того, как PutResourceAttributes завершится.

Предупреждение

Помните, что последующие вызовы PutResourceAttributes перезапишут ранее сохранённые атрибуты. Например, если он был вызван сначала с MAC-адресом, но позже необходимо добавить IP-адрес, потребуется вызвать его с обоими IP- и MAC-адресами, чтобы избежать перезаписи MAC-адреса.
Обратите внимание на инструкции относительно специального случая использования параметра ` ResourceAttributeList https://docs.aws.amazon.com/migrationhub/latest/ug/API_PutResourceAttributes.html#migrationhub-PutResourceAttributes-request-ResourceAttributeList`__ при указании любого значения, относящегося к «ВМ».

Примечание

Поскольку это асинхронный вызов, он всегда возвращает 200, независимо от того, происходит ли связывание или нет. Чтобы подтвердить, найдено ли соответствие по предоставленным данным, вызовите ListDiscoveredResources .

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

Синтаксис

  put-resource-attributes
--progress-update-stream <value>
--migration-task-name <value>
--resource-attribute-list <value>
[--dry-run | --no-dry-run]
[--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]

Параметры

--progress-update-stream (строка)

Имя потока обновления ProgressUpdateStream.

--migration-task-name (строка)

Уникальный идентификатор, который ссылается на задачу миграции. Не храните личные данные в этом поле.

--resource-attribute-list (список)

Информация о мигрируемом ресурсе. Эти данные будут использованы для сопоставления задачи с ресурсом в репозитории службы обнаружения приложений.

Примечание

Принимает массив объектов ResourceAttribute, где поле Type зарезервировано для следующих значений:

IPV4_ADDRESS | IPV6_ADDRESS | MAC_ADDRESS | FQDN | VM_MANAGER_ID | VM_MANAGED_OBJECT_REFERENCE | VM_NAME | VM_PATH | BIOS_ID | MOTHERBOARD_SERIAL_NUMBER

, где идентифицирующее значение может быть строкой длиной до 256 символов.

Предупреждение

Если для объекта ResourceAttribute установлено любое значение, относящееся к «ВМ», необходимо, как минимум, всегда устанавливать VM_MANAGER_ID. Если VM_MANAGER_ID не установлено, все поля «ВМ» будут отброшены, и поля «ВМ» не будут использоваться для сопоставления задачи миграции с сервером в репозитории службы обнаружения приложений. Пример использования указания значений, относящихся к «ВМ», см. в разделе «Пример» ниже.
Если у сервера, который вы пытаетесь сопоставить, есть несколько IP- или MAC-адресов, вы должны указать все известные вам адреса в отдельных парах «тип/значение», передаваемых параметру ResourceAttributeList, чтобы максимально увеличить вероятность соответствия.

(структура)

Атрибут, связанный с ресурсом.

Обратите внимание на соответствующий формат, требуемый для каждого типа, указанного ниже:

IPV4

x.x.x.x

где x - целое число в диапазоне [0,255]

IPV6

y : y : y : y : y : y : y : y

где y - шестнадцатеричное число от 0 до FFFF. [0, FFFF]

MAC_ADDRESS

^([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})$

FQDN

^[^<>{}\\\\/?,=\\p{Cntrl}]{1,256}$

Тип -> (строка)

Тип ресурса.

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

Значение типа ресурса.

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

Type=string,Value=string ...

Синтаксис JSON:

[
  {
    "Type": "IPV4_ADDRESS"|"IPV6_ADDRESS"|"MAC_ADDRESS"|"FQDN"|"VM_MANAGER_ID"|"VM_MANAGED_OBJECT_REFERENCE"|"VM_NAME"|"VM_PATH"|"BIOS_ID"|"MOTHERBOARD_SERIAL_NUMBER",
    "Value": "string"
  }
  ...
]

--dry-run | --no-dry-run (булево)

Необязательный булевый флаг, указывающий, должно ли быть произведено какое-либо действие. Используется для проверки наличия у вызывающего абонента разрешения на выполнение вызова.

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

Вывод

Нет