tag_resource¶
Operation¶
tag_resource
¶
tag_resource(request: TagResourceInput | TagResourceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[TagResourceInputDict]) -> TagResourceOutput
Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up to five times per second, per account.
-
TagResourceis an asynchronous operation. If you issue a ListTagsOfResource request immediately after aTagResourcerequest, DynamoDB might return your previous tag set, if there was one, or an empty tag set. This is becauseListTagsOfResourceuses 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 theListTagsOfResourcerequest again. -
The application or removal of tags using
TagResourceandUntagResourceAPIs is eventually consistent.ListTagsOfResourceAPI 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
|
TagResourceInput | TagResourceInputDict | 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[TagResourceInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
TagResourceOutput
|
An instance of |
tag_resource
async
¶
tag_resource(request: TagResourceInput | TagResourceInputDict | None = None, /, *, plugins: list[Plugin] | None = None, **kwargs: Unpack[TagResourceInputDict]) -> TagResourceOutput
Associate a set of tags with an Amazon DynamoDB resource. You can then activate these user-defined tags so that they appear on the Billing and Cost Management console for cost allocation tracking. You can call TagResource up to five times per second, per account.
-
TagResourceis an asynchronous operation. If you issue a ListTagsOfResource request immediately after aTagResourcerequest, DynamoDB might return your previous tag set, if there was one, or an empty tag set. This is becauseListTagsOfResourceuses 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 theListTagsOfResourcerequest again. -
The application or removal of tags using
TagResourceandUntagResourceAPIs is eventually consistent.ListTagsOfResourceAPI 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
|
TagResourceInput | TagResourceInputDict | 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[TagResourceInputDict]
|
The input fields as keyword arguments. |
{}
|
Returns:
| Type | Description |
|---|---|
TagResourceOutput
|
An instance of |
Input¶
Pass the input as keyword arguments, a positional dictionary, or a positional model object. Pass plugins separately as a keyword argument.
Output¶
TagResourceOutput
dataclass
¶
Bases: _SerdeShape
Dataclass for TagResourceOutput structure.