создание-аккаунта

Описание

Создаёт учётную запись Amazon Web Services, которая автоматически становится членом организации, от имени которой был выполнен запрос. Это асинхронный запрос, который выполняется Amazon Web Services в фоновом режиме. Поскольку CreateAccount работает асинхронно, он может вернуть сообщение об успешном завершении, даже если инициализация учётной записи всё ещё продолжается. Возможно, потребуется подождать несколько минут, прежде чем можно будет успешно получить доступ к учётной записи. Для проверки статуса запроса выполните одно из следующих действий:

• Используйте значение Id элемента ответа CreateAccountStatus от этой операции в качестве параметра для операции DescribeCreateAccountStatus.
• Проверьте журнал CloudTrail на наличие события CreateAccountResult. Сведения об использовании CloudTrail с Organizations см. в разделе Ведение журнала и мониторинг в Organizations в Руководстве пользователя Organizations.

Пользователь, вызывающий API для создания учётной записи, должен иметь разрешение organizations:CreateAccount. Если вы включили все функции в организации, Organizations создаёт необходимую связанную с сервисом роль под названием AWSServiceRoleForOrganizations. Дополнительные сведения см. в разделе Organizations и роли, связанные с сервисом, в Руководстве пользователя Organizations.

Если запрос включает теги, запрашивающий должен иметь разрешение organizations:TagResource.

Organizations предварительно настраивает новую учётную запись-член с ролью (по умолчанию с именем OrganizationAccountAccessRole), которая предоставляет пользователям в учётной записи управления правами администратора в новой учётной записи-члене. Принципы в учётной записи управления могут использовать роль. Organizations клонирует информацию о названии и адресе компании для новой учётной записи из учётной записи управления организацией.

Данную операцию можно вызывать только из учётной записи управления организацией.

Дополнительные сведения о создании учётных записей см. в разделе Создание учётной записи-члена в вашей организации в Руководстве пользователя Organizations.

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

Резюме

  create-account
--email <value>
--account-name <value>
[--role-name <value>]
[--iam-user-access-to-billing <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]

Параметры

--email (строка)

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

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

--iam-user-access-to-billing (строка)

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

Включить отладку протоколирования.

--endpoint-url (string)

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

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

Файл сертификатов доверенной третьей стороны для проверки 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 для вывода.

--cli-auto-prompt (boolean)

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

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

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

Примеры

Создание учетной записи участника, автоматически входящей в организацию

В следующем примере показано, как создать учетную запись участника в организации. Учетная запись участника настроена с именем Production Account и адресом электронной почты susan@example.com. Организация автоматически создаёт роль IAM с именем OrganizationAccountAccessRole, так как параметр roleName не указан. Также устанавливается значение по умолчанию ALLOW для параметра IamUserAccessToBilling, разрешающего пользователям или ролям IAM с достаточными разрешениями доступ к данным счетов. Организация автоматически отправляет Сузан электронное письмо «Добро пожаловать в AWS»:

aws organizations create-account --email susan@example.com --account-name "Production Account"

Вывод включает объект запроса, показывающий, что статус теперь IN_PROGRESS:

{
        "CreateAccountStatus": {
                "State": "IN_PROGRESS",
                "Id": "car-examplecreateaccountrequestid111"
        }
}

Позже можно запросить текущий статус запроса, указав значение Id в ответ на команду describe-create-account-status в качестве значения параметра create-account-request-id.

Дополнительную информацию см. в разделе Создание учетной записи AWS в вашей организации в Руководстве пользователя AWS Organizations.

Вывод

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