azure.mgmt.resource.resources.v2019_07_01.operations module

Raises:

get_at_management_group_scope(group_id: str, deployment_name: str, operation_id: str, **kwargs: Any) → DeploymentOperation[source]

Gets a deployments operation.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.
operation_id (str) – The ID of the operation to get. Required.

Returns:

DeploymentOperation or the result of cls(response)

Return type:

Raises:

get_at_scope(scope: str, deployment_name: str, operation_id: str, **kwargs: Any) → DeploymentOperation[source]

Gets a deployments operation.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.
operation_id (str) – The ID of the operation to get. Required.

Returns:

DeploymentOperation or the result of cls(response)

Return type:

Raises:

get_at_subscription_scope(deployment_name: str, operation_id: str, **kwargs: Any) → DeploymentOperation[source]

Gets a deployments operation.

Parameters:

deployment_name (str) – The name of the deployment. Required.
operation_id (str) – The ID of the operation to get. Required.

Returns:

DeploymentOperation or the result of cls(response)

Return type:

Raises:

get_at_tenant_scope(deployment_name: str, operation_id: str, **kwargs: Any) → DeploymentOperation[source]

Gets a deployments operation.

Parameters:

deployment_name (str) – The name of the deployment. Required.
operation_id (str) – The ID of the operation to get. Required.

Returns:

DeploymentOperation or the result of cls(response)

Return type:

Raises:

list(resource_group_name: str, deployment_name: str, top: int | None = None, **kwargs: Any) → Iterable[DeploymentOperation][source]

Gets all deployments operations for a deployment.

Parameters:

resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.
top (int) – The number of results to return. Default value is None.

Returns:

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

Return type:

Raises:

list_at_management_group_scope(group_id: str, deployment_name: str, top: int | None = None, **kwargs: Any) → Iterable[DeploymentOperation][source]

Gets all deployments operations for a deployment.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.
top (int) – The number of results to return. Default value is None.

Returns:

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

Return type:

Raises:

list_at_scope(scope: str, deployment_name: str, top: int | None = None, **kwargs: Any) → Iterable[DeploymentOperation][source]

Gets all deployments operations for a deployment.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.
top (int) – The number of results to return. Default value is None.

Returns:

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

Return type:

Raises:

list_at_subscription_scope(deployment_name: str, top: int | None = None, **kwargs: Any) → Iterable[DeploymentOperation][source]

Gets all deployments operations for a deployment.

Parameters:

deployment_name (str) – The name of the deployment. Required.
top (int) – The number of results to return. Default value is None.

Returns:

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

Return type:

Raises:

list_at_tenant_scope(deployment_name: str, top: int | None = None, **kwargs: Any) → Iterable[DeploymentOperation][source]

Gets all deployments operations for a deployment.

Parameters:

deployment_name (str) – The name of the deployment. Required.
top (int) – The number of results to return. Default value is None.

Returns:

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

Return type:

Raises:

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.DeploymentsOperations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s deployments attribute.

begin_create_or_update(resource_group_name: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended][source]

begin_create_or_update(resource_group_name: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended]

Deploys resources to a resource group.

You can provide the template and parameters directly in the request or link to JSON files.

Parameters:

resource_group_name (str) – The name of the resource group to deploy the resources to. The name is case insensitive. The resource group must already exist. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Additional parameters supplied to the operation. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_create_or_update_at_management_group_scope(group_id: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended][source]

begin_create_or_update_at_management_group_scope(group_id: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended]

Deploys resources at management group scope.

You can provide the template and parameters directly in the request or link to JSON files.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Additional parameters supplied to the operation. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_create_or_update_at_scope(scope: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended][source]

begin_create_or_update_at_scope(scope: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended]

Deploys resources at a given scope.

You can provide the template and parameters directly in the request or link to JSON files.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Additional parameters supplied to the operation. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_create_or_update_at_subscription_scope(deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended][source]

begin_create_or_update_at_subscription_scope(deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended]

Deploys resources at subscription scope.

You can provide the template and parameters directly in the request or link to JSON files.

Parameters:

deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Additional parameters supplied to the operation. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_create_or_update_at_tenant_scope(deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended][source]

begin_create_or_update_at_tenant_scope(deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.DeploymentExtended]

Deploys resources at tenant scope.

You can provide the template and parameters directly in the request or link to JSON files.

Parameters:

deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Additional parameters supplied to the operation. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_delete(resource_group_name: str, deployment_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a deployment from the deployment history.

A template deployment that is currently running cannot be deleted. Deleting a template deployment removes the associated deployment operations. Deleting a template deployment does not affect the state of the resource group. This is an asynchronous operation that returns a status of 202 until the template deployment is successfully deleted. The Location response header contains the URI that is used to obtain the status of the process. While the process is running, a call to the URI in the Location header returns a status of 202. When the process finishes, the URI in the Location header returns a status of 204 on success. If the asynchronous request failed, the URI in the Location header returns an error-level status code.

Parameters:

resource_group_name (str) – The name of the resource group with the deployment to delete. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

begin_delete_at_management_group_scope(group_id: str, deployment_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a deployment from the deployment history.

A template deployment that is currently running cannot be deleted. Deleting a template deployment removes the associated deployment operations. This is an asynchronous operation that returns a status of 202 until the template deployment is successfully deleted. The Location response header contains the URI that is used to obtain the status of the process. While the process is running, a call to the URI in the Location header returns a status of 202. When the process finishes, the URI in the Location header returns a status of 204 on success. If the asynchronous request failed, the URI in the Location header returns an error-level status code.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

begin_delete_at_scope(scope: str, deployment_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a deployment from the deployment history.

A template deployment that is currently running cannot be deleted. Deleting a template deployment removes the associated deployment operations. This is an asynchronous operation that returns a status of 202 until the template deployment is successfully deleted. The Location response header contains the URI that is used to obtain the status of the process. While the process is running, a call to the URI in the Location header returns a status of 202. When the process finishes, the URI in the Location header returns a status of 204 on success. If the asynchronous request failed, the URI in the Location header returns an error-level status code.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

LROPoller[WhatIfOperationResult]

begin_delete_at_subscription_scope(deployment_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a deployment from the deployment history.

A template deployment that is currently running cannot be deleted. Deleting a template deployment removes the associated deployment operations. This is an asynchronous operation that returns a status of 202 until the template deployment is successfully deleted. The Location response header contains the URI that is used to obtain the status of the process. While the process is running, a call to the URI in the Location header returns a status of 202. When the process finishes, the URI in the Location header returns a status of 204 on success. If the asynchronous request failed, the URI in the Location header returns an error-level status code.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: An instance of LROPoller that returns either None or the result of cls(response)
Return type:: LROPoller[None]
Raises:: HttpResponseError –

begin_delete_at_tenant_scope(deployment_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a deployment from the deployment history.

A template deployment that is currently running cannot be deleted. Deleting a template deployment removes the associated deployment operations. This is an asynchronous operation that returns a status of 202 until the template deployment is successfully deleted. The Location response header contains the URI that is used to obtain the status of the process. While the process is running, a call to the URI in the Location header returns a status of 202. When the process finishes, the URI in the Location header returns a status of 204 on success. If the asynchronous request failed, the URI in the Location header returns an error-level status code.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: An instance of LROPoller that returns either None or the result of cls(response)
Return type:: LROPoller[None]
Raises:: HttpResponseError –

begin_what_if(resource_group_name: str, deployment_name: str, parameters: _models.DeploymentWhatIf, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.WhatIfOperationResult][source]

begin_what_if(resource_group_name: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.WhatIfOperationResult]

Returns changes that will be made by the deployment if executed at the scope of the resource group.

Parameters:

resource_group_name (str) – The name of the resource group the template will be deployed to. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (DeploymentWhatIf or IO[bytes]) – Parameters to validate. Is either a DeploymentWhatIf type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

LROPoller[WhatIfOperationResult]

begin_what_if_at_subscription_scope(deployment_name: str, parameters: _models.DeploymentWhatIf, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.WhatIfOperationResult][source]

begin_what_if_at_subscription_scope(deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.WhatIfOperationResult]

Returns changes that will be made by the deployment if executed at the scope of the subscription.

Parameters:

deployment_name (str) – The name of the deployment. Required.
parameters (DeploymentWhatIf or IO[bytes]) – Parameters to What If. Is either a DeploymentWhatIf type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

calculate_template_hash(template: MutableMapping[str, Any], **kwargs: Any) → TemplateHashResult[source]

Calculate the hash of the given template.

Parameters:: template (JSON) – The template provided to calculate hash. Required.
Returns:: TemplateHashResult or the result of cls(response)
Return type:: TemplateHashResult
Raises:: HttpResponseError –

cancel(resource_group_name: str, deployment_name: str, **kwargs: Any) → None[source]

Cancels a currently running template deployment.

You can cancel a deployment only if the provisioningState is Accepted or Running. After the deployment is canceled, the provisioningState is set to Canceled. Canceling a template deployment stops the currently running template deployment and leaves the resource group partially deployed.

Parameters:

resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

None or the result of cls(response)

Return type:

None

Raises:

cancel_at_management_group_scope(group_id: str, deployment_name: str, **kwargs: Any) → None[source]

Cancels a currently running template deployment.

You can cancel a deployment only if the provisioningState is Accepted or Running. After the deployment is canceled, the provisioningState is set to Canceled. Canceling a template deployment stops the currently running template deployment and leaves the resources partially deployed.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

None or the result of cls(response)

Return type:

None

Raises:

cancel_at_scope(scope: str, deployment_name: str, **kwargs: Any) → None[source]

Cancels a currently running template deployment.

You can cancel a deployment only if the provisioningState is Accepted or Running. After the deployment is canceled, the provisioningState is set to Canceled. Canceling a template deployment stops the currently running template deployment and leaves the resources partially deployed.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

None or the result of cls(response)

Return type:

None

Raises:

cancel_at_subscription_scope(deployment_name: str, **kwargs: Any) → None[source]

Cancels a currently running template deployment.

You can cancel a deployment only if the provisioningState is Accepted or Running. After the deployment is canceled, the provisioningState is set to Canceled. Canceling a template deployment stops the currently running template deployment and leaves the resources partially deployed.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: None or the result of cls(response)
Return type:: None
Raises:: HttpResponseError –

cancel_at_tenant_scope(deployment_name: str, **kwargs: Any) → None[source]

Cancels a currently running template deployment.

You can cancel a deployment only if the provisioningState is Accepted or Running. After the deployment is canceled, the provisioningState is set to Canceled. Canceling a template deployment stops the currently running template deployment and leaves the resources partially deployed.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: None or the result of cls(response)
Return type:: None
Raises:: HttpResponseError –

check_existence(resource_group_name: str, deployment_name: str, **kwargs: Any) → bool[source]

Checks whether the deployment exists.

Parameters:

resource_group_name (str) – The name of the resource group with the deployment to check. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

bool or the result of cls(response)

Return type:

Raises:

check_existence_at_management_group_scope(group_id: str, deployment_name: str, **kwargs: Any) → bool[source]

Checks whether the deployment exists.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

bool or the result of cls(response)

Return type:

Raises:

check_existence_at_scope(scope: str, deployment_name: str, **kwargs: Any) → bool[source]

Checks whether the deployment exists.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

bool or the result of cls(response)

Return type:

Raises:

check_existence_at_subscription_scope(deployment_name: str, **kwargs: Any) → bool[source]

Checks whether the deployment exists.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: bool or the result of cls(response)
Return type:: bool
Raises:: HttpResponseError –

check_existence_at_tenant_scope(deployment_name: str, **kwargs: Any) → bool[source]

Checks whether the deployment exists.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: bool or the result of cls(response)
Return type:: bool
Raises:: HttpResponseError –

export_template(resource_group_name: str, deployment_name: str, **kwargs: Any) → DeploymentExportResult[source]

Exports the template used for specified deployment.

Parameters:

resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExportResult or the result of cls(response)

Return type:

DeploymentExportResult

Raises:

export_template_at_management_group_scope(group_id: str, deployment_name: str, **kwargs: Any) → DeploymentExportResult[source]

Exports the template used for specified deployment.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExportResult or the result of cls(response)

Return type:

DeploymentExportResult

Raises:

export_template_at_scope(scope: str, deployment_name: str, **kwargs: Any) → DeploymentExportResult[source]

Exports the template used for specified deployment.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExportResult or the result of cls(response)

Return type:

DeploymentExportResult

Raises:

export_template_at_subscription_scope(deployment_name: str, **kwargs: Any) → DeploymentExportResult[source]

Exports the template used for specified deployment.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: DeploymentExportResult or the result of cls(response)
Return type:: DeploymentExportResult
Raises:: HttpResponseError –

export_template_at_tenant_scope(deployment_name: str, **kwargs: Any) → DeploymentExportResult[source]

Exports the template used for specified deployment.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: DeploymentExportResult or the result of cls(response)
Return type:: DeploymentExportResult
Raises:: HttpResponseError –

get(resource_group_name: str, deployment_name: str, **kwargs: Any) → DeploymentExtended[source]

Gets a deployment.

Parameters:

resource_group_name (str) – The name of the resource group. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExtended or the result of cls(response)

Return type:

DeploymentExtended

Raises:

get_at_management_group_scope(group_id: str, deployment_name: str, **kwargs: Any) → DeploymentExtended[source]

Gets a deployment.

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExtended or the result of cls(response)

Return type:

DeploymentExtended

Raises:

get_at_scope(scope: str, deployment_name: str, **kwargs: Any) → DeploymentExtended[source]

Gets a deployment.

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.

Returns:

DeploymentExtended or the result of cls(response)

Return type:

DeploymentExtended

Raises:

get_at_subscription_scope(deployment_name: str, **kwargs: Any) → DeploymentExtended[source]

Gets a deployment.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: DeploymentExtended or the result of cls(response)
Return type:: DeploymentExtended
Raises:: HttpResponseError –

get_at_tenant_scope(deployment_name: str, **kwargs: Any) → DeploymentExtended[source]

Gets a deployment.

Parameters:: deployment_name (str) – The name of the deployment. Required.
Returns:: DeploymentExtended or the result of cls(response)
Return type:: DeploymentExtended
Raises:: HttpResponseError –

list_at_management_group_scope(group_id: str, filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[DeploymentExtended][source]

Get all the deployments for a management group.

Parameters:

group_id (str) – The management group ID. Required.
filter (str) – The filter to apply on the operation. For example, you can use $filter=provisioningState eq ‘{state}’. Default value is None.
top (int) – The number of results to get. If null is passed, returns all deployments. Default value is None.

Returns:

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

Return type:

Raises:

list_at_scope(scope: str, filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[DeploymentExtended][source]

Get all the deployments at the given scope.

Parameters:

scope (str) – The scope of a deployment. Required.
filter (str) – The filter to apply on the operation. For example, you can use $filter=provisioningState eq ‘{state}’. Default value is None.
top (int) – The number of results to get. If null is passed, returns all deployments. Default value is None.

Returns:

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

Return type:

Raises:

list_at_subscription_scope(filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[DeploymentExtended][source]

Get all the deployments for a subscription.

Parameters:

filter (str) – The filter to apply on the operation. For example, you can use $filter=provisioningState eq ‘{state}’. Default value is None.
top (int) – The number of results to get. If null is passed, returns all deployments. Default value is None.

Returns:

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

Return type:

Raises:

list_at_tenant_scope(filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[DeploymentExtended][source]

Get all the deployments at the tenant scope.

Parameters:

filter (str) – The filter to apply on the operation. For example, you can use $filter=provisioningState eq ‘{state}’. Default value is None.
top (int) – The number of results to get. If null is passed, returns all deployments. Default value is None.

Returns:

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

Return type:

Raises:

list_by_resource_group(resource_group_name: str, filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[DeploymentExtended][source]

Get all the deployments for a resource group.

Parameters:

resource_group_name (str) – The name of the resource group with the deployments to get. The name is case insensitive. Required.
filter (str) – The filter to apply on the operation. For example, you can use $filter=provisioningState eq ‘{state}’. Default value is None.
top (int) – The number of results to get. If null is passed, returns all deployments. Default value is None.

Returns:

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

Return type:

Raises:

validate(resource_group_name: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult[source]

validate(resource_group_name: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult

Validates whether the specified template is syntactically correct and will be accepted by Azure Resource Manager..

Parameters:

resource_group_name (str) – The name of the resource group the template will be deployed to. The name is case insensitive. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Parameters to validate. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

DeploymentValidateResult or the result of cls(response)

Return type:

Raises:

validate_at_management_group_scope(group_id: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult[source]

validate_at_management_group_scope(group_id: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult

Validates whether the specified template is syntactically correct and will be accepted by Azure Resource Manager..

Parameters:

group_id (str) – The management group ID. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Parameters to validate. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

DeploymentValidateResult or the result of cls(response)

Return type:

Raises:

validate_at_scope(scope: str, deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult[source]

validate_at_scope(scope: str, deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult

Validates whether the specified template is syntactically correct and will be accepted by Azure Resource Manager..

Parameters:

scope (str) – The scope of a deployment. Required.
deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Parameters to validate. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

DeploymentValidateResult or the result of cls(response)

Return type:

Raises:

validate_at_subscription_scope(deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult[source]

validate_at_subscription_scope(deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult

Validates whether the specified template is syntactically correct and will be accepted by Azure Resource Manager..

Parameters:

deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Parameters to validate. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

DeploymentValidateResult or the result of cls(response)

Return type:

Raises:

validate_at_tenant_scope(deployment_name: str, parameters: _models.Deployment, *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult[source]

validate_at_tenant_scope(deployment_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.DeploymentValidateResult

Validates whether the specified template is syntactically correct and will be accepted by Azure Resource Manager..

Parameters:

deployment_name (str) – The name of the deployment. Required.
parameters (Deployment or IO[bytes]) – Parameters to validate. Is either a Deployment type or a IO[bytes] type. Required.

Returns:

DeploymentValidateResult or the result of cls(response)

Return type:

Raises:

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.Operations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s operations attribute.

list(**kwargs: Any) → Iterable[Operation][source]

Lists all of the available Microsoft.Resources REST API operations.

Returns:: An iterator like instance of either Operation or the result of cls(response)
Return type:: ItemPaged[Operation]
Raises:: HttpResponseError –

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.ProvidersOperations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s providers attribute.

get(resource_provider_namespace: str, expand: str | None = None, **kwargs: Any) → Provider[source]

Gets the specified resource provider.

Parameters:

resource_provider_namespace (str) – The namespace of the resource provider. Required.
expand (str) – The $expand query parameter. For example, to include property aliases in response, use $expand=resourceTypes/aliases. Default value is None.

Returns:

Provider or the result of cls(response)

Return type:

Provider

Raises:

get_at_tenant_scope(resource_provider_namespace: str, expand: str | None = None, **kwargs: Any) → Provider[source]

Gets the specified resource provider at the tenant level.

Parameters:

resource_provider_namespace (str) – The namespace of the resource provider. Required.
expand (str) – The $expand query parameter. For example, to include property aliases in response, use $expand=resourceTypes/aliases. Default value is None.

Returns:

Provider or the result of cls(response)

Return type:

Provider

Raises:

list(top: int | None = None, expand: str | None = None, **kwargs: Any) → Iterable[Provider][source]

Gets all resource providers for a subscription.

Parameters:

top (int) – The number of results to return. If null is passed returns all deployments. Default value is None.
expand (str) – The properties to include in the results. For example, use &$expand=metadata in the query string to retrieve resource provider metadata. To include property aliases in response, use $expand=resourceTypes/aliases. Default value is None.

Returns:

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

Return type:

ItemPaged[Provider]

Raises:

list_at_tenant_scope(top: int | None = None, expand: str | None = None, **kwargs: Any) → Iterable[Provider][source]

Gets all resource providers for the tenant.

Parameters:

top (int) – The number of results to return. If null is passed returns all providers. Default value is None.
expand (str) – The properties to include in the results. For example, use &$expand=metadata in the query string to retrieve resource provider metadata. To include property aliases in response, use $expand=resourceTypes/aliases. Default value is None.

Returns:

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

Return type:

ItemPaged[Provider]

Raises:

register(resource_provider_namespace: str, **kwargs: Any) → Provider[source]

Registers a subscription with a resource provider.

Parameters:: resource_provider_namespace (str) – The namespace of the resource provider to register. Required.
Returns:: Provider or the result of cls(response)
Return type:: Provider
Raises:: HttpResponseError –

unregister(resource_provider_namespace: str, **kwargs: Any) → Provider[source]

Unregisters a subscription from a resource provider.

Parameters:: resource_provider_namespace (str) – The namespace of the resource provider to unregister. Required.
Returns:: Provider or the result of cls(response)
Return type:: Provider
Raises:: HttpResponseError –

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.ResourceGroupsOperations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s resource_groups attribute.

begin_delete(resource_group_name: str, **kwargs: Any) → LROPoller[None][source]

Deletes a resource group.

When you delete a resource group, all of its resources are also deleted. Deleting a resource group deletes all of its template deployments and currently stored operations.

Parameters:: resource_group_name (str) – The name of the resource group to delete. The name is case insensitive. Required.
Returns:: An instance of LROPoller that returns either None or the result of cls(response)
Return type:: LROPoller[None]
Raises:: HttpResponseError –

check_existence(resource_group_name: str, **kwargs: Any) → bool[source]

Checks whether a resource group exists.

Parameters:: resource_group_name (str) – The name of the resource group to check. The name is case insensitive. Required.
Returns:: bool or the result of cls(response)
Return type:: bool
Raises:: HttpResponseError –

create_or_update(resource_group_name: str, parameters: _models.ResourceGroup, *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroup[source]

create_or_update(resource_group_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroup

Creates or updates a resource group.

Parameters:

resource_group_name (str) – The name of the resource group to create or update. Can include alphanumeric, underscore, parentheses, hyphen, period (except at end), and Unicode characters that match the allowed characters. Required.
parameters (ResourceGroup or IO[bytes]) – Parameters supplied to the create or update a resource group. Is either a ResourceGroup type or a IO[bytes] type. Required.

Returns:

ResourceGroup or the result of cls(response)

Return type:

ResourceGroup

Raises:

ResourceGroupExportResult

export_template(resource_group_name: str, parameters: _models.ExportTemplateRequest, *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroupExportResult[source]

export_template(resource_group_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroupExportResult

Captures the specified resource group as a template.

Parameters:

resource_group_name (str) – The name of the resource group to export as a template. Required.
parameters (ExportTemplateRequest or IO[bytes]) – Parameters for exporting the template. Is either a ExportTemplateRequest type or a IO[bytes] type. Required.

Returns:

ResourceGroupExportResult or the result of cls(response)

Return type:

Raises:

ItemPaged[ResourceGroup]

get(resource_group_name: str, **kwargs: Any) → ResourceGroup[source]

Gets a resource group.

Parameters:: resource_group_name (str) – The name of the resource group to get. The name is case insensitive. Required.
Returns:: ResourceGroup or the result of cls(response)
Return type:: ResourceGroup
Raises:: HttpResponseError –

list(filter: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[ResourceGroup][source]

Gets all the resource groups for a subscription.

Parameters:

filter (str) – The filter to apply on the operation. :code:` `You can filter by tag names and values. For example, to filter for a tag name and value, use $filter=tagName eq ‘tag1’ and tagValue eq ‘Value1’. Default value is None.
top (int) – The number of results to return. If null is passed, returns all resource groups. Default value is None.

Returns:

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

Return type:

Raises:

update(resource_group_name: str, parameters: _models.ResourceGroupPatchable, *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroup[source]

update(resource_group_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → _models.ResourceGroup

Updates a resource group.

Resource groups can be updated through a simple PATCH operation to a group address. The format of the request is the same as that for creating a resource group. If a field is unspecified, the current value is retained.

Parameters:

resource_group_name (str) – The name of the resource group to update. The name is case insensitive. Required.
parameters (ResourceGroupPatchable or IO[bytes]) – Parameters supplied to update a resource group. Is either a ResourceGroupPatchable type or a IO[bytes] type. Required.

Returns:

ResourceGroup or the result of cls(response)

Return type:

ResourceGroup

Raises:

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.ResourcesOperations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s resources attribute.

begin_create_or_update(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, parameters: _models.GenericResource, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource][source]

begin_create_or_update(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource]

Creates a resource.

Parameters:

resource_group_name (str) – The name of the resource group for the resource. The name is case insensitive. Required.
resource_provider_namespace (str) – The namespace of the resource provider. Required.
parent_resource_path (str) – The parent resource identity. Required.
resource_type (str) – The resource type of the resource to create. Required.
resource_name (str) – The name of the resource to create. Required.
api_version (str) – The API version to use for the operation. Required.
parameters (GenericResource or IO[bytes]) – Parameters for creating or updating the resource. Is either a GenericResource type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_create_or_update_by_id(resource_id: str, api_version: str, parameters: _models.GenericResource, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource][source]

begin_create_or_update_by_id(resource_id: str, api_version: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource]

Create a resource by ID.

Parameters:

resource_id (str) – The fully qualified ID of the resource, including the resource name and resource type. Use the format, /subscriptions/{guid}/resourceGroups/{resource-group-name}/{resource-provider-namespace}/{resource-type}/{resource-name}. Required.
api_version (str) – The API version to use for the operation. Required.
parameters (GenericResource or IO[bytes]) – Create or update resource parameters. Is either a GenericResource type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_delete(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, **kwargs: Any) → LROPoller[None][source]

Deletes a resource.

Parameters:

resource_group_name (str) – The name of the resource group that contains the resource to delete. The name is case insensitive. Required.
resource_provider_namespace (str) – The namespace of the resource provider. Required.
parent_resource_path (str) – The parent resource identity. Required.
resource_type (str) – The resource type. Required.
resource_name (str) – The name of the resource to delete. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

begin_delete_by_id(resource_id: str, api_version: str, **kwargs: Any) → LROPoller[None][source]

Deletes a resource by ID.

Parameters:

resource_id (str) – The fully qualified ID of the resource, including the resource name and resource type. Use the format, /subscriptions/{guid}/resourceGroups/{resource-group-name}/{resource-provider-namespace}/{resource-type}/{resource-name}. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

begin_move_resources(source_resource_group_name: str, parameters: _models.ResourcesMoveInfo, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[None][source]

begin_move_resources(source_resource_group_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[None]

Moves resources from one resource group to another resource group.

The resources to move must be in the same source resource group. The target resource group may be in a different subscription. When moving resources, both the source group and the target group are locked for the duration of the operation. Write and delete operations are blocked on the groups until the move completes.

Parameters:

source_resource_group_name (str) – The name of the resource group containing the resources to move. Required.
parameters (ResourcesMoveInfo or IO[bytes]) – Parameters for moving resources. Is either a ResourcesMoveInfo type or a IO[bytes] type. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

begin_update(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, parameters: _models.GenericResource, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource][source]

begin_update(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource]

Updates a resource.

Parameters:

resource_group_name (str) – The name of the resource group for the resource. The name is case insensitive. Required.
resource_provider_namespace (str) – The namespace of the resource provider. Required.
parent_resource_path (str) – The parent resource identity. Required.
resource_type (str) – The resource type of the resource to update. Required.
resource_name (str) – The name of the resource to update. Required.
api_version (str) – The API version to use for the operation. Required.
parameters (GenericResource or IO[bytes]) – Parameters for updating the resource. Is either a GenericResource type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_update_by_id(resource_id: str, api_version: str, parameters: _models.GenericResource, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource][source]

begin_update_by_id(resource_id: str, api_version: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[_models.GenericResource]

Updates a resource by ID.

Parameters:

resource_id (str) – The fully qualified ID of the resource, including the resource name and resource type. Use the format, /subscriptions/{guid}/resourceGroups/{resource-group-name}/{resource-provider-namespace}/{resource-type}/{resource-name}. Required.
api_version (str) – The API version to use for the operation. Required.
parameters (GenericResource or IO[bytes]) – Update resource parameters. Is either a GenericResource type or a IO[bytes] type. Required.

Returns:

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

Return type:

Raises:

begin_validate_move_resources(source_resource_group_name: str, parameters: _models.ResourcesMoveInfo, *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[None][source]

begin_validate_move_resources(source_resource_group_name: str, parameters: IO[bytes], *, content_type: str = 'application/json', **kwargs: Any) → LROPoller[None]

Validates whether resources can be moved from one resource group to another resource group.

This operation checks whether the specified resources can be moved to the target. The resources to move must be in the same source resource group. The target resource group may be in a different subscription. If validation succeeds, it returns HTTP response code 204 (no content). If validation fails, it returns HTTP response code 409 (Conflict) with an error message. Retrieve the URL in the Location header value to check the result of the long-running operation.

Parameters:

source_resource_group_name (str) – The name of the resource group containing the resources to validate for move. Required.
parameters (ResourcesMoveInfo or IO[bytes]) – Parameters for moving resources. Is either a ResourcesMoveInfo type or a IO[bytes] type. Required.

Returns:

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

Return type:

LROPoller[None]

Raises:

check_existence(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, **kwargs: Any) → bool[source]

Checks whether a resource exists.

Parameters:

resource_group_name (str) – The name of the resource group containing the resource to check. The name is case insensitive. Required.
resource_provider_namespace (str) – The resource provider of the resource to check. Required.
parent_resource_path (str) – The parent resource identity. Required.
resource_type (str) – The resource type. Required.
resource_name (str) – The name of the resource to check whether it exists. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

bool or the result of cls(response)

Return type:

Raises:

check_existence_by_id(resource_id: str, api_version: str, **kwargs: Any) → bool[source]

Checks by ID whether a resource exists.

Parameters:

resource_id (str) – The fully qualified ID of the resource, including the resource name and resource type. Use the format, /subscriptions/{guid}/resourceGroups/{resource-group-name}/{resource-provider-namespace}/{resource-type}/{resource-name}. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

bool or the result of cls(response)

Return type:

Raises:

get(resource_group_name: str, resource_provider_namespace: str, parent_resource_path: str, resource_type: str, resource_name: str, api_version: str, **kwargs: Any) → GenericResource[source]

Gets a resource.

Parameters:

resource_group_name (str) – The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace (str) – The namespace of the resource provider. Required.
parent_resource_path (str) – The parent resource identity. Required.
resource_type (str) – The resource type of the resource. Required.
resource_name (str) – The name of the resource to get. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

GenericResource or the result of cls(response)

Return type:

GenericResource

Raises:

get_by_id(resource_id: str, api_version: str, **kwargs: Any) → GenericResource[source]

Gets a resource by ID.

Parameters:

resource_id (str) – The fully qualified ID of the resource, including the resource name and resource type. Use the format, /subscriptions/{guid}/resourceGroups/{resource-group-name}/{resource-provider-namespace}/{resource-type}/{resource-name}. Required.
api_version (str) – The API version to use for the operation. Required.

Returns:

GenericResource or the result of cls(response)

Return type:

GenericResource

Raises:

ItemPaged[GenericResourceExpanded]

list(filter: str | None = None, expand: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[GenericResourceExpanded][source]

Get all the resources in a subscription.

Parameters:

filter (str) – The filter to apply on the operation.  `The properties you can use for eq (equals) or ne (not equals) are: location, resourceType, name, resourceGroup, identity, identity/principalId, plan, plan/publisher, plan/product, plan/name, plan/version, and plan/promotionCode.:code:` `For example, to filter by a resource type, use: $filter=resourceType eq 'Microsoft.Network/virtualNetworks':code:` `You can use substringof(value, property) in the filter. The properties you can use for substring are: name and resourceGroup.:code:` `For example, to get all resources with 'demo' anywhere in the name, use: $filter=substringof('demo', name):code:` `You can link more than one substringof together by adding and/or operators.:code:` `You can filter by tag names and values. For example, to filter for a tag name and value, use $filter=tagName eq 'tag1' and tagValue eq 'Value1':code:` :code:` `You can use some properties together when filtering. The combinations you can use are: substringof and/or resourceType, plan and plan/publisher and plan/name, identity and identity/principalId. Default value is None.
expand (str) – Comma-separated list of additional properties to be included in the response. Valid values include createdTime, changedTime and provisioningState. For example, $expand=createdTime,changedTime. Default value is None.
top (int) – The number of results to return. If null is passed, returns all resources. Default value is None.

Returns:

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

Return type:

Raises:

ItemPaged[GenericResourceExpanded]

list_by_resource_group(resource_group_name: str, filter: str | None = None, expand: str | None = None, top: int | None = None, **kwargs: Any) → Iterable[GenericResourceExpanded][source]

Get all the resources for a resource group.

Parameters:

resource_group_name (str) – The resource group with the resources to get. Required.
filter (str) – The filter to apply on the operation.  `The properties you can use for eq (equals) or ne (not equals) are: location, resourceType, name, resourceGroup, identity, identity/principalId, plan, plan/publisher, plan/product, plan/name, plan/version, and plan/promotionCode.:code:` `For example, to filter by a resource type, use: $filter=resourceType eq 'Microsoft.Network/virtualNetworks':code:` `You can use substringof(value, property) in the filter. The properties you can use for substring are: name and resourceGroup.:code:` `For example, to get all resources with 'demo' anywhere in the name, use: $filter=substringof('demo', name):code:` `You can link more than one substringof together by adding and/or operators.:code:` `You can filter by tag names and values. For example, to filter for a tag name and value, use $filter=tagName eq 'tag1' and tagValue eq 'Value1':code:` :code:` `You can use some properties together when filtering. The combinations you can use are: substringof and/or resourceType, plan and plan/publisher and plan/name, identity and identity/principalId. Default value is None.
expand (str) – Comma-separated list of additional properties to be included in the response. Valid values include createdTime, changedTime and provisioningState. For example, $expand=createdTime,changedTime. Default value is None.
top (int) – The number of results to return. If null is passed, returns all resources. Default value is None.

Returns:

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

Return type:

Raises:

models = <module 'azure.mgmt.resource.resources.v2019_07_01.models' from '/mnt/vss/_work/1/s/sdk/resources/azure-mgmt-resource/.tox/sphinx/lib/python3.11/site-packages/azure/mgmt/resource/resources/v2019_07_01/models/__init__.py'>

class azure.mgmt.resource.resources.v2019_07_01.operations.TagsOperations(*args, **kwargs)[source]

Bases: object

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through ResourceManagementClient’s tags attribute.

create_or_update(tag_name: str, **kwargs: Any) → TagDetails[source]

Creates a tag in the subscription.

The tag name can have a maximum of 512 characters and is case insensitive. Tag names created by Azure have prefixes of microsoft, azure, or windows. You cannot create tags with one of these prefixes.

Parameters:: tag_name (str) – The name of the tag to create. Required.
Returns:: TagDetails or the result of cls(response)
Return type:: TagDetails
Raises:: HttpResponseError –

create_or_update_value(tag_name: str, tag_value: str, **kwargs: Any) → TagValue[source]

Creates a tag value. The name of the tag must already exist.

Parameters:

tag_name (str) – The name of the tag. Required.
tag_value (str) – The value of the tag to create. Required.

Returns:

TagValue or the result of cls(response)

Return type:

TagValue

Raises:

delete(tag_name: str, **kwargs: Any) → None[source]

Deletes a tag from the subscription.

You must remove all values from a resource tag before you can delete it.

Parameters:: tag_name (str) – The name of the tag. Required.
Returns:: None or the result of cls(response)
Return type:: None
Raises:: HttpResponseError –

delete_value(tag_name: str, tag_value: str, **kwargs: Any) → None[source]

Deletes a tag value.

Parameters:

tag_name (str) – The name of the tag. Required.
tag_value (str) – The value of the tag to delete. Required.

Returns:

None or the result of cls(response)

Return type:

None

Raises: