az iot central scheduled-job

참고 항목

이 참조는 Azure CLI(버전 2.37.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot central scheduled-job 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

IoT Central 일정 작업을 관리하고 구성합니다.

명령

Name Description 형식 상태
az iot central scheduled-job create

ID별로 예약된 작업을 만듭니다.

내선 번호 GA
az iot central scheduled-job delete

ID별로 예약된 기존 작업을 삭제합니다.

내선 번호 GA
az iot central scheduled-job list

애플리케이션에서 예약된 작업 정의 목록을 가져옵니다.

내선 번호 GA
az iot central scheduled-job list-runs

예약된 작업 정의에 대한 작업 인스턴스 목록을 가져옵니다.

내선 번호 GA
az iot central scheduled-job show

ID별로 예약된 작업에 대한 세부 정보를 가져옵니다.

내선 번호 GA
az iot central scheduled-job update

ID별로 예약된 작업을 업데이트합니다.

내선 번호 GA

az iot central scheduled-job create

ID별로 예약된 작업을 만듭니다.

--schedule 및 --content는 인라인 json 또는 파일 경로일 수 있습니다.

az iot central scheduled-job create --app-id
                                    --content
                                    --group-id
                                    --id
                                    --schedule
                                    [--api-version {2022-06-30-preview, 2022-07-31}]
                                    [--batch]
                                    [--batch-type {number, percentage}]
                                    [--cancellation-threshold]
                                    [--cancellation-threshold-batch]
                                    [--cancellation-threshold-type {number, percentage}]
                                    [--central-api-uri]
                                    [--desc]
                                    [--job-name]
                                    [--token]

예제

이름으로 일정 작업 만들기

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule {jobScheduleJSONPatch} --content {jobDataJSONPath}

이름 및 일괄 처리 구성을 사용하여 예약된 작업을 만듭니다.

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule	{jobScheduleJSONPatch} --content {jobDataJSONPath} --batch {jobBatchValue} --batch-type {jobBatchType}

일괄 처리 없이 이름 및 취소 임계값 구성을 사용하여 예약된 작업을 만듭니다.

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule	{jobScheduleJSONPatch} --content {jobDataJSONPath} --cancellation-threshold {jobCancellationThresholdValue} --cancellation-threshold-type {jobCancellationThresholdType} --description {jobDesc}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--content -k

작업 데이터 정의입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다. 요청 본문에는 JobData 배열이 포함되어야 합니다.

--group-id -g

작업을 실행할 디바이스 그룹의 ID입니다.

--id --job-id

예약된 작업의 고유 식별자입니다.

--schedule

작업을 실행할 일정입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--batch -b

일괄 처리가 수행되는 디바이스의 수 또는 백분율입니다.

--batch-type --bt

여러 디바이스에서 일괄 처리가 수행되는지 또는 전체의 백분율을 지정합니다.

허용되는 값: number, percentage
기본값: number
--cancellation-threshold --cth

취소 임계값이 적용되는 디바이스의 수 또는 백분율입니다.

--cancellation-threshold-batch --ctb

취소 임계값이 일괄 처리당 적용되는지 전체 작업에 적용되는지 여부입니다.

기본값: number
--cancellation-threshold-type --ctt

여러 디바이스에 취소 임계값이 적용되는지 또는 전체의 백분율에 적용되는지 지정합니다.

허용되는 값: number, percentage
기본값: number
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--desc --description

작업에 대한 자세한 설명입니다.

--job-name

작업의 표시 이름입니다.

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central scheduled-job delete

ID별로 예약된 기존 작업을 삭제합니다.

az iot central scheduled-job delete --app-id
                                    --id
                                    [--api-version {2022-06-30-preview, 2022-07-31}]
                                    [--central-api-uri]
                                    [--token]

예제

ID로 예약된 기존 작업 삭제

az iot central scheduled-job delete --app-id {appid} --id {scheduledJobId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--id --job-id

예약된 작업의 고유 식별자입니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central scheduled-job list

애플리케이션에서 예약된 작업 정의 목록을 가져옵니다.

az iot central scheduled-job list --app-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--token]

예제

애플리케이션에서 예약된 작업 정의 목록 가져오기

az iot central scheduled-job list --app-id {appid}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central scheduled-job list-runs

예약된 작업 정의에 대한 작업 인스턴스 목록을 가져옵니다.

az iot central scheduled-job list-runs --app-id
                                       --id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--token]

예제

예약된 작업 정의에 대한 작업 인스턴스 목록을 가져옵니다.

az iot central scheduled-job list-runs --app-id {appid} --job-id {jobId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--id --job-id

예약된 작업의 고유 식별자입니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central scheduled-job show

ID별로 예약된 작업에 대한 세부 정보를 가져옵니다.

az iot central scheduled-job show --app-id
                                  --id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--token]

예제

ID별 예약된 작업에 대한 세부 정보 가져오기

az iot central scheduled-job show --app-id {appid} --id {scheduledJobId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--id --job-id

예약된 작업의 고유 식별자입니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central scheduled-job update

ID별로 예약된 작업을 업데이트합니다.

az iot central scheduled-job update --app-id
                                    --id
                                    [--api-version {2022-06-30-preview, 2022-07-31}]
                                    [--batch]
                                    [--batch-type {number, percentage}]
                                    [--cancellation-threshold]
                                    [--cancellation-threshold-batch]
                                    [--cancellation-threshold-type {number, percentage}]
                                    [--central-api-uri]
                                    [--content]
                                    [--desc]
                                    [--group-id]
                                    [--job-name]
                                    [--schedule]
                                    [--token]

예제

이름으로 일정 작업 업데이트

az iot central scheduled-job update --app-id {appid} --job-id {jobId} --job-name {displayName}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--id --job-id

예약된 작업의 고유 식별자입니다.

선택적 매개 변수

--api-version --av
사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--batch -b

일괄 처리가 수행되는 디바이스의 수 또는 백분율입니다.

--batch-type --bt

여러 디바이스에서 일괄 처리가 수행되는지 또는 전체의 백분율을 지정합니다.

허용되는 값: number, percentage
기본값: number
--cancellation-threshold --cth

취소 임계값이 적용되는 디바이스의 수 또는 백분율입니다.

--cancellation-threshold-batch --ctb

취소 임계값이 일괄 처리당 적용되는지 전체 작업에 적용되는지 여부입니다.

--cancellation-threshold-type --ctt

여러 디바이스에 취소 임계값이 적용되는지 또는 전체의 백분율에 적용되는지 지정합니다.

허용되는 값: number, percentage
기본값: number
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--content -k

작업 데이터 정의입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다. 요청 본문에는 JobData 배열이 포함되어야 합니다.

--desc --description

작업에 대한 자세한 설명입니다.

--group-id -g

작업을 실행할 디바이스 그룹의 ID입니다.

--job-name

작업의 표시 이름입니다.

--schedule

작업을 실행할 일정입니다. JSON 파일 또는 원시 문자열화된 JSON에 대한 경로를 제공합니다.

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.