EnvironmentsOperations Class

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through

DevTestLabsClient's

<xref:environments> attribute.

Constructor

EnvironmentsOperations(*args, **kwargs)

Methods

begin_create_or_update

Create or replace an existing environment. This operation can take a while to complete.
begin_delete

Delete environment. This operation can take a while to complete.
get

Get environment.
list

List environments in a given user profile.
update

Allows modifying tags of environments. All other properties will be ignored.

begin_create_or_update

Create or replace an existing environment. This operation can take a while to complete.

begin_create_or_update(resource_group_name: str, lab_name: str, user_name: str, name: str, dtl_environment: _models.DtlEnvironment, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.DtlEnvironment]

Parameters

Name Description
resource_group_name
Required
str

The name of the resource group. Required.
lab_name
Required
str

The name of the lab. Required.
user_name
Required
str

The name of the user profile. Required.
name
Required
str

The name of the environment. Required.
dtl_environment
Required
DtlEnvironment or IO[bytes]

An environment, which is essentially an ARM template deployment. Is either a DtlEnvironment type or a IO[bytes] type. Required.

Returns

Type Description
LROPoller[DtlEnvironment]

An instance of LROPoller that returns either DtlEnvironment or the result of cls(response)

Exceptions

Type Description
HttpResponseError

begin_delete

Delete environment. This operation can take a while to complete.

begin_delete(resource_group_name: str, lab_name: str, user_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name Description
resource_group_name
Required
str

The name of the resource group. Required.
lab_name
Required
str

The name of the lab. Required.
user_name
Required
str

The name of the user profile. Required.
name
Required
str

The name of the environment. Required.

Returns

Type Description
LROPoller[None]

An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type Description
HttpResponseError

get

Get environment.

get(resource_group_name: str, lab_name: str, user_name: str, name: str, expand: str | None = None, **kwargs: Any) -> DtlEnvironment

Parameters

Name Description
resource_group_name
Required
str

The name of the resource group. Required.
lab_name
Required
str

The name of the lab. Required.
user_name
Required
str

The name of the user profile. Required.
name
Required
str

The name of the environment. Required.
expand
str

Specify the $expand query. Example: 'properties($select=deploymentProperties)'. Default value is None.

Default value: None

Returns

Type Description
DtlEnvironment

DtlEnvironment or the result of cls(response)

Exceptions

Type Description
HttpResponseError

list

List environments in a given user profile.

list(resource_group_name: str, lab_name: str, user_name: str, expand: str | None = None, filter: str | None = None, top: int | None = None, orderby: str | None = None, **kwargs: Any) -> ItemPaged[DtlEnvironment]

Parameters

Name Description
resource_group_name
Required
str

The name of the resource group. Required.
lab_name
Required
str

The name of the lab. Required.
user_name
Required
str

The name of the user profile. Required.
expand
str

Specify the $expand query. Example: 'properties($select=deploymentProperties)'. Default value is None.

Default value: None
filter
str

The filter to apply to the operation. Example: '$filter=contains(name,'myName'). Default value is None.

Default value: None
top
int

The maximum number of resources to return from the operation. Example: '$top=10'. Default value is None.

Default value: None
orderby
str

The ordering expression for the results, using OData notation. Example: '$orderby=name desc'. Default value is None.

Default value: None

Returns

Type Description
ItemPaged[DtlEnvironment]

An iterator like instance of either DtlEnvironment or the result of cls(response)

Exceptions

Type Description
HttpResponseError

update

Allows modifying tags of environments. All other properties will be ignored.

update(resource_group_name: str, lab_name: str, user_name: str, name: str, tags: dict[str, str] | None = None, **kwargs: Any) -> DtlEnvironment

Parameters

Name Description
resource_group_name
Required
str

The name of the resource group. Required.
lab_name
Required
str

The name of the lab. Required.
user_name
Required
str

The name of the user profile. Required.
name
Required
str

The name of the environment. Required.
tags
dict[str, str]

The tags of the resource. Default value is None.

Default value: None

Returns

Type Description
DtlEnvironment

DtlEnvironment or the result of cls(response)

Exceptions

Type Description
HttpResponseError

Attributes

models 

models = <module 'azure.mgmt.devtestlabs.models' from 'C:\\ToolCache\\Python\\3.12.10\\x64\\Lib\\site-packages\\py2docfx\\venv\\venv125\\Lib\\site-packages\\azure\\mgmt\\devtestlabs\\models\\__init__.py'>