ResourcesOperations Class

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through

<xref:resources> attribute.

Constructor

ResourcesOperations(*args, **kwargs)

Methods

begin_create_or_update	Creates a resource.
begin_create_or_update_by_id	Create a resource by ID.
begin_delete	Deletes a resource.
begin_delete_by_id	Deletes a resource by ID.
begin_move_resources	Moves resources from one resource group to another resource group. The resources to be moved must be in the same source resource group in the source subscription being used. 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.
begin_update	Updates a resource.
begin_update_by_id	Update a resource by ID.
begin_validate_move_resources	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 be moved must be in the same source resource group in the source subscription being used. 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.
check_existence	Checks whether a resource exists.
check_existence_by_id	Checks by ID whether a resource exists. This API currently works only for a limited set of Resource providers. In the event that a Resource provider does not implement this API, ARM will respond with a 405. The alternative then is to use the GET API to check for the existence of the resource.
get	Gets a resource.
get_by_id	Gets a resource by ID.
list	Get all the resources in a subscription.
list_by_resource_group	Get all the resources for a resource group.

begin_create_or_update

Creates a resource.

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

Parameters

Name	Description
resource_group_name Required	str The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace Required	str The resource provider of the resource to check. Required.
parent_resource_path Required	str The parent resource identity. Required.
resource_type Required	str The resource type. Required.
resource_name Required	str The name of the resource to check whether it exists. Required.
parameters Required	GenericResource or <xref:JSON> or IO[bytes] Resource create parameters. Is one of the following types: GenericResource, JSON, IO[bytes] Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[GenericResource]	An instance of LROPoller that returns GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

begin_create_or_update_by_id

Create a resource by ID.

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

Parameters

Name	Description
resource_id Required	str Required.
parameters Required	GenericResource or <xref:JSON> or IO[bytes] Resource create parameters. Is one of the following types: GenericResource, JSON, IO[bytes] Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[GenericResource]	An instance of LROPoller that returns GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

begin_delete

Deletes a resource.

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]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace Required	str The resource provider of the resource to check. Required.
parent_resource_path Required	str The parent resource identity. Required.
resource_type Required	str The resource type. Required.
resource_name Required	str The name of the resource to check whether it exists. Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns None

Exceptions

Type	Description
HttpResponseError

begin_delete_by_id

Deletes a resource by ID.

