TaskAddParameter 클래스
추가할 Azure Batch 작업입니다.
Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(하지만 제한되지 않음)가 있습니다. 복구 작업으로 인한 재시도는 독립적이며 maxTaskRetryCount에 대해 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업은 손상 또는 중복 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점 지정을 사용하는 것입니다.
Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.
- 상속
-
TaskAddParameter
생성자
TaskAddParameter(*, id: str, command_line: str, display_name: str = None, container_settings=None, exit_conditions=None, resource_files=None, output_files=None, environment_settings=None, affinity_info=None, constraints=None, required_slots: int = None, user_identity=None, multi_instance_settings=None, depends_on=None, application_package_references=None, authentication_token_settings=None, **kwargs)
매개 변수
- id
- str
필수 요소. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다(즉, 대/소문자만 다른 작업 내에 두 개의 ID가 없을 수 있음).
- command_line
- str
필수 요소. 다중 instance 작업의 경우 기본 작업 및 모든 하위 작업이 조정 명령줄 실행을 완료한 후 명령줄이 기본 작업으로 실행됩니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
- container_settings
- TaskContainerSettings
태스크가 실행되는 컨테이너에 대한 설정입니다. 이 작업을 실행할 풀에 containerConfiguration이 설정된 경우 이 설정도 설정해야 합니다. 이 작업을 실행할 풀에 containerConfiguration이 설정되어 있지 않으면 설정하면 안 됩니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
- resource_files
- list[ResourceFile]
다중 instance 작업의 경우 리소스 파일은 주 작업이 실행되는 컴퓨팅 노드에만 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
- environment_settings
- list[EnvironmentSetting]
- constraints
- TaskConstraints
이 작업에 적용되는 실행 제약 조건입니다. 제약 조건을 지정하지 않으면 maxTaskRetryCount는 작업에 지정된 maxTaskRetryCount이고 maxWallClockTime은 무한하며 retentionTime은 7일입니다.
- required_slots
- int
태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 instance 작업의 경우 1이어야 합니다.
- multi_instance_settings
- MultiInstanceSettings
Task가 다중 instance 작업임을 나타내고 다중 instance 작업을 실행하는 방법에 대한 정보를 포함하는 개체입니다.
- depends_on
- TaskDependencies
이 태스크가 사용하는 작업입니다. 이 작업은 의존하는 모든 작업이 성공적으로 완료될 때까지 예약되지 않습니다. 이러한 작업이 실패하고 재시도 횟수가 소진되는 경우 이 작업은 예약되지 않습니다. Job에 usesTaskDependencies가 true로 설정되어 있지 않고 이 요소가 있으면 TaskDependenciesNotSpecifiedOnJob 오류 코드와 함께 요청이 실패합니다.
- application_package_references
- list[ApplicationPackageReference]
애플리케이션 패키지는 다운로드되어 작업 작업 디렉터리가 아닌 공유 디렉터리에 배포됩니다. 따라서 참조된 패키지가 노드에 이미 있고 최신 상태이면 다시 다운로드되지 않습니다. 컴퓨팅 노드의 기존 복사본이 사용됩니다. 참조된 패키지를 설치할 수 없는 경우(예: 패키지가 삭제되었거나 다운로드가 실패했기 때문에) 작업이 실패합니다.
- authentication_token_settings
- AuthenticationTokenSettings
태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다. 이 속성을 설정하면 Batch 서비스는 계정 액세스 키를 요구하지 않고 Batch 서비스 작업을 인증하는 데 사용할 수 있는 인증 토큰을 Task에 제공합니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공됩니다. 태스크가 토큰을 사용하여 수행할 수 있는 작업은 설정에 따라 달라집니다. 예를 들어 태스크는 작업에 다른 작업을 추가하거나 작업 또는 작업 아래의 다른 작업의 상태 검사 위해 작업 권한을 요청할 수 있습니다.
메서드
as_dict |
json.dump를 사용하여 JSONify일 수 있는 받아쓰기를 반환합니다. 고급 사용은 필요에 따라 콜백을 매개 변수로 사용할 수 있습니다. 키는 Python에서 사용되는 특성 이름입니다. Attr_desc 메타데이터의 받아쓰기입니다. 현재 msrest 형식의 'type'과 RestAPI로 인코딩된 키가 있는 'key'가 포함되어 있습니다. Value는 이 개체의 현재 값입니다. 반환된 문자열은 키를 serialize하는 데 사용됩니다. 반환 형식이 목록인 경우 계층적 결과 받아쓰기로 간주됩니다. 이 파일의 세 가지 예제를 참조하세요.
XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다. |
deserialize |
RestAPI 구문을 사용하여 str을 구문 분석하고 모델을 반환합니다. |
enable_additional_properties_sending | |
from_dict |
지정된 키 추출기를 사용하여 받아쓰기를 구문 분석하여 모델을 반환합니다. 기본적으로 키 추출기(rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor 및 last_rest_key_case_insensitive_extractor)를 고려합니다. |
is_xml_model | |
serialize |
이 모델에서 azure로 전송될 JSON을 반환합니다. 이는 as_dict(full_restapi_key_transformer, keep_readonly=False)에 대한 별칭입니다. XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다. |
validate |
이 모델의 유효성을 재귀적으로 검사하고 ValidationError 목록을 반환합니다. |
as_dict
json.dump를 사용하여 JSONify일 수 있는 받아쓰기를 반환합니다.
고급 사용은 필요에 따라 콜백을 매개 변수로 사용할 수 있습니다.
키는 Python에서 사용되는 특성 이름입니다. Attr_desc 메타데이터의 받아쓰기입니다. 현재 msrest 형식의 'type'과 RestAPI로 인코딩된 키가 있는 'key'가 포함되어 있습니다. Value는 이 개체의 현재 값입니다.
반환된 문자열은 키를 serialize하는 데 사용됩니다. 반환 형식이 목록인 경우 계층적 결과 받아쓰기로 간주됩니다.
이 파일의 세 가지 예제를 참조하세요.
attribute_transformer
full_restapi_key_transformer
last_restapi_key_transformer
XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.
as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)
매개 변수
- key_transformer
- <xref:function>
키 변환기 함수입니다.
- keep_readonly
반환
dict JSON 호환 개체
반환 형식
deserialize
RestAPI 구문을 사용하여 str을 구문 분석하고 모델을 반환합니다.
deserialize(data, content_type=None)
매개 변수
반환
이 모델의 instance
예외
enable_additional_properties_sending
enable_additional_properties_sending()
from_dict
지정된 키 추출기를 사용하여 받아쓰기를 구문 분석하여 모델을 반환합니다.
기본적으로 키 추출기(rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor 및 last_rest_key_case_insensitive_extractor)를 고려합니다.
from_dict(data, key_extractors=None, content_type=None)
매개 변수
- key_extractors
반환
이 모델의 instance
예외
is_xml_model
is_xml_model()
serialize
이 모델에서 azure로 전송될 JSON을 반환합니다.
이는 as_dict(full_restapi_key_transformer, keep_readonly=False)에 대한 별칭입니다.
XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.
serialize(keep_readonly=False, **kwargs)
매개 변수
반환
dict JSON 호환 개체
반환 형식
validate
Azure SDK for Python