Skip to content

untag_resource

Operation

untag_resource

untag_resource(request: UntagResourceInput | UntagResourceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[UntagResourceInputDict]) -> UntagResourceOutput

Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to five times per second, per account.

  • UntagResource is an asynchronous operation. If you issue a ListTagsOfResource request immediately after an UntagResource request, DynamoDB might return your previous tag set, if there was one, or an empty tag set. This is because ListTagsOfResource uses an eventually consistent query, and the metadata for your tags or table might not be available at that moment. Wait for a few seconds, and then try the ListTagsOfResource request again.

  • The application or removal of tags using TagResource and UntagResource APIs is eventually consistent. ListTagsOfResource API will only reflect the changes after a few seconds.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

Parameters:

Name Type Description Default
request UntagResourceInput | UntagResourceInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[UntagResourceInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
UntagResourceOutput

An instance of UntagResourceOutput.

untag_resource async

untag_resource(request: UntagResourceInput | UntagResourceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[UntagResourceInputDict]) -> UntagResourceOutput

Removes the association of tags from an Amazon DynamoDB resource. You can call UntagResource up to five times per second, per account.

  • UntagResource is an asynchronous operation. If you issue a ListTagsOfResource request immediately after an UntagResource request, DynamoDB might return your previous tag set, if there was one, or an empty tag set. This is because ListTagsOfResource uses an eventually consistent query, and the metadata for your tags or table might not be available at that moment. Wait for a few seconds, and then try the ListTagsOfResource request again.

  • The application or removal of tags using TagResource and UntagResource APIs is eventually consistent. ListTagsOfResource API will only reflect the changes after a few seconds.

For an overview on tagging DynamoDB resources, see Tagging for DynamoDB in the Amazon DynamoDB Developer Guide.

Parameters:

Name Type Description Default
request UntagResourceInput | UntagResourceInputDict | None

The input as a model or dictionary. Pass this or keyword arguments, not both.

None
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None
**kwargs Unpack[UntagResourceInputDict]

The input fields as keyword arguments.

{}

Returns:

Type Description
UntagResourceOutput

An instance of UntagResourceOutput.

Input

Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.

UntagResourceInputDict

Bases: TypedDict

Dictionary form of UntagResourceInput.

Attributes

resource_arn instance-attribute
resource_arn: Required[str]

The DynamoDB resource that the tags will be removed from. This value is an Amazon Resource Name (ARN).

tag_keys instance-attribute
tag_keys: Required[Sequence[str]]

A list of tag keys. Existing tags of the resource whose keys are members of this list will be removed from the DynamoDB resource.

UntagResourceInput dataclass

Bases: _SerdeShape

Dataclass for UntagResourceInput structure.

Attributes

resource_arn class-attribute instance-attribute
resource_arn: str | None = ...

The DynamoDB resource that the tags will be removed from. This value is an Amazon Resource Name (ARN).

tag_keys class-attribute instance-attribute
tag_keys: list[str] | None = ...

A list of tag keys. Existing tags of the resource whose keys are members of this list will be removed from the DynamoDB resource.

Output

UntagResourceOutput dataclass

Bases: _SerdeShape

Dataclass for UntagResourceOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.