PoolAddParameter 클래스

추가할 Azure Batch 서비스의 풀입니다.

Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.

상속

Model

PoolAddParameter

생성자

PoolAddParameter(*, id: str, vm_size: str, display_name: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, mount_configuration=None, target_node_communication_mode=None, **kwargs)

매개 변수

id

str

필수

필수 사항입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않으며 대/소문자를 구분하지 않습니다(즉, 계정 내에 대/소문자만 다른 풀 ID가 두 개 없을 수 있음).

display_name

str

필수

표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.

vm_size

str

필수

필수 사항입니다. Cloud Services 풀에 사용 가능한 가상 머신 크기(cloudServiceConfiguration으로 만든 풀)에 대한 자세한 내용은 Cloud Services 크기(https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/)를 참조하세요. Batch는 ExtraSmall, A1V2 및 A2V2를 제외한 모든 Cloud Services VM 크기를 지원합니다. Virtual Machines Marketplace의 이미지를 사용하여 풀에 사용할 수 있는 VM 크기(virtualMachineConfiguration으로 만든 풀)에 대한 자세한 내용은 Virtual Machines 크기(https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/Linux) 또는 Virtual Machines 크기(Windows)(https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)를 참조하세요. Batch는 STANDARD_A0 및 Premium Storage(STANDARD_GS, STANDARD_DS 및 STANDARD_DSV2 시리즈)를 제외한 모든 Azure VM 크기를 지원합니다.

cloud_service_configuration

CloudServiceConfiguration

필수

풀에 대한 클라우드 서비스 구성입니다. 이 속성과 virtualMachineConfiguration은 상호 배타적이며 속성 중 하나를 지정해야 합니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우 이 속성을 지정할 수 없습니다.

virtual_machine_configuration

VirtualMachineConfiguration

필수

풀에 대한 가상 머신 구성입니다. 이 속성과 cloudServiceConfiguration은 상호 배타적이며 속성 중 하나를 지정해야 합니다.

resize_timeout

<xref:timedelta>

필수

이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

target_dedicated_nodes

int

필수

풀에서 원하는 전용 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

target_low_priority_nodes

int

필수

풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

enable_auto_scale

bool

필수

풀 크기가 시간에 따라 자동으로 조정되어야 하는지 여부입니다. false이면 targetDedicatedNodes 및 targetLowPriorityNodes 중 하나 이상을 지정해야 합니다. true이면 autoScaleFormula 속성이 필요하며 풀은 수식에 따라 자동으로 크기가 조정됩니다. 기본값은 false입니다.

auto_scale_formula

str

필수

enableAutoScale이 false로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 생성하기 전에 수식이 유효한지 확인합니다. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 'Azure Batch 풀에서 컴퓨팅 노드 자동 크기 조정'(https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/)을 참조하세요.

auto_scale_evaluation_interval

<xref:timedelta>

필수

기본값은 15분입니다. 최소 및 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

enable_inter_node_communication

bool

필수

풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 노드 간 통신을 사용하도록 설정하면 풀의 컴퓨팅 노드에 대한 배포 제한으로 인해 풀의 최대 크기가 제한됩니다. 이로 인해 풀이 원하는 크기에 도달하지 못할 수 있습니다. 기본값은 false입니다.

network_configuration

NetworkConfiguration

필수

풀에 대한 네트워크 구성입니다.

start_task

StartTask

필수

풀에 조인할 때 각 컴퓨팅 노드에서 실행되도록 지정된 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다.

certificate_references

list[CertificateReference]

필수

Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 환경 변수 AZ_BATCH_CERTIFICATES_DIR 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.

application_package_references

list[ApplicationPackageReference]

필수

풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅되거나 이미지로 다시 설치될 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.

application_licenses

list[str]

필수

애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다.

task_slots_per_node

int

필수

풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256개입니다.

task_scheduling_policy

TaskSchedulingPolicy

필수

풀의 컴퓨팅 노드에 태스크를 분산하는 방법. 지정하지 않으면 기본값이 분산됩니다.

user_accounts

list[UserAccount]

필수

metadata

list[MetadataItem]

필수

Batch 서비스는 메타데이터에 의미를 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

mount_configuration

list[MountConfiguration]

필수

Azure 파일 공유, NFS, CIFS 또는 Blobfuse 기반 파일 시스템을 사용하여 스토리지를 탑재합니다.

target_node_communication_mode

str 또는 NodeCommunicationMode

필수

풀에 대해 원하는 노드 통신 모드입니다. 생략하면 기본값은 Default입니다. 가능한 값은 'default', 'classic', 'simplified'입니다.

메서드

as_dict	json.dump를 사용하여 JSONify일 수 있는 받아쓰기를 반환합니다. 고급 사용은 필요에 따라 콜백을 매개 변수로 사용할 수 있습니다. 키는 Python에서 사용되는 특성 이름입니다. Attr_desc 메타데이터의 받아쓰기입니다. 현재 msrest 형식이 있는 'type'과 RestAPI 인코딩된 키가 있는 'key'가 포함되어 있습니다. 값은 이 개체의 현재 값입니다. 반환된 문자열은 키를 serialize하는 데 사용됩니다. 반환 형식이 목록인 경우 계층적 결과 받아쓰기로 간주됩니다. 이 파일의 세 가지 예제를 참조하세요. attribute_transformer full_restapi_key_transformer last_restapi_key_transformer 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'가 포함되어 있습니다. 값은 이 개체의 현재 값입니다.

반환된 문자열은 키를 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

기본값: True

반환

dict JSON 호환 개체

반환 형식

dict

deserialize

RestAPI 구문을 사용하여 str를 구문 분석하고 모델을 반환합니다.

deserialize(data, content_type=None)

매개 변수

data

str

필수

RestAPI 구조를 사용하는 str입니다. 기본적으로 JSON입니다.

content_type

str

기본값: None

기본적으로 JSON은 XML인 경우 application/xml을 설정합니다.

반환

이 모델의 instance

예외

DeserializationError if something went wrong

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)

매개 변수

data

dict

필수

RestAPI 구조를 사용하는 받아쓰기

content_type

str

기본값: None

기본적으로 JSON은 XML인 경우 application/xml을 설정합니다.

key_extractors

기본값: None

반환

이 모델의 instance

예외

DeserializationError if something went wrong

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)

매개 변수

keep_readonly

bool

기본값: False

읽기 전용 특성을 직렬화하려는 경우

반환

dict JSON 호환 개체

반환 형식

dict

validate

이 모델의 유효성을 재귀적으로 확인하고 ValidationError 목록을 반환합니다.

validate()

반환

유효성 검사 오류 목록

반환 형식

list