Package: azure-mgmt-imagebuilder
Microsoft Azure SDK for PythonThis is the Microsoft Azure Image Builder Client Library.
This package has been tested with Python 3.7+.
For a more complete view of Azure libraries, see theazure sdk python release.DisclaimerAzure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer tohttps://github.com/Azure/azure-sdk-for-python/issues/20691Getting startedPrerequisitesPython 3.7+ is required to use this package.Azure subscriptionInstall the packagepipinstallazure-mgmt-imagebuilder
pipinstallazure-identityAuthenticationBy default,Azure Active Directorytoken authentication depends on correct configure of following environment variables.AZURE_CLIENT_IDfor Azure client ID.AZURE_TENANT_IDfor Azure tenant ID.AZURE_CLIENT_SECRETfor Azure client secret.In addition, Azure subscription ID can be configured via environment variableAZURE_SUBSCRIPTION_ID.With above configuration, client can be authenticated by following code:fromazure.identityimportDefaultAzureCredentialfromazure.mgmt.imagebuilderimportImageBuilderClientimportossub_id=os.getenv("AZURE_SUBSCRIPTION_ID")client=ImageBuilderClient(credential=DefaultAzureCredential(),subscription_id=sub_id)ExamplesCode samples for this package can be found at:Search Image Builderon docs.microsoft.comAzure Python Mgmt SDK Samples RepoTroubleshootingNext stepsProvide FeedbackIf you encounter any bugs or have suggestions, please file an issue in theIssuessection of the project.Release History1.3.0 (2023-12-18)Features AddedModel ImageTemplate has a new parameter error_handlingModel ImageTemplateUpdateParameters has a new parameter properties1.2.0 (2023-04-20)Features AddedAdded operation group TriggersOperationsModel ImageTemplate has a new parameter optimizeModel ImageTemplateSharedImageDistributor has a new parameter target_regionsModel ImageTemplateSharedImageDistributor has a new parameter versioningModel ImageTemplateSharedImageVersionSource has a new parameter exact_versionModel ImageTemplateVhdDistributor has a new parameter uri1.2.0b1 (2022-11-28)Other ChangesAdded generated samples in github repoDrop support for python<3.7.01.1.0 (2022-06-07)FeaturesModel ImageTemplate has a new parameter exact_staging_resource_groupModel ImageTemplate has a new parameter staging_resource_groupModel ImageTemplate has a new parameter validateModel Resource has a new parameter system_dataModel RunOutput has a new parameter system_dataModel TrackedResource has a new parameter system_data1.0.0 (2021-12-07)FeaturesModel ImageTemplate has a new parameter system_dataModel VirtualNetworkConfig has a new parameter proxy_vm_sizeModel ImageTemplateVmProfile has a new parameter user_assigned_identitiesModel ImageTemplatePlatformImageSource has a new parameter exact_versionBreaking changesModel Resource no longer has parameter tagsModel Resource no longer has parameter location1.0.0b1 (2021-05-25)This is beta preview version.This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).General breaking changesCredential system has been completly revamped:azure.common.credentialsormsrestazure.azure_active_directoryinstances are no longer supported, use theazure-identityclasses instead:https://pypi.org/project/azure-identity/credentialsparameter has been renamedcredentialTheconfigattribute no longer exists on a client, configuration should be passed as kwarg. Example:MyClient(credential, subscription_id, enable_logging=True). For a complete set of
supported options, see theparameters accept in init documentation of azure-coreYou can't import aversionmodule anymore, use__version__insteadOperations that used to return amsrest.polling.LROPollernow returns aazure.core.polling.LROPollerand are prefixed withbegin_.Exceptions tree have been simplified and most exceptions are nowazure.core.exceptions.HttpResponseError(CloudErrorhas been removed).Most of the operation kwarg have changed. Some of the most noticeable:rawhas been removed. Equivalent feature can be found usingcls, a callback that will give access to internal HTTP response for advanced userFor a complete set of
supported options, see theparameters accept in Request documentation of azure-coreGeneral new featuresType annotations support usingtyping. SDKs are mypy ready.This client has now stable and official support for async. Check theaionamespace of your package to find the async client.This client now support natively tracing library like OpenCensus or OpenTelemetry. See thistracing quickstartfor an overview.0.4.0 (2020-05-07)FeaturesModel Operation has a new parameter is_data_actionModel ImageTemplateSharedImageDistributor has a new parameter exclude_from_latestModel ImageTemplateSharedImageDistributor has a new parameter storage_account_typeModel ImageTemplatePlatformImageSource has a new parameter plan_infoModel ImageTemplateVmProfile has a new parameter vnet_configModel ImageTemplateVmProfile has a new parameter os_disk_size_gbAdded operation VirtualMachineImageTemplatesOperations.cancelBreaking changesParameter identity of model ImageTemplate is now required0.3.0 (2019-11-19)FeaturesModel ImageTemplatePowerShellCustomizer has a new parameter
run_elevatedModel ImageTemplatePowerShellCustomizer has a new parameter
sha256_checksumModel ImageTemplate has a new parameter vm_profileModel ImageTemplateFileCustomizer has a new parameter
sha256_checksumModel ImageTemplateShellCustomizer has a new parameter
sha256_checksumGeneral breaking changesThis version uses a next-generation code generator thatmightintroduce breaking changes if from some import. In summary, some modules
were incorrectly visible/importable and have been renamed. This fixed
several issues caused by usage of classes that were not supposed to be
used in the first place.ImageBuilderClient cannot be imported fromazure.mgmt.imagebuilder.image_builder_clientanymore (import
fromazure.mgmt.imagebuilderworks like before)ImageBuilderClientConfiguration import has been moved fromazure.mgmt.imagebuilder.image_builder_clienttoazure.mgmt.imagebuilderA modelMyClassfrom a "models" sub-module cannot be imported
anymore usingazure.mgmt.imagebuilder.models.my_class(import
fromazure.mgmt.imagebuilder.modelsworks like before)An operation classMyClassOperationsfrom anoperationssub-module cannot be imported anymore usingazure.mgmt.imagebuilder.operations.my_class_operations(import
fromazure.mgmt.imagebuilder.operationsworks like before)Last but not least, HTTP connection pooling is now enabled by default.
You should always use a client as a context manager, or call close(), or
use no more than one client per process.0.2.1 (2019-04-25)BugfixesAdd missing build_timeout_in_minutesFix some regexp checking0.2.0 (2019-04-12)New API version 2019-05-01-preview0.1.0 (2019-04-09)Initial Release