[ aws . sagemaker-geospatial ]
start-earth-observation-job
Описание
Используйте эту операцию для создания задания по наблюдению за Землёй.
См. также: Документация API AWS
Синтаксис
start-earth-observation-job
[--client-token <value>]
--execution-role-arn <value>
--input-config <value>
--job-config <value>
[--kms-key-id <value>]
--name <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]
Параметры
--client-token (строка)
--execution-role-arn (строка)
--input-config (структура)
Данные конфигурации входных данных для задания по наблюдению за Землёй.
PreviousEarthObservationJobArn -> (строка)
RasterDataCollectionQuery -> (структура)
Структура, представляющая запрос RasterDataCollection, состоящий из области интереса, RasterDataCollectionArn, диапазона времени и фильтров свойств.
AreaOfInterest -> (структура помеченных объединений)
Область интереса, запрошенная для сбора растровых данных.
Примечание
Это структура помеченных объединений. Может быть установлено только одно из следующих верхнеуровневых ключей:AreaOfInterestGeometry.AreaOfInterestGeometry -> (структура помеченных объединений)
Объект GeoJSON, представляющий географическую область в пространстве координат.
Примечание
Это структура помеченных объединений. Может быть установлено только одно из следующих верхнеуровневых ключей:MultiPolygonGeometry, PolygonGeometry.MultiPolygonGeometry -> (структура)
Структура, представляющая геометрию Многоугольника.
Coordinates -> (список)
Координаты многоугольной геометрии.
(список)
(список)
PolygonGeometry -> (структура)
Структура, представляющая геометрию Многоугольника.
Coordinates -> (список)
Координаты, представляющие многоугольник на основе спецификации GeoJson.
(список)
(список)
PropertyFilters -> (структура)
Список фильтров свойств, используемых в запросе Raster Data Collection.
LogicalOperator -> (строка)
Properties -> (список)
Список фильтров свойств.
(структура)
Структура, представляющая отдельный фильтр свойств.
Property -> (структура помеченных объединений)
Представляет отдельное свойство для сопоставления при поиске в коллекции растровых данных.
Примечание
Это структура помеченных объединений. Может быть установлено только одно из следующих верхнеуровневых ключей:EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation.EoCloudCover -> (структура)
Структура, представляющая фильтр свойств EoCloudCover, содержащая нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
LandsatCloudCoverLand -> (структура)
Структура, представляющая фильтр свойств Land Cloud Cover для коллекции Landsat, содержащая нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
Platform -> (структура)
Структура, представляющая фильтр свойств Platform, состоящий из значения и оператора сравнения.
ComparisonOperator -> (строка)
Value -> (строка)
ViewOffNadir -> (структура)
Структура, представляющая фильтр свойств ViewOffNadir, содержащая нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
ViewSunAzimuth -> (структура)
Структура, представляющая фильтр свойств ViewSunAzimuth, содержащая нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
ViewSunElevation -> (структура)
Структура, представляющая фильтр свойств ViewSunElevation, содержащая нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
RasterDataCollectionArn -> (строка)
TimeRangeFilter -> (структура)
Фильтр диапазона времени, используемый в запросе RasterDataCollection.
EndTime -> (метка времени)
StartTime -> (метка времени)
Синтаксис JSON:
{
"PreviousEarthObservationJobArn": "string",
"RasterDataCollectionQuery": {
"AreaOfInterest": {
"AreaOfInterestGeometry": {
"MultiPolygonGeometry": {
"Coordinates": [
[
[
[double, ...]
...
]
...
]
...
]
},
"PolygonGeometry": {
"Coordinates": [
[
[double, ...]
...
]
...
]
}
}
},
"PropertyFilters": {
"LogicalOperator": "AND",
"Properties": [
{
"Property": {
"EoCloudCover": {
"LowerBound": float,
"UpperBound": float
},
"LandsatCloudCoverLand": {
"LowerBound": float,
"UpperBound": float
},
"Platform": {
"ComparisonOperator": "EQUALS"|"NOT_EQUALS"|"STARTS_WITH",
"Value": "string"
},
"ViewOffNadir": {
"LowerBound": float,
"UpperBound": float
},
"ViewSunAzimuth": {
"LowerBound": float,
"UpperBound": float
},
"ViewSunElevation": {
"LowerBound": float,
"UpperBound": float
}
}
}
...
]
},
"RasterDataCollectionArn": "string",
"TimeRangeFilter": {
"EndTime": timestamp,
"StartTime": timestamp
}
}
}
--job-config (структура помеченных объединений)
Объект, содержащий информацию о конфигурации задания.
Примечание
Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан:BandMathConfig, CloudMaskingConfig, CloudRemovalConfig, GeoMosaicConfig, LandCoverSegmentationConfig, ResamplingConfig, StackConfig, TemporalStatisticsConfig, ZonalStatisticsConfig.BandMathConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для BandMath.
CustomIndices -> (структура)
Вычисляемые пользовательские индексы.
Operations -> (список)
Список индексов BandMath для вычисления.
(структура)
Представляет арифметическую операцию для вычисления спектрального индекса.
Equation -> (строка)
Name -> (строка)
OutputType -> (строка)
PredefinedIndices -> (список)
Один или несколько поддерживаемых предопределенных индексов для вычисления. Допустимые значения: NDVI, EVI2, MSAVI, NDWI, NDMI, NDSI и WDRVI.
(строка)
CloudMaskingConfig -> (структура)
CloudRemovalConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для удаления облаков.
AlgorithmName -> (строка)
InterpolationValue -> (строка)
TargetBands -> (список)
Целевые полосы, которые будут возвращены в выходных данных операции CloudRemoval.
(строка)
GeoMosaicConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для геомозаики.
AlgorithmName -> (строка)
TargetBands -> (список)
Целевые полосы для геомозаики.
(строка)
LandCoverSegmentationConfig -> (структура)
ResamplingConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для ресемплирования.
AlgorithmName -> (строка)
OutputResolution -> (структура)
Структура, представляющая выходное разрешение (в целевых геореференцированных единицах) результата операции ресемплирования.
UserDefined -> (структура)
Пользовательское разрешение для вывода операции Resampling, определенное значением и единицей измерения.
Unit -> (строка)
Value -> (число с плавающей запятой)
TargetBands -> (список)
Полосы, используемые в операции. Если целевые полосы не указаны, используются все доступные полосы ввода.
(строка)
StackConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для задания Stacking Earth Observation.
OutputResolution -> (структура)
Структура, представляющая выходное разрешение (в целевых геореференцированных единицах) результата операции стекирования.
Predefined -> (строка)
HIGHEST, LOWEST и AVERAGE.UserDefined -> (структура)
Структура, представляющая пользовательское выходное разрешение для операции Stacking, определенное как значение и единица измерения.
Unit -> (строка)
Value -> (число с плавающей запятой)
TargetBands -> (список)
Список полос, которые необходимо расположить в заданном порядке. Если параметр не указан, все доступные полосы в наборе данных стекируются в алфавитном порядке их имён активов.
(строка)
TemporalStatisticsConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для временных статистик.
GroupBy -> (строка)
Statistics -> (список)
Список вариантов статистических методов.
(строка)
TargetBands -> (список)
Список имён целевых полос для вычисления временной статистики.
(строка)
ZonalStatisticsConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для зональных статистик.
Statistics -> (список)
Список зональных статистик для вычисления.
(строка)
TargetBands -> (список)
Полосы, используемые в операции. Если целевые полосы не указаны, используются все доступные входные полосы.
(строка)
ZoneS3Path -> (строка)
ZoneS3PathKmsKeyId -> (строка)
Идентификатор ключа Amazon Web Services Key Management Service (Amazon Web Services KMS) (ARN или ID), который Amazon SageMaker использует для расшифровки выходных артефактов с шифрованием Amazon S3 на стороне сервера. Роль выполнения SageMaker должна иметь разрешение kms:GenerateDataKey.
KmsKeyId может быть в одном из следующих форматов:
- // Идентификатор ключа KMS
"1234abcd-12ab-34cd-56ef-1234567890ab" - // Amazon Resource Name (ARN) ключа KMS
"arn:aws:kms:<region>:<account>:key/<key-id-12ab-34cd-56ef-1234567890ab>"
Дополнительную информацию об идентификаторах ключей см. в документации Amazon Web Services Key Management Service (Amazon Web Services KMS).
Синтаксис JSON:
{
"BandMathConfig": {
"CustomIndices": {
"Operations": [
{
"Equation": "string",
"Name": "string",
"OutputType": "INT32"|"FLOAT32"|"INT16"|"FLOAT64"|"UINT16"
}
...
]
},
"PredefinedIndices": ["string", ...]
},
"CloudMaskingConfig": {
},
"CloudRemovalConfig": {
"AlgorithmName": "INTERPOLATION",
"InterpolationValue": "string",
"TargetBands": ["string", ...]
},
"GeoMosaicConfig": {
"AlgorithmName": "NEAR"|"BILINEAR"|"CUBIC"|"CUBICSPLINE"|"LANCZOS"|"AVERAGE"|"RMS"|"MODE"|"MAX"|"MIN"|"MED"|"Q1"|"Q3"|"SUM",
"TargetBands": ["string", ...]
},
"LandCoverSegmentationConfig": {
},
"ResamplingConfig": {
"AlgorithmName": "NEAR"|"BILINEAR"|"CUBIC"|"CUBICSPLINE"|"LANCZOS"|"AVERAGE"|"RMS"|"MODE"|"MAX"|"MIN"|"MED"|"Q1"|"Q3"|"SUM",
"OutputResolution": {
"UserDefined": {
"Unit": "METERS",
"Value": float
}
},
"TargetBands": ["string", ...]
},
"StackConfig": {
"OutputResolution": {
"Predefined": "HIGHEST"|"LOWEST"|"AVERAGE",
"UserDefined": {
"Unit": "METERS",
"Value": float
}
},
"TargetBands": ["string", ...]
},
"TemporalStatisticsConfig": {
"GroupBy": "ALL"|"YEARLY",
"Statistics": ["MEAN"|"MEDIAN"|"STANDARD_DEVIATION", ...],
"TargetBands": ["string", ...]
},
"ZonalStatisticsConfig": {
"Statistics": ["MEAN"|"MEDIAN"|"STANDARD_DEVIATION"|"MAX"|"MIN"|"SUM", ...],
"TargetBands": ["string", ...],
"ZoneS3Path": "string",
"ZoneS3PathKmsKeyId": "string"
}
}
--kms-key-id (строка)
--name (строка)
--tags (массив)
Каждый тег состоит из ключа и значения.
ключ -> (строка)
значение -> (строка)
Упрощённый синтаксис:
KeyName1=string,KeyName2=string
Синтаксис JSON:
{"string": "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-auto-prompt (логическое значение)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров входных данных CLI.
Вывод
Arn -> (строка)
CreationTime -> (метка времени)
DurationInSeconds -> (целое число)
ExecutionRoleArn -> (строка)
InputConfig -> (структура)
Информация о конфигурации входных данных для задания по наблюдению за Землёй.
PreviousEarthObservationJobArn -> (строка)
RasterDataCollectionQuery -> (структура)
Структура, представляющая запрос RasterDataCollection, содержащий область интереса, RasterDataCollectionArn, RasterDataCollectionName, диапазон времени и фильтры свойств.
AreaOfInterest -> (структура со ссылочными типами)
Область интереса, используемая в поиске.
Примечание
Это структура со ссылочными типами. Только один из следующих верхних ключей может быть установлен:AreaOfInterestGeometry.AreaOfInterestGeometry -> (структура со ссылочными типами)
Объект GeoJSON, представляющий географический охват в пространстве координат.
Примечание
Это структура со ссылочными типами. Только один из следующих верхних ключей может быть установлен:MultiPolygonGeometry, PolygonGeometry.MultiPolygonGeometry -> (структура)
Структура, представляющая геометрию Многоугольника.
Coordinates -> (список)
Координаты геометрии многоугольника.
(список)
(список)
PolygonGeometry -> (структура)
Структура, представляющая геометрию Многоугольника.
Coordinates -> (список)
Координаты, представляющие многоугольник на основе спецификации GeoJson.
(список)
(список)
PropertyFilters -> (структура)
Фильтры свойств, используемые в поиске.
LogicalOperator -> (строка)
Properties -> (список)
Список фильтров свойств.
(структура)
Структура, представляющая отдельный PropertyFilter.
Property -> (структура со ссылочными типами)
Представляет отдельное свойство для сопоставления при поиске в коллекции растровых данных.
Примечание
Это структура со ссылочными типами. Только один из следующих верхних ключей может быть установлен:EoCloudCover, LandsatCloudCoverLand, Platform, ViewOffNadir, ViewSunAzimuth, ViewSunElevation.EoCloudCover -> (структура)
Структура, представляющая фильтр свойств EoCloudCover, содержащий нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
LandsatCloudCoverLand -> (структура)
Структура, представляющая фильтр свойств Land Cloud Cover для коллекции Landsat, содержащий нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
Platform -> (структура)
Структура, представляющая фильтр свойств Platform, состоящий из значения и оператора сравнения.
ComparisonOperator -> (строка)
Value -> (строка)
ViewOffNadir -> (структура)
Структура, представляющая фильтр свойств ViewOffNadir, содержащий нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
ViewSunAzimuth -> (структура)
Структура, представляющая фильтр свойств ViewSunAzimuth, содержащий нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
ViewSunElevation -> (структура)
Структура, представляющая фильтр свойств ViewSunElevation, содержащий нижнюю и верхнюю границы.
LowerBound -> (число с плавающей точкой)
UpperBound -> (число с плавающей точкой)
RasterDataCollectionArn -> (строка)
RasterDataCollectionName -> (строка)
TimeRangeFilter -> (структура)
Фильтр диапазона времени, используемый в поиске.
EndTime -> (метка времени)
StartTime -> (метка времени)
JobConfig -> (структура со ссылочными типами)
Объект, содержащий информацию о конфигурации задания.
Примечание
Это структура помеченных союзов. Только один из следующих ключей верхнего уровня может быть задан:BandMathConfig, CloudMaskingConfig, CloudRemovalConfig, GeoMosaicConfig, LandCoverSegmentationConfig, ResamplingConfig, StackConfig, TemporalStatisticsConfig, ZonalStatisticsConfig.BandMathConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для BandMath.
CustomIndices -> (структура)
Пользовательские индексы, которые вычисляются.
Operations -> (список)
Список индексов BandMath для вычисления.
(структура)
Представляет арифметическую операцию для вычисления спектрального индекса.
Equation -> (строка)
Name -> (строка)
OutputType -> (строка)
PredefinedIndices -> (список)
Один или несколько поддерживаемых предопределенных индексов для вычисления. Допустимые значения: NDVI , EVI2 , MSAVI , NDWI , NDMI , NDSI и WDRVI .
(строка)
CloudMaskingConfig -> (структура)
CloudRemovalConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для удаления облаков.
AlgorithmName -> (строка)
InterpolationValue -> (строка)
TargetBands -> (список)
Целевые полосы, которые будут возвращены в выходных данных операции CloudRemoval.
(строка)
GeoMosaicConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для геомозаики.
AlgorithmName -> (строка)
TargetBands -> (список)
Целевые полосы для геомозаики.
(строка)
LandCoverSegmentationConfig -> (структура)
ResamplingConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для ресемплирования.
AlgorithmName -> (строка)
OutputResolution -> (структура)
Структура, представляющая выходное разрешение (в целевых геореференционных единицах) результата операции ресемплирования.
UserDefined -> (структура)
Пользовательское разрешение для вывода операции ресемплирования, определенное значением и единицей измерения.
Unit -> (строка)
Value -> (число с плавающей точкой)
TargetBands -> (список)
Полосы, используемые в операции. Если целевые полосы не указаны, используются все доступные полосы ввода.
(строка)
StackConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для задания Stacking Earth Observation.
OutputResolution -> (структура)
Структура, представляющая выходное разрешение (в целевых геореференционных единицах) результата операции стекирования.
Predefined -> (строка)
HIGHEST , LOWEST и AVERAGE .UserDefined -> (структура)
Структура, представляющая пользовательское выходное разрешение для операции стекирования, определенное как значение и единица измерения.
Unit -> (строка)
Value -> (число с плавающей точкой)
TargetBands -> (список)
Список полос, которые должны быть сложены в указанном порядке. Если параметр не предоставлен, все доступные полосы в наборе данных складываются в алфавитном порядке их имен активов.
(строка)
TemporalStatisticsConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для временных статистик.
GroupBy -> (строка)
Statistics -> (список)
Список вариантов методов статистики.
(строка)
TargetBands -> (список)
Список имен целевых полос для расчета временной статистики.
(строка)
ZonalStatisticsConfig -> (структура)
Объект, содержащий информацию о конфигурации задания для зональных статистик.
Statistics -> (список)
Список зональных статистик для вычисления.
(строка)
TargetBands -> (список)
Полосы, используемые в операции. Если целевые полосы не указаны, используются все доступные входные полосы.
(строка)
ZoneS3Path -> (строка)
ZoneS3PathKmsKeyId -> (строка)
Идентификатор или Amazon Resource Name (ARN) ключа Amazon Web Services Key Management Service (Amazon Web Services KMS), который Amazon SageMaker использует для расшифровки выходных артефактов с шифрованием на стороне сервера Amazon S3. Роль выполнения SageMaker должна иметь разрешение kms:GenerateDataKey.
KmsKeyId может быть любого из следующих форматов:
- // Идентификатор ключа KMS
"1234abcd-12ab-34cd-56ef-1234567890ab" - // Amazon Resource Name (ARN) ключа KMS
"arn:aws:kms:<region>:<account>:key/<key-id-12ab-34cd-56ef-1234567890ab>"
Дополнительную информацию об идентификаторах ключей см. в документации Amazon Web Services Key Management Service (Amazon Web Services KMS).
KmsKeyId -> (строка)
Name -> (строка)
Status -> (строка)
Tags -> (карта)
Каждый тег состоит из ключа и значения.
key -> (строка)
value -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.