Spec-Zone.ru › AWS CLI v2

[ aws . proton ]

обновить-сервис

Описание

Изменение описания сервиса или использование спецификации для добавления и удаления экземпляров сервиса.

Примечание

Существующие экземпляры сервиса и конвейер сервиса не могут быть изменены с помощью этого API. Их можно только удалить.

Используйте параметр description для изменения описания.

Измените параметр spec для добавления или удаления экземпляров.

Примечание

Вы не можете удалить экземпляр сервиса (удалить его из спецификации), если к нему прикреплён компонент.

Дополнительную информацию о компонентах см. в разделе Компоненты Proton в Руководстве пользователя Proton.

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

Синтаксис

  update-service
[--description <value>]
--name <value>
[--spec <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]

Параметры

--description (строка)

Изменённое описание сервиса.

--name (строка)

Имя сервиса для изменения.

--spec (строка)

Список экземпляров сервиса для добавления и существующих экземпляров сервиса, которые должны остаться. Пропустите существующие экземпляры сервиса, чтобы удалить их из списка. Не включайте изменения в существующие экземпляры сервиса или конвейер. Дополнительную информацию см. в разделе Изменение сервиса в Руководстве пользователя Proton.

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

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры имеют правила цитирования, подобные unix-подобным. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для обновления сервиса

Следующий пример update-service изменяет описание сервиса.

aws proton update-service \
    --name "MySimpleService" \
    --description "Edit by updating description"

Вывод:

{
    "service": {
        "arn": "arn:aws:proton:region-id:123456789012:service/MySimpleService",
        "branchName": "mainline",
        "createdAt": "2021-03-12T22:39:42.318000+00:00",
        "description": "Edit by updating description",
        "lastModifiedAt": "2021-03-12T22:44:21.975000+00:00",
        "name": "MySimpleService",
        "repositoryConnectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "repositoryId": "myorg/myapp",
        "status": "ACTIVE",
        "templateName": "fargate-service"
    }
}

Дополнительную информацию см. в разделе Изменение сервиса в Руководстве администратора AWS Proton или в разделе Изменение сервиса в Руководстве пользователя AWS Proton.

Вывод

сервис -> (структура)

Данные подробностей сервиса, возвращаемые Proton.

arn -> (строка)

Amazon Resource Name (ARN) сервиса.

branchName -> (строка)

Имя ветки репозитория кода, содержащего код, развернутый в Proton.

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

Время создания сервиса.

description -> (строка)

Описание сервиса.

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

Время последнего изменения сервиса.

name -> (строка)

Имя сервиса.

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

Данные подробностей конвейера сервиса.

arn -> (строка)

Amazon Resource Name (ARN) конвейера сервиса.

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

Время создания конвейера сервиса.

deploymentStatus -> (строка)

Статус развертывания конвейера сервиса.

deploymentStatusMessage -> (строка)

Сообщение о статусе развертывания конвейера сервиса.

lastAttemptedDeploymentId -> (строка)

Идентификатор последней попытки развертывания этого конвейера сервиса.

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

Время последней попытки развертывания конвейера сервиса.

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

Время последнего успешного развертывания конвейера сервиса.

lastSucceededDeploymentId -> (строка)

Идентификатор последнего успешного развертывания этого конвейера сервиса.

spec -> (строка)

Спецификация сервиса, которая использовалась для создания конвейера сервиса.

templateMajorVersion -> (строка)

Основная версия шаблона сервиса, которая использовалась для создания конвейера сервиса.

templateMinorVersion -> (строка)

Дополнительная версия шаблона сервиса, которая использовалась для создания конвейера сервиса.

templateName -> (строка)

Имя шаблона сервиса, который использовался для создания конвейера сервиса.

repositoryConnectionArn -> (строка)

Amazon Resource Name (ARN) подключения к репозиторию. Дополнительную информацию см. в разделе Настройка подключения AWS CodeStar в Руководстве пользователя Proton.

repositoryId -> (строка)

Идентификатор репозитория исходного кода.

spec -> (строка)

Отформатированная спецификация, определяющая сервис.

status -> (строка)

Статус сервиса.

statusMessage -> (строка)

Сообщение о статусе сервиса.

templateName -> (строка)

Имя шаблона сервиса.

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

Spec-Zone.ru

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