CloudPool 클래스

Azure Batch 서비스의 풀입니다.

변수는 서버에서만 채워지고 요청을 보낼 때 무시됩니다.

상속

Model

CloudPool

생성자

CloudPool(*, id: str = None, display_name: str = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, allocation_state=None, allocation_state_transition_time=None, vm_size: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, resize_errors=None, current_dedicated_nodes: int = None, current_low_priority_nodes: int = 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, auto_scale_run=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, stats=None, mount_configuration=None, identity=None, target_node_communication_mode=None, **kwargs)

매개 변수

id

str

필수

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

display_name

str

필수

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

url

str

필수

e_tag

str

필수

불투명 문자열입니다. 이를 사용하여 요청 간에 풀이 변경되었는지 여부를 검색할 수 있습니다. 특히 풀을 업데이트할 때 ETag를 전달하여 그 동안 풀을 수정한 사람이 없는 경우에만 변경 내용이 적용되도록 지정할 수 있습니다.

last_modified

datetime

필수

targetDedicatedNodes 또는 enableAutoscale 설정과 같은 풀 수준 데이터가 마지막으로 변경된 시간입니다. 컴퓨팅 노드 변경 상태와 같은 노드 수준 변경은 고려하지 않습니다.

creation_time

datetime

필수

state

str 또는 PoolState

필수

가능한 값은 '활성', '삭제 중'입니다.

state_transition_time

datetime

필수

allocation_state

str 또는 AllocationState

필수

가능한 값은 'steady', 'resizing', 'stopping'입니다.

allocation_state_transition_time

datetime

필수

vm_size

str

필수

풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀에서 컴퓨팅 노드에 대한 VM 크기 선택(https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes)을 참조하세요.

cloud_service_configuration

CloudServiceConfiguration

필수

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

virtual_machine_configuration

VirtualMachineConfiguration

필수

풀에 대한 가상 머신 구성입니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다.

resize_timeout

<xref:timedelta>

필수

가장 최근의 크기 조정 작업에 대한 시간 제한입니다. (풀을 만들 때의 초기 크기 조정은 크기 조정으로 계산됩니다.) 기본값은 15분입니다.

resize_errors

list[ResizeError]

필수

이 속성은 마지막 풀 크기 조정 중에 하나 이상의 오류가 발생한 경우에만 설정되며 Pool allocationState가 Steady인 경우에만 설정됩니다.

current_dedicated_nodes

int

필수

현재 풀에 있는 전용 컴퓨팅 노드 수입니다.

current_low_priority_nodes

int

필수

현재 풀에 있는 스폿/우선 순위가 낮은 컴퓨팅 노드 수입니다. 선점된 스폿/낮은 우선 순위 컴퓨팅 노드가 이 수에 포함됩니다.

target_dedicated_nodes

int

필수

풀에서 원하는 전용 컴퓨팅 노드 수입니다.

target_low_priority_nodes

int

필수

풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다.

enable_auto_scale

bool

필수

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

auto_scale_formula

str

필수

이 속성은 풀이 자동으로 스케일링되는 경우에만 설정됩니다. 즉, enableAutoScale이 true입니다.

auto_scale_evaluation_interval

<xref:timedelta>

필수

이 속성은 풀이 자동으로 스케일링되는 경우에만 설정됩니다. 즉, enableAutoScale이 true입니다.

auto_scale_run

AutoScaleRun

필수

자동 크기 조정 수식의 마지막 실행 결과 및 오류입니다. 이 속성은 풀이 자동으로 스케일링되는 경우에만 설정됩니다. 즉, enableAutoScale이 true입니다.

enable_inter_node_communication

bool

필수

풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 이렇게 하면 풀에 컴퓨팅 노드를 할당할 수 있는 제한이 적용됩니다. 이 값을 지정하면 풀에 할당할 컴퓨팅 노드의 요청된 수를 줄일 수 있습니다.

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]

필수

패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 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]

필수

stats

PoolStatistics

필수

풀의 전체 수명 동안의 사용률 및 리소스 사용 통계입니다. 이 속성은 CloudPool이 'stats' 특성을 포함한 expand 절로 검색된 경우에만 채워집니다. 그렇지 않으면 null입니다. 통계를 즉시 사용할 수 없습니다. Batch 서비스는 통계의 주기적인 롤업을 수행합니다. 일반적인 지연 시간은 약 30분입니다.

mount_configuration

list[MountConfiguration]

필수

Azure Files, NFS, CIFS/SMB 및 Blobfuse를 지원합니다.

identity

BatchPoolIdentity

필수

구성된 경우 Batch 풀의 ID입니다. Batch 풀과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

target_node_communication_mode

str 또는 NodeCommunicationMode

필수

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

변수

current_node_communication_mode

str 또는 NodeCommunicationMode

풀 통신 모드의 현재 상태입니다. 가능한 값은 'default', 'classic', 'simplified'입니다.

메서드

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를 전달할 수 있습니다.
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

기본값: 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