Skip to content

untag

untag(
    arn: GroupArnV2,
    keys: TagKeyList,
    *,
    config_overrides: Optional[ResourceGroupsClientConfig] = None,
) -> UntagOutput

Deletes tags from a specified resource group.

Minimum permissions

To run this command, you must have the following permissions:

  • resource-groups:Untag

Parameters:

  • arn (GroupArnV2) –

    The Amazon resource name (ARN) of the resource group from which to remove tags. The command removed both the specified keys and any values associated with those keys.

  • keys (TagKeyList) –

    The keys of the tags to be removed.

Raises:

Source code in docs_src/capo_resource_groups/_services/resource_groups.py
def untag(
    self,
    arn: "capo_resource_groups.types.group_arn_v2.GroupArnV2",
    keys: "capo_resource_groups.types.tag_key_list.TagKeyList",
    *,
    config_overrides: Optional[ResourceGroupsClientConfig] = None,
) -> "capo_resource_groups.types.untag_output.UntagOutput":
    """<p>Deletes tags from a specified resource group.</p> <p> <b>Minimum permissions</b> </p> <p>To run this command, you must have the following permissions:</p> <ul> <li> <p> <code>resource-groups:Untag</code> </p> </li> </ul>

    Args:
        arn: <p>The Amazon resource name (ARN) of the resource group from which to remove tags. The command removed both the specified keys and any values associated with those keys.</p>
        keys: <p>The keys of the tags to be removed.</p>

    Raises:
        capo_resource_groups.errors.bad_request_exception.BadRequestException: <p>The request includes one or more parameters that violate validation rules.</p>
        capo_resource_groups.errors.forbidden_exception.ForbiddenException: <p>The caller isn't authorized to make the request. Check permissions.</p>
        capo_resource_groups.errors.internal_server_error_exception.InternalServerErrorException: <p>An internal error occurred while processing the request. Try again later.</p>
        capo_resource_groups.errors.method_not_allowed_exception.MethodNotAllowedException: <p>The request uses an HTTP method that isn't allowed for the specified resource.</p>
        capo_resource_groups.errors.not_found_exception.NotFoundException: <p>One or more of the specified resources don't exist.</p>
        capo_resource_groups.errors.too_many_requests_exception.TooManyRequestsException: <p>You've exceeded throttling limits by making too many requests in a period of time.</p>
        capo_resource_groups.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_resource_groups.types.untag_input.UntagInput]",
    ) -> OperationResponse["capo_resource_groups.types.untag_output.UntagOutput"]:
        import capo_resource_groups._operations.ardi.untag

        output, http_response = capo_resource_groups._operations.ardi.untag.untag(
            req.options, req.input
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("Untag")
    )
    input_: capo_resource_groups.types.untag_input.UntagInput = {
        "arn": arn,
        "keys": keys,
    }

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