CustomImagesOperations Class

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through

DevTestLabsClient's

<xref:custom_images> attribute.

Constructor

CustomImagesOperations(*args, **kwargs)

Methods

begin_create_or_update

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

Delete custom image. This operation can take a while to complete.
get

Get custom image.
list

List custom images in a given lab.
update

Allows modifying tags of custom images. All other properties will be ignored.

begin_create_or_update

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

async begin_create_or_update(resource_group_name: str, lab_name: str, name: str, custom_image: _models.CustomImage, *, content_type: str = 'application/json', **kwargs: Any) -> AsyncLROPoller[_models.CustomImage]

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.
name
Required
str

The name of the custom image. Required.
custom_image
Required
CustomImage or IO[bytes]

A custom image. Is either a CustomImage type or a IO[bytes] type. Required.

Returns

Type Description
AsyncLROPoller[CustomImage]

An instance of AsyncLROPoller that returns either CustomImage or the result of cls(response)

Exceptions

Type Description
HttpResponseError

begin_delete

Delete custom image. This operation can take a while to complete.

async begin_delete(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> AsyncLROPoller[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.
name
Required
str

The name of the custom image. Required.

Returns

Type Description
AsyncLROPoller[None]

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

Exceptions

Type Description
HttpResponseError

get

Get custom image.

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

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.
name
Required
str

The name of the custom image. Required.
expand
str

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

Default value: None

Returns

Type Description
CustomImage

CustomImage or the result of cls(response)

Exceptions

Type Description
HttpResponseError

list

List custom images in a given lab.

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

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.
expand
str

Specify the $expand query. Example: 'properties($select=vm)'. 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
AsyncItemPaged[CustomImage]

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

Exceptions

Type Description
HttpResponseError

update

Allows modifying tags of custom images. All other properties will be ignored.

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

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.
name
Required
str

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

The tags of the resource. Default value is None.

Default value: None

Returns

Type Description
CustomImage

CustomImage 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'>