tag_resource ¶

tag_resource(
    resource_arn: TaggableResourceArn,
    tags: TagMap,
    *,
    config_overrides: Optional[EventBridgeV2ClientConfig] = None,
) -> TagResourceResponse

Adds or replaces tags on an event bus, subscriber, or event source.

Raises:

AccessDeniedException –

The caller does not have the permissions required to perform the operation. This error is also returned when the operation cannot use the AWS KMS key for the event bus.
InternalException –

The request failed because of an internal service error. Retry the request.
InvalidInputException –

A request parameter is missing or not valid.
ThrottlingException –

The request was throttled because it exceeds a request rate limit. Retry the request with backoff.
ConcurrentModificationException –

Another change to the resource is already in progress. Retry the request.
InvalidStateException –

The resource is not in a state that allows the operation. For example, an event bus that is still being created cannot accept events.
LimitExceededException –

The request would exceed a service quota for the account.
ResourceNotFoundException –

The resource does not exist.
UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_eventbridgev2/_services/event_bridge_v2.py

def tag_resource(
    self,
    resource_arn: "capo_eventbridgev2.types.taggable_resource_arn.TaggableResourceArn",
    tags: "capo_eventbridgev2.types.tag_map.TagMap",
    *,
    config_overrides: Optional[EventBridgeV2ClientConfig] = None,
) -> "capo_eventbridgev2.types.tag_resource_response.TagResourceResponse":
    """Adds or replaces tags on an event bus, subscriber, or event source.

    Raises:
        capo_eventbridgev2.errors.access_denied_exception.AccessDeniedException: The caller does not have the permissions required to perform the operation. This error is also returned when the operation cannot use the AWS KMS key for the event bus.
        capo_eventbridgev2.errors.internal_exception.InternalException: The request failed because of an internal service error. Retry the request.
        capo_eventbridgev2.errors.invalid_input_exception.InvalidInputException: A request parameter is missing or not valid.
        capo_eventbridgev2.errors.throttling_exception.ThrottlingException: The request was throttled because it exceeds a request rate limit. Retry the request with backoff.
        capo_eventbridgev2.errors.concurrent_modification_exception.ConcurrentModificationException: Another change to the resource is already in progress. Retry the request.
        capo_eventbridgev2.errors.invalid_state_exception.InvalidStateException: The resource is not in a state that allows the operation. For example, an event bus that is still being created cannot accept events.
        capo_eventbridgev2.errors.limit_exceeded_exception.LimitExceededException: The request would exceed a service quota for the account.
        capo_eventbridgev2.errors.resource_not_found_exception.ResourceNotFoundException: The resource does not exist.
        capo_eventbridgev2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_eventbridgev2.types.tag_resource_request.TagResourceRequest]",
    ) -> OperationResponse[
        "capo_eventbridgev2.types.tag_resource_response.TagResourceResponse"
    ]:
        import capo_eventbridgev2._operations.aws_events_v2.tag_resource

        output, http_response = (
            capo_eventbridgev2._operations.aws_events_v2.tag_resource.tag_resource(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("TagResource")
    )
    input_: capo_eventbridgev2.types.tag_resource_request.TagResourceRequest = {
        "resource_arn": resource_arn,
        "tags": tags,
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output