nebius.api.nebius.ai.v1.DevlabSpec

class documentation

class DevlabSpec(Message): (source)

Constructor: DevlabSpec(initial_message, image, environment_variables, ports, ...)

View In Hierarchy

DevlabSpec defines an interactive workload that will be run.

Class DiskSpec No class docstring; 2/2 properties, 3/3 methods documented
Class EnvironmentVariable EnvironmentVariable defines an environment variable for the Devlab's container.
Class FileInjection FileInjection materializes a small file inside the container at launch.
Class MysteryBoxSecretRef Reference to a MysteryBox secret.
Class Port No class docstring; 3/3 properties, 4/4 methods, 1/1 class documented
Class PrimaryRoute No class docstring; 1/1 property, 2/2 methods documented
Class RegistryCredentials No class docstring; 1/1 property, 2/2 methods documented
Class Template Reference to a VM app template the Devlab's container is rendered from.
Class VolumeMount VolumeMount represents an extra volume mount for the Devlab container.
Class Workspace No class docstring; 1/1 property, 2/2 methods documented
Method __init__ Create a message from a source message and field values.
Method args.setter Set or clear the generated args field.
Method auth_token_mysterybox_secret.setter Set or clear the generated auth_token_mysterybox_secret field.
Method container_command.setter Set or clear the generated container_command field.
Method disk.setter Set or clear the generated disk field.
Method environment_variables.setter Set or clear the generated environment_variables field.
Method image.setter Set or clear the generated image field.
Method injected_files.setter Set or clear the generated injected_files field.
Method platform.setter Set or clear the generated platform field.
Method ports.setter Set or clear the generated ports field.
Method preset.setter Set or clear the generated preset field.
Method primary_route.setter Set or clear the generated primary_route field.
Method public_ip.setter Set or clear the generated public_ip field.
Method registry_credentials.setter Set or clear the generated registry_credentials field.
Method shm_size_bytes.setter Set or clear the generated shm_size_bytes field.
Method ssh_authorized_keys.setter Set or clear the generated ssh_authorized_keys field.
Method subnet_id.setter Set or clear the generated subnet_id field.
Method template.setter Set or clear the generated template field.
Method volumes.setter Set or clear the generated volumes field.
Method working_dir.setter Set or clear the generated working_dir field.
Method workspace.setter Set or clear the generated workspace field.
Property args The arguments to pass to the entrypoint command.
Property auth_token_mysterybox_secret The MysteryBox secret that contains the authentication token under the AUTH_TOKEN payload key. This field enables an authentication proxy for the Devlab's HTTP ports. The proxy rejects requests without an ...
Property container_command The entrypoint command for the Devlab's container.
Property disk Disk spec for the main disk of the Devlab runtime VM.
Property environment_variables Specifies the environment variables for the Devlab's container.
Property image The Docker image to use for the Devlab's container.
Property injected_files Small config files injected into the container before the user process starts. Intended for configs, not datasets. Read methods return target paths. File content is returned only by Get with view SECRET.
Property platform Compute platform that the Devlab will be run on.
Property ports Specifies the ports that the Devlab exposes.
Property preset Compute preset that the Devlab will be run on.
Property primary_route Primary web route exposed through the managed HTTPS endpoint.
Property public_ip Whether to assign a public IP to the Devlab runtime VM.
Property registry_credentials Registry credentials for private Docker registry.
Property shm_size_bytes Shared memory size in bytes for the Devlab's container.
Property ssh_authorized_keys Public keys to be authorized for SSH access to the Devlab.
Property subnet_id Subnet ID where the Devlab will be deployed.
Property template Template that defines the Devlab's container.
Property volumes Extra volumes to be mounted into the Devlab container.
Property working_dir The working directory for the Devlab's container.
Property workspace Primary workspace storage for user state.

Inherited from Message:

