modify_user async ¶

async def modify_user(
    self,
    *,
    config_overrides: Optional[AsyncElastiCacheClientConfig] = None,
    user_id: Optional["capo_elasticache.types.user_id.UserId"] = None,
    access_string: Optional[
        "capo_elasticache.types.access_string.AccessString"
    ] = None,
    append_access_string: Optional[
        "capo_elasticache.types.access_string.AccessString"
    ] = None,
    passwords: Optional[
        "capo_elasticache.types.password_list_input.PasswordListInput"
    ] = None,
    no_password_required: Optional[
        "capo_elasticache.types.boolean_optional.BooleanOptional"
    ] = None,
    authentication_mode: Optional[
        "capo_elasticache.types.authentication_mode.AuthenticationMode"
    ] = None,
    engine: Optional["capo_elasticache.types.engine_type.EngineType"] = None,
) -> "capo_elasticache.types.user.User":
    """<p>Changes user password(s) and/or access string.</p>

    Args:
        user_id: <p>The ID of the user.</p>
        access_string: <p>Access permissions string used for this user.</p>
        append_access_string: <p>Adds additional user permissions to the access string.</p>
        passwords: <p>The passwords belonging to the user. You are allowed up to two.</p>
        no_password_required: <p>Indicates no password is required for the user.</p>
        authentication_mode: <p>Specifies how to authenticate the user.</p>
        engine: <p>Modifies the engine listed for a user. The options are valkey or redis.</p>

    Raises:
        capo_elasticache.errors.invalid_parameter_combination_exception.InvalidParameterCombinationException: <p>Two or more incompatible parameters were specified.</p>
        capo_elasticache.errors.invalid_parameter_value_exception.InvalidParameterValueException: <p>The value for a parameter is invalid.</p>
        capo_elasticache.errors.invalid_user_state_fault.InvalidUserStateFault: <p>The user is not in active state.</p>
        capo_elasticache.errors.service_linked_role_not_found_fault.ServiceLinkedRoleNotFoundFault: <p>The specified service linked role (SLR) was not found.</p>
        capo_elasticache.errors.user_not_found_fault.UserNotFoundFault: <p>The user does not exist or could not be found.</p>
        capo_elasticache.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_elasticache.types.modify_user_message.ModifyUserMessage]",
    ) -> AsyncOperationResponse["capo_elasticache.types.user.User"]:
        import capo_elasticache._operations.amazon_elasti_cache_v9.modify_user

        (
            output,
            http_response,
        ) = await capo_elasticache._operations.amazon_elasti_cache_v9.modify_user.async_modify_user(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ModifyUser")
    )
    input_: capo_elasticache.types.modify_user_message.ModifyUserMessage = {}
    if user_id is not None:
        input_["user_id"] = user_id
    if access_string is not None:
        input_["access_string"] = access_string
    if append_access_string is not None:
        input_["append_access_string"] = append_access_string
    if passwords is not None:
        input_["passwords"] = passwords
    if no_password_required is not None:
        input_["no_password_required"] = no_password_required
    if authentication_mode is not None:
        input_["authentication_mode"] = authentication_mode
    if engine is not None:
        input_["engine"] = engine

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output