begin_delete_by_id(resource_id: str, *, api_version: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_id Required	str Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns None

Exceptions

Type	Description
HttpResponseError

begin_move_resources

Moves resources from one resource group to another resource group.

The resources to be moved must be in the same source resource group in the source subscription being used. 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.

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

Parameters

Name	Description
source_resource_group_name Required	str The name of the resource group to get. The name is case insensitive. Required.
parameters Required	ResourcesMoveInfo or <xref:JSON> or IO[bytes] Parameters for moving resources. Is one of the following types: ResourcesMoveInfo, JSON, IO[bytes] Required.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns None

Exceptions

Type	Description
HttpResponseError

begin_update

Updates a resource.

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

Parameters

Name	Description
resource_group_name Required	str The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace Required	str The resource provider of the resource to check. Required.
parent_resource_path Required	str The parent resource identity. Required.
resource_type Required	str The resource type. Required.
resource_name Required	str The name of the resource to check whether it exists. Required.
parameters Required	GenericResource or <xref:JSON> or IO[bytes] Resource create parameters. Is one of the following types: GenericResource, JSON, IO[bytes] Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[GenericResource]	An instance of LROPoller that returns GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

begin_update_by_id

Update a resource by ID.

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

Parameters

Name	Description
resource_id Required	str Required.
parameters Required	GenericResource or <xref:JSON> or IO[bytes] Resource create parameters. Is one of the following types: GenericResource, JSON, IO[bytes] Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
LROPoller[GenericResource]	An instance of LROPoller that returns GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

begin_validate_move_resources

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 be moved must be in the same source resource group in the source subscription being used. 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.

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

Parameters

Name	Description
source_resource_group_name Required	str The name of the resource group to get. The name is case insensitive. Required.
parameters Required	ResourcesMoveInfo or <xref:JSON> or IO[bytes] Parameters for moving resources. Is one of the following types: ResourcesMoveInfo, JSON, IO[bytes] Required.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns None

Exceptions

Type	Description
HttpResponseError

check_existence

Checks whether a resource exists.

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

Parameters

Name	Description
resource_group_name Required	str The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace Required	str The resource provider of the resource to check. Required.
parent_resource_path Required	str The parent resource identity. Required.
resource_type Required	str The resource type. Required.
resource_name Required	str The name of the resource to check whether it exists. Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
bool	bool

Exceptions

Type	Description
HttpResponseError

check_existence_by_id

Checks by ID whether a resource exists. This API currently works only for a limited set of Resource providers. In the event that a Resource provider does not implement this API, ARM will respond with a 405. The alternative then is to use the GET API to check for the existence of the resource.

check_existence_by_id(resource_id: str, *, api_version: str, **kwargs: Any) -> bool

Parameters

Name	Description
resource_id Required	str Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
bool	bool

Exceptions

Type	Description
HttpResponseError

get

Gets a resource.

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

Parameters

Name	Description
resource_group_name Required	str The name of the resource group containing the resource to get. The name is case insensitive. Required.
resource_provider_namespace Required	str The resource provider of the resource to check. Required.
parent_resource_path Required	str The parent resource identity. Required.
resource_type Required	str The resource type. Required.
resource_name Required	str The name of the resource to check whether it exists. Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
GenericResource	GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

get_by_id

Gets a resource by ID.

get_by_id(resource_id: str, *, api_version: str, **kwargs: Any) -> GenericResource

Parameters

Name	Description
resource_id Required	str Required.

Keyword-Only Parameters

Name	Description
api_version	str The API version to use for this operation. Required.

Returns

Type	Description
GenericResource	GenericResource. The GenericResource is compatible with MutableMapping

Exceptions

Type	Description
HttpResponseError

list

Get all the resources in a subscription.

list(*, filter: str | None = None, expand: str | None = None, top: int | None = None, **kwargs: Any) -> ItemPaged[GenericResourceExpanded]

Keyword-Only Parameters

Name	Description
filter	str The filter to apply on the operation. Filter comparison operators include `eq` (equals) and `ne` (not equals) and may be used with the following properties: `location`, `resourceType`, `name`, `resourceGroup`, `identity`, `identity/principalId`, `plan`, `plan/publisher`, `plan/product`, `plan/name`, `plan/version`, and `plan/promotionCode`. For example, to filter by a resource type, use $filter=resourceType eq 'Microsoft.Network/virtualNetworks'``<br><br><br>``substringof(value, property) can be used to filter for substrings of the following currently-supported properties: `name` and resourceGroup``<br><br>For example, to get all resources with 'demo' anywhere in the resource name, use ``$filter=substringof('demo', name)``<br><br>Multiple substring operations can also be combined using ``and/`or` operators. Note that any truncated number of results queried via `$top` may also not be compatible when using a filter. Resources can be filtered by tag names and values. For example, to filter for a tag name and value, use `$filter=tagName eq 'tag1' and tagValue eq 'Value1'`. Note that when resources are filtered by tag name and value, the original tags for each resource will not be returned in the results. Any list of additional properties queried via `$expand` may also not be compatible when filtering by tag names/values. For tag names only, resources can be filtered by prefix using the following syntax: `$filter=startswith(tagName, 'depart')`. This query will return all resources with a tag name prefixed by the phrase `depart` (i.e.`department`, `departureDate`, `departureTime`, etc.) Note that some properties can be combined when filtering resources, which include the following: `substringof() and/or resourceType`, `plan and plan/publisher and plan/name`, and `identity and identity/principalId`. Default value is None. Default value: 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. Default value: None
top	int The number of recommendations per page if a paged version of this API is being used. Default value is None. Default value: None

Returns

Type	Description
ItemPaged[GenericResourceExpanded]	An iterator like instance of GenericResourceExpanded

Exceptions

Type	Description
HttpResponseError

list_by_resource_group

Get all the resources for a resource group.

list_by_resource_group(resource_group_name: str, *, filter: str | None = None, expand: str | None = None, top: int | None = None, **kwargs: Any) -> ItemPaged[GenericResourceExpanded]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group to get. The name is case insensitive. Required.

Keyword-Only Parameters

Name	Description
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. For example, to filter by a resource type, use: $filter=resourceType eq 'Microsoft.Network/virtualNetworks' You can use substringof(value, property) in the filter. The properties you can use for substring are: name and resourceGroup. For example, to get all resources with 'demo' anywhere in the name, use: $filter=substringof('demo', name) You can link more than one substringof together by adding and/or operators. 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'. When you filter by a tag name and value, the tags for each resource are not returned in the results. 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. Default value: 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. Default value: None
top	int The number of results to return. If null is passed, returns all resources. Default value is None. Default value: None

Returns

Type	Description
ItemPaged[GenericResourceExpanded]	An iterator like instance of GenericResourceExpanded

Exceptions

Type	Description
HttpResponseError

Feedback

War diese Seite hilfreich?