Class Method from_json Create a message from protobuf JSON mapping.
Class Method FromString Create a message by parsing protobuf wire-format bytes.
Class Method get_descriptor Return the message descriptor from the registry.
Class Method is_credentials Return True if a Python field contains credentials.
Class Method is_sensitive Return True if a Python field has the sensitive annotation.
Method __dir__ List generated fields, oneofs, and nested declarations.
Method __repr__ Render non-default fields without disclosing annotated secrets.
Method ByteSize Return the serialized protobuf wire size in bytes.
Method check_presence Check presence using a generated Python field name.
Method Clear Clear all fields, extensions, unknown fields, and the reset mask.
Method clear_extension Clear an extension value.
Method ClearField Clear a protobuf field or oneof and record it in the reset mask.
Method CopyFrom Replace this message with an independent copy of another message.
Method FindInitializationErrors Return paths of missing required fields.
Method get_extension Return an extension value.
Method get_full_update_reset_mask Create a reset mask from the current protobuf state.
Method get_mask Return the reset mask for field changes.
Method has_extension Return True if an extension has explicit presence.
Method HasField Return True if a protobuf field or oneof has explicit presence.
Method is_default Return True if a generated field has its default value.
Method IsInitialized Return True if every required field is initialized.
Method MergeFrom Merge fields from another message of the same generated type.
Method MergeFromString Merge protobuf wire-format bytes into this message.
Method ParseFromString Parse protobuf wire-format bytes and replace this message.
Method SerializeToString Serialize the message using protobuf wire format.
Method set_extension Set an extension value.
Method set_mask Set the reset mask for this message.
Method to_json Serialize this message using protobuf JSON mapping.
Method which_field_in_oneof Return the selected Python field name for a protobuf oneof.
Method WhichOneof Return the selected protobuf field name for a oneof.
Constant __DEPRECATION_DETAILS__ Undocumented
Constant __EXTENSION_REGISTRY__ Registry that decodes protobuf extensions.
Constant __FIELDS__ Runtime field data that the generator creates.
Constant __MAX_NESTING_DEPTH__ Maximum protobuf nesting depth for serialization, parsing, and initialization checks.
Constant __PB2_DESCRIPTOR__ Alias for code that expects a protobuf descriptor.
Constant __PROTO_DESCRIPTOR__ Message descriptor from the registry.
Constant __PY_TO_PB2__ Mapping from Python names to protobuf names.
Constant __REGISTRY__ Registry for the message and its descriptor.
Class Variable __PROTO_FULL_NAME__ Fully qualified protobuf message name.
Property Extensions Provide protobuf-compatible mapping access to extension values.
Class Method _fields_by_number Undocumented
Class Method _fields_by_proto_name Undocumented
Class Method _fields_by_python_name Undocumented
Class Method _from_string Deserialize internally without invoking generated user warnings.
Class Method _oneof_python_name Undocumented
Class Method _public_fields_by_proto_name Undocumented
Class Method _public_fields_by_python_name Undocumented
Static Method _format_map_key Undocumented
Static Method _repr_field Undocumented
Method _bind_child Undocumented
Method _bind_mutation Undocumented
Method _check_same_type Undocumented
Method _child_changed Undocumented
Method _clear_state Undocumented
Method _closed_enum_unknown Undocumented
Method _converted_view Undocumented
Method _decode_map_entry Undocumented
Method _detach_child Undocumented
Method _field_has_value Undocumented
Method _field_is_default Undocumented
Method _find_initialization_errors Undocumented
Method _get_field Undocumented
Method _initialize Initialize message state, optionally suppressing generated warnings.
Method _map Undocumented
Method _merge_from_string Undocumented
Method _nesting_limit Undocumented
Method _notify Undocumented
Method _record_reset Undocumented
Method _repeated Undocumented
Method _select Undocumented
Method _serialize_to_string Undocumented
Method _set_field Undocumented
Method _suspend_mutation Undocumented
Method _suspend_reset_mask Undocumented
Method _try_decode_field Undocumented
Method _write_field Undocumented
Instance Variable _extensions Undocumented
Instance Variable _mutation_suspended Undocumented
Instance Variable _on_mutation Undocumented
Instance Variable _oneofs Undocumented
Instance Variable _present Undocumented
Instance Variable _reset_mask Undocumented
Instance Variable _reset_mask_suspended Undocumented
Instance Variable _unknown_fields Undocumented
Instance Variable _values Undocumented
Instance Variable _views Undocumented
def __init__(self, initial_message: SerializableMessage | None = None, *, image: str | None | UnsetType = ..., environment_variables: Iterable[EnvironmentVariable] | None | UnsetType = ..., ports: Iterable[Port] | None | UnsetType = ..., container_command: str | None | UnsetType = ..., args: str | None | UnsetType = ..., working_dir: str | None | UnsetType = ..., volumes: Iterable[VolumeMount] | None | UnsetType = ..., registry_credentials: RegistryCredentials | None | UnsetType = ..., platform: str | None | UnsetType = ..., preset: str | None | UnsetType = ..., shm_size_bytes: int | None | UnsetType = ..., disk: DiskSpec | None | UnsetType = ..., subnet_id: str | None | UnsetType = ..., public_ip: bool | None | UnsetType = ..., ssh_authorized_keys: Iterable[str] | None | UnsetType = ..., workspace: Workspace | None | UnsetType = ..., primary_route: PrimaryRoute | None | UnsetType = ..., template: Template | None | UnsetType = ..., injected_files: Iterable[FileInjection] | None | UnsetType = ..., auth_token_mysterybox_secret: MysteryBoxSecretRef | None | UnsetType = ...): (source)
overrides nebius.base.protos.direct.Message.__init__

Create a message from a source message and field values.

@args.setter
def args(self, value: str | None): (source)

Set or clear the generated args field.

@auth_token_mysterybox_secret.setter
def auth_token_mysterybox_secret(self, value: MysteryBoxSecretRef | None): (source)

Set or clear the generated auth_token_mysterybox_secret field.

@container_command.setter
def container_command(self, value: str | None): (source)

Set or clear the generated container_command field.

@disk.setter
def disk(self, value: DiskSpec | None): (source)

Set or clear the generated disk field.

@environment_variables.setter
def environment_variables(self, value: Iterable[EnvironmentVariable] | None): (source)

Set or clear the generated environment_variables field.

@image.setter
def image(self, value: str | None): (source)

Set or clear the generated image field.

@injected_files.setter
def injected_files(self, value: Iterable[FileInjection] | None): (source)

Set or clear the generated injected_files field.

@platform.setter
def platform(self, value: str | None): (source)

Set or clear the generated platform field.

@ports.setter
def ports(self, value: Iterable[Port] | None): (source)

Set or clear the generated ports field.

@preset.setter
def preset(self, value: str | None): (source)

Set or clear the generated preset field.

@primary_route.setter
def primary_route(self, value: PrimaryRoute | None): (source)

Set or clear the generated primary_route field.

@public_ip.setter
def public_ip(self, value: bool | None): (source)

Set or clear the generated public_ip field.

@registry_credentials.setter
def registry_credentials(self, value: RegistryCredentials | None): (source)

Set or clear the generated registry_credentials field.

@shm_size_bytes.setter
def shm_size_bytes(self, value: int | None): (source)

Set or clear the generated shm_size_bytes field.

@ssh_authorized_keys.setter
def ssh_authorized_keys(self, value: Iterable[str] | None): (source)

Set or clear the generated ssh_authorized_keys field.

@subnet_id.setter
def subnet_id(self, value: str | None): (source)

Set or clear the generated subnet_id field.

@template.setter
def template(self, value: Template | None): (source)

Set or clear the generated template field.

@volumes.setter
def volumes(self, value: Iterable[VolumeMount] | None): (source)

Set or clear the generated volumes field.

@working_dir.setter
def working_dir(self, value: str | None): (source)

Set or clear the generated working_dir field.

@workspace.setter
def workspace(self, value: Workspace | None): (source)

Set or clear the generated workspace field.

@property
args: str = (source)

The arguments to pass to the entrypoint command.

@property
auth_token_mysterybox_secret: MysteryBoxSecretRef = (source)

The MysteryBox secret that contains the authentication token under the AUTH_TOKEN payload key. This field enables an authentication proxy for the Devlab's HTTP ports. The proxy rejects requests without an Authorization: Bearer <token> header that contains the matching token. If absent, Serverless does not add this bearer-token check.

@property
container_command: str = (source)

The entrypoint command for the Devlab's container.

@property
disk: DiskSpec = (source)

Disk spec for the main disk of the Devlab runtime VM.

@property
environment_variables: MutableSequence[EnvironmentVariable] = (source)

Specifies the environment variables for the Devlab's container.

@property
image: str = (source)

The Docker image to use for the Devlab's container.

Required unless template is set: the template declares the image.

@property
injected_files: MutableSequence[FileInjection] = (source)

Small config files injected into the container before the user process starts. Intended for configs, not datasets. Read methods return target paths. File content is returned only by Get with view SECRET.

@property
platform: str = (source)

Compute platform that the Devlab will be run on.

@property
ports: MutableSequence[Port] = (source)

Specifies the ports that the Devlab exposes.

@property
preset: str = (source)

Compute preset that the Devlab will be run on.

@property
primary_route: PrimaryRoute = (source)

Primary web route exposed through the managed HTTPS endpoint.

Required unless template is set: the template declares the primary web UI port.

@property
public_ip: bool = (source)

Whether to assign a public IP to the Devlab runtime VM.

@property
registry_credentials: RegistryCredentials = (source)

Registry credentials for private Docker registry.

@property
shm_size_bytes: int = (source)

Shared memory size in bytes for the Devlab's container.

@property
ssh_authorized_keys: MutableSequence[str] = (source)

Public keys to be authorized for SSH access to the Devlab.

@property
subnet_id: str = (source)

Subnet ID where the Devlab will be deployed.

@property
template: Template = (source)

Template that defines the Devlab's container.

When set, the template declares the container shape: image, entrypoint command, arguments, working directory, ports, optional shared memory size, the primary web route, and the default workspace path. The spec must leave image, container command, arguments, working directory, and primary route empty. Environment variables and ports extend the template-declared ones, workspace.container_path may override the template default, and shm_size_bytes may be set only when the template leaves it unset.

The template is consumed at creation time: read methods return the rendered container shape instead of the template reference.

@property
volumes: MutableSequence[VolumeMount] = (source)

Extra volumes to be mounted into the Devlab container.

@property
working_dir: str = (source)

The working directory for the Devlab's container.

@property
workspace: Workspace = (source)

Primary workspace storage for user state.