Spec-Zone.ru › AWS CLI v2

[ aws . deploy ]

get-application-revision

Описание

Получает информацию о ревизии приложения.

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

Синтаксис

  get-application-revision
--application-name <value>
[--revision <value>]
[--s3-location <value>]
[--github-location <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]

Параметры

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

Имя приложения, соответствующее ревизии.

--revision (структура)

Информация о ревизии приложения для получения, включая тип и расположение.

revisionType -> (строка)

Тип ревизии приложения:

  • S3: Ревизия приложения, хранящаяся в Amazon S3.
  • GitHub: Ревизия приложения, хранящаяся в GitHub (только для развертываний EC2/на локальных серверах).
  • Строка: строка в формате YAML или JSON (только для развертываний Lambda).
  • AppSpecContent: Объект AppSpecContent, содержащий содержимое файла AppSpec для развертывания Lambda или Amazon ECS. Содержимое отформатировано в формате JSON или YAML, хранится как RawString.

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

Информация о расположении ревизии, хранящейся в Amazon S3.

bucket -> (строка)

Имя Amazon S3-бакета, где хранится ревизия приложения.

key -> (строка)

Имя Amazon S3-объекта, представляющего скомпонованные артефакты для ревизии приложения.

bundleType -> (строка)

Тип файла ревизии приложения. Должен быть одним из следующих:

  • tar : архив в формате tar.
  • tgz : сжатый архив в формате tar.
  • zip : архив в формате zip.
  • YAML : файл в формате YAML.
  • JSON : файл в формате JSON.

version -> (строка)

Конкретная версия Amazon S3-объекта, представляющего скомпонованные артефакты для ревизии приложения.

Если версия не указана, система использует последнюю по умолчанию.

eTag -> (строка)

ETag Amazon S3-объекта, представляющего скомпонованные артефакты для ревизии приложения.

Если ETag не указан в качестве входного параметра, валидация ETag объекта пропускается.

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

Информация о расположении артефактов приложения, хранящихся в GitHub.

repository -> (строка)

Пара GitHub-аккаунт/репозиторий, хранящий ссылку на коммит, представляющий скомпонованные артефакты для ревизии приложения.

Указывается как account/repository.

commitId -> (строка)

SHA1 ID коммита GitHub, представляющий скомпонованные артефакты для ревизии приложения.

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

Информация о расположении ревизии развертывания Lambda, хранящейся как RawString.

content -> (строка)

Строка ревизии в формате YAML или JSON. Она включает информацию о том, какую функцию Lambda обновить, и дополнительные функции Lambda, которые проверяют жизненный цикл развертывания.

sha256 -> (строка)

Значение SHA256 хэша содержимого ревизии.

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

Содержимое файла AppSpec для развертывания Lambda или Amazon ECS. Содержимое отформатировано в формате JSON или YAML и хранится как RawString.

content -> (строка)

Строка ревизии в формате YAML или JSON.

Для развертывания Lambda содержимое включает имя функции Lambda, алиас её исходной версии и алиас её заменяющей версии. Развертывание переключает трафик с исходной версии функции Lambda на заменяющую.

Для развертывания Amazon ECS содержимое включает имя задачи, информацию о балансировщике нагрузки, который направляет трафик в контейнер, и многое другое.

Для обоих типов развертываний содержимое может указывать функции Lambda, которые выполняются в указанных крючках, таких как BeforeInstall, во время развертывания.

sha256 -> (строка)

Значение SHA256 хэша содержимого ревизии.

Упрощенный синтаксис:

revisionType=string,s3Location={bucket=string,key=string,bundleType=string,version=string,eTag=string},gitHubLocation={repository=string,commitId=string},string={content=string,sha256=string},appSpecContent={content=string,sha256=string}

Синтаксис JSON:

{
  "revisionType": "S3"|"GitHub"|"String"|"AppSpecContent",
  "s3Location": {
    "bucket": "string",
    "key": "string",
    "bundleType": "tar"|"tgz"|"zip"|"YAML"|"JSON",
    "version": "string",
    "eTag": "string"
  },
  "gitHubLocation": {
    "repository": "string",
    "commitId": "string"
  },
  "string": {
    "content": "string",
    "sha256": "string"
  },
  "appSpecContent": {
    "content": "string",
    "sha256": "string"
  }
}

--s3-location (структура) Информация о расположении ревизии приложения в Amazon S3. Вы должны указать бакет, ключ и bundleType. Дополнительно вы можете указать eTag и версию.bucket -> (строка)

Название Amazon S3-бакета.

key -> (строка)

Имя ключа Amazon S3-объекта.

bundleType -> (строка)

Формат пакета, хранящегося в Amazon S3.

eTag -> (строка)

eTag Amazon S3-объекта.

version -> (строка)

Версия Amazon S3-объекта.

Упрощенный синтаксис:

bucket=string,key=string,bundleType=string,eTag=string,version=string

Синтаксис JSON:

{
  "bucket": "string",
  "key": "string",
  "bundleType": "tar"|"tgz"|"zip",
  "eTag": "string",
  "version": "string"
}

