Batch / Client / create_service_environment
create_service_environment¶
- Batch.Client.create_service_environment(**kwargs)¶
Creates a service environment for running service jobs. Service environments define capacity limits for specific service types such as SageMaker Training jobs.
See also: AWS API Documentation
Request Syntax
response = client.create_service_environment( serviceEnvironmentName='string', serviceEnvironmentType='SAGEMAKER_TRAINING', state='ENABLED'|'DISABLED', capacityLimits=[ { 'maxCapacity': 123, 'capacityUnit': 'string' }, ], tags={ 'string': 'string' } )
- Parameters:
serviceEnvironmentName (string) –
[REQUIRED]
The name for the service environment. It can be up to 128 characters long and can contain letters, numbers, hyphens (-), and underscores (_).
serviceEnvironmentType (string) –
[REQUIRED]
The type of service environment. For SageMaker Training jobs, specify
SAGEMAKER_TRAINING
.state (string) – The state of the service environment. Valid values are
ENABLED
andDISABLED
. The default value isENABLED
.capacityLimits (list) –
[REQUIRED]
The capacity limits for the service environment. The number of instances a job consumes is the total number of instances requested in the submit training job request resource configuration.
(dict) –
Defines the capacity limit for a service environment. This structure specifies the maximum amount of resources that can be used by service jobs in the environment.
maxCapacity (integer) –
The maximum capacity available for the service environment. This value represents the maximum amount of resources that can be allocated to service jobs.
For example,
maxCapacity=50
,capacityUnit=NUM_INSTANCES
. This indicates that the maximum number of instances that can be run on this service environment is 50. You could then run 5 SageMaker Training jobs that each use 10 instances. However, if you submit another job that requires 10 instances, it will wait in the queue.capacityUnit (string) –
The unit of measure for the capacity limit. This defines how the maxCapacity value should be interpreted. For
SAGEMAKER_TRAINING
jobs, useNUM_INSTANCES
.
tags (dict) –
The tags that you apply to the service environment to help you categorize and organize your resources. Each tag consists of a key and an optional value. For more information, see Tagging your Batch resources.
(string) –
(string) –
- Return type:
dict
- Returns:
Response Syntax
{ 'serviceEnvironmentName': 'string', 'serviceEnvironmentArn': 'string' }
Response Structure
(dict) –
serviceEnvironmentName (string) –
The name of the service environment.
serviceEnvironmentArn (string) –
The Amazon Resource Name (ARN) of the service environment.
Exceptions