--github-location (структура) Информация о расположении ревизии приложения в GitHub. Вы должны указать репозиторий и ID коммита, который ссылается на ревизию приложения. Для репозитория используйте формат GitHub-аккаунт/имя-репозитория или GitHub-организация/имя-репозитория. Для ID коммита используйте SHA1 Git-ссылку на коммит.repository -> (строка)

GitHub-аккаунт или организация и репозиторий. Укажите как GitHub-аккаунт/репозиторий или GitHub-организация/репозиторий.

commitId -> (строка)

SHA1 Git-ссылка на коммит.

Упрощенный синтаксис:

repository=string,commitId=string

Синтаксис JSON:

{
  "repository": "string",
  "commitId": "string"
}

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставляются другие аргументы, эти значения переопределят значения, полученные из JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение NULL или значение 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
  • таблица
  • yaml
  • yaml-stream

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

Получение информации о ревизии приложения

Следующий get-application-revision пример отображает информацию о ревизии приложения, связанной с указанным приложением.

aws deploy get-application-revision \
    --application-name WordPress_App \
    --s3-location bucket=CodeDeployDemoBucket,bundleType=zip,eTag=dd56cfdEXAMPLE8e768f9d77fEXAMPLE,key=WordPressApp.zip

Вывод:

{
    "applicationName": "WordPress_App",
    "revisionInfo": {
        "description": "Application revision registered by Deployment ID: d-A1B2C3111",
        "registerTime": 1411076520.009,
        "deploymentGroups": "WordPress_DG",
        "lastUsedTime": 1411076520.009,
        "firstUsedTime": 1411076520.009
    },
    "revision": {
        "revisionType": "S3",
        "s3Location": {
            "bundleType": "zip",
            "eTag": "dd56cfdEXAMPLE8e768f9d77fEXAMPLE",
            "bucket": "CodeDeployDemoBucket",
            "key": "WordPressApp.zip"
        }
    }
}

Вывод

applicationName -> (строка)

Название приложения, соответствующее данной ревизии.

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

Дополнительная информация о ревизии, включая тип и расположение.

revisionType -> (строка)

Тип ревизии приложения:

  • S3: Ревизия приложения, хранящаяся в Amazon S3.
  • GitHub: Ревизия приложения, хранящаяся в GitHub (только для развертываний EC2/локальных).
  • Строка: Строка в формате YAML или JSON (только для развертываний Lambda).
  • AppSpecContent: Объект AppSpecContent, содержащий содержимое файла AppSpec для развертывания Lambda или Amazon ECS. Содержимое отформатировано как JSON или YAML и хранится как RawString.

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

Информация о расположении ревизии, хранящейся в Amazon S3.

bucket -> (строка)

Имя Amazon S3-бакета, в котором хранится ревизия приложения.

key -> (строка)

Имя объекта Amazon S3, представляющего скомпонованные артефакты для ревизии приложения.

bundleType -> (строка)

Тип файла ревизии приложения. Должен быть одним из следующих:

  • tar : Архив в формате tar.
  • tgz : Сжатый архив в формате tar.
  • zip : Архив в формате zip.
  • YAML : Файл в формате YAML.
  • JSON : Файл в формате JSON.

version -> (строка)

Конкретная версия объекта Amazon S3, представляющего скомпонованные артефакты для ревизии приложения.

Если версия не указана, система использует последнюю версию по умолчанию.

eTag -> (строка)

ETag объекта Amazon S3, представляющего скомпонованные артефакты для ревизии приложения.

Если ETag не указан в качестве входного параметра, валидация ETag объекта пропускается.

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

Информация о расположении артефактов приложения, хранящихся в GitHub.

repository -> (строка)

Пара GitHub-аккаунта и репозитория, хранящие ссылку на коммит, представляющий скомпонованные артефакты для ревизии приложения.

Указывается в формате account/repository.

commitId -> (строка)

SHA1-ID коммита GitHub, представляющий скомпонованные артефакты для ревизии приложения.

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

Информация о расположении ревизии развертывания Lambda, хранящейся как RawString.

content -> (строка)

Строка ревизии в формате YAML или JSON. Она включает информацию о том, какую функцию Lambda обновить, и необязательные функции Lambda, которые валидируют события жизненного цикла развертывания.

sha256 -> (строка)

Значение хеша SHA256 содержимого ревизии.

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

Содержимое файла AppSpec для развертывания Lambda или Amazon ECS. Содержимое отформатировано как JSON или YAML и хранится как RawString.

content -> (строка)

Строка ревизии в формате YAML или JSON.

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

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

Для обоих типов развертываний содержимое может указывать функции Lambda, которые выполняются на заданных крючках, таких как BeforeInstall, во время развертывания.

sha256 -> (строка)

Значение хеша SHA256 содержимого ревизии.

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

Общая информация о ревизии.

description -> (строка)

Комментарий к ревизии.

deploymentGroups -> (список)

Группы развертываний, для которых данная ревизия является текущей целевой.

(строка)

firstUsedTime -> (временная метка)

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

lastUsedTime -> (временная метка)

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

registerTime -> (временная метка)

Время регистрации ревизии в CodeDeploy.

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

Spec-Zone.ru

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